Vue / 系统课时
按钮与操作权限
按钮与操作权限
页面能访问并不代表所有操作都能执行。企业后台通常需要继续细分“查看、创建、编辑、删除、审批”等权限。本节用 Vue 3 自定义指令和权限组件封装操作入口,让模板保持简洁,同时明确前端隐藏按钮与后端接口鉴权之间的边界。
学习目标
- 能用统一的权限判断函数控制按钮、菜单项等操作入口。
- 能实现
v-permission指令,并理解何时改用权限组件。 - 能避免只隐藏按钮、不校验接口权限造成的越权风险。
先集中权限判断逻辑
不要在模板里到处写 includes。先把权限集合和判断规则封装成单一入口,后续指令、组件、路由守卫都调用它。这样权限码命名或“满足任一/满足全部”的规则变化时,只改一处。
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"));预期输出
true
false真实项目中的权限集合通常来自登录接口或用户信息接口,并存入 Pinia 等状态层。这里用 Set 是为了演示查找逻辑;登录用户变化时应同步重建权限集合,不能沿用旧用户状态。
用自定义指令移除无权限入口
当需求只是“没有权限就不渲染这个操作入口”时,自定义指令足够直接。下面的指令在元素挂载时检查权限,没有权限就把元素从父节点移除。
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 中。
一个典型模板如下:
<script setup lang="ts">
function editOrder(): void {
console.log("edit");
}
</script>
<template>
<button v-permission="'order:update'" @click="editOrder">
编辑订单
</button>
</template>预期结果
拥有 order:update:页面显示“编辑订单”按钮,点击后控制台输出 edit
缺少 order:update:按钮不会出现在 DOM 中动态值在真实应用中由登录用户决定,因此每个账号的结果可能不同。
权限变化时优先使用组件
上面的指令只在 mounted 时判断一次。如果应用支持不刷新页面就切换角色、刷新权限或模拟身份,权限状态可能在元素挂载后改变,此时单次指令判断容易失效。更稳妥的方式是用组件根据响应式状态决定是否渲染插槽。
<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 时还应展示明确提示,而不是假设“按钮隐藏了就不会发生越权请求”。