swan.onAppShow

基础库 3.60.2 开始支持,低版本需做兼容处理

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

# 方法参数

function callback
小程序切前台事件的回调函数。

callback返回参数说明 :

# Object res 返回的对象信息

属性 类型 说明 最低版本
scene String 打开智能小程序的场景值
path String 打开小程序的路径。
query Object 打开小程序的query。
shareTicket String 标记转发对象。
referrerInfo Object 从另一个小程序打开该小程序时,返回此字段。
entryType String 页面展现的来源标识,可取的值为: 'user'、'schema'、'sys',对应代表的意义如下表。 2.10.7
appURL String 展现时的调起协议,仅当entryType值为 schema 时存在。 2.10.7

# referrerInfo 的结构

属性 类型 说明
appId String 来源小程序的 appKey。
extraData Object 来源小程序传过来的数据

# entryType 的取值说明

属性 类型 说明
user String 表示通过home前后台切换或解锁屏幕等方式调起。
schema String 表示通过协议调起。
sys String 其它。

# 示例

# 扫码体验

请使用百度APP扫码

# 图片示例

# 代码示例

// app.js
App({
    onShow: function (res) {
        console.log('onShow', res)
        swan.showModal({
            title: 'res',
            content: JSON.stringify(res),
            showCancel: false
        });
    }
});

// app.js
App({
    onLaunch: function () {
        swan.onAppShow(function(res) {
            console.warn('请在真机中进行中进行验证,在工具中点击工具栏的刷新按钮也可模拟onShow触发事件,开发者按照自己的业务逻辑进行监听,被触发时机和App.onShow一致。');
            swan.showModal({
                title: 'res',
                content: JSON.stringify(res),
                showCancel: false
            });
            console.log('scene', res.scene);
            console.log('path', res.path);
            console.log('query', res.query);
            console.log('shareTicket', res.shareTicket);
            console.log('referrerInfo', res.referrerInfo);
            console.log('entryType', res.entryType);
            console.log('appURL', res.appURL);
        });
    }
});

# Bug&Tip

  • 在解析 query 的时候,基础库会使用decodeURIComponent对query的参数值进行一次解码,该功能将在未来的基础库版本下线,并提前通知开发者下线的基础库版本号;
  • 如在打开或跳转小程序时传递了 encode 后的值作为参数,为避免发生页面错误,使用时请自行将拿到的值使用decodeURIComponent进行一次decode操作。