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 | 标签类型 | enum | primary |
| tag-effect | 标签效果 | enum | light |
| effect 1.3.4 | tooltip 主题,内置主题:dark / light | enum / string | light |
| trigger | 触发输入标签的按键 | enum | Enter |
| type 1.3.4 | 输入框类型,number 时按数字规则过滤与转换 | enum | text |
| precision 1.3.4 | number 类型下的小数精度,不设置则不支持小数点 | number | — |
| before-create-tag 1.3.4 | 新增标签前的拦截钩子,返回假值时阻止新增且输入框内容保留 | Function | — |
| draggable | 是否可以拖动标签 | boolean | false |
| delimiter 1.3.4 | 匹配到分隔符时添加标签 | string / regexp | — |
| size | 输入框尺寸 | enum | default |
| collapse-tags 1.3.4 | 是否将标签折叠为一段文本 | boolean | false |
| collapse-tags-tooltip 1.3.4 | 鼠标悬停折叠文本时显示所有标签,需开启 collapse-tags | boolean | true |
| max-collapse-tags 1.3.4 | 折叠时显示的最大标签数,需开启 collapse-tags | number | 1 |
| save-on-blur 1.3.4 | 输入框失去焦点时保存输入值 | boolean | true |
| clearable | 是否显示清除按钮 | boolean | false |
| clear-icon 1.3.4 | 自定义清除图标组件 | string / object | CircleCloseFilled |
| disabled | 是否禁用 | boolean | false |
| validate-event | 是否触发表单验证 | boolean | true |
| readonly | 等价于原生 readonly 属性 | boolean | false |
| autofocus | 等价于原生 autofocus 属性 | boolean | false |
| id | 等价于原生 input id 属性 | string | — |
| tabindex | 等价于原生 tabindex 属性 | string / number | — |
| maxlength | 等价于原生 maxlength 属性 | string / number | — |
| minlength | 等价于原生 minlength 属性 | string / number | — |
| placeholder | 输入框占位文本 | string | — |
| autocomplete | 等价于原生 autocomplete 属性 | string | off |
| aria-label a11y | 等价于原生 aria-label 属性 | string | — |
事件
| 名称 | 详情 | 类型 |
|---|---|---|
| change | 绑定值变化时触发的事件 | Function |
| input | 在 Input 值改变时触发 | Function |
| add-tag | tag 被添加时触发 | Function |
| remove-tag | tag 被移除时触发 | Function |
| drag-tag 1.3.4 | tag 拖拽排序后触发 | Function |
| focus | 在 Input 获得焦点时触发 | Function |
| blur | 在 Input 失去焦点时触发 | Function |
| clear | 点击清除图标时触发 | Function |
Slots
| 名称 | 详情 | 类型 |
|---|---|---|
| tag | 作为 tag 的内容 | object |
| prefix | InputTag 头部内容 | — |
| suffix | InputTag 尾部内容 | — |
对外暴露的方法
| 名称 | 详情 | 类型 |
|---|---|---|
| focus | 使 input 获取焦点 | Function |
| blur | 使 input 失去焦点 | Function |
Copyright 2025 Winning Health 版权所有

