uni-app生命周期

应用生命周期

uni-app支持如下应用生命周期函数:

函数名说明
onLaunchuni-app初始化完成时触发(全局只触发一次)
onShowuni-app启动,或从后台进入前台显示
onHideuni-app从前台进入后台
onErroruni-app报错时触发
onUniNViewMessagenvue页面发送的数据进行监听,可参考nvue向vue通讯
onUnhandledRejection对未处理的Promise拒绝事件监听函数
onPageNotFound页面不存在监听函数
onThemeChange监听系统主题变化

注意:
1、 应用生命周期仅可以在App.vue中监听,在其他页面监听无效。
2、 onLaunch里进行页面跳转,如遇白屏报错,请参考https://ask.dcloud.net.cn/article/35942

页面生命周期

uni-app支持如下页面生命周期函数:

函数名说明平台差异说明最低版本
onLoad监听页面加载,其参数为上个页面传递的数据,参数类型为Object(用于页面传参),参考示例
onShow监听页面显示,页面每次出现在屏幕上都触发,包括从下级页面点返回露出当前页面
onReady监听页面初次渲染。注意如果渲染速度快,会在页面进入动画完成前触发
onHide监听页面隐藏
onUnload监听页面卸载
onResize监听窗口尺寸变化App、微信小程序
onPullDownRefresh监听用户下拉动作,一般用于下拉刷新,参考示例
onReachBottom页面上拉触底事件的处理函数
onTabItemTap点击tab时触发,参数为Object,具体见下方注意事项微信小程序、百度小程序、H5、App(自定义组件模式)
onShareAppMessage用户点击右上角分享微信小程序、百度小程序、字节跳动小程序、支付宝小程序
onPageScroll监听页面滚动,参数为Object
onNavigationBarButtonTap监听原生标题栏按钮点击事件,参数为ObjectApp、H5
onBackPress监听页面返回,返回event={from:backbutton、navigateBack},backbutton表示来源是左上角返回按钮或android返回键;navigateBack表示来源是uni.navigateBack;表示来源是uni.navigateBack;详细说明及使用:onBackPress详解
onNavigationBarSearchInputChanged监听原生标题栏搜索输入框输入内容变化事件App、H51.6.0
onNavigationBarSearchInputConfirmed监听原生标题栏搜索输入框搜索事件,用户点击软键盘上的”搜索“按钮时触发。App、H51.6.0
onNavigationBarSearchInputClicked监听原生标题栏搜索输入框点击事件App、H51.6.0
onShareTimeline监听用户点击右上角转发到朋友圈微信小程序2.8.1+
onAddToFavorites监听用户点击右上角收藏微信小程序2.8.1+

onPageScroll参数说明:

属性类型说明
scrollTopNumber页面在垂直方向已滚动的距离(单位px)

onTabItemTap参数说明:

属性类型说明
indexString被点击tabItem的序号,从0开始
pagePathString被点击tabItem的页面路径
textString被点击tabItem的按钮文字

注意:

onTabItemTap常用于点击当前tabitem,滚动或刷新当前页面。如果是点击不同的tabitem,一定会触发页面切换。
如果想在App端实现点击某个tabitem不跳转页面,不能使用onTabItemTap,可以使用plus.nativeObj.view放一个区块盖住原先的tabitem,并拦截点击事件。
onTabItemTap在App端,从HBuilderX 1.9 的自定义组件编译模式开始支持。
避免在 onShow 里使用需要权限的 API(比如 setScreenBrightness() 等需要手机权限), 可能会再次触发onShow造成死循环。

onNavigationBarButtonTap参数说明:

属性类型说明
indexNumber原生标题栏按钮数组的下标

onBackPress参数说明:

属性类型说明
fromString触发返回行为的来源:‘backbutton’——左上角导航栏按钮及安卓返回键; ‘navigateBack’——uni.navigateBack()方法。
// An highlighted block
export default{
	data() {
		return{};
	},
	onBackPress(options) {
		console.log('from:' + options.from)
	}
 }
©️2020 CSDN 皮肤主题: 深蓝海洋 设计师:CSDN官方博客 返回首页