Tag 标签
介绍
用于标记关键词和概括主要内容。
代码演示
基础用法
通过 type 属性控制标签颜色。
<z-tag type="primary">标签</z-tag>
<z-tag type="success">标签</z-tag>
<z-tag type="danger">标签</z-tag>
<z-tag type="warning">标签</z-tag>
可关闭标签
添加 closeable 属性表示标签是可关闭的,关闭标签时会触发 close 事件,在 close 事件中可以执行隐藏标签的逻辑。
<z-tag :show="show" closeable size="medium" type="primary" @close="close">
标签
</z-tag>
import { ref } from 'vue';
const show = ref(true);
const close = () => {
show.value = false;
};
标签大小
通过 size 属性调整标签大小。
<z-tag type="primary">标签</z-tag>
<z-tag type="primary" size="medium">标签</z-tag>
<z-tag type="primary" size="large">标签</z-tag>
自定义颜色
通过 color 和 text-color 属性设置标签颜色。
<z-tag color="#7232dd">标签</z-tag>
<z-tag color="#ffe1e1" text-color="#ad0000">标签</z-tag>
<z-tag color="#7232dd" plain>标签</z-tag>
API
Props
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| type | 类型,可选值为 primary success danger warning | string | default |
| size | 大小, 可选值为 large medium | string | - |
| color | 标签颜色 | string | - |
| show | 是否展示标签 | boolean | true |
| plain | 是否为空心样式 | boolean | false |
| round | 是否为圆角样式 | boolean | false |
| mark | 是否为标记样式 | boolean | false |
| text-color | 文本颜色,优先级高于 color 属性 | string | white |
| closeable | 是否为可关闭标签 | boolean | false |
Slots
| 名称 | 说明 |
|---|---|
| default | 标签显示内容 |
Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| click | 点击时触发 | event: MouseEvent |
| close | 关闭标签时触发 | event: MouseEvent |
主题定制
样式变量
组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 ConfigProvider 组件。
| 名称 | 默认值 | 描述 |
|---|---|---|
| --z-tag-padding | 0 var(--z-padding-base) | - |
| --z-tag-text-color | var(--z-white) | - |
| --z-tag-font-size | var(--z-font-size-sm) | - |
| --z-tag-radius | 4rpx | - |
| --z-tag-line-height | 32rpx | - |
| --z-tag-medium-padding | 4rpx 12rpx | - |
| --z-tag-large-padding | var(--z-padding-base) var(--z-padding-xs) | - |
| --z-tag-large-radius | var(--z-radius-md) | - |
| --z-tag-large-font-size | var(--z-font-size-md) | - |
| --z-tag-round-radius | var(--z-radius-max) | - |
| --z-tag-danger-color | var(--z-danger-color) | - |
| --z-tag-primary-color | var(--z-primary-color) | - |
| --z-tag-success-color | var(--z-success-color) | - |
| --z-tag-warning-color | var(--z-warning-color) | - |
| --z-tag-default-color | var(--z-gray-6) | - |
| --z-tag-plain-background | var(--z-background-2) | - |
