Page({
data: { // 页面的初始数据
text: 'init data',
array: [{msg: '1'}, {msg: '2'}]
},
options: { // 页面的组件选项,同 Component 构造器 中的 options ,需要基础库版本 2.10.1
},
onLoad: function (options) { // 生命周期函数--监听页面加载
/* 页面加载时触发。一个页面只会调用一次,可以在 onLoad 的参数中获取打开当前页面路径中的参数。
参数:
名称 类型 说明
query Object 打开当前页面路径中的参数
*/
},
onShow: function () { // 生命周期函数--监听页面显示
/* 页面显示/切入前台时触发。 */
},
onReady: function () { // 生命周期函数--监听页面初次渲染完成
/* 页面初次渲染完成时触发。一个页面只会调用一次,代表页面已经准备妥当,可以和视图层进行交互。
注意:对界面内容进行设置的 API 如wx.setNavigationBarTitle,请在onReady之后进行。详见生命周期
*/
},
onHide: function () { // 生命周期函数--监听页面隐藏
/* 页面隐藏/切入后台时触发。 如 wx.navigateTo 或底部 tab 切换到其他页面,小程序切入后台等。 */
},
onUnload: function () { // 生命周期函数--监听页面卸载
/* 页面卸载时触发。如wx.redirectTo或wx.navigateBack到其他页面时。 */
},
onPullDownRefresh: function () { // 页面相关事件处理函数--监听用户下拉动作
/* 监听用户下拉刷新事件。
需要在app.json的window选项中或页面配置中开启enablePullDownRefresh。
可以通过wx.startPullDownRefresh触发下拉刷新,调用后触发下拉刷新动画,效果与用户手动下拉刷新一致。
当处理完数据刷新后,wx.stopPullDownRefresh可以停止当前页面的下拉刷新。
*/
},
onReachBottom: function () { // 页面上拉触底事件的处理函数
/* 监听用户上拉触底事件。
可以在app.json的window选项中或页面配置中设置触发距离onReachBottomDistance。
在触发距离内滑动期间,本事件只会被触发一次。
*/
},
onShareAppMessage: function () { // 用户点击右上角分享
/* 监听用户点击页面内转发按钮(button 组件 open-type="share")或右上角菜单“转发”按钮的行为,并自定义转发内容。
注意:只有定义了此事件处理函数,右上角菜单才会显示“转发”按钮
参数 Object object:
参数 类型 说明 最低版本
from String 转发事件来源。
button:页面内转发按钮; 1.2.4
menu:右上角转发菜单
target Object 如果 from 值是 button,则 target 是触发这次转发事件的 button,否则为 undefined 1.2.4
webViewUrl String 页面中包含web-view组件时,返回当前web-view的url 1.6.4
*/
},
onShareTimeline: function () { // 用户点击右上角转发到朋友圈
/* 监听右上角菜单“分享到朋友圈”按钮的行为,并自定义分享内容。
注意:只有定义了此事件处理函数,右上角菜单才会显示“分享到朋友圈”按钮
自定义转发内容
事件处理函数返回一个 Object,用于自定义分享内容,不支持自定义页面路径,返回内容如下:
字段 说明 默认值
title 自定义标题,即朋友圈列表页上显示的标题 当前小程序名称
query 自定义页面路径中携带的参数,如 path?a=1&b=2 的 “?” 后面部分 当前页面路径携带的参数
imageUrl 自定义图片路径,可以是本地文件或者网络图片。支持 PNG 及 JPG,显示图片长宽比是 1:1。 默认使用小程序 Logo
*/
},
onAddToFavorites: function () { // 用户点击右上角收藏
/* 监听用户点击右上角菜单“收藏”按钮的行为,并自定义收藏内容。
参数 Object object:
参数 类型 说明
webViewUrl String 页面中包含web-view组件时,返回当前web-view的url
此事件处理函数需要 return 一个 Object,用于自定义收藏内容:
字段 说明 默认值
title 自定义标题 页面标题或账号名称
imageUrl 自定义图片,显示图片长宽比为 1:1 页面截图
query 自定义query字段 当前页面的query
*/
// webview 页面返回 webViewUrl
console.log('webViewUrl: ', res.webViewUrl)
return {
title: '自定义标题',
imageUrl: 'http://demo.png',
query: 'name=xxx&age=xxx',
}
},
onPageScroll: function () { // 页面滚动触发事件的处理函数
/* 监听用户滑动页面事件。
参数 Object object:
属性 类型 说明
scrollTop Number 页面在垂直方向已滚动的距离(单位px)
注意:请只在需要的时候才在 page 中定义此方法,不要定义空方法。
以减少不必要的事件派发对渲染层-逻辑层通信的影响。
注意:请避免在 onPageScroll 中过于频繁的执行 setData 等引起逻辑层-渲染层通信的操作。
尤其是每次传输大量数据,会影响通信耗时。
*/
},
onResize: function () { // 页面尺寸改变时触发
/* 小程序屏幕旋转时触发。 */
},
onTabItemTap: function (item) { // 当前是 tab 页时,点击 tab 时触发
console.log(item.index)
console.log(item.pagePath)
console.log(item.text)
/* 点击 tab 时触发
Object 参数说明:
参数 类型 说明 最低版本
index String 被点击tabItem的序号,从0开始 1.9.0
pagePath String 被点击tabItem的页面路径 1.9.0
text String 被点击tabItem的按钮文字 1.9.0
*/
},
else: function () { // 开发者可以添加任意的函数或数据到 Object 参数中,在页面的函数中用 this 可以访问
},
})