Vue3中使用自定义指令实现后台管理系统中对于按钮权限的控制

一、自定义指令的全局注册

1. 创建自定义指令: 你可以创建一个自定义指令来实现某种功能，比如改变文本颜色。

   Vue.directive('color', {bind(el, binding) {el.style.color = binding.value; // 使用绑定的值设置颜色}
   });
   

2. 全局注册自定义指令: 在 Vue 应用的入口文件（通常是 main.js 或 app.js）中进行注册。

   import Vue from 'vue';
   import App from './App.vue';// 全局注册自定义指令
   Vue.directive('color', {bind(el, binding) {el.style.color = binding.value; // 使用绑定的值设置颜色}
   });new Vue({render: h => h(App),
   }).$mount('#app');
   

3. 在模板中使用: 你可以在任何组件中使用这个指令。

   <template><div v-color="'red'">这段文本将会是红色</div>
   </template>
   

二、 按钮权限详解

本质是控制页面上的按钮显示与否

当我们从后端拿取到一个角色的按钮权限列表（一般是一个字符串数组），通过自定义指令去检查当前用户的角色是否在权限数组中，匹配上证明该角色有这个按钮权限，那么在相应的页面中也有对应按钮的显示，反之没有显示按钮或者按钮被禁用。

三、具体实现

1.在src中创建directive文件夹下的index.ts文件中

import type { App } from 'vue';
import permission from './permission';export default {install(Vue: App) {Vue.directive('permission', permission);}
};

2.在directive文件夹下创建permission文件夹下的index.ts文件中

import type { DirectiveBinding } from 'vue';// 定义一个函数 checkPermission，用于检查元素的权限
function checkPermission(el: HTMLElement, binding: DirectiveBinding) {// 从绑定对象中获取权限值const { value } = binding;// 获取当前角色的按钮权限数组（从后端获取后已经存储到本地了）const btnAclArr = JSON.parse(localStorage.getItem('permissionButtton'));// 检查 value 是否为数组if (Array.isArray(value)) {// 确保数组不为空if (value.length > 0) {const permissionValues = value[0];// 检查当前用户的角色是否在权限数组中const hasPermission = btnAclArr.includes(permissionValues);// 如果没有权限且元素有父节点，移除该元素if (!hasPermission && el.parentNode) {el.parentNode.removeChild(el);}}} else {// 如果 value 不是数组，抛出错误throw new Error(`need roles! Like v-permission="['admin','user']"`);}
}// 导出一个对象，定义自定义指令的生命周期钩子
export default {// 在元素挂载时调用 checkPermission 函数mounted(el: HTMLElement, binding: DirectiveBinding) {checkPermission(el, binding);},// 在元素更新时调用 checkPermission 函数updated(el: HTMLElement, binding: DirectiveBinding) {checkPermission(el, binding);}
};

3.在页面上的按钮添加v-permission属性

 <a-buttonv-permission="['acl:api:add']"type="primary"@click="addApi()"
><template #icon><icon-plus /></template>新建
</a-button>