Skip to content

内置字典索引

Forge Admin 预置了一批系统字典,用于标准化下拉选项与状态显示。以下列出常用内置字典。

字典结构

每个字典由一条 sys_dict_type(类型)和多条 sys_dict_data(数据)组成:

json
{
  "dictType": "sys_user_status",
  "dictName": "用户状态",
  "dictDataList": [
    { "dictLabel": "正常", "dictValue": "0", "listClass": "success" },
    { "dictLabel": "停用", "dictValue": "1", "listClass": "danger" }
  ]
}

系统内置字典

字典类型字典名称字典值示例
sys_user_status用户状态0=正常, 1=停用
sys_show_hide显示隐藏0=显示, 1=隐藏
sys_yes_no是否Y=是, N=否
sys_sex性别0=男, 1=女, 2=未知
sys_oper_type操作类型0=其他, 1=新增, 2=修改, 3=删除
sys_common_status通用状态0=成功, 1=失败
sys_notice_type通知类型1=通知, 2=公告
sys_notice_status通知状态0=正常, 1=关闭
sys_menu_type菜单类型M=目录, C=菜单, F=按钮
sys_data_scope数据权限范围1=全部, 2=自定义, 3=本部门, 4=本部门及以下, 5=仅本人

字典值详解

sys_user_status(用户状态)

字典值字典标签样式说明
0正常success(绿色)账号可正常登录
1停用danger(红色)账号被禁用,无法登录

sys_show_hide(显示隐藏)

字典值字典标签说明
0显示前端可见
1隐藏前端不可见

sys_yes_no(是否)

字典值字典标签说明
Y肯定
N否定

sys_sex(性别)

字典值字典标签说明
0男性
1女性
2未知未知性别

sys_oper_type(操作类型)

字典值字典标签说明
0其他非标准操作
1新增新增操作
2修改修改操作
3删除删除操作
4授权权限分配
5导出数据导出
6导入数据导入

sys_data_scope(数据权限范围)

字典值字典标签说明
1全部可查看所有数据
2自定义可查看指定部门数据
3本部门仅查看本部门数据
4本部门及以下查看本部门及子部门数据
5仅本人仅查看自己的数据

前端使用

前端通过 useDict 组合式函数获取字典数据:

typescript
const { sys_user_status, sys_sex } = useDict('sys_user_status', 'sys_sex')

// 在模板中使用
<n-tag :type="sys_user_status[row.status]?.listClass">
  {{ sys_user_status[row.status]?.dictLabel }}
</n-tag>

💡 业务开发中如需新增字典,请在「系统管理 → 字典管理」页面操作,勿直接修改数据库。

Forge Admin — 基于 Vue3 + Spring Boot 的企业级后台管理框架