Tag 标签
用于标记与选择。
基础用法
使用 type 属性定义标签类型。此外,可使用 color 属性设置标签背景色。
Tag 1Tag 2Tag 3Tag 4Tag 5
图标标签
使用 icon-tag 开启图标标签样式。可通过 icon 属性一行配置图标,也可通过 icon 插槽自定义图标;当两者同时存在时,插槽优先。图标标签边框色默认 #C9CDD3,可通过 bordered 设为 false 去掉边框,或通过 border-color 自定义边框色。
可移除标签
使用 closable 定义可移除标签,接受 Boolean。默认移除时有淡出动画;若不需要,可将 disable-transitions 设为 true(同样为 Boolean)。移除标签时触发 close 事件。
Tag 1Tag 2Tag 3Tag 4Tag 5
动态编辑
可通过 close 事件动态新增或移除标签。
Tag 1Tag 2Tag 3
尺寸
除默认尺寸外,还提供三种尺寸,适用于不同场景。
使用 size 属性,可选 large、default 或 small。
LargeDefaultSmall
主题
标签提供四种主题:dark、light、plain 与 dot(圆点 + 文案,无背景描边)。
使用 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 | 标签类型 | enum | primary |
| closable | 是否可关闭 | boolean | false |
| disable-transitions | 是否禁用动画 | boolean | false |
| hit | 是否有高亮描边 | boolean | false |
| color | 背景色 | string | — |
| size | 尺寸 | enum | — |
| effect | 主题 | enum | light |
| round | 是否为圆角 | boolean | false |
| icon-tag | 是否启用图标标签样式 | boolean | false |
| icon | 图标组件 | string / Component | — |
| bordered | 图标标签是否显示边框 | boolean | true |
| border-color | 图标标签边框颜色 | string | — |
标签 事件
| 名称 | 说明 | 类型 |
|---|---|---|
| click | 点击标签时触发 | Function |
| close | 关闭标签时触发 | Function |
标签 插槽
| 名称 | 说明 |
|---|---|
| default | 自定义默认内容 |
| icon | 自定义图标内容 |
可选中标签 API
可选中标签 属性
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| checked / v-model:checked | 是否选中 | boolean | false |
| disabled | 是否禁用 | boolean | false |
| type | CheckTag 类型 | enum | primary |
可选中标签 事件
| 名称 | 说明 | 类型 |
|---|---|---|
| change | 点击可选中标签时触发 | Function |
可选中标签 插槽
| 名称 | 说明 |
|---|---|
| default | 自定义默认内容 |