tt.navigateToMiniProgram
收藏
我的收藏

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

跳转到另一个小程序。

前提条件
业务背景
使用限制

该方法需要预先在 app.json 中配置 navigateToMiniProgramAppIdList 属性。每个小程序可跳转的其他小程序数量限制为不超过10

注意事项

跳转需要由用户点击触发,只能在 bindtap 的事件回调中同步使用该 api,并且会弹窗询问是否允许跳转。

支持沙盒
相关教程

语法

tt.navigateToMiniProgram(options)

参数说明

options 为 object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
pathstring
要跳转的小程序页面路径(不传则默认打开首页),允许携带 query 参数,格式详见示例
1.15.0
extraDataobject

需要传递给目标小程序的数据,目标小程序可在 App.onLaunchApp.onShowtt.getLaunchOptionsSync 中获取到这份数据。如果跳转的是小游戏,可以在 tt.onShowtt.getLaunchOptionsSync 中可以获取到这份数据数据

1.15.0
envVersionenumcurrent

要打开的小程序版本。合法的值有 current--线上版;latest--测试版。仅在当前小程序为开发版或测试版时此参数有效。如果当前小程序是正式版,则打开的小程序必定是正式版

1.15.0
appIdstring
要跳转的小程序 id
1.15.0
successfunction
接口调用成功的回调函数
1.15.0
failfunction
接口调用失败的回调函数
1.15.0
completefunction
接口调用结束的回调函数(调用成功、失败都会执行)
1.15.0

回调成功

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring
"navigateToMiniProgram:ok"
1.15.0

回调失败

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring
"navigateToMiniProgram:fail" + 详细错误信息
1.15.0

扫码体验

请使用字节宿主APP扫码

代码示例