外观
权限规则
模板使用统一的用户授权集合。菜单来自本地配置还是后端适配器,只影响路由的数据来源,不改变按钮的权限判断方式。
用户授权与加载状态
AuthAdapter.getUserInfo() 返回规范化用户信息:
ts
return {
userId: 'user-1',
userName: '示例用户',
roles: ['operator'],
permissions: ['resource:read', 'resource:edit']
}permissions是标准操作权限集合;显式[]表示没有操作权限。- 兼容旧
buttons字段:仅在未提供permissions时作为输入,两者不会合并。 - 角色与操作权限独立,不根据
R_SUPER等角色名自动授予全部操作权限。 permissionsReady独立表示用户信息是否已成功加载,空角色不代表未加载。- 用户信息、权限和加载状态不持久化;刷新后重新获取,新建会话及退出时立即清空。
后端若将已授权按钮放在菜单中,由项目适配层提取并转换为用户 permissions。模板不会把本地路由 authList 自动转换为授权。
统一判断入口
ts
import { usePermission } from '@/hooks'
const { ready, hasPermission, hasAllPermissions, hasRole, hasAllRoles } = usePermission()| 调用 | 含义 |
|---|---|
hasPermission('resource:edit') | 检查单个操作权限 |
hasPermission(['resource:read', 'resource:edit']) | 满足任一项 |
hasAllPermissions(['resource:read', 'resource:edit']) | 全部满足 |
hasRole(['operator', 'auditor']) | 满足任一角色 |
hasAllRoles(['operator', 'auditor']) | 全部角色满足 |
权限未加载时返回 false。空字符串、空数组或包含空值的要求视为配置错误,返回 false,开发环境发出提示。无权限限制的普通按钮不要绑定权限指令。
默认仅将精确的 *:*:* 视为操作权限通配符,可在 src/config/index.ts 的 accessControl.wildcardPermission 中修改,或设为 false 关闭。它不绕过角色限制,也不支持隐式的 resource:* 前缀匹配。
指令与业务禁用条件
vue
<ElButton v-permission="'resource:edit'">编辑</ElButton>
<ElButton v-permission.all="['resource:read', 'resource:edit']">处理</ElButton>
<ElButton v-permission.disabled="'resource:approve'">审批</ElButton>
<section v-roles="'auditor'">审计区域</section>
<ElButton :disabled="!hasPermission('resource:execute') || taskRunning">执行</ElButton>指令和 Hook 共用相同的判断逻辑。默认隐藏节点,权限恢复后恢复原节点;.disabled 保留按钮并禁止操作。绑定值、用户授权或角色变化都会触发重新判断,组件卸载时停止监听。
业务状态继续由页面控制,获得权限不会覆盖业务自身的禁用条件。复杂的按钮禁用条件优先像上例一样通过 :disabled 显式组合。
useAuth().hasAuth() 和 v-auth 保留兼容入口,但统一读取用户授权,不再根据访问模式或路由 authList 切换来源。
页面与隐藏详情页
ts
{
path: 'detail/:id',
name: 'ResourceDetail',
component: '/resource/detail',
meta: {
title: '资源详情',
isHide: true,
activePath: '/resource/list',
permissions: ['resource:read']
}
}- 动态路由始终要求登录。没有声明
roles、permissions的页面不增加授权限制。 meta.roles要求满足任一角色;meta.permissions默认满足任一操作权限,配置permissionMode: 'all'可要求全部满足。- 显式配置
roles: []或permissions: []会拒绝访问,省略字段才表示不增加限制。 - 子页面同时受所有父级限制约束;
isHide、activePath只影响展示,不授予访问权限。 - 访问路径必须匹配已声明路由,拥有
/resource不会自动获得任意/resource/...地址的访问权。 - 菜单和注册路由随授权变化更新。撤销当前页权限后进入 403;获得权限后可以重新访问。
- 静态公开页用于登录和错误恢复;项目新增需要登录的静态页应声明
requiresAuth: true,也可声明角色、操作权限限制。
空菜单与恢复
用户信息和菜单请求成功,但最终可访问菜单为空时,保留认证会话并展示“尚未分配访问权限”。不会因此退出登录,也不会误报 500。
页面提供“重新检查”动作。项目也可调用 src/services/permission.ts 的 refreshAccess(),重新获取用户授权和后端菜单并进入可访问首页。网络错误走错误状态,认证失效仍由认证层处理。
从旧模板迁移
- 将依赖路由
authList的实际授权转换为用户permissions;authList仅保留动作名称等描述。 - 保留旧
buttons输入亦可,但新适配器建议返回permissions,不要用空数组表示“使用旧字段”。 - 为隐藏详情页声明权限或嵌套在带限制的父级下,不能通过
activePath推断授权。 - 检查权限键是否需要项目级命名空间,避免多个页面的
edit被意外视为同一权限。 - 不再依赖节点从 DOM 中移除;以用户能否看到、操作作为测试断言。
前端权限控制用户界面和导航,业务接口仍应由服务端执行鉴权。