目录
1.wx.navigateTo(object)
跳转到应用内非 tabBar 页面 , 路径后可带参数。参数与路径之间使用?分隔,参数键与参数值用=相连,不同参数用&分隔
wx.navigateTo({
url: 'path?key=value&key2=value2'
})
默认有返回按钮,返回到上一个页面
2.wx.redirectTo(object)
跳转到应用内非 tabBar 页面,路径后可带参数。参数与路径之间使用?分隔,参数键与参数值用=相连,不同参数用&分隔
wx.redirectTo({
url: 'path?key=value&key2=value2'
})
默认有返回按钮,返回到上一个页面的再上一层
3.wx.reLaunch(object)
跳转到应用内页面 , 路径后可带参数。参数与路径之间使用?分隔,参数键与参数值用=相连,不同参数用&分隔;如果跳转的页面路径是 tabBar 页面则不能带参数
wx.reLaunch({
url: 'path?key=value&key2=value2'
})
默认没有返回按钮,不可返回
4.wx.switchTab(object)
跳转到应用内 tabBar 页面(需在 app.json 的 tabBar 字段定义的页面),路径后不能带参数
{
"tabBar": {
"color": "#858585",
"selectedColor": "#39b5de",
"backgroundColor": "#ffffff",
"borderStyle": "black",
"list": [
{
"pagePath": "pages/list/list",
"iconPath": "icons路径",
"selectedIconPath": "icons路径",
"text": "列表"
}]
}
}
wx.switchTab({
url: 'path'
})
仅此api,能跳转到tabar定义过的页面
4.wx.navigateBack(object)
参数 | 类型 | 默认值 | 说明 |
---|---|---|---|
delta | Number | 1 | 返回的页面数,如果 delta 大于现有页面数,则返回到首页。 |
// A页面
wx.navigateTo({
url: 'B?id=1'
})
// B页面
wx.navigateTo({
url: 'C?id=1'
})
// 在C页面内 navigateBack,返回B页面
wx.navigateBack({
delta: 1
})
5.使用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 | 手指松开后点击态保留时间,单位毫秒 | |
bindsuccess | String | 当target="miniProgram"时有效,跳转小程序成功 | 2.0.7 | |
binderror | String | 当target="miniProgram"时有效,跳转小程序失败 | 2.0.7 | |
bindcomplete | String | 当target="miniProgram"时有效,跳转小程序完成 | 2.0.7 |
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 |
/** 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>
<navigator target="miniProgram" open-type="navigate" app-id="" path="" extra-data="" version="release">打开绑定的小程序</navigator>
</view>
<!-- navigator.wxml -->
<view style="text-align:center"> {{title}} </view>
<view> 点击左上角返回到上级页面 </view>
<!-- redirect.wxml -->
<view style="text-align:center"> {{title}} </view>
<view> 点击左上角返回到上上级页面 </view>