微信小程序页面导航 navigator 组件

傷城~ 2021-09-08 05:12 456阅读 0赞

[完整**微信小程序(Java后端) 技术贴**目录清单页面（必看）][Java_]

页面导航(navigator)组件,它类似于HTML中的a标签；

<table> 
 <thead> 
  <tr> 
   <th align="left">属性</th> 
   <th align="left">类型</th> 
   <th align="left">默认值</th> 
   <th align="left">必填</th> 
   <th align="left">说明</th> 
   <th align="left">最低版本</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">target</td> 
   <td align="left">string</td> 
   <td align="left">self</td> 
   <td align="left">否</td> 
   <td align="left">在哪个目标上发生跳转，默认当前小程序</td> 
   <td align="left"><a href="https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html" rel="nofollow">2.0.7</a></td> 
  </tr> 
  <tr> 
   <td align="left">url</td> 
   <td align="left">string</td> 
   <td align="left"></td> 
   <td align="left">否</td> 
   <td align="left">当前小程序内的跳转链接</td> 
   <td align="left"><a href="https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html" rel="nofollow">1.0.0</a></td> 
  </tr> 
  <tr> 
   <td align="left">open-type</td> 
   <td align="left">string</td> 
   <td align="left">navigate</td> 
   <td align="left">否</td> 
   <td align="left">跳转方式</td> 
   <td align="left"><a href="https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html" rel="nofollow">1.0.0</a></td> 
  </tr> 
  <tr> 
   <td align="left">delta</td> 
   <td align="left">number</td> 
   <td align="left">1</td> 
   <td align="left">否</td> 
   <td align="left">当 open-type 为 ‘navigateBack’ 时有效，表示回退的层数</td> 
   <td align="left"><a href="https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html" rel="nofollow">1.0.0</a></td> 
  </tr> 
  <tr> 
   <td align="left">app-id</td> 
   <td align="left">string</td> 
   <td align="left"></td> 
   <td align="left">否</td> 
   <td align="left">当<code>target="miniProgram"</code>时有效，要打开的小程序 appId</td> 
   <td align="left"><a href="https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html" rel="nofollow">2.0.7</a></td> 
  </tr> 
  <tr> 
   <td align="left">path</td> 
   <td align="left">string</td> 
   <td align="left"></td> 
   <td align="left">否</td> 
   <td align="left">当<code>target="miniProgram"</code>时有效，打开的页面路径，如果为空则打开首页</td> 
   <td align="left"><a href="https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html" rel="nofollow">2.0.7</a></td> 
  </tr> 
  <tr> 
   <td align="left">extra-data</td> 
   <td align="left">object</td> 
   <td align="left"></td> 
   <td align="left">否</td> 
   <td align="left">当<code>target="miniProgram"</code>时有效，需要传递给目标小程序的数据，目标小程序可在 <code>App.onLaunch()</code>，<code>App.onShow()</code> 中获取到这份数据。<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/app-service/app.html" rel="nofollow">详情</a></td> 
   <td align="left"><a href="https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html" rel="nofollow">2.0.7</a></td> 
  </tr> 
  <tr> 
   <td align="left">version</td> 
   <td align="left">string</td> 
   <td align="left">release</td> 
   <td align="left">否</td> 
   <td align="left">当<code>target="miniProgram"</code>时有效，要打开的小程序版本</td> 
   <td align="left"><a href="https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html" rel="nofollow">2.0.7</a></td> 
  </tr> 
  <tr> 
   <td align="left">hover-class</td> 
   <td align="left">string</td> 
   <td align="left">navigator-hover</td> 
   <td align="left">否</td> 
   <td align="left">指定点击时的样式类，当<code>hover-class="none"</code>时，没有点击态效果</td> 
   <td align="left"><a href="https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html" rel="nofollow">1.0.0</a></td> 
  </tr> 
  <tr> 
   <td align="left">hover-stop-propagation</td> 
   <td align="left">boolean</td> 
   <td align="left">false</td> 
   <td align="left">否</td> 
   <td align="left">指定是否阻止本节点的祖先节点出现点击态</td> 
   <td align="left"><a href="https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html" rel="nofollow">1.5.0</a></td> 
  </tr> 
  <tr> 
   <td align="left">hover-start-time</td> 
   <td align="left">number</td> 
   <td align="left">50</td> 
   <td align="left">否</td> 
   <td align="left">按住后多久出现点击态，单位毫秒</td> 
   <td align="left"><a href="https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html" rel="nofollow">1.0.0</a></td> 
  </tr> 
  <tr> 
   <td align="left">hover-stay-time</td> 
   <td align="left">number</td> 
   <td align="left">600</td> 
   <td align="left">否</td> 
   <td align="left">手指松开后点击态保留时间，单位毫秒</td> 
   <td align="left"><a href="https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html" rel="nofollow">1.0.0</a></td> 
  </tr> 
  <tr> 
   <td align="left">bindsuccess</td> 
   <td align="left">string</td> 
   <td align="left"></td> 
   <td align="left">否</td> 
   <td align="left">当<code>target="miniProgram"</code>时有效，跳转小程序成功</td> 
   <td align="left"><a href="https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html" rel="nofollow">2.0.7</a></td> 
  </tr> 
  <tr> 
   <td align="left">bindfail</td> 
   <td align="left">string</td> 
   <td align="left"></td> 
   <td align="left">否</td> 
   <td align="left">当<code>target="miniProgram"</code>时有效，跳转小程序失败</td> 
   <td align="left"><a href="https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html" rel="nofollow">2.0.7</a></td> 
  </tr> 
  <tr> 
   <td align="left">bindcomplete</td> 
   <td align="left">string</td> 
   <td align="left"></td> 
   <td align="left">否</td> 
   <td align="left">当<code>target="miniProgram"</code>时有效，跳转小程序完成</td> 
   <td align="left"><a href="https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html" rel="nofollow">2.0.7</a></td> 
  </tr> 
 </tbody> 
</table>

**target 的合法值**

<table> 
 <thead> 
  <tr> 
   <th align="left">值</th> 
   <th align="left">说明</th> 
   <th align="left">最低版本</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">self</td> 
   <td align="left">当前小程序</td> 
   <td align="left"></td> 
  </tr> 
  <tr> 
   <td align="left">miniProgram</td> 
   <td align="left">其它小程序</td> 
   <td align="left"></td> 
  </tr> 
 </tbody> 
</table>

**open-type 的合法值**

<table> 
 <thead> 
  <tr> 
   <th align="left">值</th> 
   <th align="left">说明</th> 
   <th align="left">最低版本</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">navigate</td> 
   <td align="left">对应 <a href="https://developers.weixin.qq.com/miniprogram/dev/api/route/wx.navigateTo.html" rel="nofollow">wx.navigateTo</a> 或 <a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html" rel="nofollow">wx.navigateToMiniProgram</a> 的功能</td> 
   <td align="left"></td> 
  </tr> 
  <tr> 
   <td align="left">redirect</td> 
   <td align="left">对应 <a href="https://developers.weixin.qq.com/miniprogram/dev/api/route/wx.redirectTo.html" rel="nofollow">wx.redirectTo</a> 的功能</td> 
   <td align="left"></td> 
  </tr> 
  <tr> 
   <td align="left">switchTab</td> 
   <td align="left">对应 <a href="https://developers.weixin.qq.com/miniprogram/dev/api/route/wx.switchTab.html" rel="nofollow">wx.switchTab</a> 的功能</td> 
   <td align="left"></td> 
  </tr> 
  <tr> 
   <td align="left">reLaunch</td> 
   <td align="left">对应 <a href="https://developers.weixin.qq.com/miniprogram/dev/api/route/wx.reLaunch.html" rel="nofollow">wx.reLaunch</a> 的功能</td> 
   <td align="left"><a href="https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html" rel="nofollow">1.1.0</a></td> 
  </tr> 
  <tr> 
   <td align="left">navigateBack</td> 
   <td align="left">对应 <a href="https://developers.weixin.qq.com/miniprogram/dev/api/route/wx.navigateBack.html" rel="nofollow">wx.navigateBack</a> 的功能</td> 
   <td align="left"><a href="https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html" rel="nofollow">1.1.0</a></td> 
  </tr> 
  <tr> 
   <td align="left">exit</td> 
   <td align="left">退出小程序，<code>target="miniProgram"</code>时生效</td> 
   <td align="left"><a href="https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html" rel="nofollow">2.1.0</a></td> 
  </tr> 
 </tbody> 
</table>

**version 的合法值**

<table> 
 <thead> 
  <tr> 
   <th align="left">值</th> 
   <th align="left">说明</th> 
   <th align="left">最低版本</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">develop</td> 
   <td align="left">开发版</td> 
   <td align="left"></td> 
  </tr> 
  <tr> 
   <td align="left">trial</td> 
   <td align="left">体验版</td> 
   <td align="left"></td> 
  </tr> 
  <tr> 
   <td align="left">release</td> 
   <td align="left">正式版，仅在当前小程序为开发版或体验版时此参数有效；如果当前小程序是正式版，则打开的小程序必定是正式版。</td> 
   <td align="left"></td> 
  </tr> 
 </tbody> 
</table>

**使用限制**

1.  需要用户确认跳转 从 `2.3.0` 版本开始，在跳转至其他小程序前，将统一增加弹窗，询问是否跳转，用户确认后才可以跳转其他小程序。如果用户点击取消，则回调 `fail cancel`。
2.  每个小程序可跳转的其他小程序数量限制为不超过 10 个 从 2.4.0 版本以及指定日期（具体待定）开始，开发者提交新版小程序代码时，如使用了跳转其他小程序功能，则需要在代码配置中声明将要跳转的小程序名单，限定不超过 10 个，否则将无法通过审核。该名单可在发布新版时更新，不支持动态修改。配置方法详见 [配置][Link 1]。调用此接口时，所跳转的 appId 必须在配置列表中，否则回调 `fail appId "${appId}" is not in navigateToMiniProgramAppIdList`。

**无需声明跳转名单，不限跳转数量（众测中）**

1.  从2020年4月24日起，使用跳转其他小程序功能将无需在全局配置中声明跳转名单，调用此接口时将不再校验所跳转的 AppID 是否在 navigateToMiniProgramAppIdList 中。
2.  从2020年4月24日起，跳转其他小程序将不再受数量限制，使用此功能时请注意遵守运营规范。

**关于调试**

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

**Bug & Tip**

1.  `tip`：`navigator-hover` 默认为 `{background-color: rgba(0, 0, 0, 0.1); opacity: 0.7;}`, [navigator][] 的子节点背景色应为透明色

**示例代码**

[在开发者工具中预览效果][Link 3]

index.wxml

<view class="btn-area">
      <navigator url="/navigate/navigate?title=navigate" hover-class="navigator-hover">跳转到新页面</navigator>
      <navigator url="../redirect/redirect?title=redirect" open-type="redirect" hover-class="other-navigator-hover">在当前页打开</navigator>
      
    </view>

index.js

// redirect.js navigator.js
    Page({ 
      onLoad: function (options) { 
        this.setData({ 
          title: options.title
        })
      }
    })

index.wxss

@import '../lib/weui.wxss'
    /** wxss **/
    /** 修改默认的navigator点击态 **/
    .navigator-hover { 
        color:blue;
    }
    /** 自定义其他点击态样式类 **/
    .other-navigator-hover { 
        color:red;
    }

navigator.wxml

<view style="text-align:center"> {
       {title}} </view>
    <view> 点击左上角返回回到之前页面 </view>

navigator.js

// redirect.js navigator.js
    Page({ 
      onLoad: function (options) { 
        this.setData({ 
          title: options.title
        })
      }
    })

运行效果：

![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-SJZseJnc-1622870031676)(image-20210605103436764.png)\]][img-SJZseJnc-1622870031676_image-20210605103436764.png]

> 微信搜一搜【java1234】关注这个放荡不羁的程序员，关注后回复【资料】有我准备的一线大厂笔试面试资料以及简历模板。

[Java_]: https://blog.csdn.net/caoli201314/article/details/116643190
[Link 1]: https://developers.weixin.qq.com/miniprogram/dev/framework/config.html
[Link 2]: https://developers.weixin.qq.com/miniprogram/dev/devtools/different.html#%E8%B7%B3%E8%BD%AC%E5%B0%8F%E7%A8%8B%E5%BA%8F%E8%B0%83%E8%AF%95%E6%94%AF%E6%8C%81
[navigator]: https://developers.weixin.qq.com/miniprogram/dev/component/navigator.html
[Link 3]: https://developers.weixin.qq.com/s/2Ec11cmI6BY1
[img-SJZseJnc-1622870031676_image-20210605103436764.png]: /images/20210716/fa36e97389f440029256749fb6041f9c.png