# Tag 标签

用于标记和选择。

# 基础用法

标签一 标签二 标签三 标签四 标签五

class属性来选择tag的类型,也可以通过color属性来自定义背景色。

<j-tag>标签一</j-tag>
<j-tag class="success">标签二</j-tag>
<j-tag class="info">标签三</j-tag>
<j-tag class="warning">标签四</j-tag>
<j-tag class="danger">标签五</j-tag>
显示代码 复制代码

# 可移除标签

标签一 标签二 标签三 标签四 标签五

设置closable属性可以定义一个标签是否可移除。默认的标签移除时会附带渐变动画,如果不想使用,可以设置disable-transitions属性,它接受一个Boolean,true 为关闭。

<j-tag
  v-for="tag in tags"
  :key="tag.name"
  closable
  :class="tag.class">
  {{tag.name}}
</j-tag>

<script>
  export default {
    data() {
      return {
        tags: [
          { name: '标签一', class: '' },
          { name: '标签二', class: 'success' },
          { name: '标签三', class: 'info' },
          { name: '标签四', class: 'warning' },
          { name: '标签五', class: 'danger' }
        ]
      };
    }
  }
</script>
显示代码 复制代码

# 动态编辑标签

动态编辑标签可以通过点击标签关闭按钮后触发的 close 事件来实现

标签一 标签二 标签三
<j-tag
  :key="tag"
  v-for="tag in dynamicTags"
  closable
  :disable-transitions="false"
  @close="handleClose(tag)">
  {{tag}}
</j-tag>
<j-input
  class="input-new-tag"
  v-if="inputVisible"
  v-model="inputValue"
  ref="saveTagInput"
  size="small"
  @keyup.enter.native="handleInputConfirm"
  @blur="handleInputConfirm"
>
</j-input>
<j-button v-else class="button-new-tag small" @click="showInput">+ New Tag</j-button>

<style>
  .j-tag + .j-tag {
    margin-left: 10px;
  }
  .button-new-tag.j-btn.small {
    margin-left: 10px;
    height: 24px;
    padding: 0 8px;
    line-height: 22px;
  }
  .input-new-tag {
    width: 90px;
    margin-left: 10px;
    vertical-align: bottom;
  }
</style>

<script>
  export default {
    data() {
      return {
        dynamicTags: ['标签一', '标签二', '标签三'],
        inputVisible: false,
        inputValue: ''
      };
    },
    methods: {
      handleClose(tag) {
        this.dynamicTags.splice(this.dynamicTags.indexOf(tag), 1);
      },

      showInput() {
        this.inputVisible = true;
        this.$nextTick(_ => {
          this.$refs.saveTagInput.$refs.input.focus();
        });
      },

      handleInputConfirm() {
        let inputValue = this.inputValue;
        if (inputValue) {
          this.dynamicTags.push(inputValue);
        }
        this.inputVisible = false;
        this.inputValue = '';
      }
    }
  }
</script>
显示代码 复制代码

# 不同尺寸

Tag 组件提供三种尺寸,可以在不同场景使用不同的大小。

大型标签 默认标签 小型标签

尺寸:largesmall,通过class配置。

<j-tag class="large" closable>大型标签</j-tag>
<j-tag  closable>默认标签</j-tag>
<j-tag class="small" closable>小型标签</j-tag>
显示代码 复制代码

# Attributes

参数 说明 类型 可选值 默认值
class 类型 string success/info/warning/danger
class 尺寸 string large/small
closable 是否可关闭 boolean false
disable-transitions 是否禁用渐变动画 boolean false
color 背景色 string

# Events

事件名称 说明 回调参数
click 点击 Tag 时触发的事件
close 关闭 Tag 时触发的事件