Tag 标签
用于标记和选择。
基础用法
由 type
属性来选择 tag 的类型。 也可以通过 color
属性来自定义背景色。
可移除标签
设置 closable
属性可以定义一个标签是否可移除。 它接受一个 Boolean
。 默认的标签移除时会附带渐变动画。 如果不想使用,可以设置 disable-transitions
属性,它接受一个 Boolean
,true
为关闭。 当 Tag 被移除时会触发 close
事件。
动态编辑标签
动态编辑标签可以通过点击标签关闭按钮后触发的 close
事件来实现。
不同尺寸
Tag 组件提供除了默认值以外的三种尺寸,可以在不同场景下选择合适的按钮尺寸。
使用 size
属性来设置额外尺寸, 可选值包括 large
, default
或 small
.
主题
Tag 组件提供了三个不同的主题:dark
、light
和 plain
。
通过设置 effect
属性来改变主题,默认为 light
。
圆形标签
Tag 可以向按钮组件一样变为完全圆形。
可选中的标签
有时候因为业务需求,我们可能会需要用到类似复选框的标签,但是按钮式的复选框的样式又不满足需求,此时我们就可以用到 check-tag
组件。 您可以在2.5.4中使用 type
属性。
check-tag 的基础使用方法,check-tag 提供的 API 非常简单。
Tag API
Tag Attributes
属性名 | 说明 | 类型 | 默认 |
---|---|---|---|
type | Tag 的类型 | enum | primary |
closable | 是否可关闭 | boolean | false |
disable-transitions | 是否禁用渐变动画 | boolean | false |
hit | 是否有边框描边 | boolean | false |
color | 背景色 | string | — |
size | Tag 的尺寸 | enum | — |
effect | Tag 的主题 | enum | light |
round | Tag 是否为圆形 | boolean | false |
Tag Events
事件名 | 说明 | Type |
---|---|---|
click | 点击 Tag 时触发的事件 | Function |
close | 关闭 Tag 时触发的事件 | Function |
Tag Slots
名称 | 说明 |
---|---|
default | 自定义默认内容 |
CheckTag API
CheckTag Attributes
属性名 | 说明 | 类型 | 默认 |
---|---|---|---|
checked / v-model:checked | 是否选中 | boolean | false |
disabled 2.8.2 | 是否禁用 | boolean | false |
type 2.5.4 | CheckTag 类型 | enum | primary |
CheckTag Events
事件名 | 说明 | 类型 |
---|---|---|
change | 点击 Check Tag 时触发的事件 | Function |
CheckTag Slots
名称 | 说明 |
---|---|
default | 自定义默认内容 |