开发
API

tt.navigateToMiniProgram

基础库 1.15.0 开始支持本方法。

跳转到另一个小程序。

语法

tt.navigateToMiniProgram(options)

参数说明

options 为 object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
appIdstring要跳转的小程序 id1.15.0
pathstring要跳转的小程序页面路径(不传则默认打开首页),允许携带 query 参数,格式详见示例1.15.0
extraDataobject需要传递给目标小程序的数据,目标小程序可在 App.onLaunchApp.onShowtt.getLaunchOptionsSync 中获取到这份数据。如果跳转的是小游戏,可以在 tt.onShowtt.getLaunchOptionsSync 中可以获取到这份数据数据1.15.0
envVersionstringcurrent要打开的小程序版本。合法的值有 current--线上版;latest--测试版。仅在当前小程序为开发版或测试版时此参数有效。如果当前小程序是正式版,则打开的小程序必定是正式版1.15.0
successFunction接口调用成功的回调函数1.15.0
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)1.15.0
failFunction接口调用失败的回调函数1.15.0

回调成功

object 类型,属性如下:

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

回调失败

object 类型,属性如下:

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

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

// app.json
{
  ...
  "navigateToMiniProgramAppIdList": [
    "tt2d495bf4b2xxxxxx"
  ],
  ...
}
tt.navigateToMiniProgram({
  appId: "tt2d495bf4b2xxxxxx",
  path: "pages/index/index?arg1=ascii&arg2=" + encodeURIComponent("中文"),
  extraData: {
    arg3: "hello",
  },
  success: function () {
    this.setData({
      success: true,
    });
  },
  fail: function (e) {
    console.log(e);
    this.setData({
      success: false,
    });
  },
});

Bug & Tip

  • Tip: 该方法需要预先在 app.json 中配置 navigateToMiniProgramAppIdList 属性。每个小程序可跳转的其他小程序数量限制为不超过10
  • Tip: 只能在 bindtap 中使用该 api,并且会弹窗询问是否允许跳转
点击纠错
评价此篇文档