1、导航组件 类似超链接标签

属性

类型

默认值

必填

说明

最低版本

target

string

self

否

在哪个目标上发生跳转，默认当前小程序

2.0.7

url

string

 

否

当前小程序内的跳转链接

1.0.0

open-type

string

navigate

否

跳转方式

1.0.0

delta

number

1

否

当 open-type 为 'navigateBack' 时有效，表示回退的层数

1.0.0

app-id

string

 

否

当target="miniProgram"时有效，要打开的小程序 appId

2.0.7

path

string

 

否

当target="miniProgram"时有效，打开的页面路径，如果为空则打开首页

2.0.7

extra-data

object

 

否

当target="miniProgram"时有效，需要传递给目标小程序的数据，目标小程序可在 App.onLaunch()，App.onShow() 中获取到这份数据。详情

2.0.7

version

string

release

否

当target="miniProgram"时有效，要打开的小程序版本

2.0.7

hover-class

string

navigator-hover

否

指定点击时的样式类，当hover-class="none"时，没有点击态效果

1.0.0

hover-stop-propagation

boolean

false

否

指定是否阻止本节点的祖先节点出现点击态

1.5.0

hover-start-time

number

50

否

按住后多久出现点击态，单位毫秒

1.0.0

hover-stay-time

number

600

否

手指松开后点击态保留时间，单位毫秒

1.0.0

bindsuccess

string

 

否

当target="miniProgram"时有效，跳转小程序成功

2.0.7

bindfail

string

 

否

当target="miniProgram"时有效，跳转小程序失败

2.0.7

bindcomplete

string

 

否

当target="miniProgram"时有效，跳转小程序完成

2.0.7

2、target目标属性跳转的有效值

值

说明

最低版本

self

当前小程序

 

miniProgram

其它小程序

 

3、open-type跳转方式属性的有效值

值

说明

最低版本

navigate

对应 wx.navigateTo 或 wx.navigateToMiniProgram 的功能

 

redirect

对应 wx.redirectTo 的功能

 

switchTab

对应 wx.switchTab 的功能

 

reLaunch

对应 wx.reLaunch 的功能

1.1.0

navigateBack

对应 wx.navigateBack 的功能

1.1.0

exit

退出小程序，target="miniProgram"时生效

2.1.0

4、version属性的有效值

值

说明

最低版本

develop

开发版

 

trial

体验版

 

release

正式版，仅在当前小程序为开发版或体验版时此参数有效；如果当前小程序是正式版，则打开的小程序必定是正式版。

 

5、使用限制

1）、需要用户确认跳转 从 2.3.0 版本开始，在跳转至其他小程序前，将统一增加弹窗，询问是否跳转，用户确认后才可以跳转其他小程序。如果用户点击取消，则回调 fail cancel。

2）、每个小程序可跳转的其他小程序数量限制为不超过 10 个 从 2.4.0 版本以及指定日期（具体待定）开始，开发者提交新版小程序代码时，如使用了跳转其他小程序功能，则需要在代码配置中声明将要跳转的小程序名单，限定不超过 10 个，否则将无法通过审核。该名单可在发布新版时更新，不支持动态修改。配置方法详见 配置。调用此接口时，所跳转的 appId 必须在配置列表中，否则回调 fail appId "${appId}" is not in navigateToMiniProgramAppIdList。

6、关于调试

  • 在开发者工具上调用此 API 并不会真实的跳转到另外的小程序，但是开发者工具会校验本次调用跳转是否成功。详情
  • 开发者工具上支持被跳转的小程序处理接收参数的调试。详情

7、代码如下：

<!--
    导航组件 navigation
    1、块级元素 默认会换行 可以直接加宽度和高度
    2、url 要跳转的页面的路径 绝对路径 相对路径
    3、target 要跳转到当前的小程序 还是其他的小程序的页面
    self 默认值 自己 小程序的页面
    miniProgram 其他的小程序的页面
    4、open-type 跳转的方式
        1）、navigation 默认值 保留当前页面 ， 跳转到应用内的某个页面，但是不能跳转到tabbar页面
        2）、redirect 关闭当前页面，跳转到应用内的某个页面，但是不允许跳转到tabbar页面
        3）、switchTab 跳转到tabBar页面，并关闭其他所有非tabBar页面
        4）、reLaunch 关闭所有页面，打开到应用内的某个页面
-->

<navigator url="/pages/demo09/demo09">轮播图页面</navigator>
<navigator url="/pages/index/index">直接跳转到tabbar页面</navigator>
<navigator url="/pages/demo09/demo09" open-type="redirect">轮播图页面 redirect</navigator>
<navigator url="/pages/index/index" open-type="switchTab">switchTab直接跳转到 tabbar 页面</navigator>
<navigator url="/pages/index/index" open-type="reLaunch">reLaunch 可以随便跳转</navigator>