全部产品

my.switchTab

跳转到指定标签页(tabbar)页面,并关闭其他所有非标签页页面。

如果小程序是一个多标签(tab)应用,即客户端窗口的底部栏可以切换页面,那么可以通过标签页配置项指定标签栏的表现形式,以及标签切换时显示的对应页面。

通过页面跳转(my.navigateTo)或者页面重定向(my.redirectTo)所到达的页面,即使是定义在标签页配置中的页面,也不会显示底部的标签栏。标签页的第一个页面必须是首页。

相关问题请参见 路由 FAQ

示例代码

// app.json
{
  "tabBar": {
    "items": [{
      "pagePath": "pages/home/index",
      "name": "首页"
    },{
      "pagePath": "pages/user/index",
      "name": "用户"
    }]
  }
}

//.js
my.switchTab({
  url: 'pages/home/index'
})

入参

Object 类型,属性如下:

属性

类型

必填

说明

url

String

跳转的标签页的路径(需在 app.json 的 tabbar 字段定义的页面)。

注意:路径后不能带参数。

success

Function

调用成功的回调函数。

fail

Function

调用失败的回调函数。

complete

Function

调用结束的回调函数(调用成功、失败都会执行)。