生命周期钩子
在 UniApp 中,页面的生命周期与 Vue 的生命周期钩子紧密相关,并且针对小程序平台,UniApp 还扩展了一些额外的生命周期钩子。以下是重要的页面生命周期钩子及其简要说明:
基础的 Vue 生命周期钩子
-
beforeCreate
- 在实例初始化之后,数据观测 (data observer) 和 event/watcher 事件配置之前被调用。
-
created
- 实例已经创建完成之后被调用。此时已完成数据观测,属性和方法的运算,watch/event 事件回调。但是尚未开始 DOM 编译,即未挂载到 DOM 上。
-
beforeMount
- 在挂载开始之前被调用:相关的 render 函数首次被调用。
-
mounted
- el 被新创建的 vm. e l 替换,并挂载到实例上去之后调用该钩子。如果根实例挂载到了一个文档内的元素上,当 m o u n t e d 被调用时 v m . el 替换,并挂载到实例上去之后调用该钩子。如果根实例挂载到了一个文档内的元素上,当 mounted 被调用时 vm. el替换,并挂载到实例上去之后调用该钩子。如果根实例挂载到了一个文档内的元素上,当mounted被调用时vm.el 也在文档内。
-
beforeUpdate
- 数据更新时调用,发生在虚拟 DOM 打补丁之前。这里适合在更新之前访问现有的 DOM,比如手动移除已添加的事件监听器。
-
updated
- 由于数据更改导致的虚拟 DOM 重新渲染和打补丁,在这之后会调用该钩子。当这个钩子被调用时,组件 DOM 已经更新,所以你现在可以执行依赖于 DOM 的操作。
-
beforeDestroy
- 实例销毁之前调用。在这一步,实例仍然完全可用。
-
destroyed
- Vue 实例销毁后调用。调用后,Vue 实例指示的所有东西都会解绑定,所有的事件监听器会被移除,所有的子实例也会被销毁。
uniapp特有的生命周期钩子
-
onLoad
- 监听页面加载,其参数为上个页面传递的数据,参数类型为 Object(用于页面传参),触发时机早于
onShow
。
- 监听页面加载,其参数为上个页面传递的数据,参数类型为 Object(用于页面传参),触发时机早于
-
onShow
- 监听页面显示。页面每次出现在屏幕上都触发,包括从下级页面点返回露出当前页面。
-
onReady
- 监听页面初次渲染完成。注意如果渲染速度快,会在页面进入动画完成前触发。
-
onHide
- 监听页面隐藏。
-
onUnload
- 监听页面卸载。
-
onPullDownRefresh
- 监听用户下拉动作: 一般用于下拉刷新动作,需要在
pages.json
里开启 enablePullDownRefresh。可以通过uni.stopPullDownRefresh
停止当前页面的下拉刷新。
- 监听用户下拉动作: 一般用于下拉刷新动作,需要在
-
onReachBottom
- 页面滚动到底部的事件(不是scroll-view滚到底),常用于分页加载数据。
-
onShareAppMessage
- 用户点击右上角菜单的"转发"按钮时触发,可用于自定义转发内容。
-
onPageScroll
- 监听页面滚动,参数为 Object。
-
onTabItemTap
- 点击 tab 时触发,参数为 Object,仅在包含 tabBar 的页面中有效。