Vue / 系统课时

按钮与操作权限

按钮与操作权限

页面能访问并不代表所有操作都能执行。企业后台通常需要继续细分“查看、创建、编辑、删除、审批”等权限。本节用 Vue 3 自定义指令和权限组件封装操作入口,让模板保持简洁,同时明确前端隐藏按钮与后端接口鉴权之间的边界。

学习目标

  • 能用统一的权限判断函数控制按钮、菜单项等操作入口。
  • 能实现 v-permission 指令,并理解何时改用权限组件。
  • 能避免只隐藏按钮、不校验接口权限造成的越权风险。

先集中权限判断逻辑

不要在模板里到处写 includes。先把权限集合和判断规则封装成单一入口,后续指令、组件、路由守卫都调用它。这样权限码命名或“满足任一/满足全部”的规则变化时,只改一处。

ts
const grantedPermissions = new Set([
  "order:read",
  "order:update"
]);

export function hasPermission(code: string): boolean {
  return grantedPermissions.has(code);
}

console.log(hasPermission("order:update"));
console.log(hasPermission("order:delete"));

预期输出

text
true
false

真实项目中的权限集合通常来自登录接口或用户信息接口,并存入 Pinia 等状态层。这里用 Set 是为了演示查找逻辑;登录用户变化时应同步重建权限集合,不能沿用旧用户状态。

用自定义指令移除无权限入口

当需求只是“没有权限就不渲染这个操作入口”时,自定义指令足够直接。下面的指令在元素挂载时检查权限,没有权限就把元素从父节点移除。

ts
import type { App, Directive } from "vue";
import { hasPermission } from "./permission";

const permissionDirective: Directive<HTMLElement, string> = {
  mounted(el, binding) {
    if (!hasPermission(binding.value)) {
      el.parentNode?.removeChild(el);
    }
  }
};

export function installPermissionDirective(app: App): void {
  app.directive("permission", permissionDirective);
}

这是片段示例,依赖 Vue 3 应用实例和前面定义的 hasPermission。在 main.ts 中调用 installPermissionDirective(app) 后,可以在模板中写 v-permission="'order:update'";若当前用户没有该权限,对应元素不会保留在 DOM 中。

一个典型模板如下:

vue
<script setup lang="ts">
function editOrder(): void {
  console.log("edit");
}
</script>

<template>
  <button v-permission="'order:update'" @click="editOrder">
    编辑订单
  </button>
</template>

预期结果

text
拥有 order:update:页面显示“编辑订单”按钮,点击后控制台输出 edit
缺少 order:update:按钮不会出现在 DOM 中

动态值在真实应用中由登录用户决定,因此每个账号的结果可能不同。

权限变化时优先使用组件

上面的指令只在 mounted 时判断一次。如果应用支持不刷新页面就切换角色、刷新权限或模拟身份,权限状态可能在元素挂载后改变,此时单次指令判断容易失效。更稳妥的方式是用组件根据响应式状态决定是否渲染插槽。

vue
<script setup lang="ts">
import { computed } from "vue";
import { useAuthStore } from "./stores/auth";

const props = defineProps<{ code: string }>();
const auth = useAuthStore();

const allowed = computed(() => auth.permissions.includes(props.code));
</script>

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

这是片段示例,依赖一个公开 permissions: string[] 的 Pinia useAuthStore。验证时在运行中的应用修改权限数组:拥有权限时插槽内容出现,移除权限后内容应立即消失。这个方案更适合权限可能动态变化、或需要统一空态与降级提示的场景。

区分隐藏、禁用和后端拒绝

“隐藏按钮”适合用户本来就不应看到的操作;“禁用按钮”适合用户有操作权限但当前业务状态不允许执行,例如订单已完成后禁止再次编辑。两者不要混为一谈,否则用户会误以为业务状态限制是权限不足。

前端权限只能控制操作入口,不能作为安全边界。即使删除按钮被移除,用户仍可能手工构造请求,因此对应的 DELETE /orders/<ID> 等接口必须在服务端再次校验身份、资源范围和操作权限。前端拿到 403 时还应展示明确提示,而不是假设“按钮隐藏了就不会发生越权请求”。

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

目录与阅读设置

阅读设置

17

记录一个想法

按钮与操作权限

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

登录哪都通