简介
树型下拉单选框是一种将选项以层级结构展示的下拉选择控件,允许用户在树状结构中进行单选操作。
配置项
分类 | 配置 | 示例 | 说明 |
内容 | 选项列表 | 数据源 | |
默认值 | 默认选中的值 | ||
展开的树节点 | 当前展开的树节点的值。 | ||
展位内容 | 没有选择任何选项时显示的提示文本。 | ||
标签 | 详情参见表单通用属性 | ||
交互 | 隐藏 | 控制树型下拉单选框的默认展示状态,为 | |
搜索 | 开启树型下拉单选框的搜索能力,根据用户输入的内容过滤数据。 | ||
禁用 | 是否禁用树型下拉单选框 | ||
校验 | 详情参见表单通用属性 | ||
样式 | 外边距 | 详情参见通用属性 | |
自定义树节点的展开/折叠图标 | 支持自定义树节点的展开/折叠图标。 如果只设置展开图标,则折叠图标为展开图标逆时针转向90度;只设置折叠图标,则展开图标为折叠图标顺时针转向90度。 | ||
清除按钮 | 是否展示清除按钮 | ||
形态变体 | 树型下拉单选框的输入框形态。 | ||
是否展示线条样式 | 数据源各层级间是否展示线条样式 | ||
是否展示选框 | 是否展示选框,仅支持单选 | ||
CSS 样式 | 节点悬浮态背景色 | 鼠标悬浮在节点时的背景色 | |
节点选中态背景色 | 选中节点的背景色 | ||
圆角 | 树型下拉单选框圆角,详情参见通用属性 | ||
文字颜色 | 文字颜色,对树节点生效 | ||
标签字体大小 | 仅对标签文字内容生效 |
属性与方法
名称 | 类型 | 示例 | 说明 |
value | string |
| 当前树型下拉单选框组件的选中内容 |
labelText | string |
| 只读,当前树型下拉单选框组件的标签文字内容 |
disabled | boolean |
| 只读,是否禁用当前树型下拉单选框组件 |
data | array |
| 只读,当前树型下拉单选框组件的下拉菜单数据 |
treeExpandedKeys | array |
| 当前树型下拉单选框组件的下拉菜单树的展开项的key集合 |
validationStatus | boolean |
| 当前树型下拉单选框组件的校验状态 |
validationMessage | string |
| 当前树型下拉单选框组件的校验信息 |
hidden | boolean |
| 当前组件是否隐藏,详情参见通用属性 |
setValue | func |
| 设置树型下拉单选框的选中值为 |
clearValue | func |
| 清除树型下拉单选框的选中值 |
setTreeExpandedKeys | func |
| 设置树型下拉单选框的展开项为 |
clearTreeExpandedKeys | func |
| 清除树型下拉单选框的展开项,即折叠菜单 |
setHidden | func |
| 设置树型下拉单选框是否隐藏,参数为 |
clearHidden | func |
| 清除树型下拉单选框的隐藏状态,详情参见通用属性 |
validate | func |
| 触发树型下拉单选框的校验 |
clearValidate | func |
| 清除树型下拉单选框的校验状态 |
focus | func |
| 使树型下拉单选框获取焦点 |
blur | func |
| 使树型下拉单选框失去焦点 |
事件回调
配置 | 说明 |
当树型下拉单选框的选中值发生变化时将触发的事件 | |
选中树节点时将触发的事件 | |
文本框值变化时将触发的事件 |
场景示例
商品分类
在后台商品管理页面,可以对商品的分类进行过滤,从而快速找到目标商品