webpack+vue项目实战（四，前端与后端的数据交互和前端展示数据）

2021-05-16 19:29

阅读：625

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这个标签这里。不知道排版布局的话，参考上一篇文章喔！不要不知道我在说什么！

技术分享
然后开始写

下面简单写几个栗子

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">Xa>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>回款类型
                    立即回款
                    定期回款
                    --
                
                
回款日期
                    {{new Date(castInfo.cashDate).toLocaleDateString().replace(/\//g, ‘-‘) }}
                

回款状态
                    待回款
                    部分回款
                    已回款
                    已取消
                    --
                

回款渠道
                    支付宝
                    微信支付
                    银行转账
                    苏宁易付宝
                    易极付
                    蓝金灵支付
                    --
                

备注
                    {{castInfo.remark}}

遮罩层和详情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下面，直接引入下面的代码


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>

    //修改后
    "回款编号" width="180">
        
第二种情况是，比如回款状态，可以进行搜索的字段。但是是下拉搜索的

    //修改前
    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项目实战（三，配置功能操作页和组件的按需加载）