【微信小程序】页面事件

向右看齐 2023-10-01 23:03 48阅读 0赞

**目录**

小程序 - 视图与逻辑

页面导航 - 导航传参

1. 声明式导航传参

2. 编程式导航传参

3. 在 onLoad 中接收导航参数

页面事件 - 下拉刷新事件

1. 什么是下拉刷新

2. 启用下拉刷新

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

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

5. 停止下拉刷新的效果

页面事件 - 上拉触底事件

1. 什么是上拉触底

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

3. 配置上拉触底距离

--------------------

## **小程序 - 视图与逻辑** ##

### **页面导航 - 导航传参** ###

#### **1. 声明式导航传参**  ####

navigator 组件的 url 属性用来指定将要跳转到的页面的路径。同时， 路径的后面还可以携带参数 ：

*  参数与路径之间使用 ? 分隔 
 *  参数键与参数值用 = 相连 
 *  不同参数用 & 分隔

**代码示例如下：**

<navigator url="/pages/info/info?name=zs&age=20">跳转到info页面</navigator>

#### **2. 编程式导航传参**  ####

调用  wx.navigateTo( Object object )  方法跳转页面时，也可以携带参数，代码示例如下：

<button bindtap="gotoInfo2">跳转到info页面</button>

gotoInfo2() {
        wx.navigateTo({
          url: '/pages/info/info?name=ls&gender=男'
        })
      },

#### **3. 在 onLoad 中接收导航参数**  ####

通过 声明式导航传参 或 编程式导航传参 所携带的参数，可以直接在  onLoad 事件 中直接获取到，示例代码如下：

/**
       * 生命周期函数--监听页面加载
       */
    onLoad: function (options) {
        console.log(options)
     //options是 导航 传过来的参数对象
      },

### **页面事件 - 下拉刷新事件** ###

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

![789aff6ed1024d5499bc7c48082354df.gif][]

<view>count值是：{
           {count}}</view>
    <button bindtap="addCount">+1</button>

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

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

/**
       * 页面相关事件处理函数--监听用户下拉动作
       */
    onPullDownRefresh: function () {
      
        this.setData({
          count: 0
        })
    
      },

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

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

/**
       * 页面相关事件处理函数--监听用户下拉动作
       */
      onPullDownRefresh: function () {
        // console.log('触发了message页面的下拉刷新')
        this.setData({
          count: 0
        })
    //当数据重置成功后，调用此函数，关闭下拉刷新的效果
        wx.stopPullDownRefresh()
      },

### **页面事件 - 上拉触底事件**  ###

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

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

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

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

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

#### **3. 配置上拉触底距离**  ####

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

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

[789aff6ed1024d5499bc7c48082354df.gif]: https://img-blog.csdnimg.cn/789aff6ed1024d5499bc7c48082354df.gif