Skip to content

在实际应用场景中,常常需要依据用户角色对按钮的操作权限实施控制。实现这一控制主要有两种方式:一种是借助前端指令基于角色进行权限管控,另一种是通过后台返回对应的权限属性来实现精细化控制。本文聚焦于前端权限指令展开探讨。

权限指令

在 src/directives/permission.ts 中实现权限指令,代码如下:

typescript
//src/directives/permission.ts 
import { useUserStore } from "@/stores/user";
import type { DirectiveBinding } from "vue";
/**
 * 检查元素权限:根据用户角色判断是否有权限显示元素
 * @param el - 当前指令绑定的DOM元素
 * @param bindings - 指令绑定的值和参数
 */
function checkPermission(el: HTMLElement, bindings: DirectiveBinding) {
  // 获取指令绑定的值(权限数组)
  const { value } = bindings;
  // 获取用户状态管理仓库
  const store = useUserStore();
  // 计算属性:获取用户拥有的角色名称数组
  const roles = computed(() => store.state.roles.map((role) => role.name));
  // 校验权限配置格式
  if (value && Array.isArray(value)) {
    // 判断用户是否拥有任一所需角色
    const hasPermission = roles.value.some((item) => value.includes(item));
    // 无权限则移除DOM元素
    if (!hasPermission) {
      el.parentNode?.removeChild(el);
    }
  } else {
    // 抛出异常提示正确用法
    throw new Error(`请提供权限,如:v-permission="['admin','editor']"`);
  }
}
/**
 * 权限指令:Vue3自定义指令,用于元素级权限控制
 * 使用方式:v-permission="['admin','editor']"
 */
const permission = (el: HTMLElement, bindings: DirectiveBinding) => {
  // 元素插入DOM时执行权限检查
  checkPermission(el, bindings);
};
export default permission;

在 src/directives/index.ts 中引入 permission.ts(如果有其他全局指令也在该文件中引入),代码如下:

typescript
//src/directives/index.ts
import type { App } from "vue";
import permision from "./permission"; // 导入权限判断核心逻辑
/**
 * 权限指令插件:用于在Vue应用中注册自定义权限指令
 * 使用方式:在main.js中通过app.use()安装
 */
const install = (app: App) => {
  // 注册全局自定义指令v-permission
  // 指令名称:permission
  // 指令实现:permision函数(来自permission模块)
  app.directive("permission", permision);
};
export default install;

指令引入

在 src/main.ts 中引入directive,代码如下:

typescript
//src/main.ts
import { createApp } from "vue";
import App from "./App.vue";
import router from "./router";
import "normalize.css/normalize.css";
import { createPinia } from "pinia";
import element from "./plugins/element";
import piniaPluginPersistedstate from "pinia-plugin-persistedstate";
import "./permission";
import directives from "./directives/index";
// import ElementPlus from "element-plus";
// import "element-plus/dist/index.css";
import "@/style/index.scss";
import "uno.css";
const app = createApp(App);
const pinia = createPinia();
pinia.use(piniaPluginPersistedstate); // 安装持久化插件
app.use(router);
app.use(pinia);
app.use(element);
// app.use(ElementPlus);
app.use(directives);
app.mount("#app");

在需要进行权限控制的组件上使用 v-permission 指令,并传入所需角色数组,例如:v-permission="['admin','editor']"。系统会自动检查用户角色,仅当用户拥有 admineditor 角色时显示该组件,其他用户将无法看到或操作此元素。示例代码如下:

html
<el-button
  v-permission="['admin','editor']"
  type="primary"
  @click="handleEdit">
  编辑
</el-button>

【代码】https://gitee.com/lara0101/vue3-admion-lara.git (如有报错请根据提示自行调试,没有时间详细回复,谢谢)