微信小程序之下拉刷新事件、上拉触底事件和案例

学习的最大理由是想摆脱平庸,早一天就多一份人生的精彩;迟一天就多一天平庸的困扰。各位小伙伴,如果您:
想系统/深入学习某技术知识点…
一个人摸索学习很难坚持,想组团高效学习…
想写博客但无从下手,急需写作干货注入能量…
热爱写作,愿意让自己成为更好的人…

文章目录

  • 前言
  • 一、页面事件 - 下拉刷新事件
    • 1、什么是下拉刷新
    • 2、启用下拉刷新
    • 3、配置下拉刷新窗口的样式
    • 4、监听页面的下拉刷新事件
    • 5、停止下拉刷新的效果
  • 二、页面事件 - 上拉触底事件
    • 1、什么是上拉触底
    • 2、监听页面的上拉触底事件
    • 3、配置上拉触底距离
  • 三、页面事件 - 上拉触底案例
    • 1、案例的实现步骤
    • 2、步骤1 - 定义获取随机颜色的方法
    • 3、步骤2 - 在页面加载时获取初始数据
    • 4、步骤3 - 渲染 UI 结构并美化页面效果
    • 5、步骤4 - 上拉触底时获取随机颜色
    • 6、步骤5 - 添加 loading 提示效果
    • 7、步骤6 - 对上拉触底进行节流处理
  • 总结


前言

一、页面事件 - 下拉刷新事件
1、什么是下拉刷新
2、启用下拉刷新
3、配置下拉刷新窗口的样式
4、监听页面的下拉刷新事件
5、停止下拉刷新的效果
二、页面事件 - 上拉触底事件
1、什么是上拉触底
2、监听页面的上拉触底事件
3、配置上拉触底距离
三、页面事件 - 上拉触底案例
1、案例的实现步骤
2、步骤1 - 定义获取随机颜色的方法
3、步骤2 - 在页面加载时获取初始数据
4、步骤3 - 渲染 UI 结构并美化页面效果
5、步骤4 - 上拉触底时获取随机颜色
6、步骤5 - 添加 loading 提示效果
7、步骤6 - 对上拉触底进行节流处理


一、页面事件 - 下拉刷新事件

1、什么是下拉刷新

下拉刷新是移动端的专有名词,指的是通过手指在屏幕上的下拉滑动操作,从而重新加载页面数据的行为。

2、启用下拉刷新

启用下拉刷新有两种方式:

  • 全局开启下拉刷新
    • 在 app.json 的 window 节点中,将 enablePullDownRefresh 设置为 true
  • 局部开启下拉刷新
    • 在页面的 .json 配置文件中,将 enablePullDownRefresh 设置为 true

在实际开发中,推荐使用第 2 种方式,为需要的页面单独开启下拉刷新的效果。

3、配置下拉刷新窗口的样式

在全局或页面的 .json 配置文件中,通过 backgroundColor 和 backgroundTextStyle 来配置下拉刷新窗口的样式,其中:

  • backgroundColor 用来配置下拉刷新窗口的背景颜色,仅支持16 进制的颜色值
  • backgroundTextStyle 用来配置下拉刷新 loading 的样式,仅支持 dark 和 light
  "enablePullDownRefresh": true,
  "backgroundColor": "#ffffff",
  "backgroundTextStyle": "dark"

微信小程序之下拉刷新事件、上拉触底事件和案例_第1张图片

4、监听页面的下拉刷新事件

在页面的 .js 文件中,通过 onPullDownRefresh() 函数即可监听当前页面的下拉刷新事件。
例如,在页面的 wxml 中有如下的 UI 结构,点击按钮可以让 count 值自增 +1:

count值为:{{count}}

data: {
  count:0

},
countAdd(){
  this.setData({
    count:this.data.count+1
  })
},

微信小程序之下拉刷新事件、上拉触底事件和案例_第2张图片
在触发页面的下拉刷新事件的时候,如果要把 count 的值重置为 0,示例代码如下:

  onPullDownRefresh() {
    this.setData({
      count:0
    })
  },

5、停止下拉刷新的效果

当处理完下拉刷新后,下拉刷新的 loading 效果会一直显示,不会主动消失,所以需要手动隐藏下拉刷新的 loading 效果。此时,调用 wx.stopPullDownRefresh() 可以停止当前页面的下拉刷新。示例代码如下:

  onPullDownRefresh() {
    this.setData({
      count:0
    })
    //当数据重置成功之后,调用此函数,关闭下拉刷新效果
    wx.stopPullDownRefresh()
  },

微信小程序之下拉刷新事件、上拉触底事件和案例_第3张图片

二、页面事件 - 上拉触底事件

1、什么是上拉触底

上拉触底是移动端的专有名词,通过手指在屏幕上的上拉滑动操作,从而加载更多数据的行为。

2、监听页面的上拉触底事件

在页面的 .js 文件中,通过 onReachBottom() 函数即可监听当前页面的上拉触底事件。示例代码如下:

  onReachBottom() {
    console.log('触发了上拉触底的事件')
  },

3、配置上拉触底距离

上拉触底距离指的是触发上拉触底事件时,滚动条距离页面底部的距离。
可以在全局或页面的 .json 配置文件中,通过 onReachBottomDistance 属性来配置上拉触底的距离。
小程序默认的触底距离是 50px,在实际开发中,可以根据自己的需求修改这个默认值。
微信小程序之下拉刷新事件、上拉触底事件和案例_第4张图片

三、页面事件 - 上拉触底案例

1、案例的实现步骤

  • 定义获取随机颜色的方法
  • 在页面加载时获取初始数据
  • 渲染 UI 结构并美化页面效果
  • 在上拉触底时调用获取随机颜色的方法
  • 添加 loading 提示效果
  • 对上拉触底进行节流处理

2、步骤1 - 定义获取随机颜色的方法

js代码

  data: {
    colorList:[], //随机颜色的列表
  },

js代码

  getColors(){//获取随机颜色的方法
    wx.request({
      url: 'https://applet-base-api-t.itheima.net/api/color',
      method:'get',
      success:({data:res})=>{
        this.setData({
          colorList:[...this.data.colorList,...res.data]//将获取的新数组和原数组通过展开运算符进行拼接
          //如果出错了,改成  colorList: this.data.colorList.concat(res.data)
        })
        }
    })
  },

3、步骤2 - 在页面加载时获取初始数据

js代码

  /**
   * 生命周期函数--监听页面加载
   */
  onLoad(options) {
    this.getColors()

  },

4、步骤3 - 渲染 UI 结构并美化页面效果

wxml代码

{{item}}

wxss代码

.num-item{
  border: 1px solid #efefef;
  border-radius: 8rpx;
  line-height: 200rpx;
  margin: 15rpx;
  text-align: center;
  text-shadow: 0rpx 0rpx 5rpx #fff;
  box-shadow: 1rpx 1rpx 6rpx #aaa;
}

5、步骤4 - 上拉触底时获取随机颜色

js代码

  /**
   * 页面上拉触底事件的处理函数
   */
  onReachBottom() {
    //调用获取随机颜色的方法
    this.getColors()
  },

6、步骤5 - 添加 loading 提示效果

js代码

  getColors(){//获取随机颜色的方法
    //显示Loading效果
    wx.showLoading({
      title: '数据加载中...',
    })

    wx.request({
      url: 'https://applet-base-api-t.itheima.net/api/color',
      method:'get',
      success:({data:res})=>{
        this.setData({
          colorList:[...this.data.colorList,...res.data]//将获取的新数组和原数组通过展开运算符进行拼接
          //如果出错了,改成  colorList: this.data.colorList.concat(res.data)
        })
        },
        complete:()=>{
          wx.hideLoading() //隐藏Loading效果
          this.setData({
            isLoding:false
          })
      }
    })
  },

7、步骤6 - 对上拉触底进行节流处理

  • 在 data 中定义 isloading 节流阀
    • false 表示当前没有进行任何数据请求
    • true 表示当前正在进行数据请求
  • 在 getColors() 方法中修改 isloading 节流阀的值
    • 在刚调用 getColors 时将节流阀设置 true
    • 在网络请求的 complete 回调函数中,将节流阀重置为 false
  • 在 onReachBottom 中判断节流阀的值,从而对数据请求进行节流控制
    • 如果节流阀的值为 true,则阻止当前请求
    • 如果节流阀的值为 false,则发起数据请求

js代码

  data: {
    colorList:[], //随机颜色的列表
    isLoding:false
  },
  getColors(){//获取随机颜色的方法
    this.setData({
      isLoding:true
    })
    //显示Loading效果
    wx.showLoading({
      title: '数据加载中...',
    })

    wx.request({
      url: 'https://applet-base-api-t.itheima.net/api/color',
      method:'get',
      success:({data:res})=>{
        this.setData({
          colorList:[...this.data.colorList,...res.data]//将获取的新数组和原数组通过展开运算符进行拼接
          //如果出错了,改成  colorList: this.data.colorList.concat(res.data)
        })
        },
        complete:()=>{
          wx.hideLoading() //隐藏Loading效果
          this.setData({
            isLoding:false
          })
      }
    })
  },
  /**
   * 页面上拉触底事件的处理函数
   */
  onReachBottom() {
    if(this.data.isLoding) return
    //调用获取随机颜色的方法
    this.getColors()
  },

总结

以上就是微信小程序之下拉刷新事件、上拉触底事件和案例的相关知识点,希望对你有所帮助。
积跬步以至千里,积怠惰以至深渊。时代在这跟着你一起努力哦!

你可能感兴趣的:(微信小程序,微信小程序,小程序)