41 lines
2.6 KiB
Markdown
41 lines
2.6 KiB
Markdown
# Tree
|
||
|
||
**控件功能**：树形结构控件，用于展示层级化的数据（如目录、组织架构等），支持异步加载、节点增删改、复选、工具栏操作等功能。可作为静态树或可编辑树使用。
|
||
|
||
**类型**：容器控件
|
||
**父类控件**：`bricks.VScrollPanel`
|
||
|
||
## 初始化参数
|
||
|
||
| 参数名 | 类型 | 必需 | 说明 |
|
||
|--------|------|------|------|
|
||
| `row_height` | `String` | 否 | 每个节点行的高度，默认 `'35px'` |
|
||
| `idField` | `String` | 是 | 数据中表示节点唯一标识的字段名 |
|
||
| `textField` | `String` | 是 | 数据中表示节点显示文本的字段名 |
|
||
| `is_leafField` | `String` | 否 | 标识节点是否为叶子节点的字段名，默认 `'is_leaf'` |
|
||
| `typeField` | `String` | 否 | 区分节点类型的字段名，用于定制图标 |
|
||
| `data` | `Array` | 否 | 静态树数据数组，直接初始化节点 |
|
||
| `dataurl` | `String` | 否 | 异步加载子节点数据的 URL 地址 |
|
||
| `method` | `String` | 否 | 请求数据的方法，默认 `'GET'` |
|
||
| `params` | `Object` | 否 | 请求时附加的全局参数 |
|
||
| `node_view` | `Widget Description` | 否 | 自定义节点渲染模板（描述对象） |
|
||
| `checkField` | `String` | 否 | 支持复选功能时，数据中保存勾选状态的字段名 |
|
||
| `node_typeicons` | `Object` | 否 | 按节点类型定义图标的映射表，格式 `{ nodetype: { open, close, leaf }, default_type: "type" }` |
|
||
| `editable` | `Object` | 否 | 编辑配置，含 `fields`, `add_url`, `delete_url`, `update_url` 等 |
|
||
| `newdata_params` | `Object` | 否 | 添加新节点时额外注入的固定参数 |
|
||
|
||
## 主要事件
|
||
|
||
| 事件名 | 触发条件 | 回调参数说明 |
|
||
|--------|--------|-------------|
|
||
| `node_selected` | 节点被点击选中或取消选中时派发 | 参数为 `node.user_data` 扩展了 `{ selected: true/false }` |
|
||
| `check_changed` | 节点复选框状态改变时派发 | 参数为该节点的 `user_data`，反映最新勾选状态 |
|
||
| `command`（来自 `toolbar_w`） | 工具栏按钮被点击时触发 | 由 `toolbar_command` 处理，根据 `event.params.name` 执行添加、删除、更新或其他自定义命令 |
|
||
| （自定义命令）如 `add`, `delete`, `update` 等 | 用户执行相应操作并成功提交后，通过 `dispatch(name, data)` 派发 | `data` 包含节点数据及元信息 `meta_data`（来源、标题、图标等），可用于打开表单或通知其他模块 |
|
||
|
||
此外，`Tree` 还会响应以下用户交互行为并执行逻辑：
|
||
- 展开/折叠节点（通过 `expand()` / `collapse()`）
|
||
- 动态加载子节点数据（`get_children_data`）
|
||
- 增删改节点（通过 HTTP 请求或本地操作）
|
||
|