未进化的程序猿
人生最苦痛的是梦醒了无路可走。做梦的人是幸福的;倘没有看出可走的路,最要紧的是不要去惊醒他。鲁迅

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>

 

posted on 2020-12-04 19:05  甘茂旺  阅读(213)  评论(0编辑  收藏  举报