基于vue的tab-list类目切换商品列表组件的示例代码

Z时代
2024-01-10
分类：IT

在大多数电商场景中，页面都会有类目切换加上商品列表的部分，页面大概会长这样

每次写类似场景的时候，都需要去为类目商品列表写很多逻辑，为了提高开发效率我决定将这一部分抽离成组件。

实现

1.样式

所有tab栏的样式和商品列表的样式都提供插槽，供业务自己定制

2.变量

isTabFixed: false,//是否吸顶

tab: 1,//当前tab

page: 1,//当前页数

listStatus: {

finished: false,//是否已是最后一页

loading: false,//是否加载中

items: [],//商品数组

tabMap: [],//tab列表数组

cache:{},//缓存

listName: '',//商品列表名称

tabName: '',//tab列表名称

apiName: '',//api方法名称

queryName: '',//api请求参数名称

3.缓存设计

为了减少消耗，已经请求过的商品列表我都将他们缓存下来


_addCache(proList) {
 cache[this.tab] = {
 finished: this.listStatus.finished,
 page: this.page,
 list: proList,
 };
},

4.请求数据


_getList(type) {
 let data = {};
 data[this.queryName] = this.tab;
 data.page = this.page;
 this.$http[this.apiName](data)
 .then((res) => {
 this.listStatus.finished = !res.has_more;//更新是否是最后一页的状态
 this._handleData(res.items);//处理得到的商品列表
 })
 .catch((err) => {
 note(err.message || '出错啦');
 });
},
_handleData(proList) {
 if (this.page === 1) {//表示是tab切换时请求的数据，所以直接将items的指向切换
 this.items = proList;
 } else {//因为是翻页，所以需要把数据拼接
 this.items = this.items.concat(proList);
 }
 this.$store.setData(this.listName, this.items);//把数据更新给父组件
 this._addCache(this.items);//把数据加入缓存
},

5.操作

逻辑部分主要分两块：一是列表翻页，二是tab相关

列表翻页

这部分的逻辑比较简单，主要分两点

将page加一

请求数据


_loadmore() {
 this.page = this.page + 1;
 this._getList();
},

其实对于手机列表的上拉翻页操作，还有很多的点要去注意，比如如何去避免连续请求等，由于我将这些交给了另一个专注列表渲染的组件，这里就不需要再去考虑这些操作。

tab相关

tab切换

tab切换的时候主要是两点

切换tab的指向

切换items的指向

已经加载过的列表从缓存中取

没有加载过的请求数据然后还有两个体验上的点

切换的时候应该获取切换列表的第一页数据


changeTab(id) {
 this.tab = id;
 this.$store.setData(this.tabName, this.tab);//将tab的指向同步给父组件
 this._scrollToTab();//视图回到顶部
 if (cache[this.tab]) {
 const target = cache[this.tab];
 this.listStatus.finished = target.finished;
 this.page = target.page;
 this.items = target.list;
 this.$store.setData(this.listName, this.items);//将商品列表同步给父组件
 } else {
 this.page = 1;
 this._getList();
 }
},
//视图回到顶部
_scrollToTab() {
 let scrollTop = document.documentElement.scrollTop || document.body.scrollTop;
 let productsTop = this.$refs.products.$el.offsetTop;//商品列表距离顶部的距离
 let topHeight = this.$refs.tabNav.offsetHeight;//tab栏的高度
 if (scrollTop > productsTop) {
 window.scrollTo(0, productsTop - topHeight);
 }
},

吸顶

在吸顶的时候，需要对tab栏的样式做一些小小的变动，所以需要一个变量来知道是否吸顶了


handleNavFixed() {
 this.stickyTop = this.$store.getData('stickyTop') || 0;//吸顶的高度
 window.onscroll = (e) => {
 let top = document.documentElement.scrollTop || document.body.scrollTop;
 let tabHeight = this.$refs.tabNav.offsetTop - top - 1;
 if (tabHeight <= this.stickyTop && !this.isTabFixed) {//结合判断为了避免重复计算
 this.isTabFixed = true;
 }
 if (tabHeight >= this.stickyTop && this.isTabFixed) {
 this.isTabFixed = false;
 }
 };
},

6.组件相关

作为一个组件，不同点在于需要做到的是可用性和通用性。对于组件如何更好的得到父组件的值并把更新的值传回父组件方面，是我在开发过程中的一个卡点，最后我用了一套基于vue的组件通行机制。这种通行机制的实现网上很多，这里就不详细说了。通行机制主要有两个功能

各组件间可以互相调用方法

各个组件都可以得到和更新父组件的数据

由于将tab列表都作为插槽传入，所以初始数据并不需要关心，需要关心的只是更新数据。

对于不同的页面，tab列表的名称，tab定位的名称，商品列表的名称，接口的名称，请求接口的参数都可以会不一样，所以我在这里将这些项作为参数，在初始化这个组件的时候需要传入


//组件部分
init(data = {}) {
 this.listStatus.finished = !data.hasMore;
 this.tabName = data.tabName;
 this.listName = data.listName;
 this.apiName = data.apiName;
 this.queryName = data.queryName;
 this.handleNavFixed();//判断是否吸顶
},
//调用组件
this.$bus.emit('tab-list.init', {
 tabName: 'tab',
 listName: 'items',
 apiName: 'homeList',
 queryName: 'tab_id',
 hasMore: this.hasMore,
});