tt.navigateToMiniProgram
跳转到另一个小程序
输入
继承标准对象输入,扩展属性描述:
属性 | 类型 | 必填 | 默认值 | 说明 | 最低支持版本 |
---|---|---|---|---|---|
appId | string | 是 | 要跳转的小程序 id | 1.15.0 | |
path | string | 否 | 要跳转的小程序页面路径(不传则默认打开首页),允许携带 query 参数,格式详见示例 | 1.15.0 | |
extraData | object | 否 | 需要传递给目标小程序的数据,目标小程序可在 App.onLaunch ,App.onShow ,tt.getLaunchOptionsSync 中获取到这份数据。如果跳转的是小游戏,可以在 tt.onShow 、tt.getLaunchOptionsSync 中可以获取到这份数据数据 | 1.15.0 | |
envVersion | string | 否 | current | 要打开的小程序版本。合法的值有current --线上版;latest --测试版。仅在当前小程序为开发版或测试版时此参数有效。如果当前小程序是正式版,则打开的小程序必定是正式版 | 1.15.0 |
success | function | 否 | 接口调用成功的回调函数 | 1.15.0 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) | 1.15.0 | |
fail | function | 否 | 接口调用失败的回调函数 | 1.15.0 |
代码示例
// app.json
{
...
"navigateToMiniProgramAppIdList": [
"tt2d495bf4b2xxxxxx"
],
...
}
tt.navigateToMiniProgram({
appId: "tt2d495bf4b2xxxxxx",
path: "pages/index/index?arg1=ascii&arg2=" + encodeURIComponent("中文"),
extraData: {
arg3: "hello"
},
success: function() {
that.setData({
success: true
});
},
fail: function(e) {
console.log(e);
that.setData({
success: false
});
}
});
Bug & Tip
- 该方法需要预先在app.json中配置navigateToMiniProgramAppIdList属性。每个小程序可跳转的其他小程序数量限制为不超过10个
- 只能在 bindtap 中使用该 api,并且会弹窗询问是否允许跳转