拼ui 一些业务逻辑x实现

2026-03-19 06:15:09 +08:00
parent f5c6f143c0
commit 49e45ac464
1118 changed files with 246518 additions and 5368 deletions
@@ -0,0 +1,78 @@
+# Preview 面板
+
+本章说明 `Unity Easy Chart/Library Editor` 中间区域顶部的 **Preview** 面板。
+
+Preview 的作用是：把当前选中的 `ChartProfile` 直接渲染出来，让你在编辑配置时能即时看到结果。
+
+---
+
+## Preview 会在什么时候刷新
+
+Preview 刷新是“延迟刷新”（避免你连续拖动/输入时频繁重绘）：
+
+- 当你在 **Inspector** 或 **Series** 面板修改任何绑定字段时，会触发一次 `ScheduleUpdatePreview()`。
+- 当你在 **JSON Injection** 面板点击 **ApplyToChart** 后，会触发刷新。
+- 当你在左侧 **Library** 树切换到另一个 `ChartProfile` 时，会刷新到新 Profile。
+
+实现上会把刷新放到 `EditorApplication.delayCall`，因此你可能会感觉到“改完后稍后才更新”——这是预期行为。
+
+---
+
+## Preview 显示什么
+
+- Preview 使用一个运行时的图表组件（例如 `ChartElement`）进行绘制。
+- Preview 会直接读取当前选中 `ChartProfile` 的数据并渲染。
+
+你可以把 Preview 理解为：
+
+- **你编辑的就是它渲染的**
+- **你看到的就是运行时的效果**（大多数情况下）
+
+---
+
+## 常见问题与排错
+
+### 1) 预览为空
+
+优先排查：
+
+- 是否选中了一个 `ChartProfile`
+- 是否至少存在一条 `Serie`
+- `seriesData` 是否为空（没有数据点）
+
+### 2) 数据有但显示很怪 / 看不到
+
+常见原因：
+
+- **坐标系与 SeriesType 不匹配**：例如 Profile 是 `Polar2D`，但 Series 选择了非 Radar 的类型。
+- **轴范围/数据范围不匹配**：例如数值全都落在轴范围之外。
+- **分类轴可见数量（VisibleCount）太小**：导致只显示一小段。
+
+### 3) Console 报错 “Preview refresh failed”
+
+当刷新过程中出现异常，会在 Console 输出：
+
+- `[EasyChartLibraryWindow] Preview refresh failed: ...`
+
+这通常意味着：
+
+- 某个配置组合不合法
+- 或某个字段值超出预期（例如 null / NaN）
+
+建议处理：
+
+- 先回退最近一次改动
+- 再逐步改回去定位哪一个字段触发异常
+
+---
+
+## 提示
+
+- Preview 只负责“呈现结果”，结构性问题通常需要回到 **Inspector/Series/JSON Injection** 去修。
+- 如果你在短时间内修改了很多字段，Preview 可能在最后一次改动后才统一刷新（这是为了性能）。
+
+---
+
+## Help
+
+- 点击标题栏最右侧 **Help** 图标可回到本章节。