Tag 标签

用于标记与选择。

基础用法

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

Tag 1Tag 2Tag 3Tag 4Tag 5

图标标签

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

Tag 1 Tag 2 Cancel Success Custom Border

可移除标签

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

Tag 1Tag 2Tag 3Tag 4Tag 5

动态编辑

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

Tag 1Tag 2Tag 3

尺寸

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

使用 size 属性,可选 largedefaultsmall

LargeDefaultSmall

主题

标签提供四种主题:darklightplaindot(圆点 + 文案,无背景描边)。

使用 effect 切换主题,默认为 light

DarkTag 1Tag 2Tag 3Tag 4Tag 5
LightTag 1Tag 2Tag 3Tag 4Tag 5
PlainTag 1Tag 2Tag 3Tag 4Tag 5
DotTag 1Tag 2Tag 3Tag 4Tag 5

圆角

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

Tag 1Tag 2Tag 3Tag 4Tag 5
Tag 1Tag 2Tag 3Tag 4Tag 5
Tag 1Tag 2Tag 3Tag 4Tag 5

可选中标签

某些业务场景需要类似复选框的标签,但按钮式复选框无法满足需求,因此提供 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背景色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自定义默认内容