Vue / 系统课时

控制按钮权限

控制按钮权限

本课实现页面级按钮权限控制:把后端返回的权限码集中存储,再通过权限组件决定新增、编辑和删除按钮是否渲染。完成后,同一页面会随当前用户权限显示不同操作入口,同时避免在业务模板中重复编写判断逻辑。

学习目标

  • 设计稳定、可复用的按钮权限码
  • 封装响应式权限组件并接入页面按钮
  • 理解前端隐藏与后端鉴权的职责边界

设计权限判断链路

按钮权限应使用稳定字符串表示,例如 user:add、user:edit、user:delete。登录或恢复会话后,前端把权限码写入 Pinia;页面只消费权限结果,不直接解析角色名称,也不根据“管理员”之类的展示文案做判断。

推荐链路是:接口返回权限码 → 权限仓库去重保存 → 权限组件计算是否通过 → 决定是否渲染插槽内容。权限码命名最好保持“资源:动作”格式,新增资源时仍能沿用同一判断方式。

建立权限仓库

下面是片段示例,依赖项目已经安装并注册 Pinia。仓库同时提供“满足任意权限”和“满足全部权限”两种判断,页面无需关心数组去重等细节。

ts
// src/stores/modules/permission.ts
import { defineStore } from 'pinia'

export const usePermissionStore = defineStore('permission', {
  state: () => ({
    codes: [] as string[]
  }),
  actions: {
    setCodes(codes: string[]) {
      this.codes = [...new Set(codes)]
    },
    hasAny(required: string[]) {
      return required.length === 0 ||
        required.some(code => this.codes.includes(code))
    },
    hasAll(required: string[]) {
      return required.every(code => this.codes.includes(code))
    }
  }
})

生效行为:调用 setCodes(['user:add', 'user:edit']) 后,hasAny(['user:delete', 'user:edit']) 返回 true,而 hasAll(['user:add', 'user:delete']) 返回 false。

封装权限组件

权限组件比直接删除 DOM 的指令更容易保持响应式:当权限仓库更新时,组件会重新计算并决定是否渲染按钮。下面的片段依赖 Vue 3、TypeScript 和上面的 Pinia 仓库。

vue
<!-- src/components/PermissionGate.vue -->
<script setup lang="ts">
import { computed } from 'vue'
import { usePermissionStore } from '@/stores/modules/permission'

const props = withDefaults(defineProps<{
  codes: string[]
  mode?: 'any' | 'all'
}>(), {
  mode: 'any'
})

const permissionStore = usePermissionStore()

const allowed = computed(() => {
  return props.mode === 'all'
    ? permissionStore.hasAll(props.codes)
    : permissionStore.hasAny(props.codes)
})
</script>

<template>
  <slot v-if="allowed" />
</template>

预期结果:codes 中任意权限满足时,默认渲染插槽;设置 mode="all" 后,只有全部权限都存在才渲染。

在用户列表中接入

页面只需要声明每个按钮对应的权限码。删除按钮仍应保留二次确认;权限组件只负责“是否展示”,不替代危险操作确认。

vue
<script setup lang="ts">
import PermissionGate from '@/components/PermissionGate.vue'

interface UserRow {
  id: number
  username: string
}

const rows: UserRow[] = []

function openCreateDialog() {}
function openEditDialog(row: UserRow) {}
function confirmDelete(row: UserRow) {}
</script>

<template>
  <PermissionGate :codes="['user:add']">
    <el-button type="primary" @click="openCreateDialog">新增用户</el-button>
  </PermissionGate>

  <el-table :data="rows">
    <el-table-column label="操作">
      <template #default="{ row }">
        <PermissionGate :codes="['user:edit']">
          <el-button @click="openEditDialog(row)">编辑</el-button>
        </PermissionGate>

        <PermissionGate :codes="['user:delete']">
          <el-button type="danger" @click="confirmDelete(row)">
            删除
          </el-button>
        </PermissionGate>
      </template>
    </el-table-column>
  </el-table>
</template>

预期结果:拥有 user:add 的用户能看到新增按钮;缺少 user:delete 的用户看不到删除按钮。若权限接口稍后更新仓库,组件会自动重新渲染。

处理边界与安全问题

前端隐藏按钮只能减少误操作和无效入口,不能作为安全边界。用户仍可能手工构造 HTTP 请求,因此新增、编辑和删除接口必须在服务端再次校验权限,并返回明确的 403。

权限数据加载完成前,建议默认不显示受控按钮,避免先出现再消失的闪烁。角色切换或退出登录时要及时清空权限仓库;公共操作可以传空数组,或直接不使用权限组件。

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

目录与阅读设置

阅读设置

17

记录一个想法

控制按钮权限

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

登录哪都通