Vue / 系统课时
控制按钮权限
控制按钮权限
本课实现页面级按钮权限控制:把后端返回的权限码集中存储,再通过权限组件决定新增、编辑和删除按钮是否渲染。完成后,同一页面会随当前用户权限显示不同操作入口,同时避免在业务模板中重复编写判断逻辑。
学习目标
- 设计稳定、可复用的按钮权限码
- 封装响应式权限组件并接入页面按钮
- 理解前端隐藏与后端鉴权的职责边界
设计权限判断链路
按钮权限应使用稳定字符串表示,例如 user:add、user:edit、user:delete。登录或恢复会话后,前端把权限码写入 Pinia;页面只消费权限结果,不直接解析角色名称,也不根据“管理员”之类的展示文案做判断。
推荐链路是:接口返回权限码 → 权限仓库去重保存 → 权限组件计算是否通过 → 决定是否渲染插槽内容。权限码命名最好保持“资源:动作”格式,新增资源时仍能沿用同一判断方式。
建立权限仓库
下面是片段示例,依赖项目已经安装并注册 Pinia。仓库同时提供“满足任意权限”和“满足全部权限”两种判断,页面无需关心数组去重等细节。
// 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 仓库。
<!-- 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" 后,只有全部权限都存在才渲染。
在用户列表中接入
页面只需要声明每个按钮对应的权限码。删除按钮仍应保留二次确认;权限组件只负责“是否展示”,不替代危险操作确认。
<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。
权限数据加载完成前,建议默认不显示受控按钮,避免先出现再消失的闪烁。角色切换或退出登录时要及时清空权限仓库;公共操作可以传空数组,或直接不使用权限组件。