笔记7：权限管理功能【Vue实战项目：电商管理系统（Element-UI）】

ゞ浴缸里的玫瑰 2022-08-31 13:19 584阅读 0赞

### 文章目录 ###

*   *  1 权限列表
     *   *  1.1 通过路由展示权限列表组件
         *  1.2 调用API获取权限列表的数据
         *  1.3 渲染权限列表UI结构
     *  2 权限管理
     *   *  2.1 绘制基本布局结构并获取列表数据
         *  2.2 渲染角色列表数据
         *  2.3 通过第一层for循环渲染一级权限
         *  2.4 渲染二级和三级权限
         *  2.5 美化角色下权限的UI结构
         *  2.6 完成删除角色下指定权限的功能
     *  3 分配权限
     *   *  3.1 弹出分配权限对话框并请求权限数据
         *  3.2 配置并使用el-tree树形控件
         *  3.3 加载当前角色已有的权限
         *  3.4 调用API完成分配权限的功能
     *  分配角色

## 1 权限列表 ##

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3R0NzUyODE5MjA_size_16_color_FFFFFF_t_70]

### 1.1 通过路由展示权限列表组件 ###

*  创建页面：`../components/power/Rights.vue`

<template>
      <div>
        
        <el-breadcrumb separator-class="el-icon-arrow-right">
          <el-breadcrumb-item :to="{ path: '/welcome' }">首页</el-breadcrumb-item>
          <el-breadcrumb-item>权限管理</el-breadcrumb-item>
          <el-breadcrumb-item>权限列表</el-breadcrumb-item>
        </el-breadcrumb>
        
        
        <el-card> 权限列表表单</el-card>
      </div>
    </template>
    
    <script>
    export default { };
    </script>
    
    <style lang="less" scoped>
    </style>

*  添加路由

import Rights from '../components/power/Rights.vue'
    
    Vue.use(Router)
    
    const router = new Router({ 
      routes: [
        ...
        { 
          path: '/home', component: Home, redirect: '/welcome', children: [
            ...,
            {  path: '/rights', component: Rights }
          ]
        }
      ]
    })

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3R0NzUyODE5MjA_size_16_color_FFFFFF_t_70 1]

### 1.2 调用API获取权限列表的数据 ###

### 1.3 渲染权限列表UI结构 ###

<el-table :data="rightsList" stripe border>
        <el-table-column type="index" label="序号"> </el-table-column>
        <el-table-column prop="authName" label="权限名称">
        </el-table-column>
        <el-table-column prop="path" label="路径">
        </el-table-column>
        <el-table-column prop="level" label="权限等级">
          
          <template slot-scope="scope">
            <el-tag v-if="scope.row.level === '0'">一级</el-tag>
            <el-tag type="success" v-else-if="scope.row.level === '1'">二级</el-tag>
            <el-tag type="warning" v-else>三级</el-tag>
          </template>
        </el-table-column>
    </el-table>

## 2 权限管理 ##

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3R0NzUyODE5MjA_size_16_color_FFFFFF_t_70 2]

### 2.1 绘制基本布局结构并获取列表数据 ###

*  创建页面：`../components/power/Roles.vue`

<template>
      <div>
        
        <el-breadcrumb separator-class="el-icon-arrow-right">
          <el-breadcrumb-item :to="{ path: '/welcome' }">首页</el-breadcrumb-item>
          <el-breadcrumb-item>权限管理</el-breadcrumb-item>
          <el-breadcrumb-item>角色列表</el-breadcrumb-item>
        </el-breadcrumb>
    
        
        <el-card>
          
          <el-row>
            <el-col>
              <el-button type="primary">添加角色</el-button>
            </el-col>
          </el-row>
          
        </el-card>
      </div>
    </template>
    
    <script>
    export default { };
    </script>
    
    <style lang="less" scoped>
    </style>

*  设置路由

import Roles from '../components/power/Roles.vue'
    
    Vue.use(Router)
    
    const router = new Router({ 
      routes: [
        ...
        { 
          path: '/home', component: Home, redirect: '/welcome', children: [
            ...
            {  path: '/roles', component: Roles },
          ]
        }
      ]
    })

*  获取接口数据

> 1.5.1. 角色列表接口

### 2.2 渲染角色列表数据 ###

<el-table :data="rolesList" stripe border>
        
        <el-table-column type="expand"> </el-table-column>
        
        <el-table-column type="index" label="#"> </el-table-column>
        <el-table-column prop="roleName" label="角色名称"> </el-table-column>
        <el-table-column prop="roleDesc" label="角色描述"> </el-table-column>
        <el-table-column label="操作">
          
          <template slot-scope="scope">
            <el-button size="mini" type="primary" icon="el-icon-edit"
              >编辑</el-button
            >
            <el-button size="mini" type="danger" icon="el-icon-delete"
              >删除</el-button
            >
            <el-button size="mini" type="warning" icon="el-icon-setting"
              >分配权限</el-button
            >
          </template>
        </el-table-column>
      </el-table>

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3R0NzUyODE5MjA_size_16_color_FFFFFF_t_70 3]

### 2.3 通过第一层for循环渲染一级权限 ###

*  在展开列添加`作用域插槽`，来展示数据

<el-table-column type="expand">
      <template slot-scope="scope">
        <el-row
          :class="['bdbottom', i1 === 0 ? 'bdtop' : '']"
          v-for="(item1, i1) in scope.row.children"
          :key="item1.id"
        >
          
          <el-col :span="5">
            <el-tag>{ {  item1.authName }}</el-tag>
            <i class="el-icon-caret-right"></i>
          </el-col>
          
          <el-col :span="19"></el-col>
        </el-row>
      </template>
    </el-table-column>

*  样式

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3R0NzUyODE5MjA_size_16_color_FFFFFF_t_70 4]

### 2.4 渲染二级和三级权限 ###

<el-col :span="19">
        
        <el-row
          :class="[i2 === 0 ? '' : 'bdtop']"
          v-for="(item2, i2) in item1.children"
          :key="item2.id"
        >
          <el-col :span="6">
            <el-tag type="success">{ {  item2.authName }}</el-tag>
            <i class="el-icon-caret-right"></i>
          </el-col>
          
          <el-col :span="18">
              <el-tag type="warning" v-for="item3 in item2.children" :key="item3.id">{ { item3.authName}}</el-tag>
          </el-col>
        </el-row>
      </el-col>

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3R0NzUyODE5MjA_size_16_color_FFFFFF_t_70 5]

### 2.5 美化角色下权限的UI结构 ###

*  全局设置页面最小宽度

> 解决页面过窄时，页面变形

/* 全局样式表 */
    html, body, #app { 
      ...
      min-width: 1366px; /* 防止页面过窄导致的页面变形，定义最小宽度为1366像素 */
    }

*  设置一，二级tag居中  
    定义样式

.vcenter{ 
        display: flex;
        align-items: center;
    }

绑定样式

<el-row
      :class="['bdbottom', i1 === 0 ? 'bdtop' : '','vcenter']"
      v-for="(item1, i1) in scope.row.children"
      :key="item1.id"
    >

<el-row
      :class="[i2 === 0 ? '' : 'bdtop','vcenter']"
      v-for="(item2, i2) in item1.children"
      :key="item2.id"
    >

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3R0NzUyODE5MjA_size_16_color_FFFFFF_t_70 6]

### 2.6 完成删除角色下指定权限的功能 ###

*  绑定删除方法

<el-col :span="5">
        <el-tag closable
        @close="removeRightById(scope.row, item1.id)">{ {  item1.authName }}</el-tag>
        <i class="el-icon-caret-right"></i>
      </el-col>
      
      <el-col :span="19">
        
        <el-row
          :class="[i2 === 0 ? '' : 'bdtop', 'vcenter']"
          v-for="(item2, i2) in item1.children"
          :key="item2.id"
        >
          <el-col :span="6">
            <el-tag
              type="success"
              closable
              @close="removeRightById(scope.row, item2.id)"
              >{ {  item2.authName }}</el-tag
            >
            <i class="el-icon-caret-right"></i>
          </el-col>
          
          <el-col :span="18">
            <el-tag
              type="warning"
              v-for="item3 in item2.children"
              :key="item3.id"
              closable
              @close="removeRightById(scope.row, item3.id)"
              >{ {  item3.authName }}</el-tag
            >
          </el-col>

*  实现删除方法

// 删除角色制定权限
    async removeRightById(role, rightId) { 
      const confirmResult = await this.$confirm(
        "此操作将永久删除该权限, 是否继续?",
        "提示",
        { 
          confirmButtonText: "确定",
          cancelButtonText: "取消",
          type: "warning",
        }
      ).catch((err) => err);
    
      if (confirmResult !== "confirm") { 
        return this.$message.info("取消删除！");
      }
    
      const {  data: res } = await this.$http.delete(
        `roles/${ role.id}/rights/${ rightId}`
      );
    
      if (res.meta.status !== 200) { 
        return this.$message.error("删除权限失败！");
      }
    
      // 将接口数据中的data直接赋值给children，防止页面过渡刷新
      role.children = res.data;
    },

## 3 分配权限 ##

### 3.1 弹出分配权限对话框并请求权限数据 ###

*  在`分配权限`按钮绑定点击事件`showSetRightDialog`，并实权限列表的数据获取：

async showSetRightDialog() { 
      const {  data: res } = await this.$http.get("rights/tree");
      if (res.meta.status !== 200) { 
        return this.$message.error("获取权限列表失败！");
      }
      this.rightsList = res.data;
      console.log(this.rightsList);
      this.setRightDialogVisible = true;
    },

*  编写弹窗

<el-dialog
      title="分配权限"
      :visible.sync="setRightDialogVisible"
      width="50%"
    >
      <span>这是一段信息</span>
      <span slot="footer" class="dialog-footer">
        <el-button @click="setRightDialogVisible = false">取 消</el-button>
        <el-button type="primary" @click="setRightDialogVisible = false"
          >确 定</el-button
        >
      </span>
    </el-dialog>

### 3.2 配置并使用el-tree树形控件 ###

使用element-ui中的`[tree树形控件](https://element.eleme.cn/#/zh-CN/component/tree)`来展示权限列表数据。

> 属性`show-checkbox`：节点是否可被选择  
> 属性`render-after-expand`：是否在第一次展开某个树节点后才渲染其子节点  
> 属性`node-key`: 每个树节点用来作为唯一标识的属性，整棵树应该是唯一的

<el-tree
        :data="rightsList"
        :props="treeProps"
        show-checkbox
        default-expand-all
        node-key="id"
     ></el-tree>

// 树形控件的属性绑定对象
    treeProps: { 
        children: "children",
        label: "authName",
    },

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3R0NzUyODE5MjA_size_16_color_FFFFFF_t_70 7]

### 3.3 加载当前角色已有的权限 ###

在展开角色的权限弹窗时，需要将对应的权限

*  树形控件加上`default-checked-keys`属性，展示默认选中的项

<el-dialog
      title="分配权限"
      :visible.sync="setRightDialogVisible"
      width="50%"
      @close="closeRightDialog()"
    >
      
      <el-tree
        :data="rightsList"
        :props="treeProps"
        show-checkbox
        default-expand-all
        node-key="id"
        :default-checked-keys="defKeys"
      ></el-tree>
      <span slot="footer" class="dialog-footer">
        <el-button @click="setRightDialogVisible = false">取 消</el-button>
        <el-button type="primary" @click="setRightDialogVisible = false"
          >确 定</el-button
        >
      </span>
    </el-dialog>

*  完成递归获取id的方法

// 通过递归的形式，获取角色下所有三级权限的id，并保存到 defkeys数组中
    getLeafKeys(node, arr) { 
      // 如果当前mode节点不包含children属性，则是三级节点
      if (!node.children) { 
        return arr.push(node.id);
      }
    
      node.children.forEach((item) => { 
        this.getLeafKeys(item, arr);
      });
    },

*  调用递归函数

// 展示分配权限的对话框
    async showSetRightDialog(role) { 
      // 通过接口获取所有的权限列表
      const {  data: res } = await this.$http.get("rights/tree");
      if (res.meta.status !== 200) { 
        return this.$message.error("获取权限列表失败！");
      }
      this.rightsList = res.data;
    
      // 获取该角色已有权限的id
      this.getLeafKeys(role, this.defKeys);
      this.setRightDialogVisible = true;
    },

*  关闭弹窗时清空默认展示列表

closeRightDialog() { 
      this.defKeys = [];
    },

### 3.4 调用API完成分配权限的功能 ###

*  给树形结构绑定`ref`属性，并给弹窗的确定按钮，绑定`allotRights()`方法

<el-tree
        :data="rightsList"
        :props="treeProps"
        show-checkbox
        default-expand-all
        node-key="id"
        :default-checked-keys="defKeys"
        ref="treeRef"
    ></el-tree>

*  实现`allotRights()`方法：
    
     *  通过`角色授权(roles/:roleId/rights)`接口来给用户分配相关权限。
     *  该接口的post传参需要传递`权限 ID 列表`。
     *  通过树形结构的方法`getCheckedNodes()`和`getHalfCheckedKeys()`来获取选中和半选中的权限的id。

> 知识点：  
> 1、`ref`属性：ref 被用来给DOM元素或子组件注册引用信息。引用信息会根据父组件的 $refs 对象进行注册。如果在普通的DOM元素上使用，引用信息就是元素; 如果用在子组件上，引用信息就是组件实例。（注意：只要想要在Vue中直接操作DOM元素，就必须用ref属性进行注册）  
> 2、`getCheckedKeys`：若节点可被选择（即 show-checkbox 为 true），则返回目前被选中的节点所组成的数组。  
> 3、`getHalfCheckedKeys`：若节点可被选择（即 show-checkbox 为 true），则返回目前被选中的节点的 key 所组成的数组。

// 点击为角色分配权限
    async allotRights() { 
      // 获取树形结构选中的id，并转换成字符串（给接口传参）
      const keys = [
        ...this.$refs.treeRef.getCheckedKeys(),
        ...this.$refs.treeRef.getHalfCheckedKeys(),
      ];
      const idStr = keys.join(",");
    
      // 通过接口设置该角色的属性
      const {  data: res } = await this.$http.post(
        `roles/${ this.roleId}/rights`,
        {  rids: idStr }
      );
    
      if (res.meta.status !== 200) { 
        return this.$message.error("分配权限列表失败！");
      }
    
      this.$message.success("分配权限成功");
    
      // 刷新页面数据
      this.getRolesList();
      // 关闭弹窗
      this.setRightDialogVisible = false;
    },

## 分配角色 ##

完成用户列表操作栏的分配角色的功能

*  定义变量

// 控制分配角色弹窗
    setRoleDialogVisible: false,
    // 需要被分配角色的用户信息
    userInfo: { },
    // 所有角色的数据列表
    rolesList: [],
    // 已选中的角色ID值
    selectRoleId: "",

*  分配按钮绑定`setRole`方法，实现点击后，获取角色列表信息，并且展示出来弹框

// 分配角色
    async setRole(userInfo) { 
      this.userInfo = userInfo;
    
      // 获取角色列表
      const {  data: res } = await this.$http.get("roles");
      if (res.meta.status !== 200) { 
        return this.$message.error("获取角色列表失败！");
      }
    
      this.rolesList = res.data;
    
      this.setRoleDialogVisible = true;
    },

*  完成分配角色弹窗绘制

> 知识点：  
> [select控件][select]循环展示数据

<el-dialog
      title="提示"
      :visible.sync="setRoleDialogVisible"
      width="50%"
      @close="setRoleDialogClosed()"
    >
      <div>
        <p>当前的用户：{ {  userInfo.username }}</p>
        <p>当前的角色：{ {  userInfo.role_name }}</p>
        <p>
          分配新角色：
          <el-select v-model="selectRoleId" placeholder="请选择">
            <el-option
              v-for="item in rolesList"
              :key="item.id"
              :label="item.roleName"
              :value="item.id"
            >
            </el-option>
          </el-select>
        </p>
      </div>
      <span slot="footer" class="dialog-footer">
        <el-button @click="setRoleDialogVisible = false">取 消</el-button>
        <el-button type="primary" @click="saveRoleInfo()">确 定</el-button>
      </span>
    </el-dialog>

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3R0NzUyODE5MjA_size_16_color_FFFFFF_t_70 8]

*  实现在点击分配角色弹窗的确定按钮后，设置该用户的角色

// 保存用户的角色信息
    async saveRoleInfo() { 
      if (!this.selectRoleId) { 
        return this.$message.error("请选择角色！");
      }
    
      const {  data: res } = await this.$http.put(
        `users/${ this.userInfo.id}/role`,
        { 
          rid: this.selectRoleId,
        }
      );
      if (res.meta.status !== 200) { 
        return this.$message.error("分配角色失败！");
      }
    
      this.getUserList();
      this.setRoleDialogVisible = false;
    },

*  实现关闭弹窗时，重置数据

// 监听分配角色对话框的关闭事件
    setRoleDialogClosed() { 
      this.selectRoleId = "";
      this.userInfo = { };
    },

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3R0NzUyODE5MjA_size_16_color_FFFFFF_t_70]: /images/20220829/42dc9c341a744efb8e3a6ac456e4ce3d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3R0NzUyODE5MjA_size_16_color_FFFFFF_t_70 1]: /images/20220829/d13bae3b2b6d4420b692b25311c4606c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3R0NzUyODE5MjA_size_16_color_FFFFFF_t_70 2]: /images/20220829/75cfdc1034444e1ea99dae0e71437512.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3R0NzUyODE5MjA_size_16_color_FFFFFF_t_70 3]: /images/20220829/883f0c593762456d93384204cbe5da2a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3R0NzUyODE5MjA_size_16_color_FFFFFF_t_70 4]: /images/20220829/b2bdb7a6cd264ef6aed1976f1ea78133.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3R0NzUyODE5MjA_size_16_color_FFFFFF_t_70 5]: /images/20220829/4a1d5fe98ad5404297cf3fe0e38ac98b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3R0NzUyODE5MjA_size_16_color_FFFFFF_t_70 6]: /images/20220829/7899d0774f5647b5a69801e90cb68728.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3R0NzUyODE5MjA_size_16_color_FFFFFF_t_70 7]: /images/20220829/03e2d9386986441e9338c2b23da034d1.png
[select]: https://element.eleme.cn/#/zh-CN/component/select
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3R0NzUyODE5MjA_size_16_color_FFFFFF_t_70 8]: /images/20220829/810e8cf1bab647cb9c8b8c11e787ead8.png