InputTag 标签输入框

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

基础用法

按 Enter 回车键添加输入内容为标签

自定义触发器

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


最大标签数

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

禁用状态

您可以设置 InputTag 被禁用。

tag1tag2tag3

可清空

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

tag1tag2tag3

可拖放

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

tag1tag2tag3

尺寸

使用 size 属性改变输入框大小。 除了默认大小外,还有另外两个选项: large, small, mini




自定义标签

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


tag1
tag2
tag3

自定义前缀和后缀

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

API

属性

名称详情类型默认
model-value / v-model绑定值array
max可添加标签的最大数量number
tag-type标签类型enumprimary
tag-effect标签效果enumlight
trigger触发输入标签的按键enumEnter
draggable是否可以拖动标签booleanfalse
size输入框尺寸enumdefault
clearable是否显示清除按钮booleanfalse
disabled是否禁用booleanfalse
validate-event是否触发表单验证booleantrue
readonly等价于原生 readonly 属性booleanfalse
autofocus等价于原生 autofocus 属性booleanfalse
id等价于原生 input id 属性string
tabindex等价于原生 tabindex 属性string / number
maxlength等价于原生 maxlength 属性string / number
minlength等价于原生 minlength 属性string / number
placeholder输入框占位文本string
autocomplete等价于原生 autocomplete 属性stringoff
aria-label a11y等价于原生 aria-label 属性string

事件

名称详情类型
change绑定值变化时触发的事件Function
input在 Input 值改变时触发Function
add-tagtag 被添加时触发Function
remove-tagtag 被移除时触发Function
focus在 Input 获得焦点时触发Function
blur在 Input 失去焦点时触发Function
clear点击清除图标时触发Function

Slots

名称详情类型
tag作为 tag 的内容object
prefixInputTag 头部内容
suffixInputTag 尾部内容

对外暴露的方法

名称详情类型
focus使 input 获取焦点Function
blur使 input 失去焦点Function

Copyright 2025 Winning Health 版权所有