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 | 标签类型 | enum | info |
| tag-effect | 标签效果 | enum | light |
| effect | 文字提示主题,内置 dark / light | enum / string | light |
| trigger | 触发添加标签的按键 | enum | Enter |
| draggable | 标签是否可拖拽 | boolean | false |
| delimiter | 匹配到分隔符时添加标签 | string / regex | — |
| size | 输入框尺寸 | enum | — |
| collapse-tags | 多选时是否折叠为文本展示 | boolean | false |
| collapse-tags-tooltip | 折叠时悬停是否展示全部标签(需 collapse-tags 为 true) | boolean | false |
| save-on-blur | 失焦时是否保存当前输入为标签 | boolean | true |
| clearable | 是否显示清空按钮 | boolean | false |
| clear-icon | 自定义清空图标组件 | string / object | CircleClose |
| disabled | 是否禁用 | boolean | false |
| validate-event | 是否触发表单校验 | boolean | true |
| readonly | 同原生 readonly | boolean | false |
| autofocus | 同原生 autofocus | boolean | false |
| id | 同原生 id | string | — |
| tabindex | 同原生 tabindex | string / number | — |
| max-collapse-tags | 折叠时最多展示标签数(需 collapse-tags 为 true) | number | 1 |
| maxlength | 同原生 maxlength | string / number | — |
| minlength | 同原生 minlength | string / number | — |
| placeholder | 占位文本 | string | — |
| autocomplete | 同原生 autocomplete | string | off |
| aria-label a11y | 原生 aria-label | string | — |
标签输入框 事件
| 名称 | 说明 | 类型 |
|---|---|---|
| change | modelValue 变化时 | 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 |