拼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,93 @@
+# 快速上手：2 分钟做出第一张图
+
+本章目标：按 EasyChart 推荐的最快路径跑通“**编辑 → 导出 → 在 UI 中使用**”的闭环。
+
+---
+
+## 打开编辑器窗口
+
+在 Unity 菜单栏选择：
+
+- `EasyChart/Library Editor`
+
+你会看到一个类似“资源库/配置面板/预览区”的窗口（后续章节会解释每个区域）。
+
+---
+
+## 克隆一个 Library（推荐）
+
+如果你想快速开始并保持风格一致，建议：
+
+- 先在窗口顶部工具栏选择一个已有 Library（例如内置 Demo 库）
+- 点击工具栏的 **Clone**，克隆出你的个人库（例如 `MyLibrary`）
+
+这样你后续所有修改都发生在自己的库里，避免污染原始示例。
+
+---
+
+## 克隆一个 ChartProfile（推荐）
+
+在资源树里找到一个接近你目标效果的图表（`ChartProfile`），右键：
+
+- `Clone`
+
+克隆后，你会得到一个新的 Profile（用于做“同款变体”）。选中它，右侧 Inspector 会显示你可以直接修改的所有配置。
+
+---
+
+## 修改配置并保存
+
+最少改动建议：
+
+- `coordinateSystem`：确保与你要的 Series 匹配（例如 Line/Bar/Scatter 用 `Cartesian2D`）
+- `series`：确认 `type` 正确，并填充 `seriesData`
+- `axes`：最少保证 X/Y 轴类型与数据含义匹配
+
+完成修改后，点击窗口顶部工具栏的保存按钮（如果你的版本有），或等待 Unity 自动保存资产。
+
+---
+
+## 导出 UXML（用于 UI Builder 复用）
+
+推荐做法是把 Profile 导出为可复用的 `.uxml`：
+
+- 在资源树里右键你的 Profile
+- 选择 `Export to UXML`
+
+导出的 UXML 会进入：
+
+- `Assets/EasyChart/LibraryUxml/`（Mirror/Backup 相关操作也会在这个根目录下管理导出物）
+
+---
+
+## 在 QuickStart 场景里用 UIDocument + UI Builder 使用
+
+打开示例场景：
+
+- `Assets/EasyChart/Demo/Scenes/EasyChart_QuickStart.unity`
+
+然后在 Project 中找到：
+
+- `Assets/EasyChart/Demo/UIToolKit/NewUXMLTemplate.uxml`
+
+双击它打开（或在 UI Builder 中打开）。接下来：
+
+- 从 Project 里把你刚导出的图表 `.uxml` 拖入到 `NewUXMLTemplate.uxml` 的层级中
+- 保存 UXML
+- 确认场景里的 `UIDocument` 引用了你编辑后的 `NewUXMLTemplate.uxml`
+
+运行场景，你会看到图表渲染在 UI Toolkit 页面中。
+
+---
+
+## 备选：导出为 UGUI 预制体并使用
+
+如果你希望用 UGUI（Canvas/RectTransform）工作流，也可以在 Library Editor 中把选中的 Profile 导出为 UGUI 预制体并直接放进场景 UI（具体入口与细节取决于你当前版本提供的菜单项）。
+
+---
+
+## 下一步你应该看什么
+
+- 你要系统理解 UI Toolkit 推荐工作流：`00-WorkflowAndLibrary.md`
+- 你要用 UGUI（Canvas/RectTransform）把图表用起来：`33-UGUIWorkflow.md`
+