小程序入门学习(八)之页面事件

一、下拉刷新新事件

1. 什么是下拉刷新

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

2. 启用下拉刷新

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

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

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

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

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

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

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

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

复制代码
<view>count值是:{{count}}</view>
<button bindtap="addCount">+1</button>



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


/**
* 页面相关事件处理函数--监听用户下拉动作
*/
onPullDownRefresh: function () {
	// console.log('触发了message页面的下拉刷新')
	this.setData({
	  count: 0
	})
    wx.stopPullDownRefresh()//停止下拉刷新的效果
},

二、上拉触底事件

1. 什么是上拉触底

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

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

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

复制代码
  /**
   * 页面上拉触底事件的处理函数
   */
  onReachBottom: function () {
    console.log('触发了上拉触底的事件')
  },

3. 配置上拉触底距离

上拉触底距离指的是触发上拉触底事件时,滚动条距离页面底部的距离。

可以在全局或页面的 .json 配置文件中,通过 onReachBottomDistance 属性来配置上拉触底的距离。 小程序默认的触底距离是 50px,在实际开发中,可以根据自己的需求修改这个默认值。

三、上拉触底案例

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

复制代码
  /**
   * 页面的初始数据
   */
  data: {
    colorList: [],
    isloding: false
  },



  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]
        })
      },
    })
  },

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

复制代码
  /**
   * 生命周期函数--监听页面加载
   */
  onLoad: function (options) {
    this.getColors()
  },

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

复制代码
//wxml
<view wx:for="{{colorList}}" wx:key="index" class="num-item" style="background-color: rgba({{item}});">{{item}}</view>


/* pages/contact/contact.wxss */
.num-item {
  border: 1rpx 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;
  color: black;
}

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

复制代码
  /**
   * 页面上拉触底事件的处理函数
   */
  onReachBottom: function () {
    console.log('触发了上拉触底的事件')
    if (this.data.isloding) return

    this.getColors()
  },

步骤5 - 添加 loading 提示效果

复制代码
getColors(){
	wx.showLoading({ title:'数据加载中...'})//1.展示 loading 效果

	//发起请求,获取随机颜色值的数组
	wx.request({
		// 省略其它代码...
		complete:()=>{
			wx.hideLoading()//2.隐藏 loading 效果  
		}  
	})
},

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

1)在 data 中定义 isloading 节流阀

  • false 表示当前没有进行任何数据请求
  • true 表示当前正在进行数据请求

2)在 getColors() 方法中修改 isloading 节流阀的值

  • 在刚调用 getColors 时将节流阀设置 true
  • 在网络请求的 complete 回调函数中,将节流阀重置为 false

3)在 onReachBottom 中判断节流阀的值,从而对数据请求进行节流控制

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

觉得有帮助的话,打赏一下呗。。

需要商务合作(定制程序)的欢迎私信!!

相关推荐
2501_915918412 天前
iOS 上架全流程指南 iOS 应用发布步骤、App Store 上架流程、uni-app 打包上传 ipa 与审核实战经验分享
android·ios·小程序·uni-app·cocoa·iphone·webview
00后程序员张2 天前
iOS App 混淆与加固对比 源码混淆与ipa文件混淆的区别、iOS代码保护与应用安全场景最佳实践
android·安全·ios·小程序·uni-app·iphone·webview
破无差2 天前
《赛事报名系统小程序》
小程序·html·uniapp
00后程序员张3 天前
详细解析苹果iOS应用上架到App Store的完整步骤与指南
android·ios·小程序·https·uni-app·iphone·webview
海绵宝宝不喜欢侬3 天前
uniapp-微信小程序分享功能-onShareAppMessage
微信小程序·小程序·uni-app
2501_915106323 天前
Xcode 上传 ipa 全流程详解 App Store 上架流程、uni-app 生成 ipa 文件上传与审核指南
android·macos·ios·小程序·uni-app·iphone·xcode
亮子AI3 天前
【小程序】微信小程序隐私协议
微信小程序·小程序
weixin_177297220693 天前
短剧小程序系统开发:打造个性化娱乐新平台
小程序·娱乐·短剧
weixin_lynhgworld3 天前
剧本杀小程序系统开发:开启沉浸式社交娱乐新纪元
小程序·娱乐
~废弃回忆 �༄3 天前
mobx-miniprogram小程序的数据传输
小程序