人力资源管理后台 === 左树右表

1.角色管理-编辑角色-进入行内编辑

获取数据之后针对每个数据定义标识-使用$set-代码位置(src/views/role/index.vue)

 // 针对每一行数据添加一个编辑标记
      this.list.forEach(item => {
        // item.isEdit = false // 添加一个属性 初始值为false
        // 数据响应式的问题  数据变化 视图更新
        // 添加的动态属性 不具备响应式特点
        // this.$set(目标对象, 属性名称, 初始值) 可以针对目标对象 添加的属性 添加响应式
        this.$set(item, 'isEdit', false)
      })

为什么不使用item.isEdit = false , 因为动态添加的属性不具备响应式的特点，如果想要具备响应式，可以使用$set

点击编辑时，将当前行的标记isEdit设置为true-代码位置(src/views/role/index.vue)

<el-table-column align="center" label="操作">
    <template>
        <!-- 非编辑状态 -->
        <el-button size="mini" type="text">分配权限</el-button>
        <el-button size="mini" type="text" @click="btnEditRow(row)">编辑</el-button>
        <el-button size="mini" type="text">删除</el-button>
    </template>
</el-table-column>

点击编辑的方法-代码位置(src/views/role/index.vue)

    // 点击编辑行
    btnEditRow(row) {
      row.isEdit = true // 改变行的编辑状态
    }

表格列中根据当前的isEdit标记-渲染结构-代码位置(src/views/role/index.vue)

<el-table-column prop="name" align="center" width="200" label="角色">
      <template v-slot="{ row }">
        <!-- 条件判断 -->
        <el-input v-if="row.isEdit" size="mini" />
        <span v-else>{{ row.name }}</span>
      </template>
</el-table-column>
<el-table-column prop="state" align="center" width="200" label="启用">
          <!-- 自定义列结构 -->
    <template v-slot="{ row }">
        <el-switch v-if="row.isEdit" />
        <span v-else>  {{ row.state === 1 ? "已启用" : row.state === 0 ? "未启用" : "无" }} </span>
    </template>
</el-table-column>
<el-table-column prop="description" align="center" label="描述">
     <template v-slot="{ row }">
            <el-input v-if="row.isEdit" type="textarea" />
            <span v-else>{{ row.description }}</span>
      </template>
</el-table-column>
 <el-table-column align="center" label="操作">
    <template v-slot="{ row }">
        <template v-if="row.isEdit">
            <!-- 编辑状态 -->
            <el-button type="primary" size="mini">确定</el-button>
            <el-button size="mini">取消</el-button>
        </template>
        <template v-else>
              <!-- 非编辑状态 -->
            <el-button size="mini" type="text">分配权限</el-button>
            <el-button size="mini" type="text" @click="btnEditRow(row)">编辑</el-button>
            <el-button size="mini" type="text">删除</el-button>
        </template>
    </template>
</el-table-column>

$set的应用

this.$set(目标对象, 属性名称, 初始值 )
等价于 Vue.set(目标对象, 属性名称, 初始值)
向响应式对象中添加一个属性，并确保这个新属性同样是响应式的，且触发视图更新。

2.角色管理-行内编辑-数据缓存

为什么要做数据缓存？

答：因为编辑时，可以取消会滚到之前的状态，所以编辑时的数据是临时的数据。

如图，editRow的数据是针对当前行的数据做了一份拷贝，针对这个拷贝，我们可以随意修改。

初始化时缓存数据-代码位置(src/views/role/index.vue)

    this.list.forEach(item => {
        // item.isEdit = false // 添加一个属性 初始值为false
        // 数据响应式的问题  数据变化 视图更新
        // 添加的动态属性 不具备响应式特点
        // this.$set(目标对象, 属性名称, 初始值) 可以针对目标对象 添加的属性 添加响应式
        this.$set(item, 'isEdit', false)
        this.$set(item, 'editRow', {
          name: item.name,
          state: item.state,
          description: item.description
        })
  })

点击编辑时更新缓存数据-代码位置(src/views/role/index.vue)

btnEditRow(row) {
      row.isEdit = true // 改变行的编辑状态
      // 更新缓存数据
      row.editRow.name = row.name
      row.editRow.state = row.state
      row.editRow.description = row.description
}

将编辑时的表单双向绑定缓存数据-代码位置(src/views/role/index.vue)

        <el-table-column prop="name" align="center" width="200" label="角色">
          <template v-slot="{ row }">
            <!-- 条件判断 -->
            <el-input v-if="row.isEdit" v-model="row.editRow.name" size="mini" />
            <span v-else>{{ row.name }}</span>
          </template>
        </el-table-column>
        <el-table-column prop="state" align="center" width="200" label="启用">
          <!-- 自定义列结构 -->
          <template v-slot="{ row }">
            <!-- 开 1 关 0 -->
            <el-switch v-if="row.isEdit" v-model="row.editRow.state" :active-value="1" :inactive-value="0" />
            <span v-else>  {{ row.state === 1 ? "已启用" : row.state === 0 ? "未启用" : "无" }} </span>
          </template>
        </el-table-column>
        <el-table-column prop="description" align="center" label="描述">
          <template v-slot="{ row }">
            <el-input v-if="row.isEdit" v-model="row.editRow.description" size="mini" type="textarea" />
            <span v-else>{{ row.description }}</span>
          </template>
        </el-table-column>

3.角色管理-编辑角色-确定取消

封装更新角色信息的API-代码位置(src/api/role.js)

/**
 * 更新角色
 * ***/

export function updateRole(data) {
  return request({
    url: `/sys/role/${data.id}`,
    method: 'put',
    data
  })
}

确定方法-代码位置(src/views/role/index.vue)

<el-button type="primary" size="mini" @click="btnEditOK(row)">确定</el-button>

// 点击确定时触发
    async  btnEditOK(row) {
      if (row.editRow.name && row.editRow.description) {
        // 下一步操作
        await updateRole({ ...row.editRow, id: row.id })
        // 更新成功
        this.$message.success('更新角色成功')
        // 更新显示数据  退出编辑状态
        // row.name = row.editRow.name // eslint的一校验 误判
        // Object.assign(target, source)
        Object.assign(row, {
          ...row.editRow,
          isEdit: false // 退出编辑模式
        }) // 规避eslint的误判
      } else {
        this.$message.warning('角色和描述不能为空')
      }
    }

注意：这里既然更新成功了，要把缓存数据回显到页面上，并且关闭编辑模式

取消方法-代码位置(src/views/role/index.vue)

<el-button size="mini" @click="row.isEdit = false">取消</el-button>

4.角色管理-删除角色

封装删除角色的API-代码位置(src/api/role.js)

/** *
 * 删除角色
 * **/

export function delRole(id) {
  return request({
    url: `/sys/role/${id}`,
    method: 'delete'
  })
}

在删除位置加入气泡框-代码位置(src/views/role/index.vue)

<el-popconfirm title="这是一段内容确定删除吗？" @onConfirm="confirmDel(row.id)" >
      <el-button slot="reference" style="margin-left:10px" size="mini" type="text">删除</el-button>
  </el-popconfirm>

注意：这里element-ui文档有点问题，el-popconfirm的确认事件是onConfirm，但是文档上写的是confirm事件，这里需要注意

删除方法-代码位置(src/views/role/index.vue)

 async  confirmDel(id) {
      await delRole(id) // 后端删除
      this.$message.success('删除角色成功')
      // 删除的如果是最后一个
      if (this.list.length === 1) this.pageParams.page--
      this.getRoleList()
}

5.员工管理-页面结构

基本的页面结构-代码位置(src/views/employee/index.vue)

<template>
  <div class="container">
    <div class="app-container">
      <div class="left">
        <el-input style="margin-bottom:10px" type="text" prefix-icon="el-icon-search" size="small" placeholder="输入员工姓名全员搜索" />
        <!-- 树形组件 -->
      </div>
      <div class="right">
        <el-row class="opeate-tools" type="flex" justify="end">
          <el-button size="mini" type="primary">添加员工</el-button>
          <el-button size="mini">excel导入</el-button>
          <el-button size="mini">excel导出</el-button>
        </el-row>
        <!-- 表格组件 -->
        <!-- 分页 -->
      </div>
    </div>
  </div>
</template>

<script>
export default {
  name: 'Employee'
}
</script>

<style lang="scss" scoped>
.app-container {
  background: #fff;
  display: flex;
  .left {
    width: 280px;
    padding: 20px;
    border-right: 1px solid #eaeef4;
  }
  .right {
    flex: 1;
    padding: 20px;
    .opeate-tools {
      margin:10px ;
    }
    .username {
      height: 30px;
      width: 30px;
      line-height: 30px;
      text-align: center;
      border-radius: 50%;
      color: #fff;
      background: #04C9BE;
      font-size: 12px;
      display:inline-block;
    }
  }
}

</style>

6.员工管理-左侧树的加载

定义树组件需要的数据-代码位置(src/views/employee/index.vue)

data() {
    return {
      depts: [], // 组织数据
      defaultProps: {
        label: 'name',
        children: 'children'
      }
    }
}

放置树形组件-代码位置(src/views/employee/index.vue)

<el-tree
          :data="depts"
          :props="defaultProps"
          default-expand-all
          :expand-on-click-node="false"
          highlight-current
  />

初始化时加载数据转化树形-代码位置(src/views/employee/index.vue)

  created() {
    this.getDepartment()
  },
  methods: {
    async getDepartment() {
      // 递归方法 将列表转化成树形
      // let result = await getDepartment()
      this.depts = transListToTreeData(await getDepartment(), 0)
    }
  }

7.员工管理-选中首个节点

在data中声明一个记录id的参数-代码位置(src/views/employee/index.vue)

data () {
  return  {
    // 存储查询参数
      queryParams: {
        departmentId: null
      }
  }
}

为什么要放在queryParams中，因为后面的查询会有很多查询条件，到时候查询条件都会聚合到一起，所以使用一个公共的对象来管理更方便和合适

初始化时首个id节点，并且选中-代码位置(src/views/employee/index.vue)

methods: {
    async getDepartment() {
      // 递归方法 将列表转化成树形
      // let result = await getDepartment()
      this.depts = transListToTreeData(await getDepartment(), 0)
      this.queryParams.departmentId = this.depts[0].id
      // 设置选中节点
      // 树组件渲染是异步的 等到更新完毕
      this.$nextTick(() => {
        // 此时意味着树渲染完毕
        this.$refs.deptTree.setCurrentKey(this.queryParams.departmentId)
      })
    }
  }

为什么使用��，因为我们设置完树形之后立刻选中首个节点，此时更新还没有完成，必须等待更新完成后，再去选中首个节点，所以需要使用nextTick，因为我们设置完树形之后立刻选中首个节点，此时更新还没有完成，必须等待更新完成后，再去选中首个节点，所以需要使用nextTick

监听树组件的节点切换事件-代码位置(src/views/employee/index.vue)

 <el-tree
          ref="deptTree"
          node-key="id"
          :data="depts"
          :props="defaultProps"
          default-expand-all
          :expand-on-click-node="false"
          highlight-current
          @current-change="selectNode"
  />

这里需要明白，需要给定node-key属性，否则setCurrentKey方法不知道设置的是哪个字段的值

切换节点时再次记录id-代码位置(src/views/employee/index.vue)

selectNode(node) {
  this.queryParams.departmentId = node.id
}

8.员工管理-员工列表结构

右侧列表页面结构-代码位置(src/views/employee/index.vue)

<el-table>
    <el-table-column align="center" label="头像" />
    <el-table-column label="姓名" />
    <el-table-column label="手机号" sortable />
    <el-table-column label="工号" sortable />
    <el-table-column label="聘用形式" />
    <el-table-column label="部门" />
    <el-table-column label="入职时间" sortable />
    <el-table-column label="操作" width="280px">
          <template>
              <el-button size="mini" type="text">查看</el-button>
              <el-button size="mini" type="text">角色</el-button>
              <el-button size="mini" type="text">删除</el-button>
          </template>
    </el-table-column>
</el-table>
<!-- 分页 -->
<el-row style="height: 60px" align="middle" type="flex" justify="end">
    <el-pagination
        layout="total,prev, pager, next"
        :total="1000"
     />
</el-row>

9.员工管理-获取员工数据

第一次加载之后或者是切换节点之后，都要去根据点击的节点去查询员工的数据

封装获取员工数据的API-代码位置(src/api/employee.js)

export function getEmployeeList(params) {
  return request({
    url: '/sys/user',
    params // 地址参数 查询参数
  })
}

声明一个list数据进行接受list-代码位置(src/views/employee/index.vue)

data () {
  return {
    list: []
  }
}

初始化后获取右侧表格数据-代码位置(src/views/employee/index.vue)

methods: {
    async getDepartment() {
      // 递归方法 将列表转化成树形
      // let result = await getDepartment()
      this.depts = transListToTreeData(await getDepartment(), 0)
      this.queryParams.departmentId = this.depts[0].id
      // 设置选中节点
      // 树组件渲染是异步的 等到更新完毕
      this.$nextTick(() => {
        // 此时意味着树渲染完毕
        this.$refs.deptTree.setCurrentKey(this.queryParams.departmentId)
      })
      // 这个时候参数 记录了id
      this.getEmployeeList()
    },
    // 获取员工列表的方法
    async getEmployeeList() {
      const { rows } = await getEmployeeList(this.queryParams)
      this.list = rows
    }
  }

切换节点时，获取右侧表格数据-代码位置(src/views/employee/index.vue)

selectNode(node) {
      this.queryParams.departmentId = node.id // 重新记录了参数
      this.getEmployeeList()
},

绑定表格-代码位置(src/views/employee/index.vue)

<el-table :data="list">
          <el-table-column prop="staffPhoto" align="center" label="头像" />
          <el-table-column prop="username" label="姓名" />
          <el-table-column prop="mobile" label="手机号" sortable />
          <el-table-column prop="workNumber" label="工号" sortable />
          <el-table-column prop="formOfEmployment" label="聘用形式" />
          <el-table-column prop="departmentName" label="部门" />
          <el-table-column prop="timeOfEntry" label="入职时间" sortable />
          ...
</el-table>

10.员工管理-头像和聘用形式的处理

头像的设置-代码位置(src/views/employee/index.vue)

 <el-table-column prop="staffPhoto" align="center" label="头像">
      <template v-slot="{ row }">
          <el-avatar v-if="row.staffPhoto" :src="row.staffPhoto" :size="30" />
          <span v-else class="username">{{ row.username?.charAt(0) }}</span>
      </template>
</el-table-column>

聘用形式的处理-代码位置(src/views/employee/index.vue)

<el-table-column prop="formOfEmployment" label="聘用形式">
    <template v-slot="{ row }">
        <span v-if="row.formOfEmployment === 1">正式</span>
        <span v-else-if="row.formOfEmployment === 2">非正式</span>
        <span v-else>无</span>
    </template>
</el-table-column>

11.员工管理-员工分页处理

定义分页参数-代码位置(src/views/employee/index.vue)

data () {
  return {
    queryParams: {
        departmentId: null,
        page: 1, // 当前页码
        pagesize: 10
      },
      total: 0, // 记录员工的总数
  }
}

绑定分页参数-代码位置(src/views/employee/index.vue)

<el-pagination
            layout="total,prev, pager, next"
            :total="total"
            :current-page="queryParams.page"
            :page-size="queryParams.pagesize"
            @current-change="changePage"
  />

切换页码事件-代码位置(src/views/employee/index.vue)

// 切换页码
    changePage(newPage) {
      this.queryParams.page = newPage // 赋值新页码
      this.getEmployeeList() // 查询数据
    }

切换部门时，查询第一页数据-代码位置(src/views/employee/index.vue)

selectNode(node) {
      this.queryParams.departmentId = node.id // 重新记录了参数
      this.queryParams.page = 1 // 设置第一页
      this.getEmployeeList()
},

设置ElementUI的语言为中文-代码位置(src/main.js)

Vue.use(ElementUI)

12.员工管理-员工模糊搜索

设置模糊搜索的参数字段-代码位置(src/views/employee/index.vue)

data () {
  return {
    queryParams: {
        departmentId: null,
        page: 1, // 当前页码
        pagesize: 10,
        keyword: '' // 模糊搜索字段
      },
  }
}

双向绑定input输入框，监听值改变事件-代码位置(src/views/employee/index.vue)

<el-input
          v-model="queryParams.keyword"
          style="margin-bottom:10px"
          type="text"
          prefix-icon="el-icon-search"
          size="small"
          placeholder="输入员工姓名全员搜索"
          @input="changeValue"
/>

这里监听的事件是input，有同学可能会问，为什么不用change事件，注意change事件是离开焦点触发，input是只要内容发生变化就会触发，所以这里使用input更符合使用场景

值改变查询数据-支持防抖查询-代码位置(src/views/employee/index.vue)

 changeValue() {
      // 单位时间内只执行最后一次
      // this的实例上赋值了一个timer的属性
      clearTimeout(this.timer) // 清理上一次的定时器
      this.timer = setTimeout(() => {
        this.queryParams.page = 1
        this.getEmployeeList()
      }, 300)
}