跳到主要内容
版本:4.x

Taro.onAppShow(callback)

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

返回有效 referrerInfo 的场景

场景值场景appId含义
1020公众号 profile 页相关小程序列表来源公众号
1035公众号自定义菜单来源公众号
1036App 分享消息卡片来源App
1037小程序打开小程序来源小程序
1038从另一个小程序返回来源小程序
1043公众号模板消息来源公众号

注意

部分版本在无referrerInfo的时候会返回 undefined,建议使用 options.referrerInfo && options.referrerInfo.appId 进行判断。

支持情况:

参考文档

类型

(callback: (res: CallbackResult) => void) => void

参数

参数类型说明
callback(res: CallbackResult) => void小程序切前台事件的回调函数

CallbackResult

参数类型必填说明
pathstring小程序切前台的路径
queryTaroGeneral.IAnyObject小程序切前台的 query 参数
shareTicketstringshareTicket,详见获取更多转发信息
scenenumber小程序切前台的场景值
referrerInfoResultReferrerInfo来源信息。从另一个小程序、公众号或 App 进入小程序时返回。否则返回 {}。(参见后文注意)
forwardMaterialsForwardMaterial[]打开的文件信息数组,只有从聊天素材场景打开(scene为1173)才会携带该参数
chatTypekeyof ChatType从微信群聊/单聊打开小程序时,chatType 表示具体微信群聊/单聊类型
apiCategorykeyof ApiCategoryAPI 类别

ResultReferrerInfo

来源信息。从另一个小程序、公众号或 App 进入小程序时返回。否则返回 {}。(参见后文注意)

参数类型必填说明
appIdstring来源小程序、公众号或 App 的 appId
extraDataTaroGeneral.IAnyObject来源小程序传过来的数据,scene=1037或1038时支持

ForwardMaterial

ChatType 类型合法值

参数类型说明
typestring文件的mimetype类型
namestring文件名
pathstring文件路径(如果是webview则是url)
sizenumber文件大小

ChatType

ChatType 类型合法值

参数说明
1微信联系人单聊
2企业微信联系人单聊
3普通微信群聊
4企业微信互通群聊

ApiCategory

API 类别合法值

参数说明
default默认类别
nativeFunctionalized原生功能化,视频号直播商品、商品橱窗等场景打开的小程序
browseOnly仅浏览,朋友圈快照页等场景打开的小程序
embedded内嵌,通过打开半屏小程序能力打开的小程序