-

navigator

基础库 1.0.0 开始支持,低版本需做兼容处理

页面链接。

属性名 类型 默认值 说明
target
String self 在哪个目标上发生跳转,默认当前小程序,可选值self/miniProgram
url String   应用内的跳转链接
open-type String navigate 跳转方式
delta Number   当 open-type 为 'navigateBack' 时有效,表示回退的层数
app-id
String
  当target="miniProgram"时有效,要打开的小程序 appId
path
String
  当target="miniProgram"时有效,打开的页面路径,如果为空则打开首页
extra-data
Object
  当target="miniProgram"时有效,需要传递给目标小程序的数据,目标小程序可在 App.onLaunch() App.onShow()  中获取到这份数据。
version
version
release 当target="miniProgram"时有效,要打开的小程序版本,有效值 develop(开发版),trial(体验版),release(正式版),仅在当前小程序为开发版或体验版时此参数有效;如果当前小程序是正式版,则打开的小程序必定是正式版。
hover-class String navigator-hover 指定点击时的样式类,当hover-class="none"时,没有点击态效果
hover-stop-propagation
Boolean
false
指定是否阻止本节点的祖先节点出现点击态
hover-start-time Number 50 按住后多久出现点击态,单位毫秒
hover-stay-time Number 600 手指松开后点击态保留时间,单位毫秒
bindsuccess
String
当target="miniProgram"时有效,跳转小程序成功
bindfail
String
当target="miniProgram"时有效,跳转小程序失败
bindcomplete
String
当target="miniProgram"时有效,跳转小程序完成


open-type 有效值:

说明 最低版本
navigate 对应wx.navigateTo的功能  
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/>的子节点背景色应为透明色

示例代码:

/** wxss **/
/** 修改默认的navigator点击态 **/
.navigator-hover {
    color:blue;
}
/** 自定义其他点击态样式类 **/
.other-navigator-hover {
    color:red;
}
<!-- sample.wxml -->
<view class="btn-area">
  <navigator url="/page/navigate/navigate?title=navigate" hover-class="navigator-hover">跳转到新页面</navigator>
  <navigator url="../../redirect/redirect/redirect?title=redirect" open-type="redirect" hover-class="other-navigator-hover">在当前页打开</navigator>
  <navigator url="/page/index/index" open-type="switchTab" hover-class="other-navigator-hover">切换 Tab</navigator>
</view>
<!-- navigator.wxml -->
<view style="text-align:center"> {{title}} </view>
<view> 点击左上角返回回到之前页面 </view>
<!-- redirect.wxml -->
<view style="text-align:center"> {{title}} </view>
<view> 点击左上角返回回到上级页面 </view>
// redirect.js navigator.js
Page({
  onLoad: function(options) {
    this.setData({
      title: options.title
    })
  }
})