跳到主要内容

Tree 树形控件 ​

WebH5

树形控件。展示层级数据,支持展开/收起、单选高亮、级联勾选(父级勾选/取消所有子孙,子级部分勾选时父级半选)。

何时使用 ​

展示和操作的层级数据:目录、组织架构、多级分类。

何时不使用 ​

只是让用户选一条层级路径时,用 Cascader 更省空间。

Props ​

名称类型默认值说明
nodesArray<TreeNode>[]树数据,项为 { label: string; value: string | number; children?: 同构; disabled?: boolean }
expandAllbooleanfalse默认展开全部有子节点的节点
checkablebooleanfalse是否显示复选框;勾选父级级联勾选/取消所有子孙,子级部分勾选时父级显示半选
checkedKeysArray<string | number>[]勾选的 key 列表,配合 v-model:checkedKeys 使用
selectedKeystring | number | nullnull单选高亮的 key,配合 v-model:selectedKey 使用;点击节点即更新
expandedKeysArray<string | number>"undefined(内部维护展开态)"展开的 key 列表,配合 v-model:expandedKeys 受控使用;不传时由组件内部维护
indentnumber16每层缩进(px)

Events ​

名称载荷说明
update:checkedKeysArray<string | number>勾选变化时触发,用于 v-model:checkedKeys
update:selectedKeystring | number | null点击节点时触发,用于 v-model:selectedKey
update:expandedKeysArray<string | number>展开/收起节点时触发,用于 v-model:expandedKeys
node-clickTreeNode点击节点时触发;disabled 节点不触发

示例 ​

部门树(单选高亮) ​

示例加载中…

权限配置(级联勾选) ​

示例加载中…

默认全部展开 ​

示例加载中…

自定义缩进 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Tree 文档(含手机预览)。