微信小程序页面自带的函数方法

334 阅读2分钟

微信小程序提供了一些自带的函数和方法,用于处理页面的生命周期、事件处理、数据绑定等。以下是一些常用的微信小程序页面自带函数和方法:

一、生命周期

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 会被调用,可以进行退出状态的保存。

三、除了上述页面生命周期函数外,还有一些常用的方法:

  1. setData:用于更新页面的数据,可以将数据绑定到页面的视图上。
  2. selectComponent:通过组件的 id 或自定义组件的选择器,获取组件实例,可以调用组件的方法或访问组件的属性。
  3. createAnimation:创建一个动画实例,用于实现页面中的动画效果。
  4. getSystemInfoSync:同步获取设备的系统信息,如屏幕宽高、设备型号等。
  5. wx.showToast、wx.showModal 等:用于显示提示框、模态框等常用的交互组件。

四、附带一份笔者自己整理的微信小程序生命周期笔记

image.png