InputTag 标签输入框
InputTag 组件允许用户添加内容作为标签
基础用法
按Enter回车键添加输入内容为标签
自定义触发器
您可以自定义用于触发输入标签的键位, 默认是Enter 回车键
最大标签数
您可以设置可以添加的标签数量限制。
禁用状态
您可以设置 InputTag 被禁用。
可清空
您可以设置是否显示清除按钮。
可拖放
您可以设置是否可以拖动标签。
尺寸
使用 size
属性改变输入框大小。 除了默认大小外,还有另外两个选项: large
, small
。
自定义标签
您可以通过tag
插槽自定义标签内容。
自定义前缀和后缀
您可以通过prefix
和 suffix
插槽自定义 InputTag 的前缀和后缀。
API
属性
名称 | 详情 | 类型 | 默认 |
---|---|---|---|
model-value / v-model | 绑定值 | array | — |
max | 可添加标签的最大数量 | number | — |
tag-type | 标签类型 | enum | info |
tag-effect | 标签效果 | enum | light |
trigger | 触发输入标签的按键 | enum | Enter |
draggable | 是否可以拖动标签 | boolean | false |
size | 输入框尺寸 | enum | — |
clearable | 是否显示清除按钮 | boolean | false |
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 |
focus | 在 Input 获得焦点时触发 | Function |
blur | 在 Input 失去焦点时触发 | Function |
clear | 点击清除图标时触发 | Function |
Slots
名称 | 详情 | 类型 |
---|---|---|
tag | 作为tag的内容 | object |
prefix | InputTag 头部内容 | — |
suffix | InputTag 尾部内容 | — |
对外暴露的方法
名称 | 详情 | 类型 |
---|---|---|
focus | 使 input 获取焦点 | Function |
blur | 使 input 失去焦点 | Function |