Tag 标签

用于标记与选择。

基础用法

使用 type 属性定义标签类型。此外,可使用 color 属性设置标签背景色。

图标标签

使用 icon-tag 开启图标标签样式。可通过 icon 属性一行配置图标,也可通过 icon 插槽自定义图标;当两者同时存在时,插槽优先。图标标签边框色默认 #C9CDD3,可通过 bordered 设为 false 去掉边框,或通过 border-color 自定义边框色。

可移除标签

使用 closable 定义可移除标签,接受 Boolean。默认移除时有淡出动画;若不需要,可将 disable-transitions 设为 true(同样为 Boolean)。移除标签时触发 close 事件。

动态编辑

可通过 close 事件动态新增或移除标签。

尺寸

除默认尺寸外,还提供三种尺寸,适用于不同场景。

使用 size 属性,可选 largedefaultsmall

主题

标签提供五种主题:darklightplaindot(圆点 + 文案,无背景描边)与 soft(浅底圆点胶囊,适用于状态标记)。

使用 effect 切换主题,默认为 lightsoft 主题会展示与类型色对应的浅色背景、前置状态圆点,以及常规正文色文案。

Dark
Light
Plain
Dot
Soft

浅底圆点

soft 主题适合展示业务状态,如告警等级、提示信息等。

通过 type 控制背景与圆点颜色;color 可自定义圆点颜色。支持 closable、不同 size 等常规能力。

圆角

标签也可像按钮一样设为圆角。

可选中标签

某些业务场景需要类似复选框的标签,但按钮式复选框无法满足需求,因此提供 check-tag,可使用 type 属性。

基础的 check-tag 用法,API 较为简单。

CheckedToggle meDisabled
Tag 1 Tag 2 Tag 3 Tag 4 Tag 5 Tag 6

标签 API

标签 属性

名称说明类型默认值
type标签类型enumprimary
closable是否可关闭booleanfalse
disable-transitions是否禁用动画booleanfalse
hit是否有高亮描边booleanfalse
color背景色;dot / soft 主题下为圆点颜色string
size尺寸enum
effect主题enumlight
round是否为圆角booleanfalse
icon-tag是否启用图标标签样式booleanfalse
icon图标组件string / Component
bordered图标标签是否显示边框booleantrue
border-color图标标签边框颜色string

标签 事件

名称说明类型
click点击标签时触发Function
close关闭标签时触发Function

标签 插槽

名称说明
default自定义默认内容
icon自定义图标内容

可选中标签 API

可选中标签 属性

名称说明类型默认值
checked / v-model:checked是否选中booleanfalse
disabled是否禁用booleanfalse
typeCheckTag 类型enumprimary

可选中标签 事件

名称说明类型
change点击可选中标签时触发Function

可选中标签 插槽

名称说明
default自定义默认内容