【WeChat Mini Program】Page Events

目录

小程序 - 视图与逻辑

页面导航 - 导航传参

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是 导航 The passed parameter object
  },

页面事件 - 下拉刷新事件

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：

<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('The pull-up bottoming event is triggered')
  },

3. 配置上拉触底距离

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

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