页面链接。
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 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
})
}
})
