Skip to content

vue 全家桶+node.js 搭建简易的员工管理系统

Notifications You must be signed in to change notification settings

ChenMingK/staffSystem

Repository files navigation

staff-system

Project setup

1.把 node-server 文件夹下的建表和插入数据的 sql 语句在自己的 mysql 中执行

2.修改 node-server 文件夹下的 const.js 中的相关信息:dbUser 和 dbPwd 改为自己要连接的数据库名和密码

3.下载前端文件,修改.env.development(开发环境下的环境变量)中的 VUE_APP_BASE_URL 改为自己的 node 服务监听的 IP 和端口

4.npm run serve启动服务

or 直接将 .env.development 中的环境变量修改为 .env.production 中的,然后 npm run serve 启动服务,那么你使用的就是我的服务器提供的后台 API

⚠️ Notice

服务端的 node.js 代码中有一个明显的问题:显然对每个请求都要重新建立一次数据库连接是十分耗费资源的,这里懒得改了注意下就好......

因为这个项目中很多地方的代码都可以复用,因此稍微将代码优化了一下,当你在某个组件中或样式中发现貌似少了点什么的时候可以去以下两个文件中寻找

  • utils 文件夹:封装一些常量以及做 mixin 混入
  • global.scss:@mixin 样式

如果你想更好地了解 vue 项目的搭建过程,可以看下这里https://github.com/ChenMingK/epub-Proj

页面展示

体验地址

传送门

前端开发记录

禁止点击事件的触发

需求分析:以用户身份登录时不能允许添加、删除记录操作,需要将按钮置为灰色同时原先设置的点击事件不能触发,通过权限值(privilege)来动态绑定样式。

<div class="edit-btn"
     :class="{'btn-disabled': privilege === 0}"
     @click="showEditComponent(item)"> <!--根据权限来判断是否禁用按钮-使用动态样式-->
  <span>编辑</span>
</div>

方案1:纯 CSS 实现,给动态绑定的 class 添加一下样式

  • 鼠标悬浮到该元素上时显示禁止红圈圈cursor: not-allowed
  • 鼠标原有的事件不能实现pointer-events:none

这样做有一个问题,设置了 pointer-events 后发现 cursor 样式失效了,即鼠标悬浮在该按钮上不是禁止的样式而是默认的样式

方案2:JS 在事件处理程序中做相应判断并返回

  • 绑定的事件回调中通过event.currentTarget获取触发点击事件的节点(绑定该事件的节点),event.target是你点击的节点,其会向上冒泡到event.currentTarget
  • 获取节点后判断其类名中是否存在我们动态添加的 'btn-disabled'
showEditComponent() {
  let node = event.currentTarget // 获取触发点击事件的节点
  if (node.className.search('btn-disabled') !== -1) { // node.className 返回一个字符串包含类名
    return // 不会创建表单
  }
}

v-for 循环对象

需求分析:创建表单时,需要知道哪些信息需要编辑,对于添加一条记录来说只需要员工信息的 key,对于编辑一条记录而言不仅需要 key,还需要 value(即已有的值);显然我们需要传一个对象给表单组件,一般用 v-for 来遍历数组,那么 v-for 能不能遍历对象呢?当然可以。

<!--对象遍历:注意书写顺序,value在key之前-->
<div v-for="(value, key, index) in object" :key="key">
  {{ index }}. {{ key }} - {{ value }}
</div>
<!--数组遍历-->
<div v-for="(value, index) in array" :key="index">
  {{ value }} - {{ index }}
</div>
<!--数组对象遍历-->
<div v-for="(value, key, index) in objectArray" :key="index">
  {{ value }} - {{ index }}
</div>

vue-create-api 使用技巧(如何进行组件通信以及销毁的注意事项)

this.formComponent = this.$createForm({
  $props: {
    inputList: GATE_FORM,
    tableName: 'atendence'
  },
  $events: {
    submit: this.flushData, // 使用flushData方法作为子组件submit事件的回调
    hide: this.hideForm // 点击取消时删除组件
  }
}).show()

这段代码利用 vue-create-api 创建了一个全局组件,$events 选项可以设置响应子组件事件的回调,比如我创建一个全局的表单组件,用户往里面填写了数据后点击提交触发 $emit('submit', args),那么这个父组件就能响应这个事件。这样就可以方便地进行组件通信了。

动态组件切换及过渡效果

左侧tab的实现本来应该用前端路由来实现的,即点击不同的 tab 切换不同的路由视图;这里使用的是动态组件的方式,即切换不同的 tab 就切换 main 部分(右侧)的组件,好处是我们如果想实现过渡效果,比如淡入淡出,只需要在外层添加 transition 即可。

<transition name="fade">
  <component :is="chooseComponent(currentTab)"></component>
</transition>

vue 项目引入 Echarts

  • npm install echarts
  • main.js 添加如下代码
import echarts from 'echarts'
Vue.prototype.$echarts = echarts
  • 使用时注意将 echarts.init()' 之类的改为 this.$echarts.init(dom) new this.$echarts.graphic.LinearGradient`
  • 也有说法可以按需导入什么的

mixin 混入与写 utils 方法导入的区别

mixin 混入相比(公共方法)写在 utils 的好处是可以不用手动绑定 this 直接通过 this.xxx 调用公有方法,因为其相当于把 methods 注入了 methods 选项中,书写更为简洁

比如分页操作

paging(data) {
  let arr = []
  let pages = Math.floor(data.length / 10) + 1
  for (let i = 0; i < pages; i++) {
    arr[i] = []
    for (let j = 0; j < 10; j++) {
      if ((i === pages - 1) && (i * 10 + j === data.length)) { // 25 -> max: [2][4]
        break
      } 
      arr[i][j] = data[i * 10 + j]
    }
  }
  this.pagingList = arr
  this.allPages = arr.length + 1
}

每个组件的 data 选项都有 pagingList 和 allPages 这两个属性,使用 mixin则 直接 this.paging(data) 即可,如果写成一个方法 export 导出 import 导入就需要 paging.call(this, data)

axios 前后端交互注意事项

params 选项是携带在 URL 后面的参数,即 URL& 后面的,data 选项对于 GET 请求无效,POST 请求如果想传送一个对象给后端需要将这个对象使用 JSON.stringify 序列化,后端通过 JSON.parse 来获取这个对象(plain object)

export function insertData(table, paramObj) {
  return axios({
    method: 'post',
    url: `${process.env.VUE_APP_BASE_URL}/insert`,
    params: {
      table // 需要插入的表
    },
    data: {
      obj: JSON.stringify(paramObj) // 必须为序列化的对象? plain object?
    }
  })
}

按钮与文字配色方案记录

border-radius 3px比较好看

// 编辑按钮 黄底白字
@mixin edit-btn {
  color: white;
  width: 40%;
  height: 20px;
  background: #efbe37;
  border-radius: 3px;
  cursor: pointer;
  @include center;
  font-size: 12px;
  transition: all .2s linear;
  &:hover {
    opacity: .5;
  }
}

// 删除按钮 红底白字
@mixin delete-btn {
  color: white;
  width: 40%;
  height: 20px;
  background: #fa5555;
  border-radius: 3px;
  cursor: pointer;
  @include center;
  transition: all .2s linear;
  font-size: 12px;
  &:hover {
    opacity: .5;
  }
}

// 添加按钮 蓝底白字
@mixin add-btn {
  @include center;
  background: skyblue;
  color: white;
  width: 100px;
  border-radius: 5px;
  font-size: 14px;
  // cursor: not-allowed;
  &:hover {
    cursor: pointer;
  }
}

// 切换页数按钮 灰底白字
@mixin grey-button {
  background: gray;
  color: white;
  border-radius: 3px;
  width: 80px;
  font-size: 12px;
  height: 25px;
  @include center;
  cursor: pointer;
  transition: all .2s linear;
  &:hover {
    background: rgba(0, 0, 0, .3);
  }
}

后端开发记录

express 处理 POST 请求

需要添加处理 POST 请求的中间件

  • npm install body-parser
  • cosnt bodyParser = require('body-parser)
  • app.use(bodyParser.json())
  • app.use(bodyParser.urlencoded({extended: false}))

前端 axios 的 data 选项可以通过 req.body 来接收,params 选项可以通过 req.query 来接收

数据库操作细节问题

const sql = `SELECT * FROM user WHERE username = '${query.username}'` 
// 注意这里使用 ${} 外面要加引号,sql 语句本身视为字符串,'user1' 是要加上字符串的`

利用数据库级联操作

员工信息表中的 emp_number(员工编号)作为其他表的外键被引用,那么删除员工信息的时候就会有一个问题:由于员工信息中的员工编号是作为外键被其他表引用的,数据库会报错。 这就需要利用数据库的级联操作,我们在建表时添加 foreign key(emp_number) references information(emp_number) on delete cascade 字样,这样我们后台连接数据库执行删除员工信息的时候只需要普通地执行删除操作数据库就会自动帮我们删除其他表中引用该外键的相关记录。如果不这么做的话,可能需要先查询其他表中对应的记录全部删除后再删除本表的记录。

create table leave_t(leave_number int primary key,
                    leave_date varchar(20),
                    emp_number int,
                    leave_reason varchar(50),
                    req_date varchar(20),
                    leave_approve varchar(5),
                    foreign key(emp_number) references information(emp_number)
on delete cascade);

About

vue 全家桶+node.js 搭建简易的员工管理系统

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published