WTree 组件

A2UI Protocol JSON Schema

树形控件，基于 WinDesignNext Tree 封装，用于展示和操作层级数据（组织架构、菜单、分类等）。

与 WTreeSelect 的区别：WTree 为独立树形展示/操作控件；WTreeSelect 为下拉选择器内嵌树形面板。

基础用法

API

属性	类型	说明
component	string	固定为 WTree
data / dataSource	array / string	树数据
props	object | DataBindingValue	节点字段映射
currentNodeKey	DataBindingValue	当前选中节点 key
checkedKeys	DataBindingValue	勾选节点 key 数组
showCheckbox	boolean	显示复选框
defaultExpandAll	boolean	默认全部展开
checkStrictly	boolean	父子勾选不关联
action	Action	树交互事件

path 支持说明

属性	path 支持	说明
dataSource	✅（路径字符串）	树数据数组路径
props	✅	字段映射配置
currentNodeKey	✅	当前节点，current-change 时写回
checkedKeys	✅	勾选 keys，check 时写回
emptyText	✅	空数据提示

字段映射

树数据默认使用 label/children，若字段不同：

{
  "props": { "label": "name", "children": "subList" }
}

注意事项

• 节点需包含唯一标识，通过 nodeKey 或数据中的 id 字段
• A2UI JSON 不支持 load、allowDrag 等函数属性
• defaultCheckedKeys 仅在初始化生效，动态更新请配合 checkedKeys.path 写回机制