• JS API 列表
  • 基础
  • tt.canIUse
  • tt.base64ToArrayBuffer
  • tt.arrayBufferToBase64
  • 生命周期
  • tt.canIPutStuffOverComponent
  • 版本更新
  • 定时器
  • 应用级事件
  • tt.onAppShow
  • tt.offAppShow
  • tt.onAppHide
  • tt.offAppHide
  • tt.offUnhandledRejection
  • tt.onError
  • tt.offError
  • tt.onLazyLoadError
  • tt.offLazyLoadError
  • tt.onUnhandledRejection
  • tt.onAppLaunch
  • tt.offAppLaunch
  • 环境变量
  • 性能
  • 线程
  • 窗口尺寸变化
  • tt.setPageInfo
  • TTML
  • 网络
  • 媒体
  • 地图
  • 文件
  • 数据缓存
  • 地理位置
  • 设备
  • 画布
  • 界面
  • 页面导航
  • 开放接口
  • 行业开放
  • 第三方平台
  • 其它
  • tt.onAppShow
    收藏
    我的收藏

    基础库 1.46.0 开始支持本方法,这是一个同步方法。

    监听小程序切前台事件,该事件回调参数与 App.onShow 一致。

    前提条件
    业务背景
    使用限制
    注意事项
    • 如在打开或跳转小程序时传递了 encode 后的值作为参数,为避免发生页面错误,请自行将拿到的值使用 decodeURIComponent 进行一次 decode 操作;
    • 如果多次注册同一个回调函数,该回调函数会多次执行。
    支持沙盒
    相关教程

    语法

    tt.onAppShow(callback)

    参数说明

    callback

    类型默认值必填说明最低支持版本
    function
    小程序切前台事件的回调函数。
    1.46.0

    callback 是一个回调函数,接收 object 类型的参数,属性如下:

    属性名类型说明最低支持版本
    scenestring

    小程序切前台的场景值

    1.46.0
    referrerInfoobject
    来源信息,从另一个小程序或 App 进入小程序时返回
    1.46.0
    pathstring
    小程序切前台的路径 (代码包路径)
    1.46.0
    queryobject
    小程序切前台的 query 参数
    1.46.0
    showFromenum
    唤起小程序页面的来源方式:10 - 用户点击小程序入口 schema,0 - 其它方式(如前后台切换)
    2.7.0

    referrerInfo 类型说明

    object 类型,属性如下:

    属性名类型说明最低支持版本
    appIdstring
    来源小程序的 appId
    1.46.0
    extraDataobject
    来源小程序传过来的数据
    1.46.0

    返回值

    扫码体验

    请使用字节宿主APP扫码

    代码示例