外观
KvDictTag
根据外部字典将原始值渲染为 Element Plus 标签。组件只负责映射和展示,字典内容仍由业务应用提供。
实时预览
字典标签
同一个组件可以展示成功、危险、警告和未匹配状态。
启用停用待处理未知状态
Props
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
value | string | number | boolean | null | — | 是 | 要映射的原始值 |
options | readonly KvDictTagOption[] | — | 是 | 标签字典 |
fallback | string | ((value) => string) | — | 否 | 未匹配字典时的展示内容 |
emptyText | string | '--' | 否 | 空值占位符 |
组件会将其他属性透传给 Element Plus ElTag,例如 effect、size 和 round。
KvDictTagOption:
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
value | string | number | boolean | null | 是 | 字典值 |
label | string | 是 | 展示文案 |
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>