【小程序】页面事件

深碍√TFBOYSˉ_ 2024-03-30 11:46 63阅读 0赞

**目录**

下拉刷新事件

1. 什么是下拉刷新

2. 启用下拉刷新

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

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

5. 停止下拉刷新的效果

上拉触底事件

1. 什么是上拉触底

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

编辑 3. 配置上拉触底距离

上拉触底案例

1. 案例效果展示

2. 案例的实现步骤

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

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

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

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

编辑 3. 步骤5 - 添加 loading 提示效果

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

自定义编译模式

## 下拉刷新事件 ##

### 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：

![5a4bb6de2f084f3ea624eb6a9ef98f07.png][]

在触发页面的下拉刷新事件的时候，如果要把 count 的值重置为 0，示例代码如下：

![daea88057b53479b89e7d3becda05174.png][]

### 5. 停止下拉刷新的效果 ###

当处理完下拉刷新后，下拉刷新的 loading 效果会一直显示，不会主动消失，所以需要手动隐藏下

拉刷新的 loading 效果。此时，调用 wx.stopPullDownRefresh() 可以停止当前页面的下拉刷新。示

例代码如下：

![b198f19099d64165ba4a45ce77220c5d.png][]

## 上拉触底事件 ##

### 1. 什么是上拉触底 ###

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

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

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

下：

### ![df6227f5726e4f28a6aea0a466d95def.png][] 3. 配置上拉触底距离 ###

上拉触底距离指的是触发上拉触底事件时，滚动条距离页面底部的距离。 可以在全局或页面的

.json 配置文件中，通过 onReachBottomDistance 属性来配置上拉触底的距离。 小程序默认的触

底距离是 50px，在实际开发中，可以根据自己的需求修改这个默认值。

## 上拉触底案例 ##

### 1. 案例效果展示 ###

![3f6ed44537d24b4fa45b69d905b9ebda.png][]

### 2. 案例的实现步骤 ###

定义获取随机颜色的方法

在页面加载时获取初始数据

渲染 UI 结构并美化页面效果

在上拉触底时调用获取随机颜色的方法

添加 loading 提示效果

对上拉触底进行节流处理

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

![e8456d2f595247ffa2cce1430f6dc1ce.png][]

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

### ![01c09fd61b48420fa0fa48f700661a33.png][] 3. 步骤3 - 渲染 UI 结构并美化页面效果 ###

![5a5a5d19f1b14c8c8062306d15f1361a.png][]

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

### ![3dda8b034fc240f5ac8a2e854bd31c0a.png][] 3. 步骤5 - 添加 loading 提示效果 ###

![1f2fc927e0124ee8b163a8e27b246e0d.png][]

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

在 data 中定义 isloading 节流阀

false 表示当前没有进行任何数据请求

true 表示当前正在进行数据请求

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

在刚调用 getColors 时将节流阀设置 true

在网络请求的 complete 回调函数中，将节流阀重置为 false

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

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

## 自定义编译模式 ##

![cb7926833e2246f6819ae40d71908520.png][]

[5a4bb6de2f084f3ea624eb6a9ef98f07.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/8770693ad3d74520a640952455417092.png
[daea88057b53479b89e7d3becda05174.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/f42b285a513a428792293f7818c6ea7b.png
[b198f19099d64165ba4a45ce77220c5d.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/aa3c891fa6d644f6a3e4cab72dd347b4.png
[df6227f5726e4f28a6aea0a466d95def.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/85116f4e78f94343b44c6a080655413d.png
[3f6ed44537d24b4fa45b69d905b9ebda.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/a9898bd0bd7b48caa3d8f078dc5917ff.png
[e8456d2f595247ffa2cce1430f6dc1ce.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/11e73e627bd44d37940cffaa71a4027c.png
[01c09fd61b48420fa0fa48f700661a33.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/8951c3ed576f428280f707d135ef1031.png
[5a5a5d19f1b14c8c8062306d15f1361a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/8b804038272a4e27a4a97a383bb4a1ee.png
[3dda8b034fc240f5ac8a2e854bd31c0a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/abf53a53984048efb507de3f09f6c282.png
[1f2fc927e0124ee8b163a8e27b246e0d.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/32a8d50fe31e48bc905dffa297d34f99.png
[cb7926833e2246f6819ae40d71908520.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/7b4a58c4ee27418f895b5031fc07b97c.png