Skip to content

TreeSelect 树形选择器

树形结构选择,支持父子级联多选。

单选

单选

点击节点即选中并关闭下拉,支持展开 / 收起子级。

多选(父子联动)

多选(multiple)

多选时选中父级会级联选中全部子级,再次点击取消;父级节点呈「全选 / 半选」态。

预设值

预设值(value)

受控展开(expanded)

expanded 为 JSON 数组,声明展开节点的 value 集合(受控通道):外部修改属性即时反映到下拉树。以下预设展开「前端 → 框架」,并用按钮外部驱动:

受控展开(expanded)

全部展开全部收起

预设 expanded='["fe","framework"]' 使首次展开下拉时「前端」「框架」已展开;点击「全部展开」外部写入 expanded='["fe","framework","be"]',全部收起写入 '[]',下拉打开时即时重渲染。

禁用

禁用

空态

无数据

事件

变化事件

监听 oas-changedetail.value 单选为字符串、多选为数组:

API

属性

属性说明类型默认值
disabled禁用boolean
expanded展开节点的 value 集合(JSON 数组,受控)string[]
multiple多选 + 父子级联boolean
options树形选项,JSON 数组,支持 children / disabledTreeOption[] | string[]
placeholder占位提示
value选中值(多选为 JSON 数组)string[]

事件

事件说明
oas-change选择变化,detail: { value }