Vue / 系统课时
实现角色授权
实现角色授权
本课完成角色授权弹窗:并行加载菜单树与角色已有权限,正确回填树形选中状态,再把用户调整后的叶子权限提交给后端。实现重点是避免半选父节点被误当成完整授权,并保证重复打开不同角色时不会残留旧状态。
学习目标
- 构建可回填的树形菜单授权界面
- 正确区分全选、半选与叶子权限
- 完成授权提交、加载状态和结果刷新
明确授权数据契约
菜单节点至少需要 id、name 和 children;角色授权接口建议返回真正可执行的叶子权限 ID。父节点是否半选由树组件根据子节点自动推导,不把半选父节点当作完整权限保存,可以避免回填时父节点级联勾选全部子项。
当后端必须保存目录父节点时,应把“展示回填用的叶子 ID”和“持久化用的父子 ID”分开定义,不能把同一组 ID 同时用于默认级联回填与权限判断。

实现授权弹窗
下面是片段示例,依赖 Vue 3、TypeScript、Element Plus,以及项目中的 getMenuTree、getRoleMenuIds、updateRoleMenus 三个接口函数。弹窗每次打开都重新加载,先清空旧选择,再在菜单节点渲染完成后回填。
<script setup lang="ts">
import { nextTick, ref } from 'vue'
import { ElMessage, ElTree } from 'element-plus'
import {
getMenuTree,
getRoleMenuIds,
updateRoleMenus
} from '@/api/role'
interface MenuNode {
id: number
name: string
children?: MenuNode[]
}
const props = defineProps<{
modelValue: boolean
roleId: number
}>()
const emit = defineEmits<{
'update:modelValue': [value: boolean]
success: []
}>()
const treeRef = ref<InstanceType<typeof ElTree>>()
const treeData = ref<MenuNode[]>([])
const loading = ref(false)
const submitting = ref(false)
async function loadAuthorization() {
loading.value = true
try {
const [menus, checkedLeafIds] = await Promise.all([
getMenuTree(),
getRoleMenuIds(props.roleId)
])
treeData.value = menus
await nextTick()
// 先清空,避免切换角色时残留上一次的选中状态。
treeRef.value?.setCheckedKeys([], false)
treeRef.value?.setCheckedKeys(checkedLeafIds, false)
} finally {
loading.value = false
}
}
async function submitAuthorization() {
const checkedLeafIds =
(treeRef.value?.getCheckedKeys(true) as number[] | undefined) ?? []
submitting.value = true
try {
await updateRoleMenus(props.roleId, {
menuIds: [...new Set(checkedLeafIds)]
})
ElMessage.success('角色授权已更新')
emit('success')
emit('update:modelValue', false)
} finally {
submitting.value = false
}
}
</script>
<template>
<el-dialog
title="角色授权"
:model-value="props.modelValue"
@open="loadAuthorization"
@update:model-value="emit('update:modelValue', $event)"
>
<el-tree
ref="treeRef"
v-loading="loading"
:data="treeData"
node-key="id"
show-checkbox
default-expand-all
:props="{ label: 'name', children: 'children' }"
/>
<template #footer>
<el-button @click="emit('update:modelValue', false)">取消</el-button>
<el-button
type="primary"
:loading="submitting"
:disabled="loading"
@click="submitAuthorization"
>
保存授权
</el-button>
</template>
</el-dialog>
</template>预期结果:打开弹窗后显示完整菜单树并回填当前角色的叶子权限;只勾选某个子菜单时,其父节点显示半选;点击保存后提交去重后的叶子 ID,成功提示出现,弹窗关闭并触发父页面刷新。
检查提交请求
假设用户最终勾选菜单 101 和 102,更新接口的请求体应保持简单、可重复提交。
{
"menuIds": [101, 102]
}生效行为:相同请求重复提交不会产生重复权限;后端应在事务中先校验角色是否存在,再替换角色与菜单的关联关系。
避免常见授权错误
不要在菜单数据尚未渲染时立即调用 setCheckedKeys,否则回填可能无效;应在赋值树数据后等待 nextTick。切换角色时必须先清空旧勾选,接口失败时保持弹窗打开并展示错误,不能让用户误以为保存成功。
getCheckedKeys(true) 只返回叶子节点,半选父节点仍会正确显示,但不会被误提交为完整授权。如果业务确实以父节点控制路由可见性,应由后端根据叶子权限补齐祖先目录,或明确采用另一套持久化规则。
验收授权闭环
验收时至少准备两个权限不同的角色。先修改角色 A 并保存,再打开角色 B,确认没有残留;刷新页面后重新打开角色 A,确认回填结果与刚才提交一致。最后使用对应账号登录,验证菜单可见性、按钮权限和接口 403 是否同步生效。