Vant4 Tag 标签

介绍

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

引入

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

import { createApp } from vue;
import { Tag } from vant;

const app = createApp();
app.use(Tag);

代码演示

基础用法

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

<van-tag type="primary">标签</van-tag>
<van-tag type="success">标签</van-tag>
<van-tag type="danger">标签</van-tag>
<van-tag type="warning">标签</van-tag>

空心样式

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

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

圆角样式

通过 ​round​ 设置为圆角样式。

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

标记样式

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

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

可关闭标签

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

<van-tag :show="show" closeable size="medium" type="primary" @close="close">
  标签
</van-tag>

import { ref } from vue;

export default {
  setup() {
    const show = ref(true);
    const close = () => {
      show.value = false;
    };

    return {
      show,
      close,
    };
  },
};

标签大小

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

<van-tag type="primary">标签</van-tag>
<van-tag type="primary" size="medium">标签</van-tag>
<van-tag type="primary" size="large">标签</van-tag>

自定义颜色

通过 ​color​ 和 ​text-color​ 属性设置标签颜色。

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

API

Props

Slots

Events

类型定义

组件导出以下类型定义：

import type { TagSize, TagType, TagProps } from vant;

主题定制

样式变量

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