bricks/docs/ai/tree.md

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 请求或本地操作）