【原创】Vue 项目实战之用户管理

用户列表高亮问题

用户列表作为 home 组件的子组件，被点击时并不会高亮。
menu 组件有一个 default-active 属性，可以设置高亮链接，值为当前激活菜单的 index。

单击时高亮 && 页面刷新高亮

 <el-menu-item
              :index="'/' + child.path"
              v-for="child in menu.children"
              :key="child.id"
              @click="saveNavState('/' + child.path)"
            >

  created () {
    this.getMenuList();
    this.activePath = sessionStorage.getItem('navPath');
  }

    saveNavState (path) {
      sessionStorage.setItem('navPath', path);
      this.activePath = path;
    }

    data () {
    return {
      menuList: [],
      activePath: ''
    };

绘制用户列表页

• 加入 Card
• 单行布局，组件与组件间有空隙，可以通过栅格来实现
  可以使用 element ui 中的 Layout 中的 el-row el-col

  <el-row :gutter="20">
      <el-col :span="8"
        ><el-input placeholder="请输入内容">
          <el-button
            slot="append"
            icon="el-icon-search"
          ></el-button> </el-input
      ></el-col>
      <el-col :span="6"
        ><el-button type="primary">添加用户</el-button></el-col
      >
    </el-row>

  其中 :gutter="20" 是组件间的间隔大小，栅格系统一行是 24 份。

获取用户数据并渲染表格

export default {
  created () {
    this.getUserList();
  },
  data () {
    return {
      userList: [],
      total: 0,
      params: {
        query: '',
        pagenum: 1,
        pagesize: 2
      }
    };
  },
  methods: {
    async getUserList () {
      const { data: res } = await this.$http.get('/users', { params: this.params });
      if (res.meta.status !== 200) return this.$message.error(res.error);
      this.userList = res.data.users;
      this.total = res.data.total;
    }
  }
}

  <el-table :data="userList" stripe border style="width: 100%">
        <el-table-column
          prop="username"
          label="姓名"
          width="180"
        ></el-table-column>
        <el-table-column
          prop="email"
          label="邮箱"
          width="180"
        ></el-table-column>
        <el-table-column prop="mobile" label="地址"> </el-table-column>
        <el-table-column prop="role_name" label="角色"> </el-table-column>
        <el-table-column prop="mg_state" label="状态"> </el-table-column>
        <el-table-column label="操作"> </el-table-column>
      </el-table>

配置索引列

<el-table-column type="index" label="索引列"> </el-table-column>

作用域插槽

在 table 表格中，展示状态开关，数据用到了作用域插槽。

<template slot-scope="scope">

其中 scope.row 代表一行数据，scope.row.username 代表其中的用户名字段。

绘制 编辑 删除 分配角色 按钮

<el-table-column label="操作" width="180">
          <template slot-scope="scope">
            <el-button
              type="primary"
              icon="el-icon-edit"
              size="mini"
            ></el-button>
            <el-button
              type="danger"
              icon="el-icon-delete"
              size="mini"
            ></el-button>
            <el-tooltip
              class="item"
              effect="dark"
              content="分配角色"
              placement="top"
              :enterable="false"
            >
              <el-button
                type="warning"
                icon="el-icon-setting"
                size="mini"
              ></el-button>
            </el-tooltip>
          </template>
        </el-table-column>

此处，分配角色按钮上方有一个提示文字信息，这里使用了 tooltip 组件。而按钮大小可以使用 button 组件的 size 属性设置，mini 为小图标。

分页

 <el-pagination
          @size-change="handleSizeChange"
          @current-change="handleCurrentChange"
          :current-page="userParams.pagenum"
          :page-sizes="[1, 2, 5, 10]"
          :page-size="userParams.pagesize"
          layout="total, sizes, prev, pager, next, jumper"
          :total="total"
        >
</el-pagination>

  handleSizeChange (newSize) {
      this.userParams.pagesize = newSize;
      this.getUserList();
    },
    handleCurrentChange (newPage) {
      this.userParams.pagenum = newPage;
      this.getUserList();
    }

更新用户状态（PUT 接口）

  async changeState (userId, state) {
      const { data: res } = await this.$http.put(`users/${userId}/state/${state}`);
      if (res.meta.status !== 200) return this.$message.error(res.error);
      this.$message.success('用户状态更新成功');
    }

        <el-switch
              v-model="scope.row.mg_state"
              @change="changeState(scope.row.id, scope.row.mg_state)"
            >
            </el-switch>

用户搜索

加入可清除（关键字）的 input 框，在关键字清除时显示所有用户列表。

<el-input
            placeholder="请输入内容"
            v-model="userParams.query"
            @clear="getUserList"
            clearable
          >

userParams.query 是接口中的关键字字段，clear 事件是清除关键字触发的事件。

用户增删改

        <el-col :span="4"
          ><el-button type="primary" @click="dialogFormVisible = true"
            >添加用户</el-button
          ></el-col
        >
         <!-- 添加用户的对话框 -->
    <el-dialog
      title="添加用户"
      :visible.sync="dialogFormVisible"
      @close="closeForm('userForm')"
      width="50%"
    >
      <el-form
        :model="userForm"
        :rules="rules"
        ref="userForm"
        label-width="70px"
      >
        <el-form-item label="用户名" prop="username">
          <el-input v-model="userForm.username" autocomplete="off"></el-input>
        </el-form-item>
        <el-form-item label="密码" prop="password">
          <el-input
            type="password"
            v-model="userForm.password"
            autocomplete="off"
          ></el-input>
        </el-form-item>
        <el-form-item label="邮箱" prop="email">
          <el-input v-model="userForm.email" autocomplete="off"></el-input>
        </el-form-item>
        <el-form-item label="手机" prop="mobile">
          <el-input v-model="userForm.mobile" autocomplete="off"></el-input>
        </el-form-item>
      </el-form>
      <div slot="footer" class="dialog-footer">
        <el-button @click="dialogFormVisible = false">取 消</el-button>
        <el-button type="primary" @click="addSubmit">确 定</el-button>
      </div>
    </el-dialog>

    <!-- 用户编辑对话框 -->
    <el-dialog
      title="编辑用户"
      :visible.sync="dialogEditFormVisible"
      @close="closeForm('userEditForm')"
      width="50%"
    >
      <el-form
        :model="userEditForm"
        :rules="userEditRules"
        ref="userEditForm"
        label-width="70px"
      >
        <el-form-item label="用户名" prop="username">
          <el-input
            v-model="userEditForm.username"
            disabled
            autocomplete="off"
          ></el-input>
        </el-form-item>

        <el-form-item label="邮箱" prop="email">
          <el-input v-model="userEditForm.email" autocomplete="off"></el-input>
        </el-form-item>
        <el-form-item label="手机" prop="mobile">
          <el-input v-model="userEditForm.mobile" autocomplete="off"></el-input>
        </el-form-item>
      </el-form>
      <div slot="footer" class="dialog-footer">
        <el-button @click="dialogEditFormVisible = false">取 消</el-button>
        <el-button type="primary" @click="editSubmit">确 定</el-button>
      </div>
    </el-dialog>

          <!-- 用户编辑对话框 -->
    <el-dialog
      title="编辑用户"
      :visible.sync="dialogEditFormVisible"
      @close="closeForm('userEditForm')"
      width="50%"
    >
      <el-form
        :model="userEditForm"
        :rules="userEditRules"
        ref="userEditForm"
        label-width="70px"
      >
        <el-form-item label="用户名" prop="username">
          <el-input
            v-model="userEditForm.username"
            disabled
            autocomplete="off"
          ></el-input>
        </el-form-item>

        <el-form-item label="邮箱" prop="email">
          <el-input v-model="userEditForm.email" autocomplete="off"></el-input>
        </el-form-item>
        <el-form-item label="手机" prop="mobile">
          <el-input v-model="userEditForm.mobile" autocomplete="off"></el-input>
        </el-form-item>
      </el-form>
      <div slot="footer" class="dialog-footer">
        <el-button @click="dialogEditFormVisible = false">取 消</el-button>
        <el-button type="primary" @click="editSubmit">确 定</el-button>
      </div>
    </el-dialog>

export default {
  created () {
    this.getUserList();
  },
  data () {
    // 自定义校验规则 -- 验证邮箱
    // rule:校验规则, value:校验的值, callback:回调函数
    var checkEmail = (rule, value, callback) => {
      // 验证邮箱的正则表达式
      const regEmail = /^([a-zA-Z0-9_-])+@([a-zA-Z0-9_-])+(\.[a-zA-Z0-9_-])+/;
      if (!regEmail.test(value)) callback(new Error('请输入正确的邮箱'));
      // 直接调用 callback,代表校验成功
      return callback();

    };
    // 验证手机
    var checkMobile = (rule, value, callback) => {
      // 验证手机号的正则表达式
      const regMobile = /^(0|86|17951)?(13[0-9]|15[012356789]|17[678]|18[0-9]|14[57])[0-9]{8}$/;
      if (!regMobile.test(value)) callback(new Error('请输入正确的手机号'));
      return callback();
    };
    return {
      userList: [],
      total: 0,
      userParams: {
        query: '',
        pagenum: 1,
        pagesize: 2
      },
      dialogFormVisible: false,
      dialogEditFormVisible: false,
      userForm: {
        username: '',
        password: '',
        email: '',
        mobile: '',
      },
      userEditForm: {
        username: '',
        email: '',
        mobile: '',
      },
      rules: {
        username: [
          { required: true, message: '请输入用户名', trigger: 'blur' },
          { min: 3, max: 5, message: '长度在 3 到 5 个字符', trigger: 'blur' }
        ],
        password: [
          { required: true, message: '请输入密码', trigger: 'change' }
        ],
        email: [
          { required: true, message: '请输入邮箱', trigger: 'blur' },
          { validator: checkEmail, trigger: 'blur' }
        ],
        mobile: [
          { required: true, message: '请输入手机号码', trigger: 'blur' },
          { validator: checkMobile, trigger: 'blur' }
        ]
      },
      userEditRules: {
        username: [
          { required: true, message: '请输入用户名', trigger: 'blur' },
          { min: 3, max: 5, message: '长度在 3 到 5 个字符', trigger: 'blur' }
        ],
        email: [
          { required: true, message: '请输入邮箱', trigger: 'blur' },
          { validator: checkEmail, trigger: 'blur' }
        ],
        mobile: [
          { required: true, message: '请输入手机号码', trigger: 'blur' },
          { validator: checkMobile, trigger: 'blur' }
        ]
      },
    };
  },
  methods: {
    async getUserList () {
      const { data: res } = await this.$http.get('/users', { params: this.userParams });
      if (res.meta.status !== 200) return this.$message.error(res.error);
      this.userList = res.data.users;
      this.total = res.data.total;
    },
    async changeState (userId, state) {
      const { data: res } = await this.$http.put(`users/${userId}/state/${state}`);
      if (res.meta.status !== 200) return this.$message.error(res.error);
      this.$message.success('用户状态更新成功');
    },
    handleSizeChange (newSize) {
      this.userParams.pagesize = newSize;
      this.getUserList();
    },
    handleCurrentChange (newPage) {
      this.userParams.pagenum = newPage;
      this.getUserList();
    },

    addSubmit () {
      this.$refs.userForm.validate(async valid => {
        if (!valid) return;
        let { data: res } = await this.$http.post('/users', this.userForm);
        if (res.meta.status !== 201) return this.$message.error(res.meta.msg);
        this.$message.success('添加用户成功');
        this.dialogFormVisible = false;
        // 刷新用户列表
        this.getUserList();
      });
    },
    async showEditDialog (id) {
      const { data: res } = await this.$http.get(`/users/${id}`);
      if (res.meta.status !== 200) return this.$message.error(res.meta.msg);
      this.userEditForm = res.data;
      this.dialogEditFormVisible = true;
    },
    editSubmit () {
      this.$refs.userEditForm.validate(async valid => {
        if (!valid) return;
        console.log();
        let { data: res } = await this.$http.put(`/users/${this.userEditForm.id}`, this.userEditForm);
        if (res.meta.status !== 200) return this.$message.error(res.meta.msg);
        this.$message.success('编辑成功');
        this.dialogEditFormVisible = false;
        // 刷新用户列表
        this.getUserList();
      });
    },
 async deleteSubmit (id) {
      const confirmResult = await this.$confirm('此操作将永久删除该用户, 是否继续?', '提示', {
        confirmButtonText: '确定',
        cancelButtonText: '取消',
        type: 'warning'
      }).catch(error => error);
      if (confirmResult === 'cancel') return this.$message.info('用户取消了删除');

      const { data: res } = await this.$http.delete(`/users/${id}`);
      if (res.meta.status !== 200) return this.$message.error(res.meta.msg);
      this.$message.success('删除成功');
      // 刷新用户列表
      this.getUserList();
    },
    closeForm (formname) {
      this.$refs[formname].resetFields();
    }
  }
}

MessageBox 的使用

• 引入

import { MessageBox } from 'element-ui';
Vue.prototype.$confirm = MessageBox.confirm;

• 删除用户

async deleteSubmit (id) {
      const confirmResult = await this.$confirm('此操作将永久删除该用户, 是否继续?', '提示', {
        confirmButtonText: '确定',
        cancelButtonText: '取消',
        type: 'warning'
      }).catch(error => error);
      if (confirmResult === 'cancel') return this.$message.info('用户取消了删除');

      let { data: res } = await this.$http.delete(`/users/${id}`);
      if (res.meta.status !== 200) return this.$message.error(res.meta.msg);
      this.$message.success('删除成功');
      // 刷新用户列表
      this.getUserList();
    }