tt.navigateToMiniProgram收藏我的收藏
收藏
我的收藏基础库 1.15.0 开始支持本方法,这是一个异步方法。
跳转到另一个小程序。
前提条件 | 无 |
业务背景 | 无 |
使用限制 | 该方法需要预先在 app.json 中配置 navigateToMiniProgramAppIdList 属性。每个小程序可跳转的其他小程序数量限制为不超过10个 |
注意事项 | 跳转需要由用户点击触发,只能在 bindtap 的事件回调中同步使用该 api,并且会弹窗询问是否允许跳转。 |
支持沙盒 | 否 |
相关教程 | 无 |
语法
tt.navigateToMiniProgram(options)
参数说明
options 为 object 类型,属性如下:
属性名 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
---|---|---|---|---|---|
path | string | 否 | 要跳转的小程序页面路径(不传则默认打开首页),允许携带 query 参数,格式详见示例 | 1.15.0 | |
extraData | object | 否 | 需要传递给目标小程序的数据,目标小程序可在 App.onLaunch,App.onShow,tt.getLaunchOptionsSync 中获取到这份数据。如果跳转的是小游戏,可以在 tt.onShow,tt.getLaunchOptionsSync 中可以获取到这份数据数据 | 1.15.0 | |
envVersion | enum | current | 否 | 要打开的小程序版本。合法的值有 current--线上版;latest--测试版。仅在当前小程序为开发版或测试版时此参数有效。如果当前小程序是正式版,则打开的小程序必定是正式版 | 1.15.0 |
appId | string | 是 | 要跳转的小程序 id | 1.15.0 | |
success | function | 否 | 接口调用成功的回调函数 | 1.15.0 | |
fail | function | 否 | 接口调用失败的回调函数 | 1.15.0 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) | 1.15.0 |
回调成功
object 类型,属性如下:
属性名 | 类型 | 说明 | 最低支持版本 |
---|---|---|---|
errMsg | string | "navigateToMiniProgram:ok" | 1.15.0 |
回调失败
object 类型,属性如下:
属性名 | 类型 | 说明 | 最低支持版本 |
---|---|---|---|
errMsg | string | "navigateToMiniProgram:fail" + 详细错误信息 | 1.15.0 |
扫码体验
请使用字节宿主APP扫码
代码示例
点击纠错