页面page
函数 | 说明 |
onLoad |
监听页面加载 |
onShow |
监听页面显示 |
onReady |
监听页面初次渲染完成 |
onHide |
监听页面隐藏 |
onUnload |
监听页面卸载 |
函数 | 说明 |
onPullDownRefresh |
监听用户下拉动作 |
onReachBottom |
页面上拉触底事件的处理函数 |
onShareAppMessage |
用户点击右上角转发 |
onPageScroll |
页面滚动触发事件的处理函数 |
onTabItemTap |
当前是 tab 页时,点击 tab 时触发 |
// 生命周期回调函数
1.onLoad(Object query)
页面加载时触发。一个页面只会调用一次,可以在 onLoad 的参数中获取打开当前页面路径中的参数。
2.onShow()
页面显示/切入前台时触发。
3.onReady()
页面初次渲染完成时触发。一个页面只会调用一次,代表页面已经准备妥当,可以和视图层进行交互。
4.onHide()
页面隐藏/切入后台时触发。 如 navigateTo 或底部 tab 切换到其他页面,小程序切入后台等。
5.onUnload()
页面卸载时触发。如redirectTo或navigateBack到其他页面时。
// 页面事件处理函数
1.onPullDownRefresh()
监听用户下拉刷新事件。
需要在app.json的window选项中或页面配置中开启enablePullDownRefresh。
可以通过wx.startPullDownRefresh触发下拉刷新,调用后触发下拉刷新动画,效果与用户手动下拉刷新一致。
当处理完数据刷新后,wx.stopPullDownRefresh可以停止当前页面的下拉刷新。
2.onReachBottom()
监听用户上拉触底事件。
可以在app.json的window选项中或页面配置中设置触发距离onReachBottomDistance。
在触发距离内滑动期间,本事件只会被触发一次。
3.onPageScroll(Object)
参数:scrollTop Number 页面在垂直方向已滚动的距离(单位px)
监听用户滑动页面事件。
4.onShareAppMessage(Object)
监听用户点击页面内转发按钮(<button> 组件 open-type="share")或右上角菜单“转发”按钮的行为,并自定义转发内容。
小程序App
函数 | 说明 |
onLaunch |
小程序初始化完成时(全局只触发一次) |
onShow |
小程序启动,或从后台进入前台显示时 |
onReady |
监听页面初次渲染完成 |
onHide |
监听小程序隐藏,小程序从前台进入后台时 |
onError |
小程序发生脚本错误,或者 api 调用失败时触发,会带上错误信息 |
onPageNotFound |
页面不存在监听函数 |
组件Component构造器
函数 | 说明 |
created |
实例化不能调用 setData |
attached |
渲染之前 |
ready |
渲染 |
moved |
在组件实例被移动到节点树另一个位置时执行 |
detached |
在组件实例被从页面节点树移除时执行 |