拼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,166 @@
+# Series 面板（数据与系列）
+
+本章说明 `Unity Easy Chart/Library Editor` 右侧的 **Series** 面板。
+
+Series 面板以“图表结构”的方式编辑 `ChartProfile.series`：你可以添加/删除/排序系列，设置每条 Serie 的类型与参数，并直接编辑 `seriesData`（数据点）。
+
+---
+
+## 面板结构概览
+
+当你选中一个 `ChartProfile` 后，Series 面板会显示：
+
+- 一组 Serie 卡片（每个卡片对应 `series[i]`）
+- 最底部的 **+ Add Series** 按钮
+
+每个 Serie 卡片通常由三部分组成：
+
+- **Header（标题行）**：折叠按钮 + 标题
+- **Body（主体）**：Name / Id / Type / Settings / Data
+- **Footer（右下角控制）**：↑ ↓ X
+
+---
+
+## Header：折叠/展开
+
+- Header 左侧有一个小按钮：
+  - `▼` 表示已展开
+  - `▶` 表示已折叠
+- 折叠状态会被记住（按 Profile + index 存储），用于减少长配置的视觉负担。
+
+---
+
+## Name 与 Serie Id
+
+### Name
+
+- `Name` 字段用于显示与编辑该 Serie 的名称。
+- 当你修改 Name 时，卡片标题会同步更新，并触发 Preview 刷新。
+
+### Serie Id（只读）
+
+如果该 Serie 支持 `id` 字段，面板会显示：
+
+- **Serie Id**（只读文本框）
+- **Copy**（按钮）复制 id 到剪贴板
+
+这个 id 常用于：
+
+- 交互/高亮/外部系统引用某条 serie
+- 保持引用稳定（尤其是你会重排/增删 series 时）
+
+---
+
+## Type（系列类型）与兼容性提示
+
+### Type 下拉框
+
+- `Type` 用于选择 SerieType（Line/Bar/Scatter/Pie/Radar…）。
+- 下拉框会基于注册表提供可选类型；如果当前类型不在列表里，会临时插入以保证可见。
+
+### 兼容性警告
+
+当 SeriesType 与 Profile 的 `coordinateSystem` 不兼容时，Series 面板会显示一段警告文字：
+
+- 仍然允许渲染（不会强制阻止）
+- 但会提示坐标轴/网格语义可能不一致
+
+典型例子：
+
+- Profile 是 `Polar2D`，但 SeriesType 选择了 Line/Bar（不推荐）
+
+### Pro-only 类型限制
+
+某些类型在 Free 版本不可用（例如 RingChart / HorizontalBar / Heatmap / Pie3D 等）。
+
+- 当你尝试选择这些类型时，如果未安装 Pro：
+  - 会显示提示文本
+  - 并自动把下拉框回退到原来的类型（不会修改资产）
+
+---
+
+## Settings（系列参数）
+
+Series 面板会为每条 serie 显示一组 Settings 配置：
+
+- 根折叠块名称会随类型变化（例如 `LineSettings` / `BarSettings` / `PieSettings` …）。
+- 某些类型会有更细分的子折叠（例如 Ring 的 layout/valueMapping 等）。
+
+提示：
+
+- 切换 Type 可能会触发“Settings 实例替换”（managedReference 结构变化）。
+- 发生替换时会延迟一帧重建 UI，以避免序列化句柄失效。
+
+---
+
+## Data：seriesData（数据点）
+
+Series 面板里会直接展示 `seriesData` 数组（Unity 的默认数组编辑器）。
+
+- 默认会强制展开（便于编辑）。
+- 当你增删/修改数据点时，会触发 Preview 刷新。
+
+建议：
+
+- 数据点较多时，可以配合 JSON Injection 面板进行批量编辑。
+
+---
+
+## Footer：排序与删除（渲染顺序）
+
+每个 serie 卡片右下角有三个按钮：
+
+- **↑**：把当前 serie 上移一位（`MoveArrayElement(index, index-1)`）
+- **↓**：把当前 serie 下移一位（`MoveArrayElement(index, index+1)`）
+- **X**：删除当前 serie（`DeleteArrayElementAtIndex(index)`）
+
+渲染顺序提示：
+
+- 通常 **后面的 serie 会绘制在更上层**。
+- 因此你可以用 ↑↓ 来控制遮挡关系（例如点/线盖住柱子）。
+
+---
+
+## + Add Series（新增系列）
+
+点击底部 **+ Add Series**：
+
+- 会在 `series` 数组末尾插入一个新元素。
+- 注意：如果当前已经存在至少一条 serie，Unity 的 `InsertArrayElementAtIndex(arraySize)` 会 **复制最后一个元素**（包括 type/settings）。
+- 如果这是第一条 serie，会根据坐标系设置默认类型：
+  - Polar2D：默认 Radar
+  - 其他：默认 Line
+
+新增后通常会：
+
+- 自动填入名称（如 `Serie N`）
+- 触发 `EnsureRuntimeData()`
+- 刷新 Series 列表与 Preview
+
+---
+
+## 推荐工作流
+
+### 1) 从零创建一张基础图
+
+- + Add Series
+- Type 选择 Line 或 Bar
+- 在 seriesData 里加入几个点
+- 去 Inspector 调整轴范围/可见数量
+
+### 2) 调整遮挡关系
+
+- 用 ↑↓ 调整 series 顺序
+- 观察 Preview 中的层级变化
+
+### 3) 大量数据/批量修改
+
+- 在 JSON Injection 中切换 `Datas Format`
+- Copy 到外部编辑器批量生成/替换数据
+- 粘贴回来 ApplyToChart
+
+---
+
+## Help
+
+- 点击标题栏最右侧 **Help** 图标可回到本章节。