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/> 的子节点背景色应为透明色
示例代码:
.navigator-hover {
color:blue;
}
.other-navigator-hover {
color:red;
}
<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>
<view style="text-align:center"> {{title}} </view>
<view> 点击左上角返回回到之前页面 </view>
<view style="text-align:center"> {{title}} </view>
<view> 点击左上角返回回到上级页面 </view>
Page({
onLoad: function(options) {
this.setData({
title: options.title
})
}
})
|
请发表评论