Input Tag 标签输入框

将输入内容添加为标签。

基础用法

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

自定义触发键

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


最大标签数

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

折叠标签

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

use collapse-tags

use collapse-tags-tooltip

use max-collapse-tags

禁用状态

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

tag1tag2tag3

可清空

控制是否显示清空按钮。

tag1tag2tag3

自定义清空图标

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

customclearicon

可拖拽

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

tag1tag2tag3

分隔符

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

尺寸

使用 size 调整尺寸;除默认外可选 largesmall



自定义标签

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


tag1
tag2
tag3

自定义前缀与后缀

通过 prefixsuffix 插槽自定义前后内容。

标签输入框 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-tagstruebooleanfalse
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-tagstruenumber1
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