微信小程序提供了一些自带的函数和方法,用于处理页面的生命周期、事件处理、数据绑定等。以下是一些常用的微信小程序页面自带函数和方法:
一、生命周期
1.onLoad(options)
页面加载时触发。一个页面只会调用一次,可以在 onLoad 的参数中获取打开当前页面路径中的参数。
option是一个对象,通常是页面跳转传参的内容对象
2.onShow()
页面显示/切入前台时触发。
3.onReady()
页面初次渲染完成时触发。一个页面只会调用一次,代表页面已经准备妥当,可以和视图层进行交互。
注意:对界面内容进行设置的 API 如wx.setNavigationBarTitle,请在onReady之后进行。
4.onHide()
页面隐藏/切入后台时触发。 如 wx.navigateTo 或底部 tab 切换到其他页面,小程序切入后台等。
5.onUnload()
页面卸载时触发。如wx.redirectTo或wx.navigateBack到其他页面时。
6.onRouteDone()
路由动画完成时触发。如 wx.navigateTo 页面完全推入后 或 wx.navigateBack 页面完全恢复时。
二、页面事件处理函数
1.onPullDownRefresh() 监听用户下拉刷新事件。
2.onReachBottom() 监听用户上拉触底事件。
3.onPageScroll(Object object) 监听用户滑动页面事件。
4.onAddToFavorites(Object object)
本接口为 Beta 版本,安卓 7.0.15 版本起支持,暂只在安卓平台支持
监听用户点击右上角菜单“收藏”按钮的行为,并自定义收藏内容。
5.onShareAppMessage(Object object)
监听用户点击页面内转发按钮(button 组件 open-type="share")或右上角菜单“转发”按钮的行为,并自定义转发内容。
6.onShareTimeline()
监听右上角菜单“分享到朋友圈”按钮的行为,并自定义分享内容。
注意:只有定义了此事件处理函数,右上角菜单才会显示“分享到朋友圈”按钮
本接口为 Beta 版本,暂只在 Android 平台支持,详见分享到朋友圈 (Beta)
7.onResize(Object object) 页面尺寸改变时触发。
8.onTabItemTap(Object object) 点击 tab 时触发
9.onSaveExitState()
每当小程序可能被销毁之前,页面回调函数 onSaveExitState 会被调用,可以进行退出状态的保存。
三、除了上述页面生命周期函数外,还有一些常用的方法:
- setData:用于更新页面的数据,可以将数据绑定到页面的视图上。
- selectComponent:通过组件的 id 或自定义组件的选择器,获取组件实例,可以调用组件的方法或访问组件的属性。
- createAnimation:创建一个动画实例,用于实现页面中的动画效果。
- getSystemInfoSync:同步获取设备的系统信息,如屏幕宽高、设备型号等。
- wx.showToast、wx.showModal 等:用于显示提示框、模态框等常用的交互组件。
四、附带一份笔者自己整理的微信小程序生命周期笔记