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

Posted 2023-03-28 我是夜阑的狗

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了微信小程序-- 案例 - 本地生活（列表页面）（三十）相关的知识，希望对你有一定的参考价值。

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

😀 作者：我是夜阑的狗🐶

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

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

文章目录

前言
一、案例 - 本地生活（列表页面）
- - 1、演示页面效果以及主要功能
二、页面导航并传参
三、上拉触底时加载下一页数据
四、下拉刷新列表数据
五、使用 wxs 处理手机号
总结

前言

大家好，又见面了，我是夜阑的狗🐶，本文是专栏【微信小程序开发教程】专栏的第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 页数据之后，再次进行上拉操作时就会发起数据请求。在开发过程中，这种行为是不允许的，所以当数据加载完之后，需要判断是否还有下一页数据，没有的话则后续触发上拉监听就应该不用触发。
这里就需要公式来进行推导了，如果下面的公式成立，则证明没有下一页数据了：
$\\begincases 页码值 * 每页显示多少条数据 >= 总数据条数 \\\\ page * pageSize >= total\\\\ \\endcases$

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

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

文章目录

前言

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

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

二、页面导航并传参

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

1、动态设置页面标题

2、创建编译模式

3、列表页面的 API 接口

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

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

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

文章目录

前言

一、案例 - 本地生活

1、首页效果以及实现步骤

二、项目结构

1、新建项目

2、梳理项目结构

三、配置导航栏效果

四、配置 tabBar 效果

五、实现轮播图效果

1、获取轮播图数据

2、渲染轮播图

六、实现九宫格效果

1、获取九宫格数

2、渲染九宫格

七、实现图片布局

总结