Skip to content
On this page

Tag 标签

用于标记和选择。

基础用法

type属性来选择 tag 的类型,hit属性来选择是否显示边框,也可以通过color属性来自定义文字颜色。

标签一标签二标签三标签四标签五带边框标签自定义文字颜色
<el-tag>标签一</el-tag>
<el-tag type="success">标签二</el-tag>
<el-tag type="info">标签三</el-tag>
<el-tag type="warning">标签四</el-tag>
<el-tag type="danger">标签五</el-tag>
<el-tag hit>带边框标签</el-tag>
<el-tag color="#FFA000">自定义文字颜色</el-tag>

可移除标签

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

标签一标签二标签三标签四标签五
<el-tag v-for="tag in tags" :key="tag.name" closable :type="tag.type" @close="handleClose(tag)">
  {{tag.name}}
</el-tag>

<script>
  import { reactive, toRefs } from 'vue'
  export default {
    setup() {
      const state = reactive({
        tags: [
          { name: '标签一', type: '' },
          { name: '标签二', type: 'success' },
          { name: '标签三', type: 'info' },
          { name: '标签四', type: 'warning' },
          { name: '标签五', type: 'danger' }
        ]
      })

      function handleClose(tag) {
        return state.tags.splice(state.tags.indexOf(tag),1)
      }
      return { ...toRefs(state), handleClose }
    }
  }
</script>

动态编辑标签

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

标签一标签二标签三
<el-tag
  :key="tag"
  v-for="tag in dynamicTags"
  closable
  @close="handleClose(tag)"
>
  {{tag}}
</el-tag>
<input  
  class="input-new-tag"
  v-if="inputVisible"
  v-model="inputValue"
  ref="saveTagInput"
  @keyup.enter.native="handleInputConfirm"
  @blur="handleInputConfirm"
/>


<el-button v-else class="button-new-tag" size="small" @click="showInput"
  >+ New Tag</el-button
>

<style>
  .el-tag + .el-tag {
    margin-left: 10px;
  }
  .button-new-tag {
    margin-left: 10px;
    height: 32px;
    line-height: 30px;
    padding-top: 0;
    padding-bottom: 0;
  }
  .input-new-tag {
    width: 90px;
    margin-left: 10px;
    vertical-align: bottom;
    border: 1px solid #eee;
    padding:5px;
  }
</style>

<script>
  import { reactive, ref, toRefs, nextTick } from 'vue'
  export default {
    setup() {
      const state = reactive({
        dynamicTags: ['标签一', '标签二', '标签三'],
        inputVisible: false,
        inputValue: ''
      })
      const saveTagInput = ref(null)
      const handleClose = (tag) => {
        state.dynamicTags.splice(state.dynamicTags.indexOf(tag), 1)
      }
      const showInput = () => {
        state.inputVisible = true
        nextTick((_) => {
          saveTagInput.value.focus()
        })
      }
      const handleInputConfirm = () => {
        let inputValue = state.inputValue
        if (inputValue) {
          state.dynamicTags.push(inputValue)
        }
        state.inputVisible = false
        state.inputValue = ''
      }
      return {
        ...toRefs(state),
        handleClose,
        showInput,
        handleInputConfirm,
        saveTagInput
      }
    }
  }
</script>

不同尺寸

Tag 组件提供除了默认值以外的三种尺寸,可以在不同场景下选择合适的按钮尺寸。

默认标签中等标签小型标签超小标签
<el-tag closable>默认标签</el-tag>
<el-tag size="medium" closable>中等标签</el-tag>
<el-tag size="small" closable>小型标签</el-tag>
<el-tag size="mini" closable>超小标签</el-tag>

不同主题

Tag 组件提供了三个不同的主题:darklightplain

Dark标签一标签二标签三标签四标签五
Plain标签一标签二标签三标签四标签五
<div class="tag-group">
  <span class="tag-group__title">Dark</span>
  <el-tag
    v-for="item in items"
    :key="item.label"
    :type="item.type"
    effect="dark"
  >
    {{ item.label }}
  </el-tag>
</div>
<div class="tag-group">
  <span class="tag-group__title">Plain</span>
  <el-tag
    v-for="item in items"
    :key="item.label"
    :type="item.type"
    effect="plain"
  >
    {{ item.label }}
  </el-tag>
</div>

<script>
  import { reactive, toRefs } from 'vue'
  export default {
    setup() {
      const state = reactive({
        items: [
          { type: '', label: '标签一' },
          { type: 'success', label: '标签二' },
          { type: 'info', label: '标签三' },
          { type: 'danger', label: '标签四' },
          { type: 'warning', label: '标签五' }
        ]
      })
      return { ...toRefs(state) }
    }
  }
</script>

Attributes

参数说明类型可选值默认值
type类型stringsuccess/info/warning/danger
closable是否可关闭booleanfalse
disable-transitions是否禁用渐变动画booleanfalse
hit是否有边框描边booleanfalse
color文字颜色string
size尺寸stringmedium / small / mini
effect主题stringdark / light / plainlight

Events

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