40 lines
1.2 KiB
Markdown
40 lines
1.2 KiB
Markdown
# J. 前端枚举速查
|
|
|
|
:::tip 说明
|
|
`ui/src/enums` 枚举常量速查。统一 `as const` + 类型导出，禁止散落裸字符串常量。
|
|
:::
|
|
|
|
## 枚举清单
|
|
|
|
| 文件 | 内容 | 典型消费方 |
|
|
|---|---|---|
|
|
| pageEnum.ts | 页面路径常量（BASE_LOGIN 等） | 路由守卫、登录跳转 |
|
|
| httpEnum.ts | HTTP 常量（结果类型、超时、重试） | http 拦截器 |
|
|
| permissionsEnum.ts | 权限相关常量 | usePermission、指令 |
|
|
| roleEnum.ts | 角色常量 | 超管判定展示 |
|
|
| cacheEnum.ts | 缓存键常量 | Storage 相关 |
|
|
| breakpointEnum.ts | 响应式断点 | 布局、侧边栏折叠 |
|
|
| avatarEnum.ts | 头像相关常量 | 个人中心 |
|
|
|
|
## 使用示例
|
|
|
|
```typescript
|
|
import { PageEnum } from '@/enums/pageEnum';
|
|
|
|
const loginPath = PageEnum.BASE_LOGIN;
|
|
```
|
|
|
|
## 与后端常量的关系
|
|
|
|
前后端共享语义的值（如超管通配权限码 `*:*:*`、数据范围档位 1–4）两端各自有常量定义——修改任一侧必须同步另一侧，并更新本速查。
|
|
|
|
## 编写规约
|
|
|
|
- 键名大写下划线，字符串值为主
|
|
- 带类型导出（`typeof Xxx` / 联合类型）
|
|
- 新枚举先确认无既有文件覆盖该域
|
|
|
|
## 相关
|
|
|
|
- [9.18 Hooks 与枚举](/zh/frontend/hooks-enums.html)
|