地址：https://segmentfault.com/a/1190000010063757
1.前言
今天要做的，就是在上一篇文章的基础上，进行功能页面的开发。简单点说呢，就是与后端的数据交互和怎么把数据展示出来，用到的资源主要是element-ui和vue-resource，其它参考（vue-resource插件使用）。今天讲到的一些功能开发，主要就是请求列表数据，详情数据，分页功能操作，搜索，搜索标签等的开发。今天这个，按照下面步骤，一步一步来。一个一个功能的做！
2.数据接口
我以‘回款管理’(cashList.vue)为开发的demo，下文讲到的各种增删改查都是在这个文件上操作，大家注意喔！这虽然是做5个功能，其实就只有两个接口。（按照我开发项目，后端提供的接口说明）
2-1分析接口
下面分析下我们公司后端给我提供的其中两个接口。而且两个接口都是get请求。
let http_url={
list:'http://xxx.xxx.com/xxx/cash/list',
detail:'http://xxx.xxx.com/xxx/cash/detail'
}
/**
http_url.list接口接受参数
ordId //String，订单号
cashId //String.回款编号
custoName //String，客户名称，模糊查询 cashType //int，回款类型 cashStatus //int，回款状态 userName//String，采购人，模糊查询 userMobile //String，采购人电话，模糊查询 //上面是搜索查询的字段，下面是数据的页码和每页的条数 pogeNo //int，页码(必填) pageSize //int，每页显示条数(必填) http_url.detail接口接受参数（按照我开发项目） cashId //String.回款编号(必填) **/2-2整理数据
首先，由于接口http_url.list接口可以接受一些搜索，先把整个准备了！
然后再到页码的一些东西，主要是三个，当前页码，每页条数。（自己随便设的默认值）
数据就变成了
data(){
return {
pageSize:10,//每页条数
allCount:0,//记录总数 currentPage:1,//当前页码 cashList: [], //列表数组(现在是准备请求接口，不需要模拟的数据，所以设置一个空数组) keyFrom: {....}//搜索字段 } } 大家可能不明白，同样是请求的参数，页码这些为什么要和搜索字段分开放？之所以分开放是因为页码这些，到下面分页的时候要单独使用，而且做搜索的时候，页码又不是搜索字段，所以就分开放，下面会详情的说明！
准备就准备这么多了，之后还要用到什么数据，以后再添加！
3.请求列表数据
先别急着写，大家可以想下，搜索字段那里，比如我只想根据回款ID(cashId)查询呢？
难道这样发送请求？http://xxx.xxx.com/xxx/cash/l...''&cashId=xxx&custoName=''&cashType=''&cashStatus=''&userName=''&userMobile=''
真没必要，我们想要的是这样http://xxx.xxx.com/xxx/cash/l...
所以，请求之前，先写一个方法，就是过滤搜索字段（keyFrom）里面，值为空的属性。
/**
* 清除对象中值为空的属性
*/
filterParams(obj){
let _form = obj, _newPar = {}, testStr;
//遍历对象
for (let key in _form) { testStr = null; //如果属性的值不为空。 //注意，不要这样判断if (_form[key])。因为有些属性的值可能为0，到时候就会被过滤掉 if (_form[key] !== null && _form[key] !== "") { //把值添加进新对象里面 _newPar[key]=_form[key].toString() } } //返回对象 return _newPar; } 3-1请求列表数据
getList(){
//过滤搜索字段值为空的属性，然后对象合并，合并上页码。
let _par = Object.assign(this.filterParams(this.keyFrom), {
pageNo: this.currentPage,
pageSize: this.pageSize }); this.$http.get(http_url.list, { params: _par }).then(function (res) { }); } 3-2写完之后，在mounted运行这方法。
mounted(){
this.getList();
},
为了能更直观看到结果，我在浏览器直接打开这个接口
需要的有的字段都有了
那么接下来就接收返回的字段
getList(){
//过滤搜索字段值为空的属性，然后对象合并，合并上页码。
let _par = Object.assign(this.filterParams(this.keyFrom), {
pageNo: this.currentPage,
pageSize: this.pageSize }); this.$http.get(http_url.list, { params: _par }).then(function (res) { res=res.body; //如果请求成功了，这接口code为0代表请求成功。具体怎样判断还需要看接口 if(res.code===0){ //设置列表数据 this.cashList = res.datas.entityList; } else{ this.$message.error(res.msg); } }); }3-3在html页面铺数据
怎么铺，随机应变呗！
来到el-table这个标签这里。不知道排版布局的话，参考上一篇文章喔！不要不知道我在说什么！
然后开始写<el-table-column></el-table-column>
下面简单写几个栗子
3-3-1回款id
点击回款id,会出来详情页面（详情页面的方法getDetail我们到下面写，现在）
<el-table-column label="编号" width="180"> <template scope="scope"> <a href="javascript:;">{{scope.row.cashId}}</a> </template> </el-table-column> 3-3-2订单id
订单id只需要显示，就简单了
<el-table-column label="订单编号" width="160"> <template scope="scope"> <span>{{ scope.row.ordId }}</span> </template> </el-table-column>3-3-3回款时间
回款时间需要把时间戳转成yyyy-mm-dd hh:mm:ss
<el-table-column label="回款时间" min-width="180"> <template scope="scope"> <span>{{new Date(scope.row.cashDate).toLocaleDateString().replace(/\//g, '-')}} {{new Date(scope.row.cashDate).toTimeString().split(' ')[0]}}</span> </div> </template> </el-table-column> 3-3-4回款状态
回款状态需要把状态码转换成文字
<el-table-column>
<template scope="scope"> <span v-if="scope.row.cashStatus === 0">待回款</span> <span v-if="scope.row.cashStatus === 1">部分回款</span> <span v-if="scope.row.cashStatus === 2" style="color: green">已回款</span> <span v-if="scope.row.cashStatus === 3" style="color: red">已取消</span> </template> </el-table-column>3-3-5回款金额
金额在数据库以分为单位，现在需要转换成元
<el-table-column label="回款金额(元)" width="150"> <template scope="scope"> <span>{{ (scope.row.cashAmount / 100).toFixed(2) }}</span> </template> </el-table-column> 3-3-6细节优化
好了，典型的几种数据，以及处理的方法，就是在这里了。当然这个只是做展示作用，怎么展示是看项目的需求的！
小伙伴们运行起来的时候，可能会发现两个问题。
1.比如网速比较慢的时候，请求没完成的时候，就会看到这个（这个提醒是element-ui提供的，只要发现cashList是空的，就会出现这个提醒）
如果我们想体验好一点，做一个提示加载中的提示呢
这个简单的。首先在el-table上，设置v-loading="loading"。
然后在data设置loading这个属性
然后就是在请求那里
进入方法的时候，设置loading=true，请求完了再设置成false。（当loading=true时，加载中的提示就会出现。
getList(){
//显示加载中提示
this.loading=true;
//过滤搜索字段值为空的属性，然后对象合并，合并上页码。
let _par = Object.assign(this.filterParams(this.keyFrom), { pageNo: this.currentPage, pageSize: this.pageSize }); this.$http.get(http_url.list, { params: _par }).then(function (res) { res=res.body; //如果请求成功了，这接口code为0代表请求成功。具体怎样判断还需要看接口 if(res.code===0){ //设置列表数据 this.cashList = res.datas.entityList; //关闭加载中提示 this.loading=false; } else{ this.$message.error(res.msg); } }); } 2.再有就是，如果展示的数据，有些是空的字符串，或者是null的话，在列表上就会看到。
这样提示不太友好，因为只显示空白一片，用的人可能不知道怎么回事。这时候加个判断，如果某一个属性的值，为空字符串或者null,就替换成‘--’。
getList(){
//显示加载中提示
this.loading=true;
//过滤搜索字段值为空的属性，然后对象合并，合并上页码。
let _par = Object.assign(this.filterParams(this.keyFrom), { pageNo: this.currentPage, pageSize: this.pageSize }); this.$http.get(http_url.list, { params: _par }).then(function (res) { res=res.body; //如果请求成功了，这接口code为0代表请求成功。具体怎样判断还需要看接口 if(res.code===0){ //设置列表数据 this.cashList = res.datas.entityList; this.cashList.map(function (value) { for (let key in value) { //不要if(value[key])判断，有的值可能是0，会把0过滤 if (value[key] === null || value[key] === '') { value[key] = '--' } } }); //关闭加载中提示 this.loading=false; } else{ this.$message.error(res.msg); } }); }然后我们就会看到这样的结果，就明确的说明了，这里的值为空
4.请求详情数据
详情的数据，就是点击列表的任何一条数据，出来一个详情页面。
先在浏览器请求一下（看下有身什么字段，可以方便在html里面铺数据），看到有很多字段。
详情的html
现在项目上，用的是这个效果，我们现在也用这个吧！
代码如下，castInfo是在data声明的的变量，作用是储存请求回来的字段，包含字段如上图！
<!-- 详情弹窗 -->
<div class="cash-content-box" v-if="contentShow" :class="{'show-box':contentClass}"> <div class="cash-main"> <p class="content-close"><a href="javascript:;" @click="hideContentDo">X</a></p> <div class="content-top"> <h2>回款金额：{{(castInfo.cashAmount / 100).toFixed(2)}}元</h2> <p> 回款编号：{{castInfo.cashId}}<span>|</span>回款日期：{{new Date(castInfo.cashDate).toLocaleDateString().replace(/\//g, '-') }}</p> </div> <div class="content-type"> <ul class="flli"> <li v-if="castInfo.cashStatus===0">回款状态：待回款</li> <li v-else-if="castInfo.cashStatus===1">回款状态：部分回款</li> <li v-else-if="castInfo.cashStatus===3">回款状态：已取消</li> <li v-else>回款状态：已回款</li> </ul> <div class="clear"></div> </div> <div class="content-tab"> <ul class="flli"> <li class="cur">概要</li> </ul> <div class="clear"></div> </div> <div class="content-info"> <h3 class="content-title">基本信息</h3> <table class="content-table"> <tr> <td>回款编号</td> <td><span>{{castInfo.cashId}}</span></td> </tr> <tr> <td>回款金额</td> <td>{{(castInfo.cashAmount / 100).toFixed(2)}}元</td> </tr> <tr> <td>账户类型</td> <td v-if="castInfo.cashAccountType"> {{castInfo.cashAccountType===1?'公账':'其他账户'}} </td> <td v-else-if="castInfo.cashAccountType===0">其他账户</td> <td v-else>--</td> </tr> <tr> <td>回款类型</td> <td v-if="castInfo.cashType===0">立即回款</td> <td v-if="castInfo.cashType===1">定期回款</td> <td v-if="castInfo.cashType === '--'">--</td> </tr> <tr> <td>回款日期</td> <td>{{new Date(castInfo.cashDate).toLocaleDateString().replace(/\//g, '-') }}</td> </tr> <tr> <td>回款状态</td> <td v-if="castInfo.cashStatus===0">待回款</td> <td v-if="castInfo.cashStatus===1">部分回款</td> <td v-if="castInfo.cashStatus===2">已回款</td> <td v-if="castInfo.cashStatus===3">已取消</td> <td v-if="castInfo.cashStatus === '--'">--</td> </tr> <tr> <td>回款渠道</td> <td v-if="castInfo.payChannel === 'zfb'">支付宝</td> <td v-if="castInfo.payChannel === 'wx_pay'">微信支付</td> <td v-if="castInfo.payChannel === 'bank_trans'">银行转账</td> <td v-if="castInfo.payChannel === 'easy_pay'">苏宁易付宝</td> <td v-if="castInfo.payChannel === 'yi_ji_fu'">易极付</td> <td v-if="castInfo.payChannel === 'ljl_pay'">蓝金灵支付</td> <td v-if="castInfo.payChannel === '--'">--</td> </tr> <tr> <td>备注</td> <td>{{castInfo.remark}}</td> </tr> </table> </div> </div> </div> <!--遮罩层--> <div class="cash-content" v-show="contentShow" @click="hideContentDo"></div> 遮罩层和详情div里面的样式我不说了。最外层的样式是下面这样
{
700px;
z-index: 1006; position: fixed; top: 0; right: 0; transform: translate3d(700px, 0, 0); height: 100%; background: #535968; transition: transform 1s; } transform: translate3d(700px, 0, 0);是为了一开始吧它隐藏起来，相信大家都看得懂！怎么让它显示出来呢，把样式改成transform: translate3d(0, 0, 0);这个就行了，动画效果自动会有，因为加了transition: transform 1s;。
请求详情的方法
getDetali: function (id) {
//contentShow控制详情页和遮罩层的显示，contentClass控制详情页的动画，castInfo为记录请求回来的数据。大家要在data上面声明哦！ //也是同样的处理方式，区别就是this.$loading是element提供的全局组件，效果就是整个屏幕显示加载中。 let loadingContent = this.$loading({ text: '正在加载中...' }); //显示详情 this.$http.get(http_url.detail, { params: { cashId: id } }).then(function (res) { res = res.body; if (res.code === 0) { this.castInfo = res.datas.castInfo; //关闭加载中提示 loadingContent.close(); //显示详情的div this.contentShow = true; //为了确保看到动画效果，所以让遮罩层和详情的DIV先显示，再执行this.contentClass = true;让详情DIV从右至左的出现 setTimeout(() => { this.contentClass = true; }) } else { this.$message.error(res.msg); } }); } 隐藏详情
既然是详情，又出现，就有隐藏
/**
* @description 隐藏详情
*/
hideContentDo(){
//先执行this.contentClass = false。让详情DIV从左至右回去，等回去了之后，再执行this.contentShow = false;在隐藏div,否则会看不到动画效果。设置的时间，就是当时动画的时间！transition: transform 1s this.contentClass = false; setTimeout(() => { this.contentShow = false; }, 1000) },5.分页
分页这个功能，大家可能都接触过，写得也是很复杂。但是今天用了element-ui提供的分页组件，就简单多了！
引入分页组件
在.cash-table这个DIV下面，直接引入下面的代码
<div class="cash-page">
<el-pagination @current-change="handleCurrentChange" :page-size="pageSize" :current-page="currentPage" layout="total, prev, pager, next, jumper" :total="allCount"> </el-pagination> </div>handleCurrentChange这个方法待会写，allCount，pageSize，currentPage这三个变量，都是之前已经声明了的，大家往上翻下就知道了！参数大家看官网-分页
编写分页方法
/**
* @description 分页处理
* @param val
*/
handleCurrentChange(val) {
//val是组件的返回值，返回当前是第几页 //然后把值赋值给currentPage。 this.currentPage = val; //然后再次调用getList。更新cashList this.getList(); }这个的代码看着很简单。大家可能会不太理解原理。下面我简单分析下。
1.首先执行this.currentPage = val;获取当前是第几页，比如我点击第二页。this.currentPage的值就是2。
2.然后执行this.getList();。这个时候，在方法里面。
相当于发送了这个请求http://xxx.xxx.com/xxx/cash/l...
然后在执行下去，cashList这个数组就更新了。我们分页就开发完了。
6.搜索功能
搜索功能这个太常见了，我现在做的项目，搜索需求就是。
然后输入再点击
交互很容易理解。就是输入，然后再输出结果，如上图，我在回款ID下面的文本框输入‘M2017070400060002’。然后点击搜索。就会出现输出结果。
下面，我们一步步来
6-1点击
，出现搜索框。
6-1-1，找到这个按钮，在这个按钮上绑定一个方法
6-1-2.编写filterSearch这个方法，代码如下
/**
* 显示与隐藏搜索
*/
filterSearch(){
//filterModel小伙伴们要在data上声明哦，初始值为false。这个值是记录当前是不是要显示搜索框，进行搜索的。
//当前是否需要搜索状态
if (this.filterModel) { this.cashList.splice(0, 1); } else { this.cashList.unshift({ "cashId": "#", }) } //显示或隐藏搜索 this.filterModel = !this.filterModel; }6-1-3.列表的改造
首先，清楚一个。后端返回的数据（如上图），并不是所有的字段都是可以进行搜索的字段。只有这几个字段（如下图），才可以进行搜索。
所以，这里我分三种请况。
一种情况是，比如回款编号，可以进行搜索的字段。
//修改前
<el-table-column label="回款编号" width="200"> <template scope="scope"> <span>{{ scope.row.cashId }}</span> </template> </el-table-column> //修改后
<el-table-column label="回款编号" width="180">
<template scope="scope"> <el-input v-if="scope.row.cashId=='#'" size="small" v-model="keyFrom.cashId" placeholder="请输入内容"> <el-button slot="append" icon="search"></el-button> </el-input> <a href="javascript:;" @click="getDetali(scope.row.cashId)" v-else>{{scope.row.cashId}}</a> </template> </el-table-column> 第二种情况是，比如回款状态，可以进行搜索的字段。但是是下拉搜索的
//修改前
<el-table-column label="回款状态" width="200"> <template scope="scope"> <span v-if="scope.row.cashStatus === 0" class="color-red">待回款</span> <span v-if="scope.row.cashStatus === 1">部分回款</span> <span v-if="scope.row.cashStatus === 2" class="color-green">已回款</span> <span v-if="scope.row.cashStatus === 3" style="color: red">已取消</span> </template> </el-table-column> //修改后 <el-table-column label="回款状态" width="100"> <template scope="scope"> <el-select v-model="keyFrom.cashStatus" size="small" placeholder="请选择" v-if="scope.row.cashId=='#'" @change="search" :disabled="pageStatus!==null"> <el-option value="" label="全选"></el-option> <el-option value="0" label="待回款"></el-option> <el-option value="1" label="部分回款"></el-option> <el-option value="2" label="已回款"></el-option> <el-option value="3" label="已取消"></el-option> </el-select> <div v-else> <span v-if="scope.row.cashStatus === 0" class="color-red">待回款</span> <span v-if="scope.row.cashStatus === 1">部分回款</span> <span v-if="scope.row.cashStatus === 2" class="color-green">已回款</span> <span v-if="scope.row.cashStatus === 3" style="color: red">已取消</span> </div> </template> </el-table-column> 另一种情况是，比如回款流水号，不可以进行搜索的字段。修改情况是
//修改前
<el-table-column label="回款流水号" width="150"> <template scope="scope"> <span>{{scope.row.payNo}}</span> </template> </el-table-column> //修改后 <el-table-column label="回款流水号" width="150"> <template scope="scope"> <span v-if="scope.row.cashId!='#'">{{scope.row.payNo}}</span> </template> </el-table-column> 6-1-4流程说明
下面，我简单说明下执行的流程。
1.filterModel这个值，一开始设为false。
2.点击按钮，执行filterSearch，由于filterModel=false；所以最后执行this.cashList.unshift({"cashId": "#"})。
3.this.cashList这个数组，前面就添加了{"cashId": "#"}。
点击前
点击后
4.this.cashList第一条就变成了{"cashId": "#"}，表格在遍历到第一条的时候el-table-column里面，由于**v-if**的关系。排版就改变了！这就是数据驱动的魅力！
是搜索字段的第一行就变成了文本框
不是搜索字段的第一行就变成了空白的
5.交互就实现了！但是有一点要注意，就是搜索框v-model的值一定要绑定正确！
6-2实现搜索功能
6-2-1.首先，在每个按钮里面，都绑定一个点击事件，绑定search方法，用来启动搜索！
这个按钮，大季家都知道是哪个吧！就是这里
6-2-2.然后，编写search方法
/**
* 开始搜索
*/
search(){
this.getList();
},
没看错，就是这一行，代码，因为每一个文本框v-model了keyFrom相对应的值。所以，只要在文本输入，keyFrom对应的值自动改！然后执行getList，keyFrom中，只要不是空字符或者null。就不会被过滤！这样就相当于执行http://xxx.xxx.com/xxx/cash/l...的请求。至于为什么要令写一个方法，不直接绑定getList呢，因为这里还要触发下面的搜索标签。接下来会下面要说的！
6-3实现重置搜索功能
看了搜搜索之后，我想大家都知道重置搜索怎么做了！就是先把keyFrom搜索的属性的值清空，再执行getList。
/**
* @description 重置筛选条件
*/
resetSearch(){
for (let key in this.keyFrom) { this.keyFrom[key] = null } this.getList(); } 7.搜索标签
搜索标签，在很多地方都会见到过，就是给用户看到，执行了什么条件的搜索。
下面就实现下这个功能！
7-1.编写方法
先实现，这个方法，这个方法，我想大家也已经知道了，就是遍历keyFrom，然后把属性和值遍历道一个数组里面，最后在html里面v-for循环一下！
7-2-1添加标签
addTags(){
//tagsArr就是存放筛选标签的数组，大家要在data里面设置哦，初始值为[];
let _this = this,_label,_value; //用一个变量，获取清空keyFrom里面值为空的属性！ let _params = Object.assign(this.filterParams(this.keyFrom); //用一个变量，获取_params属性的集合！ let _paramKeys = Object.keys(_params); //先清空tagsArr, this.tagsArr = []; _paramKeys.forEach((val) => { //根据val,设置_label标签名 swicth(val){ case 'cashId':_label='回款编号';break; case 'ordId':_label='订单编号';break; case 'custoName':_label='客户名称';break; case 'cashType':_label='回款类型';break; case 'cashStatus':_label='回款状态';break; case 'userName':_label='采购人';break; case 'userMobile':_label='采购人电话';break; } //然后上面有提到到，比如回款状态，这个的值是下拉搜索的。传过来的值是状态码，并不是文字。我们主要手动把状态码转译成文字 //比如状态吗是0，我们需要转成‘待回款’ //如果val等于cashStatus，就是回款状态，我们需要转译 if (_key === 'cashStatus') { //判断状态码 switch (_keyFrom3[_key]) { case '0': _value = "待回款"; break; case '1': _value = "部分回款"; break; case '2': _value = "已回款"; break; case '2': _value = "已取消"; break; } } //tagsArr添加元素！ //_value如果为真，就代表是把状态码转成文字的，就添加_value，否则就直接添加_params[val] _this.tagsArr.push({ key: val, label: _label, value: _value||_params[val] }); }); },这个方法什么时候触发呢，就是在搜索和重置搜索的时候触发 。这也解释了为什么搜索要令写一个方法！
search(){
this.getList();
this.addTags();
},
resetSearch(){
for (let key in this.keyFrom) { this.keyFrom[key] = null } this.getList(); this.addTags(); }但是大家应该还有注意到一个，就是比如‘回款状态’，是下拉搜索的，所以，在下拉框，就要绑定search方法。
7-2-2html页面遍历
然后在html页面遍历这个tagsArr。
7-2-3删除标签
眼尖的小伙伴又发现了，tagClose这个方法对吧！
接下来就实现这个！
tagClose(key, _index){
//根据下标，鼠标tagsArr数组某一项
this.tagsArr.splice(_index, 1);
//根据key，把keyFrom某一项设为空值
this.keyFrom[key] = null; //重新请求，更新cashList this.getList(); }8.未完待续
好了，今天就到这里了，这篇文章也写了将近10个小时了！如果你有耐心读到这里，你也是很有耐心的勇士！当然，当面的代码和交互还是有细节是需要优化的，这个就比较简单，小伙伴们，随机应变下就知道怎么做了！也写累了！不想说太多了！下一篇文章，预热就是利用监听路由(vue-router)。来实现同一个页面，不同状态的处理。就比如：同样是回款管理，我要求新建一个待回款的页面，但是这个页面只有待回款的数据。回款状态也不能修改！这个小伙伴们也可以试着做下，怎么实现。这个相对简单！
9.往期占坑
webpack+vue项目实战（一,搭建运行环境和相关配置）
webpack+vue项目实战（二，开发管理系统主页面）
webpack+vue项目实战（三，配置功能操作页和组件的按需加载）
