字节跳动小程序开发框架 启动程序

由 卓别林 创建, 最后一次修改 2019-07-25

App()


App(params) 是框架启动小程序的入口函数,需要开发者可以通过App(params)的参数指定小程序的生命周期函数和其他一些自定义参数。

params参数说明:

属性 类型 描述 触发时机
onLaunch Function 生命周期函数--监听小程序初始化 当小程序初始化完成时,会触发 onLaunch(全局只触发一次)
onShow Function 生命周期函数--监听小程序显示 当小程序启动,或从后台进入前台显示,会触发 onShow
onHide Function 生命周期函数--监听小程序隐藏 当小程序从前台进入后台,会触发 onHide
onError Function 错误监听函数 当小程序发生脚本错误,或者 api 调用失败时,会触发 onError 并带上错误信息
onPageNotFound Function 页面不存在监听函数 当小程序出现要打开的页面不存在的情况,会带上页面信息回调该函数,详见下文
其他 Any 开发者可以添加任意的函数或数据到 Object 参数中,用 this 可以访问

示例代码:

App({
  onLaunch: function(options) {
    // Do something initial when launch.
  },
  onShow: function(options) {
      // Do something when show.
  },
  onHide: function() {
      // Do something when hide.
  },
  onError: function(msg) {
    console.log(msg)
  },
  globalData: 'I am global data'
})

onLaunch 参数


onLaunch参数同tt.getLaunchOptionsSync

onShow参数:

属性 类型 说明
path String 启动页面
query Object 启动参数
referrerInfo Object 来源信息。从另一个小程序进入小程序时返回。
scene String 场景值

referrerInfo说明

字段 类型 说明
appId String 来源小程序id
extraData Object 来源小程序打开当前小程序时携带的数据

onPageNotFound


当要打开的页面并不存在时,会回调这个监听器,并带上以下信息:

属性 类型 说明
path String 不存在页面的路径
query Object 打开不存在页面的 query
isEntryPage Boolean 是否本次启动的首个页面

示例代码:

App({
  onPageNotFound(res) {
    tt.redirectTo({
      url: 'pages/...'
    }) // 重定向页面;如果是 tabbar 页面,请使用 tt.switchTab
  }
})

getApp()


如果想在page里面获取App()设置的全局变量的话,可以通过getApp()获取。

示例代码:

var appInstance = getApp()
console.log(appInstance.globalData) // I am global data


以上内容是否对您有帮助:
二维码
建议反馈
二维码