DictSelect 字典选择器

字典选择器组件，基于 Element Plus 封装，支持下拉选择、单选框、复选框三种展示类型。

📌 配套组件：DictTag 字典标签 - 用于展示字典值，自动渲染标签样式。

🎯 在线演示：https://vue.youlai.tech/#/demo/dictionary

下拉选择（默认）

<template>
  <DictSelect v-model="gender" code="gender" />
</template>

<script setup lang="ts">
const gender = ref(1)
</script>

单选框类型

<template>
  <DictSelect v-model="gender" type="radio" code="gender" />
</template>

<script setup lang="ts">
const gender = ref(1)
</script>

复选框类型（多选）

<template>
  <DictSelect v-model="hobbies" type="checkbox" code="hobby" />
</template>

<script setup lang="ts">
const hobbies = ref([1, 2])
</script>

Props

参数	说明	类型	默认值
modelValue	绑定值（支持 v-model）	string | number | Array	-
code	字典类型编码（必填）	string	-
type	组件类型：select(下拉)、radio(单选)、checkbox(复选)	string	'select'
placeholder	占位文本	string	'请选择'
disabled	是否禁用	boolean	false
style	自定义样式	object	{ width: '300px' }

Events

事件名	说明	回调参数
update:modelValue	值变化时触发	(value: string | number | Array)

表格中使用

在表格中展示字典值时，推荐使用 DictTag 组件：

<template>
  <el-table :data="tableData">
    <el-table-column label="性别" prop="gender">
      <template #default="{ row }">
        <DictTag :model-value="row.gender" code="gender" />
      </template>
    </el-table-column>
  </el-table>
</template>

<script setup lang="ts">
const tableData = ref([
  { name: '张三', gender: 1 },
  { name: '李四', gender: 2 }
])
</script>

💡 DictTag 会根据字典配置自动渲染标签样式，详见 DictTag 文档。

功能特性

• ✅ 多种类型（下拉选择、单选框、复选框）
• ✅ 自动加载（自动从后端加载字典数据）
• ✅ 数据缓存（字典数据自动缓存，避免重复请求）
• ✅ 值翻译（支持将字典值翻译为文本显示）
• ✅ 双向绑定（支持 v-model）

使用场景

表单中使用

<template>
  <el-form :model="form" label-width="100px">
    <el-form-item label="性别">
      <DictSelect v-model="form.gender" code="gender" />
    </el-form-item>

    <el-form-item label="爱好">
      <DictSelect v-model="form.hobbies" type="checkbox" code="hobby" />
    </el-form-item>

    <el-form-item label="状态">
      <DictSelect v-model="form.status" type="radio" code="status" />
    </el-form-item>
  </el-form>
</template>

<script setup lang="ts">
const form = reactive({
  gender: 1,
  hobbies: [1, 2],
  status: 1
})
</script>

搜索条件

<template>
  <el-form :model="queryParams" inline>
    <el-form-item label="性别">
      <DictSelect v-model="queryParams.gender" code="gender" placeholder="全部" />
    </el-form-item>
    <el-form-item>
      <el-button type="primary" @click="handleQuery">查询</el-button>
    </el-form-item>
  </el-form>
</template>

注意事项

1. 字典编码

字典编码 code 必须与后端定义的字典类型编码一致，否则无法正确加载字典数据。

2. 组件名称

• DictSelect：字典选择器，用于表单输入
• DictTag：字典标签，用于只读展示（详见 DictTag 文档）

3. 数据类型

不同类型的字典组件，v-model 绑定的数据类型不同：

• select 和 radio：绑定单个值（string | number）
• checkbox：绑定数组（Array）

相关链接

• 字典管理
• Element Plus Select
• Element Plus Radio
• Element Plus Checkbox