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 图标可回到本章节。