navigator

页面链接。

属性名 类型 默认值 说明 最低版本
target String 在哪个目标上发生跳转，默认当前小程序 2.0.7
url String 当前小程序内的跳转链接
open-type String navigate 跳转方式
delta Number 当 open-type 为 'navigateBack' 时有效，表示回退的层数
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 version release 当target="miniProgram"时有效，要打开的小程序版本，有效值 develop（开发版），trial（体验版），release（正式版），仅在当前小程序为开发版或体验版时此参数有效；如果当前小程序是正式版，则打开的小程序必定是正式版。 2.0.7
hover-class String navigator-hover 指定点击时的样式类，当hover-class="none"时，没有点击态效果
hover-stop-propagation Boolean false 指定是否阻止本节点的祖先节点出现点击态 1.5.0
hover-start-time Number 50 按住后多久出现点击态，单位毫秒
hover-stay-time Number 600 手指松开后点击态保留时间，单位毫秒

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

注：navigator-hover 默认为 {background-color: rgba(0, 0, 0, 0.1); opacity: 0.7;}, <navigator/> 的子节点背景色应为透明色

示例代码：

在开发者工具中预览效果

  1. /** wxss **/
  2. /** 修改默认的navigator点击态 **/
  3. .navigator-hover {
  4.     color:blue;
  5. }
  6. /** 自定义其他点击态样式类 **/
  7. .other-navigator-hover {
  8.     color:red;
  9. }
  1. <!-- sample.wxml -->
  2. <view class="btn-area">
  3.   <navigator url="/page/navigate/navigate?title=navigate" hover-class="navigator-hover">跳转到新页面</navigator>
  4.   <navigator url="../../redirect/redirect/redirect?title=redirect" open-type="redirect" hover-class="other-navigator-hover">在当前页打开</navigator>
  5.   <navigator url="/page/index/index" open-type="switchTab" hover-class="other-navigator-hover">切换 Tab</navigator>
  6.   <navigator target="miniProgram" open-type="navigate" app-id="" path="" extra-data="" version="release">打开绑定的小程序</navigator>
  7. </view>
  1. <!-- navigator.wxml -->
  2. <view style="text-align:center"> {{title}} </view>
  3. <view> 点击左上角返回回到之前页面 </view>
  1. <!-- redirect.wxml -->
  2. <view style="text-align:center"> {{title}} </view>
  3. <view> 点击左上角返回回到上级页面 </view>
  1. // redirect.js navigator.js
  2. Page({
  3.   onLoad: function(options) {
  4.     this.setData({
  5.       title: options.title
  6.     })
  7.   }
  8. })

原文:

https://developers.weixin.qq.com/miniprogram/dev/component/navigator.html