Vue 3 自定义权限指令 v-action
在实际的前端开发中，尤其是涉及到权限管理的系统，我们经常需要根据用户的权限动态控制某些按钮的显示和隐藏。例如：在一个后台管理系统中，不同角色的用户可能拥有不同的操作权限，比如「查看」、「编辑」、「删除」等。为了避免用户无权操作某些功能，通常需要在组件或模板中手动添加权限判断逻辑。
然而，如果在每个需要权限控制的地方都手写 v-if 或 v-show 来判断，代码会变得冗余且难以维护。为了解决这个问题，可以利用 Vue 3 的自定义指令 来封装权限控制逻辑，使得权限管理变得更直观、可复用，进而提升代码的可读性和可维护性。
举出一个实际可用的 🌰
/**
* 根据权限（binding）决定 el 的显示隐藏
* @param {*} el 指令绑定的 DOM 元素，Vue 传递给指令的 el 参数
* @param {*} binding 指令的绑定值对象，包含传递指令的值。比如：v-action="'actionCode'"，那么 binding.value 就是 'actionCode'。
* @returns
*/
function updateVisibility(el, binding) {
// 获取权限列表
const { _actions } = window;
// 如果没有指定权限值，默认「显示」
if (!binding.value) {
el.style.display = '';
return;
}
// 根据权限判断是否隐藏
el.style.display = _actions && !_actions.includes(binding.value) ? 'none' : '';
}
// action：自定义指令对象
const action = {
// 指令绑定的元素被插入到 DOM 时触发
mounted(el, binding) {
updateVisibility(el, binding);
},
// 当组件 props 或 data 发生变化导致 DOM 更新 时触发。
updated(el, binding) {
updateVisibility(el, binding);
},
};
// 注册全局指令
export default {
install(app) {
// 在 Vue 应用上 注册全局指令 v-action，让所有组件都可以使用 v-action 来控制元素的显示。
app.directive('action', action);
},
};
这个代码是一个 Vue 3 的自定义指令（v-action）， 用于根据用户的权限控制元素的显示与隐藏。它会在 mounted 和 updated 阶段检查权限，并根据权限决定是否显示元素。
🌟 总结
v-action 这个指令的作用是 根据用户权限 (window._actions) 控制元素的显示。
- 用户没有权限 → 隐藏该元素（display: none）。
- 用户有权限 → 显示该元素（display: ''）。
- 没有传递 v-action 的值 → 默认显示。
🌟 使用方式
在 Vue 组件的模板中：
<template>
<button v-action="'_EDIT'">编辑</button>
</template>
只有 _actions 数组包含 '_EDIT'，按钮才会显示。如果 window._actions 不包含 '_EDIT'，按钮会被隐藏。
这个代码在 Vue 3 项目里非常实用，特别适用于 权限控制场景！