Tag 标签

介绍

用于标记关键词和概括主要内容。

引入

通过以下方式来全局注册组件,更多注册方式请参考组件注册

  1. import { createApp } from 'vue';
  2. import { Tag } from 'vant';
  3. const app = createApp();
  4. app.use(Tag);

代码演示

基础用法

通过 type 属性控制标签颜色。

  1. <van-tag type="primary">标签</van-tag>
  2. <van-tag type="success">标签</van-tag>
  3. <van-tag type="danger">标签</van-tag>
  4. <van-tag type="warning">标签</van-tag>

空心样式

设置 plain 属性设置为空心样式。

  1. <van-tag plain type="primary">标签</van-tag>

圆角样式

通过 round 设置为圆角样式。

  1. <van-tag round type="primary">标签</van-tag>

标记样式

通过 mark 设置为标记样式(半圆角)。

  1. <van-tag mark type="primary">标签</van-tag>

可关闭标签

添加 closeable 属性表示标签是可关闭的,关闭标签时会触发 close 事件,在 close 事件中可以执行隐藏标签的逻辑。

  1. <van-tag :show="show" closeable size="medium" type="primary" @close="close">
  2. 标签
  3. </van-tag>
  1. import { ref } from 'vue';
  2. export default {
  3. setup() {
  4. const show = ref(true);
  5. const close = () => {
  6. show.value = false;
  7. };
  8. return {
  9. show,
  10. close,
  11. };
  12. },
  13. };

标签大小

通过 size 属性调整标签大小。

  1. <van-tag type="primary">标签</van-tag>
  2. <van-tag type="primary" size="medium">标签</van-tag>
  3. <van-tag type="primary" size="large">标签</van-tag>

自定义颜色

通过 colortext-color 属性设置标签颜色。

  1. <van-tag color="#7232dd">标签</van-tag>
  2. <van-tag color="#ffe1e1" text-color="#ad0000">标签</van-tag>
  3. <van-tag color="#7232dd" plain>标签</van-tag>

API

Props

参数说明类型默认值
type类型,可选值为 primary success danger warningstringdefault
size大小, 可选值为 large mediumstring-
color标签颜色string-
show是否展示标签booleantrue
plain是否为空心样式booleanfalse
round是否为圆角样式booleanfalse
mark是否为标记样式booleanfalse
text-color文本颜色,优先级高于 color 属性stringwhite
closeable是否为可关闭标签booleanfalse

Slots

名称说明
default标签显示内容

Events

事件名说明回调参数
click点击时触发event: MouseEvent
close关闭标签时触发event: MouseEvent

类型定义

组件导出以下类型定义:

  1. import type { TagSize, TagType, TagProps } from 'vant';

主题定制

样式变量

组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 ConfigProvider 组件

名称默认值描述
—van-tag-padding0 var(—van-padding-base)-
—van-tag-text-colorvar(—van-white)-
—van-tag-font-sizevar(—van-font-size-sm)-
—van-tag-border-radius2px-
—van-tag-line-height16px-
—van-tag-medium-padding2px 6px-
—van-tag-large-paddingvar(—van-padding-base) var(—van-padding-xs)-
—van-tag-large-border-radiusvar(—van-border-radius-md)-
—van-tag-large-font-sizevar(—van-font-size-md)-
—van-tag-round-border-radiusvar(—van-border-radius-max)-
—van-tag-danger-colorvar(—van-danger-color)-
—van-tag-primary-colorvar(—van-primary-color)-
—van-tag-success-colorvar(—van-success-color)-
—van-tag-warning-colorvar(—van-warning-color)-
—van-tag-default-colorvar(—van-gray-6)-
—van-tag-plain-background-colorvar(—van-background-color-light)-

Tag 标签 - 图1