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跳转方式属性的有效值
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>