VUE项目实战49商品列表功能模块初始化

Posted 2022-05-10 光仔December

接上篇《48、参数下可选项的增删改》
上一篇我们完成了参数管理模块的所有开发，本篇我们开启商品列表功能的开发。

一、创建新分支

开发新的模块，我们需要创建新的git分支，在VScode打开终端，在控制台输入“git branch”查看我们所在的分支（可以看到是在master主分支上），然后我们使用“git checkout -b goods_list”创建一个名为“goods_list”的分支，可以看到自动切换到了新的分支上：

然后我们将本地的分支推送到云端：

然后我们前往gitee云端，可以看到新增了一个分支：

二、创建组件并定义路由规则

我们在components/goods下创建一个名为“List.vue”的文件文件（商品列表管理组件）：

然后在“List.vue”文件中编写基本代码结构：

<template>
    <div>
        <h3>商品列表组件页面</h3>
    </div>
</template>
 
<script>
export default 
    data()
        return
    ,
    created(),
    methods:

</script>
 
<style scoped>
 
</style>

然后我们在“router/index.js”下引入List组件（别名GoodsList），并在路由规则中定义路由规则（“/goods”菜单的路由）：

import Vue from 'vue'
import VueRouter from 'vue-router'
import Login from '../components/Login.vue' //引用Login组件
import Home from '../components/Home.vue' 
import Welcome from '../components/Welcome.vue' 
import Users from '../components/user/Users.vue' 
import Rights from '../components/power/Rights.vue' 
import Roles from '../components/power/Roles.vue' 
import Cate from '../components/goods/Cate.vue' 
import Params from '../components/goods/Params.vue' 
import GoodsList from '../components/goods/List.vue' 
 
Vue.use(VueRouter)
const routes = []
 
const router = new VueRouter(
  routes: [
     path: '/', redirect: '/login' ,
     path: '/login', component: Login , //定义访问页面的路由地址
     
      path: '/home',
      component: Home,
      redirect: '/welcome',
      children: [
        path:'/welcome',component:Welcome,
        path:'/users',component:Users,
        path:'/rights',component:Rights,
        path:'/roles',component:Roles,
        path:'/categories',component:Cate,
        path:'/params',component:Params,
        path:'/goods',component:GoodsList
      ]
    
  ]
)
//挂载路由导航守卫
//to是我们跳转的路径，from是来自的路径，next为放行函数
router.beforeEach((to,from,next)=>
  //如果用户访问登录页，直接放行
  if(to.path ==="/login") return next();
  //从sessionStorage中获取到保存的token值
  const tokenStr = window.sessionStorage.getItem("token");
  //没有token，强制跳转到登录页面
  if(!tokenStr) return next("/login");
  next();//有token，直接放行
)
 
export default router

然后我们刷新页面，点击商品分类菜单，就被路由到刚刚创建的组件上了：

三、绘制商品分类列表基本布局

在商品列表页面，左上角是商品名称搜索框和添加商品按钮，下方是商品表格，分别显示商品的名称、价格、重量和创建时间，最右侧是修改和删除两个操作按钮：

我们先把左上角的面包屑导航和卡片视图做出来。
首先我们将在参数管理的面包屑导航直接拷贝过来修改，然后再通过“el-card”创建一个卡片视图区域，以及搜索和添加按钮：

<template>
    <div>
        <!-- 面包屑导航 -->
        <el-breadcrumb separator-class="el-icon-arrow-right">
        <el-breadcrumb-item :to=" path: '/home' ">首页</el-breadcrumb-item>
        <el-breadcrumb-item>商品管理</el-breadcrumb-item>
        <el-breadcrumb-item>商品列表</el-breadcrumb-item>
        </el-breadcrumb>
 
        <!-- 卡片视图 -->
        <el-card>
            <el-row :gutter="20" ><!-- gutter是指定每个分栏的间隔 -->
                <!-- 分栏一共占24格，给搜索框7格，添加按钮4格 -->
                <el-col :span="7">
                    <!-- 搜索与添加区域 -->
                    <el-input placeholder="请输入内容" clearable>
                        <el-button slot="append" icon="el-icon-search"></el-button>
                    </el-input>
                </el-col>
                <el-col :span="4">
                    <el-button type="primary">添加商品</el-button>
                </el-col>
            </el-row>
        </el-card>
    </div>
</template>
 
<script>
export default 
    data()
        return
    ,
    created(),
    methods:

</script>
 
<style scoped>
 
</style>

效果：

四、获取商品列表数据

我们来看一下商品分类接口API的参数和响应结果：

●响应数据格式：

    "data": 
        "total": 50,
        "pagenum": "1",
        "goods": [
            
                "goods_id": 144,
                "goods_name": "asfdsd",
                "goods_price": 1,
                "goods_number": 1,
                "goods_weight": 1,
                "goods_state": null,
                "add_time": 1512954923,
                "upd_time": 1512954923,
                "hot_mumber": 0,
                "is_promote": false
            
        ]
    ,
    "meta": 
        "msg": "获取成功",
        "status": 200
    

可以看到传参的时候，传递的是query查询参数（模糊查询用的），以及pagenum和pagesize两个的分页参数，并不复杂。
而返回的商品信息是封装在goods数组里的，遍历出来即可。

清楚了API的调用，我们来编写调用代码。首先在数据区域定义一个“goodlist”对象，用来承载商品列表数据，然后是“queryinfo”对象，为请求数据的默认请求参数对象；“total”为数据总数：

data()
    return
        //查询条件
        queryInfo:
            query: '',
            pagenum: 1,
            pagesize: 10
        ,
        //商品列表，默认为空
        goodslist: [],
        total: 0 //数据总数
    
,

然后在方法区定义名为“getGoodsList”方法，用来获取商品数据（同时该方法在created声明周期函数中调用）：

created()
    this.getGoodsList();
,
methods:
    //根据分页获取对应的商品列表
    async getGoodsList()
        const data: res = await this.$http.get('goods',params: this.queryInfo);
    if(res.meta.status!==200)
        return this.$message.error('获取商品列表失败！')
    
    console.log(res.data);
    //报数据列表，赋值给catelist
    this.goodslist = res.data.goods;
    //为总数据条数赋值
    this.total = res.data.total;
    

我们打开浏览器访问商品列表模块，F12查看返回的数据结构：

五、渲染商品列表

获取到数据后，我们渲染商品列表的表格。我们在卡片视图区域的“el-row”下面添加table表格区域：

<!-- table 表格区域 -->
<el-table :data="goodslist" border stripe>
    <el-table-column type="index"></el-table-column><!-- 索引列 -->
    <el-table-column label="商品名称" prop="goods_name"></el-table-column>
    <el-table-column label="商品价格（元）" prop="goods_price" width="90px"></el-table-column>
    <el-table-column label="商品重量" prop="goods_weight" width="70px"></el-table-column>
    <el-table-column label="创建时间" prop="add_time" width="140px"></el-table-column>
    <el-table-column label="操作" width="200px">
        <template slot-scope="">
            <el-button size= "mini" type="primary" icon="el-icon-edit">编辑</el-button>
            <el-button size= "mini" type="danger" icon="el-icon-delete">删除</el-button>
        </template>
    </el-table-column>
</el-table>

效果：

我们可以注意到，上面的时间显示的是时间戳的效果，不是标准的日期效果，我们要创建一个统一的时间处理器来处理格式问题。

我们在main.js中注册一个全局的时间处理器：

Vue.filter('dateFormat',function(originVal)
    const dt = new Date(originVal);
    const y =  dt.getFullYear();
    const m = (dt.getMonth()+1+'').padStart(2,'0');
    const d = (dt.getDate()+'').padStart(2,'0');
    const hh = (dt.getHours()+'').padStart(2,'0');
    const mm = (dt.getMinutes()+'').padStart(2,'0');
    const ss = (dt.getSeconds()+'').padStart(2,'0');
    return `$y-$m-$d $hh:$mm:$ss`
);

这里的Vue.filter是Vue的过滤器，我们可以注册很过滤器方法，来处理一些常见的文本格式化。全局的过滤器定义在main.js里，某个VUE组件的过滤器，可以定义在data数据定义区下方（和之前的computed计算属性同级）。

使用定义好的filter过滤器，在组件中有两种使用方式，一种是在双花括号后加竖杠“|”，然后拼接过滤器的名字，如：

 'ok' | globalFilter 

第二种是在html标签中使用v-bind表达式，如：

<div v-bind:data="'ok' | globalFilter" ></div>

我们是用el-table-column展示的，可以使用作用域插槽通过双花括号的形式展示时间字段，然后使用第一种加竖杠的方式，来使用全局的时间过滤器，改造如下：

<el-table-column label="创建时间" width="140px">
    <template slot-scope="scope">
        scope.row.add_time | dateFormat
    </template>
</el-table-column>

效果：

至此我们的商品列表模块介绍和基础结构搭建完成。
下一篇我们继续编写商品列表的分页效果。

参考：黑马程序员（www.itheima.com）Vue项目实战教学视频

转载请注明出处：https://blog.csdn.net/acmman/article/details/124651568