当前位置: 首页 > 文档资料 > uView 开发文档 >

Tag 标签

优质
小牛编辑
123浏览
2023-12-01

Tag 标签 平台差异说明
AppH5微信小程序支付宝小程序百度小程序头条小程序QQ小程序

基本使用

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

设置标签的类型

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

设置标签的形状

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

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

设置标签是否可以关闭

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

<template>
	<u-tag text="要清楚" closeable :show="show" @close="tagClick" />
</template>

<script>
	export default {
		data() {
			return {
				show: true
			}
		},
		methods: {
			tagClick(index) {
				this.show = false;
			}
		}
	}
</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参数值-