目录
️全局配置-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节点常用的配置项
属性名类型默认值说明navigationBarTitleTextString字符串导航栏标题文字内容navigationBarBackgroundColorHexColor#000000导航栏背景颜色,如 #000000navigationBarTextStyleStringwhite导航栏标题颜色,仅支持black/whitebackgroundColorHexColor#ffffff窗口的背景色backgroundTextStyleStringdark下拉loading的样式,仅支持dark/lightenablePullDownRefreshBooleanfalse是否全局开启下拉刷新onReachBottomDistanceNumber50页面上拉触底事件触发时距页面底部距离,单位为px
window导航栏相关设置
设置导航栏标题
设置导航栏背景颜色
设置导航栏的标题颜色
window下拉刷新
下拉刷新是移动端的专有名词,指的是通过手指在屏幕上的下拉滑倒操作,从而重新加载页面数据的行为。
启用下拉刷新的两种方式:
①全局开启下拉刷新
在app.json的window节点中,将enablePullDownRefresh 设置为 true
②局部开启下拉刷新
在页面的.json配置文件中,将enablePullDownRefresh 设置为 true
在实际开发中,推荐使用第2种方式,为需要的页面单独开启下拉刷新的效果。
设置全局下拉刷新功能
注意:在app.json中启用下拉刷新功能,会作用于每个小程序页面。
设置下拉刷新的窗口背景色
当全局开启下拉刷新后,默认的窗口背景色为白色,如果自定义下拉刷新窗口的背景色,可以通过如下设置:
设置下拉刷新的loading样式
当全局开启下拉刷新功能之后,默认窗口的loading样式为白色,如果想更改loading样式的效果,可以将backgroundTextStyle修改值,但可选值只有 light 和 dark 两种。
监听页面下拉事件
在页面的.js文件中,通过onPullDownRefresh()函数即可监听当前页面的下拉刷新事件
//页面结构
//给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 - 定义获取随机颜色的方法
步骤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文件可以实现这种需求。
注意:当页面配置与全局配置发生冲突的时候,根据就近原则,最终的效果以页面配置为准。
属性类型默认值描述navigationBarBackgroundColorHexColor#000000当前页面导航栏背景颜色,如#000000navigationBarTextStyleStringwhite当前页面导航栏标题颜色,仅支持black/whitenavigationBarTitleTextString无当前页面导航栏标题文字内容backgroundColorHexColor#ffffff当前页面窗口的背景色backgroundTextStyleStringdark当前页面下拉loading的样式,仅支持drak/lightenablePullDownRefreshBooleanfalse是否为当前页面开启下拉刷新的效果onReachBottomDistanceNumber50页面上拉触底事件触发时距页面底部距离,单位px
相关阅读
发表评论