抖音开放平台Logo
开发者文档
小程序
控制台
  • JS API 列表
  • 基础
  • TTML
  • 网络
  • 媒体
  • 地图
  • 文件
  • 数据缓存
  • 地理位置
  • 设备
  • 画布
  • 界面
  • 页面导航
  • tt.navigateTo
  • tt.redirectTo
  • tt.switchTab
  • tt.navigateBack
  • tt.reLaunch
  • 开放接口
  • 行业开放
  • 第三方平台
  • 其它

    • tt.navigateTo
    收藏
    我的收藏

    基础库 1.0.0 开始支持本方法，这是一个异步方法。
    保留当前页面，跳转到应用内的某个页面，但是不能跳转到 tabBar 页面，使用 tt.navigateBack 可以返回到原页面。

    语法

    tt.navigateTo(options)

    参数说明

    options 为 object 类型，属性如下：
    属性名
    类型
    默认值
    必填
    说明
    最低支持版本
    url
    string
    ​
    是
    需要跳转的应用内非 tabBar 的页面的路径 , 路径后可以带参数，参数与路径之间使用 ? 分隔，参数键与参数值用 = 相连，不同参数用 & 分隔，如 "path?key=value&key2=value2"
    1.0.0
    query
    object
    ​
    否
    跳转时需要传递的 query 参数，query 对象中的 key、value 最终会被拼接到 url 中，如 "key1=value1&key2=value2"。请注意，如果 query 对象中的 key 和 url 中的 key 重复将被忽略。
    3.7.0
    success
    function
    ​
    否
    接口调用成功的回调函数
    1.0.0
    fail
    function
    ​
    否
    接口调用失败的回调函数
    1.0.0
    complete
    function
    ​
    否
    接口调用结束的回调函数（调用成功、失败都会执行）
    1.0.0

    回调成功

    object 类型，属性如下：
    属性名
    类型
    说明
    最低支持版本
    errMsg
    string
    "navigateTo:ok"
    1.0.0

    回调失败

    object 类型，属性如下：
    属性名
    类型
    说明
    最低支持版本
    errMsg
    string
    "navigateTo:fail " + 详细错误信息
    1.0.0

    错误说明

    errNo
    errMsg
    说明
    最低支持版本
    20000
    navigateTo:fail params.url should be string, but got undefined
    url 未传
    2.28.0
    20000
    navigateTo:fail params.url should be string, but got ${url}
    url 为非字符串
    2.28.0
    20000
    navigateTo:fail url is invalid
    url 无效
    2.28.0
    21101
    navigateTo:fail Count of page jump is more then 10 times
    跳转超过最大页面栈层数
    2.28.0
    21102
    navigateTo:fail Can only jump to non-tab pages
    不允许跳转到 tabBar 页面
    2.28.0
    21103
    navigateTo:fail Full screen player exists
    全屏播放器状态下不允许跳转
    2.28.0
    21500
    navigateTo:fail illegal content found
    未通过敏感词检测
    2.28.0
    21500
    navigateTo:fail url "${removeHtmlSuffixFromUrl(url)}" is not in app.json
    页面未在 app.json 中配置
    2.28.0
    21500
    navigateTo:fail this page has been blocked
    目标页面被屏蔽
    2.28.0

    扫码体验

    代码示例

    开发者工具中预览

    Bug & Tip

      •Tip: 使用 navigator 组件也可以实现同样的功能；
      •Tip: 小程序页面栈中最多能有 10 个页面，达到 10 个后调用 tt.navigateTo 会失败；
      •Tip: 路由跳转传递的参数可以在页面 onLoad 生命周期中获取，基础库会将该部份字符串内容解析为 Object 格式。
    ​