Tag 标签

该组件一般用于标记和选择,有如下特点:

  • mode参数可以设置3种模式,dark(深色背景)、light(浅色背景)、plain(白色背景)
  • shape参数可以设置多种形状,circle(两边半圆形), square(方形,带圆角),circleLeft(左边半圆),circleRight(右边半圆)
  • type参数可以设置5种主题,primarysuccesswarningerrorinfo

平台差异说明

AppH5微信小程序支付宝小程序百度小程序头条小程序QQ小程序

基本使用

  • 通过type参数设置主题类型,默认为primary
  • text设置标签内容
  1. <u-tag text="雪月夜" type="success" />

设置标签的类型

  • 通过设置mode参数,可以设置标签的类型,dark(深色背景)、light(浅色背景)、plain(白色背景)
  1. <u-tag text="一丘之貉" mode="dark" />
  2. <u-tag text="沆瀣一气" mode="light" />
  3. <u-tag text="狼狈为奸" mode="plain" />

设置标签的形状

通过shape参数,可以设置标签的形状,默认是square(方形,带圆角),可选:circle(两边半圆形), circleLeft(左边半圆),circleRight(右边半圆)

  1. <u-tag text="主谓宾" shape="circle" />
  2. <u-tag text="定状补" shape="circleLeft" />

设置标签是否可以关闭

设置closeable参数为true,会在标签上自动添加一个关闭图标
设置可关闭后,点击关闭按钮,会发出close事件,回调中手动设置show参数为false,可以隐藏Tag

  1. <template>
  2. <u-tag text="要清楚" closeable :show="show" @close="tagClick" />
  3. </template>
  4. <script>
  5. export default {
  6. data() {
  7. return {
  8. show: true
  9. }
  10. },
  11. methods: {
  12. tagClick(index) {
  13. this.show = false;
  14. }
  15. }
  16. }
  17. </script>

API

Props

参数说明类型默认值可选值
type主题类型Stringprimarysuccess / info / warning / error
size标签大小Stringdefaultmini
shape标签形状Stringsquarecircle / circleLeft / circleRight
text标签的文字内容String--
bg-color自定义标签的背景颜色String--
color文字的颜色String--
border-color标签的边框颜色String--
close-color关闭按钮的颜色String--
index点击标签时,会通过click事件返回该值String | Number--
mode模式选择,见上方说明Stringlightdark / plain
closeable是否可关闭,设置为true,文字右边会出现一个关闭图标Booleanfalsetrue
show标签显示与否Booleantruefalse

Event

事件名说明回调参数版本
click点击标签触发index: 传递的index参数值-
closecloseabletrue时,点击标签关闭按钮触发index: 传递的index参数值-