中国 帮助

使用字典

在对应页面中导入需要使用的字典 typescript const { sys_normal_disable } = toRefs<any(proxy?.useDict('sys_normal_disable')); 也可以一

使用字典
封面

> 本文整理自平台文档 docs/wujies/5.x/plus-ui/dict_use.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-c5d48280b6ea-cover.svg)

  • - -

### 在对应页面中导入需要使用的字典

const { sys_normal_disable } = toRefs<any>(proxy?.useDict('sys_normal_disable'));

也可以一次获取多个字典:

const { sys_normal_disable, sys_user_sex } = toRefs<any>(proxy?.useDict('sys_normal_disable', 'sys_user_sex'));
  • useDict 已经挂载到全局 proxy 上
  • 首次获取会请求后端字典接口,之后会走 Pinia 字典缓存
  • 返回的每项数据通常包含 label、value、elTagType、elTagClass

### Form中以select形式使用

<el-select v-model="queryParams.status" clearable placeholder="用户状态">
    <el-option v-for="dict in sys_normal_disable" :key="dict.value" :label="dict.label" :value="dict.value" />
</el-select>

### 表格中以switch形式使用

<template #default="scope">
    <el-switch v-model="scope.row.status" active-value="0" inactive-value="1" @change="handleStatusChange(scope.row)">
    </el-switch>
</template>

### 表格中以tag形式使用

<template #default="scope">
    <dict-tag :options="sys_normal_disable" :value="scope.row.status" />
</template>

组件详情参考 src/components/DictTag/index.vue

dict-tag 适合表格、详情页这类只读展示场景,可自动带出字典标签样式。

### Form中以radio形式使用

<el-radio-group v-model="form.status">
    <el-radio v-for="dict in sys_normal_disable" :key="dict.value" :value="dict.value">
        {{ dict.label }}
    </el-radio>
</el-radio-group>
  • 如果后端返回值是字符串,表单组件里的 value 也建议保持字符串类型
  • 字典值和表单默认值类型不一致时,最常见的问题就是“回显不出来”

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-c5d48280b6ea-guide.svg)

章节导览
THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容