Input Tag 标签输入框 ​

将输入内容添加为标签。

基础用法 ​

按下回车将当前输入添加为标签。

自定义触发键 ​

可自定义用于确认添加标签的按键,默认为回车。


最大标签数 ​

可限制可添加的标签数量。

折叠标签 ​

使用折叠标签可将多个标签合并展示;可配合 collapse-tags-tooltip 在悬停时展示全部。启用 collapse-tags-tooltip 时 max 行为会受影响。

use collapse-tags

use collapse-tags-tooltip

use max-collapse-tags

禁用状态 ​

可将标签输入框设为禁用。

tag1tag2tag3

可清空 ​

控制是否显示清空按钮。

tag1tag2tag3

自定义清空图标 ​

通过 clear-icon 自定义清空图标。

customclearicon

可拖拽 ​

控制标签是否可拖拽排序。

tag1tag2tag3

分隔符 ​

输入匹配到分隔符时可自动添加标签。

尺寸 ​

使用 size 调整尺寸;除默认外可选 large、small。



自定义标签 ​

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


tag1
tag2
tag3

自定义前缀与后缀 ​

通过 prefix、suffix 插槽自定义前后内容。

标签输入框 API ​

标签输入框 属性 ​

名称说明类型默认值
model-value / v-model绑定值array—
max最大标签数量number—
tag-type标签类型enuminfo
tag-effect标签效果enumlight
effect文字提示主题,内置 dark / lightenum / stringlight
trigger触发添加标签的按键enumEnter
draggable标签是否可拖拽booleanfalse
delimiter匹配到分隔符时添加标签string / regex—
size输入框尺寸enum—
collapse-tags多选时是否折叠为文本展示booleanfalse
collapse-tags-tooltip折叠时悬停是否展示全部标签(需 collapse-tags 为 true)booleanfalse
save-on-blur失焦时是否保存当前输入为标签booleantrue
clearable是否显示清空按钮booleanfalse
clear-icon自定义清空图标组件string / objectCircleClose
disabled是否禁用booleanfalse
validate-event是否触发表单校验booleantrue
readonly同原生 readonlybooleanfalse
autofocus同原生 autofocusbooleanfalse
id同原生 idstring—
tabindex同原生 tabindexstring / number—
max-collapse-tags折叠时最多展示标签数(需 collapse-tags 为 true)number1
maxlength同原生 maxlengthstring / number—
minlength同原生 minlengthstring / number—
placeholder占位文本string—
autocomplete同原生 autocompletestringoff
aria-label a11y原生 aria-labelstring—

标签输入框 事件 ​

名称说明类型
changemodelValue 变化时Function
input输入框文本变化时Function
add-tag添加标签时Function
remove-tag移除标签时Function
drag-tag拖拽排序标签时Function
focus聚焦时Function
blur失焦时Function
clear点击清空图标时Function

标签输入框 插槽 ​

名称说明类型
tag自定义标签内容object
prefix前缀内容—
suffix后缀内容—

标签输入框 暴露 ​

名称说明类型
focus聚焦输入框Function
blur使输入框失焦Function