Skip to content

ETreeSelect 树形选择 ​

import EUI 1.0

示例与代码 ​

树形选择 ​

QML 代码QML
效果
运行代码,体验组件交互

可修改文字、属性和事件,再点击运行。

代码在当前浏览器中运行 许可

树节点选择 ​

QML 代码QML
效果
运行代码,体验组件交互

可修改文字、属性和事件,再点击运行。

代码在当前浏览器中运行 许可

属性 ​

属性说明取值与默认值
allowCreatebool

允许把没有匹配结果的输入创建为新选项。

默认值false
cacheDatavar

懒加载树节点的缓存数据,用于补全已选值的标签。

默认值[]
checkStrictlybool

选中状态不随父子节点联动。

默认值false
childrenRolestring

数据对象中用于文字、取值、子节点或缩进的字段名。

默认值"children"
clearablebool

显示清除操作;评分中允许再次点击当前分数清零。

默认值false
collapseTagsbool

折叠过多的已选标签。

默认值false
currentIndexint

当前选中或显示项的索引。

-1:未选择
0 起:条目索引

默认值-1
datavar

树节点数组,角色属性可自定义字段映射。

字段:
label, value, children
disabled

默认值[]
debounceint

等待、节流或自动关闭时间,单位为毫秒;0 表示不延迟或不启用定时关闭。

默认值300
defaultExpandAllbool

初始展开所有节点或行。

默认值true
editablebool

允许编辑输入或同时开启标签页新增和关闭操作。

默认值false
emptyValuesvar

判定为空值的数组;默认包含 undefined、null 和空字符串。

默认值继承 Provider,默认 [undefined, null, ""]
enabledbool

是否允许交互;false 时控件禁用。

默认值true
expandedKeysvar

已展开节点、表格行或菜单项的唯一键数组。

默认值[]
filterMethodvar

自定义过滤函数;参数和返回值遵循当前组件的过滤调用。

默认值动态绑定
filterNodeMethodvar

节点过滤函数 (query, node),返回是否保留节点。

默认值null
filterablebool

是否允许输入关键词过滤。

默认值false
heightreal

组件尺寸,单位为像素;可绑定父布局尺寸。

默认值implicitHeight
indentRolestring

数据对象中用于文字、取值、子节点或缩进的字段名。

默认值"level"
labelRolestring

数据对象中用于文字、取值、子节点或缩进的字段名。

默认值"label"
lazybool

按需创建内容或加载数据;数据控件使用 load / lazyLoad。

默认值false
leavesOnlybool

树选择仅允许选中叶子节点。

默认值false
loadvar

懒加载回调,接收节点与 resolve;使用 resolve(children) 提供子节点。

默认值null
loadingbool

是否处于加载状态。

默认值false
loadingTextstring

加载状态提示文字。

默认值随当前语言变化
maxCollapseTagsint

折叠标签时直接显示的最大数量。

默认值1
modelvar

组件的数据源;数组项结构以当前示例及组件说明为准。

默认值动态绑定
multiplebool

是否允许多选。

默认值false
multipleLimitint

多选数量上限。

0:不限制
正数:限制值

默认值0
noDataTextstring

没有数据时的提示文字。

默认值随当前语言变化
noMatchTextstring

过滤后没有匹配项时的提示文字。

默认值随当前语言变化
nodeDelegateComponent

自定义树或级联节点的 Component 插槽;null 使用默认内容。 委托上下文见本页示例。

默认值null
nodeKeystring

唯一标识字段;稳定且唯一的键可保持选择、展开与缓存状态。

默认值"value"
optionDelegateComponent

自定义选项的 Component 插槽;null 使用默认内容。 委托上下文见本页示例。

默认值treeOption
placeholderTextstring

空值时显示的占位文字。

默认值随当前语言变化
popupFooterComponent

自定义侧栏底部或弹层头尾的 Component 插槽。 委托上下文见本页示例。

默认值null
popupHeaderComponent

自定义侧栏底部或弹层头尾的 Component 插槽。 委托上下文见本页示例。

默认值null
querystring

当前过滤或搜索关键词。

默认值""
remotebool

使用远程搜索,跳过本地过滤。

默认值false
remoteMethodvar

远程查询函数,接收关键词并返回选项数组或 Promise。

默认值null
reserveKeywordbool

选择选项后保留输入关键词。

默认值true
showCheckboxbool

为树节点显示勾选框。

默认值false
sizeint

控件尺寸;默认继承最近的 EConfigProvider。

EStyle.Small
EStyle.Medium
EStyle.Large

默认值继承 Provider,默认 EStyle.Medium
tagDelegateComponent

自定义标签项的 Component 插槽;null 使用默认内容。 委托上下文见本页示例。

默认值null
textRolestring

数据对象中用于文字、取值、子节点或缩进的字段名。

默认值"label"
validateEventbool

值变化时是否向所属表单派发校验请求。

默认值true
validationMessagestring

校验结果说明或外部错误文字。

默认值""
validationStateint

输入校验状态。

EValidationState.None
EValidationState.Success
EValidationState.Warning
EValidationState.Error

默认值EValidationState.None
valuevar

当前值;通过属性绑定读写,数组形式用于多选或范围选择。

默认值undefined
valueKeystring

选项取值字段或对象值的唯一标识字段。

默认值"value"
valueOnClearvar

清除后的值,也可传函数返回清除值;默认继承配置。

默认值继承 Provider,默认 undefined
valueRolestring

数据对象中用于文字、取值、子节点或缩进的字段名。

默认值"value"
visiblebool

是否显示组件。

默认值true
widthreal

组件尺寸,单位为像素;可绑定父布局尺寸。

默认值implicitWidth
advancedbool只读

选择器是否因多选、过滤或自定义委托而使用扩展模式。

默认值由运行时计算
cacheOptionsvar只读

树选择中从缓存数据转换出的选项。

默认值由运行时计算
emptybool只读

当前值是否被判定为空。

默认值由运行时计算
groupedbool只读

选择器模型是否包含选项分组。

默认值由运行时计算
hasValidationErrorbool只读

当前校验状态是否为 Error。

默认值由运行时计算
selectedValuesvar只读

选择器多选模式下的已选值数组。

默认值由运行时计算
sourceOptionsvar只读

经过数据规范化处理的建议或选择项列表。

默认值由运行时计算
treeOptionsvar只读

树节点转换后的树选择选项。

默认值由运行时计算
visibleOptionsvar只读

选择器当前过滤后显示的选项。

默认值由运行时计算

信号 ​

签名作用
loadFailed(string message)

加载数据失败时触发,message 为失败原因。

nodeExpanded(var value, bool expanded)

节点展开状态改变时触发,包含节点标识和 expanded 状态。

方法 ​

签名作用
labelFor(key)

获取指定值对应的显示文字。

checkedState(key)

返回指定节点或路径的勾选状态,包括半选状态。

toggleExpanded(key)

切换 key 对应树节点的展开状态。

checkNode(key, checked)

设置 key 对应树节点的勾选状态。

基于 MIT 许可发布 · 第三方资源遵循其各自许可