小程序路由跳转
官方文档
https://developers.weixin.qq.com/miniprogram/dev/api/route/wx.switchTab.html
路由跳转的两种形式
标签形式
<navigator url="/pages/test/test" open-type="switchTab" >跳转到新页面</navigator>
通过open-type来选择和上面一样的跳转方式
js形式
# wxml文件
<button bind:tap="tiao">跳转</button>
# js文件
tiao1:function(){
wx.reLaunch({
url: \'/pages/test/test\',
})
},
快速总结
# wxml文件
<button bind:tap="tiao">跳转</button>
# js文件
tiao1:function(){
wx.reLaunch({
url: \'/pages/test/test\',
})
},
// 只能跳转到tabBar页面,不能跳转到非tabBar页面,并且关闭
//所有非tabBar页面,url不能携带参数
wx.switchTab({
url: \'/pages/test/test\',
})
//关闭所有的页面,打开应用内的某个页面,他的url可以携带参数
//在跳转页面的onload生命周期函数中去接收
wx.reLaunch({
url: \'/pages/test1/test1?name=123&age=18\',
})
//关闭当前页面,跳转到应用内的某个页面,但是不允许跳转到
//tabbar页面,他的路由也是可以携带参数的
wx.redirectTo({
url: \'/pages/test1/test1?name=\'+this.data.name1+\'&age=17\',
})
//保留当前页面,跳转到应用内的某个页面,但是不能跳转到
//tabbar,可以使用wx.navigateBack返回到原来的页面,
//他的url也可以带参数,小程序中页面最多栈10层
wx.navigateTo({
url: \'/pages/test1/test1?name=333\',
})
//delat表示回退多少层
wx.navigateBack({
delta:1
})
小程序路由跳转
1.1 wx.switchTab(Object object)
这里的tabBar是底下的导航栏指定的页面,
跳转到 tabBar 页面,并关闭其他所有非 tabBar 页面
参数
Object object
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
url | string | 是 | 需要跳转的 tabBar 页面的路径(需在 app.json 的 tabBar 字段定义的页面),路径后不能带参数。 | |
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例代码
{
"tabBar": {
"list": [
{
"pagePath": "index",
"text": "首页"
},
{
"pagePath": "other",
"text": "其他"
}
]
}
}
wx.switchTab({
url: \'/index\'
})
1.2 wx.reLaunch(Object object)
基础库 1.1.0 开始支持,低版本需做兼容处理。
关闭所有页面,打开到应用内的某个页面
参数
Object object
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
url | string | 是 | 需要跳转的应用内页面路径,路径后可以带参数。参数与路径之间使用?分隔,参数键与参数值用=相连,不同参数用&分隔;如 \’path?key=value&key2=value2\’ | |
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例代码
wx.reLaunch({
url: \'test?id=1\'
})
// test Page({ onLoad (option) { console.log(option.query) } })
1.3 wx.redirectTo(Object object)
关闭当前页面,跳转到应用内的某个页面。但是不允许跳转到 tabbar 页面。
参数
Object object
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
url | string | 是 | 需要跳转的应用内非 tabBar 的页面的路径, 路径后可以带参数。参数与路径之间使用 ? 分隔,参数键与参数值用 = 相连,不同参数用 & 分隔;如 \’path?key=value&key2=value2\’ |
|
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例代码
wx.redirectTo({
url: \'test?id=1\'
})
1.4 wx.navigateTo(Object object)
保留当前页面,跳转到应用内的某个页面。但是不能跳到 tabbar 页面。使用 wx.navigateBack 可以返回到原页面。小程序中页面栈最多十层。
参数
Object object
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
url | string | 是 | 需要跳转的应用内非 tabBar 的页面的路径, 路径后可以带参数。参数与路径之间使用 ? 分隔,参数键与参数值用 = 相连,不同参数用 & 分隔;如 \’path?key=value&key2=value2\’ |
|
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例代码
wx.navigateTo({
url: \'test?id=1\'
})
// test.js
Page({
onLoad(option) {
console.log(option.query)
}
})
1.5 wx.redirectTo与wx.navigateTo的区别
1.利用wx.navigateTo跳转到下一个页面的时候(这时候会执行onHide方法),下一个页面头部会有返回按钮
2.如果不想有返回按钮,可以用wx.redirectTo进行页面跳转(这时候关闭此页面,会执行onUnload生命周期,这样下一个页面就不会有返回按钮了,因为上一个页面已经被关闭了,没有页面可以返回)
1.6 wx.navigateBack(Object object)
关闭当前页面,返回上一页面或多级页面。可通过 getCurrentPages() 获取当前的页面栈,决定需要返回几层。
参数
Object object
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
delta | number | 是 | 返回的页面数,如果 delta 大于现有页面数,则返回到首页。 | |
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例代码
// 注意:调用 navigateTo 跳转时,调用该方法的页面会被加入堆栈,而 redirectTo 方法则不会。见下方示例代码
// 此处是A页面
wx.navigateTo({
url: \'B?id=1\'
})
// 此处是B页面
wx.navigateTo({
url: \'C?id=1\'
})
// 在C页面内 navigateBack,将返回A页面
wx.navigateBack({
delta: 2
})