地址：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里面的样式我不说了。最外层的样式是下面这样
{
width: 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项目实战（三，配置功能操作页和组件的按需加载）