⑥微信小程序--》小程序全局配置和详解下拉刷新和上拉触底页面事件-Toy模板网

这篇具有很好参考价值的文章主要介绍了⑥微信小程序--》小程序全局配置和详解下拉刷新和上拉触底页面事件。希望对大家有所帮助。如果存在错误或未考虑完全的地方，请大家不吝赐教，您也可以点击"举报违法"按钮提交疑问。

🏍️全局配置-window

🍇window小程序窗口的组成部分

🍇window节点常用的配置项

🍈window导航栏相关设置

设置导航栏标题

设置导航栏背景颜色

设置导航栏的标题颜色

🍉window下拉刷新

设置全局下拉刷新功能

设置下拉刷新的窗口背景色

设置下拉刷新的loading样式

监听页面下拉事件

停止下拉刷新效果

🍊window上拉触底

什么是上拉触底

监听页面上拉触底事件

配置上拉触底距离

上拉触底案例

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

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

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

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

步骤5 - 添加 loading 提示效果

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

🏍️页面配置

🏍️全局配置-window

全局设置小程序窗口的外观。

小程序根目录下的 app.json 文件是小程序的全局配置文件。常用的配置项如下：

pages记录当前小程序所有页面的存放路径

window全局设置小程序窗口的外观

tabBar设置小程序底部的 tabBar 效果

style是否启用新版的组件样式

🍇window小程序窗口的组成部分

微信小程序上来触底开启,黑马小程序基础教程,小程序,微信小程序

🍇window节点常用的配置项

属性名	类型	默认值	说明
navigationBarTitleText	String	字符串	导航栏标题文字内容
navigationBarBackgroundColor	HexColor	#000000	导航栏背景颜色，如 #000000
navigationBarTextStyle	String	white	导航栏标题颜色，仅支持black/white
backgroundColor	HexColor	#ffffff	窗口的背景色
backgroundTextStyle	String	dark	下拉loading的样式，仅支持dark/light
enablePullDownRefresh	Boolean	false	是否全局开启下拉刷新
onReachBottomDistance	Number	50	页面上拉触底事件触发时距页面底部距离，单位为px

🍈window导航栏相关设置

设置导航栏标题

微信小程序上来触底开启,黑马小程序基础教程,小程序,微信小程序

设置导航栏背景颜色

微信小程序上来触底开启,黑马小程序基础教程,小程序,微信小程序

设置导航栏的标题颜色

微信小程序上来触底开启,黑马小程序基础教程,小程序,微信小程序

🍉window下拉刷新

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

启用下拉刷新的两种方式：

①全局开启下拉刷新

在app.json的window节点中，将enablePullDownRefresh 设置为 true

②局部开启下拉刷新

在页面的.json配置文件中，将enablePullDownRefresh 设置为 true

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

设置全局下拉刷新功能

微信小程序上来触底开启,黑马小程序基础教程,小程序,微信小程序

注意：在app.json中启用下拉刷新功能，会作用于每个小程序页面。

微信小程序上来触底开启,黑马小程序基础教程,小程序,微信小程序

设置下拉刷新的窗口背景色

当全局开启下拉刷新后，默认的窗口背景色为白色，如果自定义下拉刷新窗口的背景色，可以通过如下设置：

微信小程序上来触底开启,黑马小程序基础教程,小程序,微信小程序

设置下拉刷新的loading样式

当全局开启下拉刷新功能之后，默认窗口的loading样式为白色，如果想更改loading样式的效果，可以将backgroundTextStyle修改值，但可选值只有 light 和 dark 两种。

微信小程序上来触底开启,黑马小程序基础教程,小程序,微信小程序

监听页面下拉事件

在页面的.js文件中，通过onPullDownRefresh()函数即可监听当前页面的下拉刷新事件

//页面结构
<view>count的值是：{{count}}</view>
<button bindtap="addCount">+1</button>
 
//给js文件data设置初始数据
data: {
    count:0
}
 
// +1 按钮设置点击事件处理函数
addCount(){
  this.setData({
    count:this.data.count + 1
  })
}
 
/**
 * 页面相关事件处理函数--监听用户下拉动作
 */
onPullDownRefresh() {
  this.setData({
    count:0
  })
},

微信小程序上来触底开启,黑马小程序基础教程,小程序,微信小程序

停止下拉刷新效果

根据上文案例，虽然在编辑器模拟器上效果良好但在在真机模拟过程中，下拉刷新是不会停止的，会一直刷新下去，所以我们要进行设置将其刷新后停止继续下拉刷新。

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

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

🍊window上拉触底

什么是上拉触底

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

简言之：当手机浏览页面时，需要下滑得到更多内容，当滚动条滚动到下面多少的距离需要自动加载下一页，这个距离就是上拉触底的距离。默认距离为50px，如果没有特殊需求，建议使用默认值即可。

微信小程序上来触底开启,黑马小程序基础教程,小程序,微信小程序

监听页面上拉触底事件

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

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

微信小程序上来触底开启,黑马小程序基础教程,小程序,微信小程序

配置上拉触底距离

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

可以在全局或者页面的.json文件中，通过onReachBottomDistance属性来配置上拉触底的距离。

微信小程序上来触底开启,黑马小程序基础教程,小程序,微信小程序

上拉触底案例

微信小程序上来触底开启,黑马小程序基础教程,小程序,微信小程序

定义获取随机颜色的方法

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

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

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

添加 loading 提示效果

对上拉触底进行节流处理

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

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

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

  onLoad: function (options) {
    this.getColors()
  },

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

.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 () {
    this.getColors()
  },

步骤5 - 添加 loading 提示效果

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

在 data 中定义 isloading 节流阀

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

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

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

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

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

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

如果节流阀的值为 true，则阻止当前请求

如果节流阀的值为 false，则发起数据请求

 data: {
    colorList: [],
    isloding: false
  },

  getColors() {
    this.setData({
      isloding: true
    })
    // 需要展示 loading 效果
    wx.showLoading({
      title: '数据加载中...'
    })
    wx.request({
      url: 'https://www.escook.cn/api/color',
      method: 'get',
      success: ({ data: res }) => {
        this.setData({
          colorList: [...this.data.colorList, ...res.data]
        })
      },
      complete: () => {
        wx.hideLoading()
        this.setData({
          isloding: false
        })
      }
    })
  },

 /**
  * 页面上拉触底事件的处理函数
 */
  onReachBottom: function () {
    if (this.data.isloding) return

    this.getColors()
  },

🏍️页面配置

小程序中，app.json中的window节点，可以全局配置小程序中的每一个页面窗口的表现，如果某些小程序页面想要拥有特殊的窗口表现，页面的.json文件可以实现这种需求。

注意：当页面配置与全局配置发生冲突的时候，根据就近原则，最终的效果以页面配置为准。

属性	类型	默认值	描述
navigationBarBackgroundColor	HexColor	#000000	当前页面导航栏背景颜色，如#000000
navigationBarTextStyle	String	white	当前页面导航栏标题颜色，仅支持black/white
navigationBarTitleText	String	无	当前页面导航栏标题文字内容
backgroundColor	HexColor	#ffffff	当前页面窗口的背景色
backgroundTextStyle	String	dark	当前页面下拉loading的样式，仅支持drak/light
enablePullDownRefresh	Boolean	false	是否为当前页面开启下拉刷新的效果
onReachBottomDistance	Number	50	页面上拉触底事件触发时距页面底部距离，单位px