输入标签

InputTag 组件允许用户将内容添加为标签。

基本用法

按 Enter 键将输入添加为标签。

自定义触发器

您可以自定义用于触发输入标签的键。默认键是 Enter。


最大标签数

您可以设置可添加标签的数量限制。

折叠标签 2.11.0

使用折叠标签属性将它们合并成一段文本。您可以使用折叠标签工具提示属性来启用将鼠标悬停在折叠文本上的行为以显示特定的选定值。使用折叠标签工具提示属性将使 max 属性无效。

use collapse-tags

use collapse-tags-tooltip

use max-collapse-tags

禁用

您可以将InputTag 设置为禁用。

tag1tag2tag3

可清除

您可以设置是否显示清除按钮。

tag1tag2tag3

自定义清除图标 2.11.0

您可以通过设置 clear-icon 属性来自定义透明图标。

customclearicon

可拖动

您可以设置标签是否可以拖动。

tag1tag2tag3

分隔符 2.9.9

当分隔符匹配时,您可以添加标签。

尺寸

添加size属性以更改InputTag的大小。除了默认尺寸外,还有另外两个选项:largesmall



自定义标签

您可以通过tag插槽自定义标签内容。


tag1
tag2
tag3

自定义前缀和后缀

您可以通过prefixsuffix插槽自定义InputTag的前缀和后缀。

API

属性

名称描述类型默认
模型值 / v 模型绑定值数组
最大可以输入的最大标签数数字
标签类型标签类型枚举信息
标签效果标签效果枚举
效果 2.13.2工具提示主题,内置主题:dark / light枚举 / 字符串
触发触发输入标签的按键枚举输入
可拖动标签是否可以拖动布尔值
分隔符 2.9.9当分隔符匹配时添加标签字符串 / 正则表达式
尺寸输入框尺寸枚举
折叠标签 2.11.0多重选择时是否将标签折叠为文本布尔值
折叠标签工具提示 2.11.0当鼠标悬停在折叠标签的文本上时是否显示所有选定的标签。要使用此功能,collapse-tags 必须为 true布尔值
保存模糊 2.9.7输入失去焦点时是否保存输入值布尔值真实
可清除是否显示清除按钮布尔值
清除图标 2.11.0自定义透明图标组件字符串 / 对象圆圈关闭
已禁用是否禁用输入标签布尔值
验证事件是否触发表单验证布尔值真实
只读与本机输入中的 readonly 相同布尔值
自动对焦与本机输入中的 autofocus 相同布尔值
编号与本机输入中的 id 相同字符串
标签索引与本机输入中的 tabindex 相同字符串 / 数字
最大折叠标签 2.11.0要显示的最大标签数。要使用此功能,collapse-tags 必须为 true数字1
最大长度与本机输入中的 maxlength 相同字符串 / 数字
最小长度与本机输入中的 minlength 相同字符串 / 数字
占位符输入的占位符字符串
自动完成与本机输入中的 autocomplete 相同字符串关闭
咏叹调标签 a11y原生 aria-label 属性字符串

活动

名称描述类型
改变当 modelValue 改变时触发功能
输入当输入值改变时触发功能
添加标签添加标签时触发功能
删除标签删除标签时触发功能
拖动标签 2.11.3拖动标签时触发功能
焦点当InputTag焦点时触发功能
模糊当InputTag模糊时触发功能
清除单击清除图标时触发功能

老虎机

名称描述类型
标签内容作为标签对象
前缀内容作为 InputTag 前缀
后缀内容作为InputTag后缀

暴露

名称描述类型
焦点聚焦输入元素功能
模糊模糊输入元素功能