Tag 标签

概述

对不同维度进行简单的标记和分类。

代码示例

Tag 标签 - 图1

基本用法

简单的展示,添加属性closable可以关闭标签。

点击关闭标签时,会触发 on-close 事件,需自己实现关闭逻辑。

  1. <template>
  2. <Tag>标签一</Tag>
  3. <Tag>标签二</Tag>
  4. <Tag v-if="show" closable @on-close="handleClose">标签三</Tag>
  5. </template>
  6. <script>
  7. export default {
  8. data () {
  9. return {
  10. show: true
  11. }
  12. },
  13. methods: {
  14. handleClose () {
  15. this.show = false;
  16. }
  17. }
  18. }
  19. </script>

Tag 标签 - 图2

样式类型

通过设置 type 属性为 borderdot 来选择不同的样式类型。建议有关闭的某些场景下使用 border,图例的场景下使用 dot。

  1. <template>
  2. <Tag type="border">标签三</Tag>
  3. <Tag type="border" closable>标签四</Tag>
  4. <Tag type="dot">标签一</Tag>
  5. <Tag type="dot" closable>标签二</Tag>
  6. </template>
  7. <script>
  8. export default {
  9. }
  10. </script>

Tag 标签 - 图3

各种颜色

多种预设颜色,可自定义颜色。

  1. <template>
  2. <Tag color="default">default</Tag>
  3. <Tag color="primary">primary</Tag>
  4. <Tag color="success">success</Tag>
  5. <Tag color="error">error</Tag>
  6. <Tag color="warning">warning</Tag>
  7. <Tag color="magenta">magenta</Tag>
  8. <Tag color="red">red</Tag>
  9. <Tag color="volcano">volcano</Tag>
  10. <Tag color="orange">orange</Tag>
  11. <Tag color="gold">gold</Tag>
  12. <Tag color="yellow">yellow</Tag>
  13. <Tag color="lime">lime</Tag>
  14. <Tag color="green">green</Tag>
  15. <Tag color="cyan">cyan</Tag>
  16. <Tag color="blue">blue</Tag>
  17. <Tag color="geekblue">geekblue</Tag>
  18. <Tag color="purple">purple</Tag>
  19. <Tag color="#FFA2D3">Custom Color</Tag>
  20. <br><br>
  21. <Tag type="border" closable color="primary">标签一</Tag>
  22. <Tag type="border" closable color="success">标签二</Tag>
  23. <Tag type="border" closable color="error">标签三</Tag>
  24. <Tag type="border" closable color="warning">标签四</Tag>
  25. <br><br>
  26. <Tag type="dot" closable color="primary">标签一</Tag>
  27. <Tag type="dot" closable color="success">标签二</Tag>
  28. <Tag type="dot" closable color="error">标签三</Tag>
  29. <Tag type="dot" closable color="warning">标签四</Tag>
  30. </template>
  31. <script>
  32. export default {
  33. }
  34. </script>

Tag 标签 - 图4

可选择

设置属性 checkable,可以对标签进行选择,属性 checked 控制当前选择状态。

  1. <template>
  2. <Tag checkable color="primary">标签一</Tag>
  3. <Tag checkable color="success">标签二</Tag>
  4. <Tag checkable color="error">标签三</Tag>
  5. <Tag checkable color="warning">标签四</Tag>
  6. </template>
  7. <script>
  8. export default {
  9. }
  10. </script>

Tag 标签 - 图5

动态添加和删除

用数组生成一组标签,可以动态添加和删除。

  1. <template>
  2. <Tag v-for="item in count" :key="item" :name="item" closable @on-close="handleClose2">标签{{ item + 1 }}</Tag>
  3. <Button icon="ios-add" type="dashed" size="small" @click="handleAdd">添加标签</Button>
  4. </template>
  5. <script>
  6. export default {
  7. data () {
  8. return {
  9. count: [0, 1, 2]
  10. }
  11. },
  12. methods: {
  13. handleAdd () {
  14. if (this.count.length) {
  15. this.count.push(this.count[this.count.length - 1] + 1);
  16. } else {
  17. this.count.push(0);
  18. }
  19. },
  20. handleClose2 (event, name) {
  21. const index = this.count.indexOf(name);
  22. this.count.splice(index, 1);
  23. }
  24. }
  25. }
  26. </script>

Tag 标签 - 图6

尺寸

4.0.0 设置属性 size 可以显示不同尺寸的标签。

  1. <template>
  2. <Tag>Default Tag</Tag>
  3. <Tag size="medium">Medium Tag</Tag>
  4. <Tag size="large">Large Tag</Tag>
  5. </template>
  6. <script>
  7. export default {
  8. }
  9. </script>

API

Tag props

属性 说明 类型 默认值
closable 标签是否可以关闭 Boolean false
checkable 标签是否可以选择 Boolean false
checked 标签的选中状态 Boolean true
type 标签的样式类型,可选值为 borderdot或不填 String -
color 标签颜色,预设颜色值为defaultprimarysuccesswarningerrorbluegreenredyellowpinkmagentavolcanoorangegoldlimecyangeekbluepurple,你也可以自定义颜色值。 String default
name 当前标签的名称,使用 v-for,并支持关闭时,会比较有用 String | Number -
fade 是否在出现和消失时使用渐变的动画,动画时长可能会引起占位的闪烁 Boolean true
size 4.0.0 尺寸,可选值为 large、medium、default String default

Tag events

事件名 说明 返回值
on-close 关闭时触发 event, name
on-change 切换选中状态时触发 checked, name