拼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,162 @@
+# Library 面板（资源树）
+
+本章说明 `Unity Easy Chart/Library Editor` 窗口左侧的 **Library** 面板：用于管理你的图表资产（`ChartProfile`）与文件夹结构，并决定右侧各面板正在编辑的是哪个 Profile。
+
+---
+
+## 功能概览
+
+- **展示结构**：以树状结构展示“图表库根目录”下的文件夹与 `ChartProfile`（`.asset`）。
+- **选择驱动编辑**：点击某个 `ChartProfile` 后，会驱动：
+  - Inspector 面板绑定到该 Profile
+  - Series 面板绑定到该 Profile 的 `series`
+  - Preview 预览刷新
+  - JSON Injection 生成示例 JSON（并可 Apply 回写到该 Profile）
+- **管理资产**：提供创建、重命名、删除、拖拽移动、展开/收起等操作。
+
+---
+
+## 界面结构说明
+
+Library 面板的顶部标题栏从左到右通常包含：
+
+- **Library**：标题。
+- **(当前库名称)**：括号内显示当前选中的库/根目录名称（用于区分你可能配置的多个库）。
+- **Menu（菜单按钮）**：常用操作入口（和右键菜单类似，但更集中）。
+- **Help（帮助按钮）**：打开本章节。
+
+窗口顶部全局工具栏（Window Toolbar）中，Library 下拉框右侧包含：
+
+- **+**：新增一个 Library。
+- **-**：删除当前 Library。
+- **Clone（克隆当前 Library）**：把当前 Library 复制为一个新 Library（详见下文）。
+
+标题栏下面是：
+
+- **资源树（TreeView）**：
+  - 文件夹
+  - `ChartProfile` 资产（图表配置文件）
+
+---
+
+## 选择逻辑（非常重要）
+
+- **选中的是文件夹**：
+  - 右侧 Inspector/Series 会清空（因为没有具体 Profile 可以编辑）。
+  - JSON Injection 会切换为“无选中 Profile”的示例或保持当前示例（具体以实现为准）。
+- **选中的是 ChartProfile**：
+  - Inspector/Series 立即绑定到该 Profile 的序列化数据。
+  - 任何字段变化会触发 Preview 延迟刷新（`delayCall`）。
+
+建议：如果你发现右侧面板没有内容，先确认左侧是否选中了一个 `ChartProfile`。
+
+---
+
+## 常用操作（标题栏 Menu）
+
+点击标题栏右侧 **Menu**（小菜单图标）会弹出操作菜单，常见项包括：
+
+- **New Chart**：在“目标文件夹”下创建新的 `ChartProfile`。
+- **New Folder**：在“目标文件夹”下创建新文件夹。
+- **Refresh**：重新扫描并重建树（当你在 Project 视图中手动移动/复制文件后很有用）。
+- **Expand All**：展开所有文件夹。
+- **Collapse All**：收起所有文件夹。
+- **Rename / Delete**：对“当前选中项”执行重命名/删除。
+  - 如果当前选中的是库根目录，通常会被禁用。
+- **Export UGUI Prefab**（当选中的是 Profile 时可用）：把选中 Profile 导出为 UGUI Prefab（用于运行时展示）。
+
+### 目标文件夹是如何决定的
+
+Menu 中的 **New Chart / New Folder** 会把资源创建在“目标文件夹”下：
+
+- 如果你当前选中的是 **文件夹**：目标就是该文件夹。
+- 如果你当前选中的是 **ChartProfile**：目标通常是该 Profile 所在的文件夹。
+- 如果没有选中或不明确：目标通常回退到库根目录。
+
+---
+
+## Clone Library（克隆当前 Library）
+
+当你需要把一整套图表库（包含 Profile 与 UXML）复制成一个新的库（用于分支/版本/主题变体等）时，可以使用窗口顶部工具栏里的 **Clone**。
+
+### 入口与操作
+
+- 点击 Library 下拉框右侧的 **Clone** 图标。
+- 输入新库名称并确认。
+
+### 克隆内容
+
+- `Assets/EasyChart/Library/<当前库>` 会被复制到 `Assets/EasyChart/Library/<新库>`。
+- `Assets/EasyChart/LibraryUxml/<当前库>` 会被复制到 `Assets/EasyChart/LibraryUxml/<新库>`（如果源库存在对应 UXML 目录）。
+
+### 限制与命名规则
+
+- `<Root>` 库不允许克隆。
+- 新名称会做基础清理（移除非法文件名字符），空白名称会被忽略。
+- 如果目标库已存在（同名文件夹已存在），会提示并取消。
+
+### 克隆后的行为
+
+- 会自动切换当前选中的 Library 为新库。
+- 会刷新 Library 下拉列表与左侧资源树，并触发右侧面板/预览的刷新。
+
+---
+
+## 常用操作（右键菜单）
+
+你也可以在树上的条目上 **右键**：
+
+### 右键文件夹
+
+- **New Folder...**：在该文件夹下创建子文件夹。
+- **New Chart...**：在该文件夹下创建新的 `ChartProfile`。
+- **Export Folder to UXML (Mirror/Backup)**：导出该文件夹下的内容到 UXML（用于备份/分发/版本化）。
+- **Rename...**：重命名文件夹。
+- **Delete**：删除文件夹（请谨慎，属于破坏性操作）。
+
+### 右键 ChartProfile
+
+- **Export to UXML**：导出当前 Profile 的 UXML。
+- **Clone**：克隆一个新的 Profile（用于快速派生相似图表）。
+- **Rename...**：重命名资产（同时会尝试同步更新 `profile.name` / `profile.chartName`）。
+- **Ping**：在 Project 视图中定位该资产。
+- **Delete**：删除资产。
+
+---
+
+## 拖拽移动与排序
+
+Library 树支持拖拽移动文件夹或 `ChartProfile`：
+
+- **拖拽 ChartProfile 到文件夹**：会触发 `AssetDatabase.MoveAsset`，把 `.asset` 移动到目标文件夹。
+- **拖拽文件夹到文件夹**：会把整个文件夹移动到目标文件夹下。
+
+注意：
+
+- 如果目标无效（例如拖到自身/子目录），会拒绝（鼠标提示为 Rejected）。
+- 移动后会自动刷新树。
+
+---
+
+## 重命名（双击与内联编辑）
+
+在树上 **双击** 条目会进入内联重命名流程（等价于执行 Rename）。
+
+实现上会对名字做基础清理（移除非法文件名字符）。如果你输入空白或与原名相同，会取消重命名。
+
+---
+
+## 常见问题与排错
+
+- **右侧面板为空**：
+  - 先确认左侧是否选中了 `ChartProfile`（而不是文件夹）。
+- **改了名字但 chartName 没更新**：
+  - ChartProfile 可能有额外同步逻辑；建议在 Inspector 里确认 `Chart Name` 字段是否一致。
+- **拖拽失败**：
+  - 常见原因：拖到了自身、拖到子目录、或目标路径已存在同名资源。
+
+---
+
+## Help
+
+- 点击标题栏最右侧 **Help** 图标可回到本章节。