Skip to content

KvDictTag ​

根据外部字典将原始值渲染为 Element Plus 标签。组件只负责映射和展示,字典内容仍由业务应用提供。

实时预览 ​

字典标签

同一个组件可以展示成功、危险、警告和未匹配状态。

实时渲染
启用停用待处理未知状态

Props ​

属性类型默认值必填说明
valuestring | number | boolean | null—是要映射的原始值
optionsreadonly KvDictTagOption[]—是标签字典
fallbackstring | ((value) => string)—否未匹配字典时的展示内容
emptyTextstring'--'否空值占位符

组件会将其他属性透传给 Element Plus ElTag,例如 effect、size 和 round。

KvDictTagOption:

属性类型必填说明
valuestring | number | boolean | null是字典值
labelstring是展示文案
type'primary' | 'success' | 'info' | 'warning' | 'danger'否标签类型

Slots ​

插槽参数说明
default{ option, value }自定义标签内部内容

示例代码 ​

vue
<script setup lang="ts">
  import { KvDictTag } from '@kevairy/components'

  const options = [
    { value: 1, label: '启用', type: 'success' },
    { value: 0, label: '停用', type: 'danger' }
  ]
</script>

<template>
  <KvDictTag :value="1" :options="options" effect="light" />
</template>