Vue / 系统课时

实现角色授权

实现角色授权

本课完成角色授权弹窗:并行加载菜单树与角色已有权限,正确回填树形选中状态,再把用户调整后的叶子权限提交给后端。实现重点是避免半选父节点被误当成完整授权,并保证重复打开不同角色时不会残留旧状态。

学习目标

  • 构建可回填的树形菜单授权界面
  • 正确区分全选、半选与叶子权限
  • 完成授权提交、加载状态和结果刷新

明确授权数据契约

菜单节点至少需要 id、name 和 children;角色授权接口建议返回真正可执行的叶子权限 ID。父节点是否半选由树组件根据子节点自动推导,不把半选父节点当作完整权限保存,可以避免回填时父节点级联勾选全部子项。

当后端必须保存目录父节点时,应把“展示回填用的叶子 ID”和“持久化用的父子 ID”分开定义,不能把同一组 ID 同时用于默认级联回填与权限判断。

角色授权数据流与树形半选关系

实现授权弹窗

下面是片段示例,依赖 Vue 3、TypeScript、Element Plus,以及项目中的 getMenuTree、getRoleMenuIds、updateRoleMenus 三个接口函数。弹窗每次打开都重新加载,先清空旧选择,再在菜单节点渲染完成后回填。

vue
<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,更新接口的请求体应保持简单、可重复提交。

json
{
  "menuIds": [101, 102]
}

生效行为:相同请求重复提交不会产生重复权限;后端应在事务中先校验角色是否存在,再替换角色与菜单的关联关系。

避免常见授权错误

不要在菜单数据尚未渲染时立即调用 setCheckedKeys,否则回填可能无效;应在赋值树数据后等待 nextTick。切换角色时必须先清空旧勾选,接口失败时保持弹窗打开并展示错误,不能让用户误以为保存成功。

getCheckedKeys(true) 只返回叶子节点,半选父节点仍会正确显示,但不会被误提交为完整授权。如果业务确实以父节点控制路由可见性,应由后端根据叶子权限补齐祖先目录,或明确采用另一套持久化规则。

验收授权闭环

验收时至少准备两个权限不同的角色。先修改角色 A 并保存,再打开角色 B,确认没有残留;刷新页面后重新打开角色 A,确认回填结果与刚才提交一致。最后使用对应账号登录,验证菜单可见性、按钮权限和接口 403 是否同步生效。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

实现角色授权

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通