Skip to content

InputTag 标签输入框 ​

允许用户通过输入并回车快速添加标签,常用于关键词、邀请人等场景。

ts
import { createApp } from 'vue'
import { ElInputTag } from '@szhn/dh-design-pc'

const app = createApp()
app.use(ElInputTag)

基础用法 ​

输入内容后按回车即可添加为标签。

自定义触发器 ​

通过 trigger 自定义添加标签的按键,默认值为 Enter,也支持 Space。

最大标签数 ​

通过 max 限制可添加的标签数量,达到上限后将无法继续输入。

折叠标签 ​

通过 collapse-tags 将多余标签合并为一个占位,配合 collapse-tags-tooltip 可在悬停时展开。

尺寸 ​

通过 size 属性切换 large / default / small 三种尺寸。

可清空与禁用 ​

通过 clearable 显示清空按钮,通过 disabled 禁用整个组件。

API ​

Attributes ​

属性说明类型默认值
model-value / v-model标签数组string[]—
max最大标签数number—
trigger触发添加的按键Enter / SpaceEnter
size尺寸large / default / small—
tag-type标签类型enuminfo
tag-effect标签效果light / dark / plainlight
draggable标签是否可拖拽booleanfalse
clearable是否可清空booleanfalse
disabled是否禁用booleanfalse
collapse-tags是否折叠标签booleanfalse
max-collapse-tags折叠时展示的标签数number1
delimiter分隔符触发添加string / RegExp—

Events ​

事件说明
change值变化
add-tag / remove-tag添加 / 移除标签
clear点击清除按钮
focus / blur获焦 / 失焦

更多 API 请参考 Element Plus InputTag 文档。