【微信小程序】-- 案例 - 本地生活（列表页面）（三十）

• 💌 所属专栏：【微信小程序开发教程】

• 😀 作  者：我是夜阑的狗🐶

• 🚀 个人简介：一个正在努力学技术的CV工程师，专注基础和实战分享 ，欢迎咨询！

• 💖 欢迎大家：这里是CSDN，我总结知识的地方，喜欢的话请三连，有问题请私信 😘 😘 😘

---

前言

  大家好，又见面了，我是夜阑的狗🐶，本文是专栏【微信小程序开发教程】专栏的第30篇文章;
  今天开始学习微信小程序的第15天💖💖💖，开启新的征程，记录最美好的时刻🎉，每天进步一点点。
  专栏地址：【微信小程序开发教程】， 此专栏是我是夜阑的狗微信小程序开发过程的总结，希望能够加深自己的印象，以及帮助到其他的小伙伴😉😉。
  如果文章有什么需要改进的地方还请大佬不吝赐教👏👏。

---

一、案例 - 本地生活（列表页面）

  前面已经学习了WXS 脚本的概念和基本语法，通过栗子了解到WXS的怎么创建和调用。接下来就来根据前面学的知识，在案例-本地生活上进行实践。话不多说，让我们原文再续，书接上回吧。

1、演示页面效果以及主要功能

  首先来看一下页面演示效果，页面中有列表数据，其中还要具备下拉和上拉刷新功能：

  接下来实现主要功能有三个：

• 页面导航并传参
• 上拉触底时加载下一页数据
• 下拉刷新列表数据

二、页面导航并传参

  首先创建列表页面，可以通过 app.json 文件进行快速创建。

app.json

{"pages":["pages/home/home","pages/message/message","pages/contact/contact","pages/shoplist/shoplist"],
}

  可以来看一下实际结果：

  从 view 组件改造成 navigator 组件，从而支持跳转行为，并且在跳转过程中还要传递参数（id + 名称），为了后续页面标题和查询数据做准备。

home.wxml

<view class="grid-list"><navigator class="grid-item" wx:for="{{gridList}}" wx:key="id" url="/pages/shoplist/shoplist?id={{item.id}}&title={{item.name}}"><image src="{{item.icon}}"></image><text>{{item.name}}</text></navigator>
</view>

  可以来看一下实际结果：

三、上拉触底时加载下一页数据

1、动态设置页面标题

  不能通过页面 .json 文件 中 navigationBarTitleText 来进行设置，这个操作是直接把页面标题直接写死，这样不符合需求的。这里需要调用小程序的 ·wx.setNavigationBarTitle(Object object) 来动态设置当前页面的标题。具体参数如下所示：

属性	类型	默认值	必填	说明
title	string		是	页面标题
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

  前面刚学完页面生命周期，了解到对界面内容进行设置的 API 如 wx.setNavigationBarTitle ，请在onReady之后进行。而 onReady 是页面初次渲染完成时触发，具体代码如下所示：

shoplist.js

Page({/*** 页面的初始数据*/data: {query: {}},/*** 生命周期函数--监听页面加载*/onLoad(options) {this.setData({query: options})},/*** 生命周期函数--监听页面初次渲染完成*/onReady() {wx.setNavigationBarTitle({title: this.data.query.title,})},
})

  可以来看一下实际效果：

2、创建编译模式

  为了方便后续开发，可以创建 showlist 页面的编译模式，指定好启动页面和页面参数，等下一次对 showlist 页面进行改动，编译完就会立即跳转到该页面。具体操作如下：

3、列表页面的 API 接口

  以分页的形式，加载指定分类下商铺列表的数据，如下表所示：

数据	说明
接口地址	https://www.escook.cn/categories/:cate_id/shops URL 地址中的 : cate_id 是动态参数，表示分类的 Id
请求方式	GET 请求
请求参数	_page 表示请求第几页的数据 _limit 表示每页请求几条数据

  接下来就是定义获取数据方法，并进行调用，具体代码如下所示：

shoplist.js

Page({/*** 页面的初始数据*/data: {query: {},shopList: [],page: 1, // 当前页数pageSize: 10, //一页有多少个数据total: 0, // 总页数},/*** 生命周期函数--监听页面加载*/onLoad(options) {this.setData({query: options});this.getShopList();},/*** 获取列表数据*/getShopList(){wx.request({url: `https://www.escook.cn/categories/${this.data.query.id}/shops`,method: 'GET',data:{_page: this.data.page,_limit: this.data.pageSize,},success: (res) =>{this.setData({shopList: [...this.data.shopList, ...res.data],// 页面总数获取到是字符，需要转换成数字total: res.header['X-Total-Count'] - 0,})}})},
})

  注意！注意！注意！：这里需要注意一点，就 url 是动态填充路径的，所以要用反引号 `，如果这里只用单引号’ 或者双引号 "，是不会有数据的，因为这样就把 ${this.data.query.id} 当成id的值了，肯定查询不到数据。如果要用引号，记得一定要采用拼接的方式：‘+this.data.query.id+’。

  到这里基本上就完成获取数据，可以查看返回的 res 参数里面有什么。

  知道 res 里有什么数据之后，将其赋给 data 里对应的变量即可，如下图所示：

  获取商品列表数据之后，接下来就是将其渲染到页面中并进行样式美化。

shoplist.wxml

<view class="shop-item" wx:for="{{shopList}}" wx:key="id"><view class="left-thumb"><image src="{{item.images[0]}}"></image></view><view class="right-info"><text class="shop-title">{{item.name}}</text><text>电话：{{item.phone}}</text><text>地址：{{item.address}}</text><text>营业时间：{{item.businessHours}}</text></view>
</view>

shoplist.wxss

.shop-item {display: flex;/* 添加边框 */padding: 20rpx;border: 1rpx solid #efefef;/* 圆角样式 */border-radius: 10rpx;margin: 20rpx;/* 盒子阴影 */box-shadow: 1rpx 1rpx 15rpx #ddd;
}
.left-thumb image {width: 250rpx;height: 250rpx;display: block;margin-right: 20rpx;
}
.right-info{display: flex;/* 纵向布局 */flex-direction: column;justify-content: space-around;font-size: 24rpx;
}
.shop-title{/* 文本加粗 */font-weight: bold;
}

  可以来看一下实际效果：

4、实现上拉加载数据和效果

  通过 wx.showLoading(Object object) 可实现上拉加载效果，具体代码如下：

shoplist.js

Page({/*** 获取列表数据*/getShopList(){// 展示 loading 效果wx.showLoading({title: '数据加载中',})  wx.request({url: `https://www.escook.cn/categories/${this.data.query.id}/shops`,method: 'GET',data:{_page: this.data.page,_limit: this.data.pageSize,},success: (res) =>{ // console.dir(res);this.setData({shopList: [...this.data.shopList, ...res.data],// 页面总数获取到是字符，需要转换成数字total: res.header['X-Total-Count'] - 0,});},complete: ()=>{// 隐藏 loading 效果wx.hideLoading();}})},/*** 页面上拉触底事件的处理函数*/onReachBottom() {this.setData({page: this.data.page+1});this.getShopList();},
})

shoplist.json

  并将上拉触底的距离改为200。

{"usingComponents": {},"onReachBottomDistance": 200
}

  可以来看一下实际运行效果：

5、对上拉触底进行节流处理

  前面也讲过，当连续触底多次，就会引发不必要的问题。所以需要在上拉监听函数做节流处理，如果当前请求正在请求数据，后续发送的请求都应该进行屏蔽。当前没有数据请求的时候，才可以允许发起下一页的请求。

  节流处理可分为以下步骤：

• Step 1、在 data 中定义 isloading 节流阀

  isloading 为布尔值，false 表示当前没有进行任何数据请求，可以请求， true 表示当前正在进行数据请求，重新触发的下一页请求都要被屏蔽。

• Step 2、在 getShopList() 方法中修改 isloading 节流阀的值

  当开始发起请求时，调用 getShopList 时将节流阀设置 true，数据请求完成之后，在网络请求的 complete回调函数中，将节流阀重置为 false。

• Step 3、在 onReachBottom 中判断节流阀的值，从而对数据请求进行节流控制

  如果节流阀的值为 true，则阻止当前请求。如果节流阀的值为 false，则发起数据请求。

  具体代码如下：

shoplist.js

Page({/*** 页面的初始数据*/data: {query: {},shopList: [],page: 1, // 当前页数pageSize: 10, //一页有多少个数据total: 0, // 总页数isloading: false,},/*** 获取列表数据*/getShopList(){this.setData({isloading: true})// 展示 loading 效果wx.showLoading({title: '数据加载中',})  wx.request({url: `https://www.escook.cn/categories/${this.data.query.id}/shops`,method: 'GET',data:{_page: this.data.page,_limit: this.data.pageSize,},success: (res) =>{ // console.dir(res);this.setData({shopList: [...this.data.shopList, ...res.data],// 页面总数获取到是字符，需要转换成数字total: res.header['X-Total-Count'] - 0,});},complete: ()=>{// 隐藏 loading 效果wx.hideLoading();this.setData({isloading: false})}})},/*** 页面上拉触底事件的处理函数*/onReachBottom() {// 节流处理if(this.data.isloading) return;this.setData({page: this.data.page+1});this.getShopList();},
})

  可以来看一下运行效果：

6、判断数据是否加载完毕

  当请求 8 页数据之后，再次进行上拉操作时就会发起数据请求。在开发过程中，这种行为是不允许的，所以当数据加载完之后，需要判断是否还有下一页数据，没有的话则后续触发上拉监听就应该不用触发。
  这里就需要公式来进行推导了，如果下面的公式成立，则证明没有下一页数据了：
$$\{\begin{array}{l}页码值\ast 每页显示多少条数据>=总数据条数\\ page\ast pageSize>=total\end{array}$$

  可以通过案例来验证一下这个公式准确性：

• 案例1：总共有 77 条数据，如果每页显示 10 条数据，则总共分为 8 页，其中第 8 页只有 7 条数据；
  $$\{\begin{array}{l}page（7）\ast pageSize（10）>=total（77）\\ page（8）\ast pageSize（10）>=total（77）\end{array}$$
• 案例2：总共有 80 条数据，如果每页显示 10 条数据，则总共分为 8 页，其中第 8 页面有 10 条数据；
  $$\{\begin{array}{l}page（7）\ast pageSize（10）>=total（80）\\ page（8）\ast pageSize（10）>=total（80）\end{array}$$

  综上所述，说明该公式是可行的，根据这个公式可以对数据加载请求做处理，当数据已经加载完不能加载的时候，需要给用户添加一个提示框，可以通过调用 wx.showToast(Object object) 来实现，先来了解一下该函数的部分参数：

属性	类型	默认值	必填	说明	最低版本
title	string		是	提示的内容
icon	string	success	否	图标
image	string		否	自定义图标的本地路径，image 的优先级高于 icon	1.1.0
duration	number	1500	否	提示的延迟时间
mask	boolean	false	否	是否显示透明蒙层，防止触摸穿透

  具体代码如下:

shoplist.js

Page({/*** 页面上拉触底事件的处理函数*/onReachBottom() {if(this.data.page * this.data.pageSize >= this.data.total){// 没有下一页数据return wx.showToast({title: '数据加载已完成',icon:'none'})}// 节流处理if(this.data.isloading) return;this.setData({page: this.data.page+1});this.getShopList();},
})

  当数据加载完之后，可以来看一下运行效果：

四、下拉刷新列表数据

  完成上拉刷新之后，接下来就是要实现下拉刷新列表数据，并其样式进行美化。
  下拉刷新需要重置页面部分参数，然后在根据重置过后的数据重新发起请求，这里还需要注意一点就是需要主动来关闭下拉刷新窗口，这里可以把关闭操作放在数据请求完成之后。具体代码如下所示：

shoplist.json

  开启下拉刷新功能。

{"usingComponents": {},"onReachBottomDistance": 200,"enablePullDownRefresh": true,"backgroundColor": "#efefef","backgroundTextStyle": "dark"
}

shoplist.js

  但是这里有个问题了，如果直接把关闭操作放在 getShopList 里的 complete，这样上拉刷新的时候也会进行调用，这很明显不符合开发需求，所以需要对关闭下拉刷新操作进行限制一下。可以对 getShopList 进行传递回调函数，只有下拉刷新的时候才会给 getShopList 进行传函数，其他时候不传即可。
   stopPD && stopPD(); 而表达的意思是当 stopPD 不为 undefined 的时候就执行该函数，反转不执行。

Page({/*** 获取列表数据*/getShopList(stopPD){...wx.request({...complete: ()=>{// 隐藏 loading 效果wx.hideLoading();this.setData({isloading: false});// 数据请求完成关闭下拉刷新窗口// wx.stopPullDownRefresh();stopPD && stopPD();}})},/*** 页面相关事件处理函数--监听用户下拉动作*/onPullDownRefresh() {// 需要重置关键的数据this.setData({page: 1,shopList: [],total: 0})// 重新发起数据请求this.getShopList(() => {wx.stopPullDownRefresh();});},
})

  当数据加载几页之后，触发下拉监听时，会将页面中的 page、shopList 和 total 进行重置，然后在请求第一页的数据，可以来看一下运行效果：

五、使用 wxs 处理手机号

  最后就是要来处理列表数据中的手机号，可以使用 wxs 脚本来对页面数据进行过滤。创建 tool.wxs 脚本编写功能，具体操作如下：

tool.wxs

function splitPhone(str){if(str.length !== 11) return str;var arr = str.split('');arr.splice(3, 0, '-');arr.splice(8, 0, '-');return arr.join('');
}module.exports = {splitPhone: splitPhone
}

shoplist.wxml

<view class="shop-item" wx:for="{{shopList}}" wx:key="id"><view class="left-thumb"><image src="{{item.images[0]}}"></image></view><view class="right-info"><text class="shop-title">{{item.name}}</text><text>电话：{{tools.splitPhone(item.phone)}}</text><text>地址：{{item.address}}</text><text>营业时间：{{item.businessHours}}</text></view>
</view><wxs src="../../utils/tool.wxs" module="tools"></wxs>

  到这里基本上就完成整个列表页面的设置了，来看一下实际效果：

---

总结

  感谢观看，这里就是案例 - 本地生活（列表页面）的介绍，如果觉得有帮助，请给文章点个赞吧，让更多的人看到。🌹 🌹 🌹

  也欢迎你，关注我。👍 👍 👍

  原创不易，还希望各位大佬支持一下，你们的点赞、收藏和留言对我真的很重要！！！💕 💕 💕 最后，本文仍有许多不足之处，欢迎各位认真读完文章的小伙伴们随时私信交流、批评指正！下期再见。🎉

更多专栏订阅:

• 😀 【LeetCode题解（持续更新中）】
• 🚝 【Java Web项目构建过程】
• 💛 【微信小程序开发教程】
• ⚽ 【JavaScript随手笔记】
• 🤩 【大数据学习笔记（华为云）】
• 🦄 【程序错误解决方法（建议收藏）】
• 🚀 【软件安装教程】

订阅更多，你们将会看到更多的优质内容！！