InputTag 标签输入框 ​

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

基础用法 ​

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

青霉素
花粉
尘螨
青霉素
花粉
尘螨

最大标签数 ​

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

折叠标签 1.3.4 ​

您可以设置 collapse-tags 属性将标签折叠为一段文本,配合 collapse-tags-tooltip 属性开启鼠标悬停折叠文本时显示所有标签的行为,并通过 max-collapse-tags 属性设置折叠时显示的最大标签数。

默认折叠并在悬停时显示全部标签

高血压
+ 4

仅折叠

高血压
+ 4

自定义折叠时显示的标签数

高血压糖尿病冠心病
+ 2

数字标签 1.3.4 ​

设置 type 为 number 开启数字标签输入,仅支持数字(不支持负号)。配合 precision 可以保留指定小数位数,输入超出部分直接截断,提交时按 precision 四舍五入。

23
0.651.25

创建拦截 1.3.4 ​

通过 before-create-tag 可以在新标签创建前进行拦截,返回假值(或 Promise 解析为假值)时阻止新增,且输入框内容保留。

可清空 ​

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

发热咳嗽乏力

自定义触发器 ​

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


自定义清除图标 1.3.4 ​

您可以通过 clear-icon 属性自定义清除图标组件。

青霉素头孢克洛布洛芬

可拖放 ​

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

血常规尿常规心电图

分隔符 1.3.4 ​

您可以设置 delimiter 属性,在输入内容匹配到分隔符时自动添加标签,粘贴带分隔符的文本时同样生效。

心内科神经内科内分泌科

自定义前缀和后缀 ​

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

API ​

属性 ​

名称详情类型默认
model-value / v-model绑定值array—
max可添加标签的最大数量number—
tag-type标签类型enumprimary
tag-effect标签效果enumlight
effect 1.3.4tooltip 主题,内置主题:dark / lightenum / stringlight
trigger触发输入标签的按键enumEnter
type 1.3.4输入框类型,number 时按数字规则过滤与转换enumtext
precision 1.3.4number 类型下的小数精度,不设置则不支持小数点number—
before-create-tag 1.3.4新增标签前的拦截钩子,返回假值时阻止新增且输入框内容保留Function—
draggable是否可以拖动标签booleanfalse
delimiter 1.3.4匹配到分隔符时添加标签string / regexp—
size输入框尺寸enumdefault
collapse-tags 1.3.4是否将标签折叠为一段文本booleanfalse
collapse-tags-tooltip 1.3.4鼠标悬停折叠文本时显示所有标签,需开启 collapse-tagsbooleantrue
max-collapse-tags 1.3.4折叠时显示的最大标签数,需开启 collapse-tagsnumber1
save-on-blur 1.3.4输入框失去焦点时保存输入值booleantrue
clearable是否显示清除按钮booleanfalse
clear-icon 1.3.4自定义清除图标组件string / objectCircleCloseFilled
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
drag-tag 1.3.4tag 拖拽排序后触发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 版权所有