ETreeSelect 树形选择
示例与代码
树形选择
树节点选择
属性
allowCreatebool允许把没有匹配结果的输入创建为新选项。
falsecacheDatavar懒加载树节点的缓存数据,用于补全已选值的标签。
[]checkStrictlybool选中状态不随父子节点联动。
falsechildrenRolestring数据对象中用于文字、取值、子节点或缩进的字段名。
"children"clearablebool显示清除操作;评分中允许再次点击当前分数清零。
falsecollapseTagsbool折叠过多的已选标签。
falsecurrentIndexint当前选中或显示项的索引。
-1:未选择
0 起:条目索引
-1datavar树节点数组,角色属性可自定义字段映射。
字段:
label, value, children
disabled
[]debounceint等待、节流或自动关闭时间,单位为毫秒;0 表示不延迟或不启用定时关闭。
300defaultExpandAllbool初始展开所有节点或行。
trueeditablebool允许编辑输入或同时开启标签页新增和关闭操作。
falseemptyValuesvar判定为空值的数组;默认包含 undefined、null 和空字符串。
继承 Provider,默认 [undefined, null, ""]enabledbool是否允许交互;false 时控件禁用。
trueexpandedKeysvar已展开节点、表格行或菜单项的唯一键数组。
[]filterMethodvar自定义过滤函数;参数和返回值遵循当前组件的过滤调用。
动态绑定filterNodeMethodvar节点过滤函数 (query, node),返回是否保留节点。
nullfilterablebool是否允许输入关键词过滤。
falseheightreal组件尺寸,单位为像素;可绑定父布局尺寸。
implicitHeightindentRolestring数据对象中用于文字、取值、子节点或缩进的字段名。
"level"labelRolestring数据对象中用于文字、取值、子节点或缩进的字段名。
"label"lazybool按需创建内容或加载数据;数据控件使用 load / lazyLoad。
falseleavesOnlybool树选择仅允许选中叶子节点。
falseloadvar懒加载回调,接收节点与 resolve;使用 resolve(children) 提供子节点。
nullloadingbool是否处于加载状态。
falseloadingTextstring加载状态提示文字。
随当前语言变化maxCollapseTagsint折叠标签时直接显示的最大数量。
1modelvar组件的数据源;数组项结构以当前示例及组件说明为准。
动态绑定multiplebool是否允许多选。
falsemultipleLimitint多选数量上限。
0:不限制
正数:限制值
0noDataTextstring没有数据时的提示文字。
随当前语言变化noMatchTextstring过滤后没有匹配项时的提示文字。
随当前语言变化nodeDelegateComponent自定义树或级联节点的 Component 插槽;null 使用默认内容。 委托上下文见本页示例。
nullnodeKeystring唯一标识字段;稳定且唯一的键可保持选择、展开与缓存状态。
"value"optionDelegateComponent自定义选项的 Component 插槽;null 使用默认内容。 委托上下文见本页示例。
treeOptionplaceholderTextstring空值时显示的占位文字。
随当前语言变化popupHeaderComponent自定义侧栏底部或弹层头尾的 Component 插槽。 委托上下文见本页示例。
nullquerystring当前过滤或搜索关键词。
""remotebool使用远程搜索,跳过本地过滤。
falseremoteMethodvar远程查询函数,接收关键词并返回选项数组或 Promise。
nullreserveKeywordbool选择选项后保留输入关键词。
trueshowCheckboxbool为树节点显示勾选框。
falsesizeint控件尺寸;默认继承最近的 EConfigProvider。
EStyle.SmallEStyle.MediumEStyle.Large
继承 Provider,默认 EStyle.MediumtagDelegateComponent自定义标签项的 Component 插槽;null 使用默认内容。 委托上下文见本页示例。
nulltextRolestring数据对象中用于文字、取值、子节点或缩进的字段名。
"label"validateEventbool值变化时是否向所属表单派发校验请求。
truevalidationMessagestring校验结果说明或外部错误文字。
""validationStateint输入校验状态。
EValidationState.NoneEValidationState.SuccessEValidationState.WarningEValidationState.Error
EValidationState.Nonevaluevar当前值;通过属性绑定读写,数组形式用于多选或范围选择。
undefinedvalueKeystring选项取值字段或对象值的唯一标识字段。
"value"valueOnClearvar清除后的值,也可传函数返回清除值;默认继承配置。
继承 Provider,默认 undefinedvalueRolestring数据对象中用于文字、取值、子节点或缩进的字段名。
"value"visiblebool是否显示组件。
truewidthreal组件尺寸,单位为像素;可绑定父布局尺寸。
implicitWidthadvancedbool只读选择器是否因多选、过滤或自定义委托而使用扩展模式。
由运行时计算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 对应树节点的勾选状态。