组件/表单组件

EInputTag 标签输入

import EUI 1.0

示例与代码

标签输入

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Column { width: Math.min(640, parent.width) spacing: 16 EInputTag { max: 5 delimiter: "," clearable: true draggable: true value: ["Qt", "QML", "Desktop"] prefixComponent: Component { EIcon { iconSize: 16 iconSource: EIcons.TAG } } } }

效果

运行代码，体验组件交互

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

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

标签输入

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 EInputTag { max: 5 width: 520 value: exampleData.models.InitialTags }

效果

运行代码，体验组件交互

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

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

属性

属性说明取值与默认值

clearablebool

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

默认值false

closablebool

是否显示关闭或删除按钮。

默认值true

collapseTagsbool

折叠过多的已选标签。

默认值false

delimiterstring

输入标签时分割多个标签的字符。

默认值""

draggablebool

是否支持拖动；具体拖动对象由当前组件决定。

默认值true

enabledbool

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

默认值true

heightreal

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

默认值implicitHeight

maxint

标签数量上限。

0：不限制
正数：限制值

默认值0

maxCollapseTagsint

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

默认值1

placeholderTextstring

空值时显示的占位文字。

默认值""

prefixComponentComponent

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

默认值null

sizeint

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

EStyle.Small
EStyle.Medium
EStyle.Large

默认值继承 Provider，默认 EStyle.Medium

suffixComponentComponent

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

默认值null

tagDelegateComponent

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

默认值null

triggerint

提交新标签的键盘按键。

Qt.Key_*
例如 Qt.Key_Return
Qt.Key_Enter / Qt.Key_Space

默认值Qt.Key_Return

validateEventbool

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

默认值true

validationMessagestring

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

默认值""

validationStateint

输入校验状态。

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

默认值EValidationState.None

valuevar

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

默认值[]

visiblebool

是否显示组件。

默认值true

widthreal

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

默认值implicitWidth

rowHeightint只读

菜单项、数据行或表头行的高度，单位为像素。

默认值由运行时计算

信号

签名作用

cleared()

使用清空操作清除内容后触发。

added(string tag)

添加标签后触发，tag 为新增的标签文字。

removed(string tag)

移除标签后触发，tag 为被移除的标签文字。

reordered(int from, int to)

调整标签顺序后触发，from 和 to 为原索引与目标索引。

方法

签名作用

clear()

清空组件当前内容或选择。

addTag(text)

添加 text 对应的标签；重复值和不符合限制的内容不会加入。

removeTag(index)

移除 index 对应的标签。

moveTag(from, to)

将标签从 from 移动到 to，索引从 0 开始。