地址: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项目实战(三,配置功能操作页和组件的按需加载)
发布者:全栈程序员-用户IM,转载请注明出处:https://javaforall.cn/113800.html原文链接:https://javaforall.cn
【正版授权,激活自己账号】: Jetbrains全家桶Ide使用,1年售后保障,每天仅需1毛
【官方授权 正版激活】: 官方授权 正版激活 支持Jetbrains家族下所有IDE 使用个人JB账号...