《微信小程序开发》 页面导航最强详解 | 如何对小程序页面进行跳转?
Posted XianZhe_
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了《微信小程序开发》 页面导航最强详解 | 如何对小程序页面进行跳转?相关的知识,希望对你有一定的参考价值。
《微信小程序开发》 页面导航最强详解 | 如何对小程序页面进行跳转?
文章目录
一、微信小程序导航
小程序能够在不同的页面进行跳转切换,路由起到了至关重要的作用,所有页面的路由全部由小程序框架进行管理,要想开发好小程序,路由可谓是一门必修课。
在使用方面上区分,小程序的路由和Vue类似,分为 命名式导航 和 编程式导航 两种,只不过路由的切换方式、传参方式等有所不同。同时微信小程序的导航跟 uni-app 十分相似,学会原生的微信小程序,相信对于使用 uni-app 是没有问题的。
在本文演示代码中,tabbar 页面配置如下, 其余页面均为非 tabbar 页面。
"tabBar":
"list": [
"pagePath": "pages/index/index",
"text": "主页",
"iconPath": "./image/homepage.png",
"selectedIconPath": "./image/homepage-sel.png"
,
"pagePath": "pages/about/index",
"text": "关于",
"iconPath": "./image/category.png",
"selectedIconPath": "./image/category-sel.png"
]
本文包含的内容有:命名式导航,编程式导航,路由传参,页面栈。
二、命名式导航与编程式导航对应表
1、在开始讲解之前,我觉得有必要将此对应表先列出来:
- ①这样有助于阅读后面的内容时能够回来查询弥补。
- ②作为复习作用,在往后打开此文章能够一目了然的作为一个备忘表。
跳转方式(open-type) | 编程式对应 | To tabBar 页面 | 说明 | 最低版本 |
---|---|---|---|---|
navigate | wx.navigateTo | ❌ | 保留当前页面,跳转到应用内的某个页面,但是不能跳到 tabbar 页面。 | 兼容 |
redirect | wx.redirectTo | ❌ | 关闭当前页面,跳转到应用内的某个页面。但是不允许跳转到 tabbar 页面。 | 兼容 |
switchTab | wx.switchTab | ✅ | 跳转到 tabBar 页面,并关闭其他所有非 tabBar 页面。 | 兼容 |
reLaunch | wx.reLaunch | ✅ | 关闭所有页面,打开到应用内的某个页面。 | 1.1.0 |
navigateBack | wx.navigateBack | 不能在 tabBar 页面中使用❗ | 关闭当前页面,返回上一页面或多级页面。 | 1.1.0 |
exit | wx.exitMiniProgram | 退出小程序,target="miniProgram"时生效 | 2.1.0 |
2、一些管理路由Api:
- getCurrentPages(): 获取当前页面栈。数组中第一个元素为首页,最后一个元素为当前页面。小程序中页面栈最多十层。
showPages() console.log(getCurrentPages()); // -> [Ra]
- Router对象: 页面路由器对象。可以通过
this.pageRouter
或this.router
获得当前页面或自定义组件的路由器对象。
页面路由器有switchTab
、reLaunch
、redirectTo
、navigateTo
、navigateBack
五个方法,与wx
对象向同名的五个方法switchTab
、reLaunch
、redirectTo
、navigateTo
、navigateBack
功能相同。不同的是,使用Router对象进行页面跳转,相对路径永远相对于this
指代的页面或自定义组件。showRout() console.log(this.pageRouter); console.log(this.router); // -> true console.log(this.pageRouter === this.router);
三、命名式导航🥇
1、基本语法
使用 navigator
组件进行跳转,可以理解成 html 中的 <a/>
标签。url 属性填入路由地址,更改 open-type 属性实现不同的跳转方式。
<navigator open-type="switchTab" url="../index/index">主页</navigator>
可以配合 button
组件进行使用
<navigator open-type="switchTab" url="../index/index">
<button type="primary" class="btn">主页</button>
</navigator>
2、navigate 跳转方式
保留当前页面,跳转到应用内的某个页面,但是不能跳到 tabbar 页面,一般用来跳转到详情页、支付页等。
保留当前页面就是在页面栈中保留了上一页面指向,注意观察下方图示,页面栈从数量1变成了2。
<navigator open-type="navigate" url="../detail/index">
<button type="primary" class="btn">navigate / 跳转到详情页</button>
</navigator>
跳转前 | 跳转后 |
---|---|
倘若非要跳转到 tabbar 页面,那么点击之后是没有效果的。
3、redirect 跳转方式
关闭当前页面,跳转到应用内的某个页面。 但是不允许跳转到 tabbar 页面。
注意观察下方图示,可以发现两点:
- 对比
navigate
跳转方式,使用redirect
跳转方式后页面栈数为1,始终指向当前页面。 - 在详情页中,左上角不再是回退按钮,更改为了主页按钮,证明跳转前的页面已被关闭,页面栈中已移除。
<navigator open-type="redirect" url="../detail/index">
<button type="primary" class="btn">redirect / 跳转到详情页</button>
</navigator>
跳转前 | 跳转后 |
---|---|
但实际上 redirect
是可以跳转到 tabbar 页面,但会给页面栈造成意料之外的影响。
打印出跳转前和跳转后的页面栈,看看两者之间的区别:
- 可以看到跳转之后的页面栈数并未发生改变,但透过页面栈元素的
route
属性可以发现,详情页其实已经被删除。相对的,页面栈居然存在多个同样的 tarBar 页面。 - 带着这个意料之外的页面栈,再次来到详情页,跳转回到主页时,抛出
Expected updated data but get first rendering data
异常,且页面栈元素被重置。
鉴于对页面栈的影响,且官方并不推荐使用,所以伙伴们还是别用这个方式跳转到tabbar页面为妙。
<navigator open-type="redirect" url="../index/index">
<button type="warn" class="btn">redirect / 主页</button>
</navigator>
跳转前 | 跳转后 |
---|---|
4、switchTab 跳转方式
跳转到 tabBar 页面,使用此跳转方式会关闭其他所有非 tabBar 页面。
在下面的示例图中,使用后switchTab 跳转方式跳转后,页面栈中只剩下当前页面元素。
<navigator open-type="switchTab" url="../index/index">
<button type="primary" class="btn">switchTab / 主页</button>
</navigator>
跳转前 | 跳转后 |
---|---|
5、reLaunch 跳转方式
关闭所有页面,打开到应用内的某个页面。
就用法而已,reLaunch
跳转方式与 switchTab
跳转方式类似,不同的在于switchTab
是专门为 tabBar 页面设计的,只能跳转到 tabBar 页面,而 reLaunch
跳转到哪都行。
<navigator open-type="reLaunch" url="../other/index">
<button plain class="btn">reLaunch/跳转到其他页面</button>
</navigator>
跳转前 | 跳转后 |
---|---|
6、navigateBack 跳转方式
关闭当前页面,返回上一页面或多级页面,需要配合 delta
属性进行使用。
使用 navigateBack 时,需要注意以下几点:
- 页面栈最多十层,也就是说最多能返回九级页面,注意把握页面栈大小。
- 如果 delta 大于已有页面数,则跳转到栈中的第一个页面(首页)。
navigateBack
不能在 tabbar 页面中使用,会不起作用。
<navigator open-type="navigateBack" delta="1">
<button type="warn" plain class="btn">回到上一级 d1</button>
</navigator>
<navigator open-type="navigateBack" delta="2">
<button type="warn" plain class="btn">回到上一级 d2</button>
</navigator>
<navigator open-type="navigateBack" delta="10">
<button type="warn" plain class="btn">回到上一级 d10</button>
</navigator>
跳转前 | 跳转后 |
---|---|
7、exit 退出小程序
exit 只能在手机上才有效果,开发者工具上是没用的,要注意将 target 设为miniProgram。
<navigator open-type="exit" target="miniProgram">
<button type="warn" plain class="btn">退出小程序</button>
</navigator>
四、编程式导航🏆
与声明式导航不同的是,编程式导航主要是靠JS代码实现,调用 wx.
Api 进行跳转,其作用和声明式导航是一样的。
关于每个不同跳转方式的区别,在 三、命名式导航 中已经充分的讲解,这里不过多叙述,只演示写法。
声明式导航和编程式导航只是写法不同,同时编程式的写法大同小异,下面的演示重复性会很高,已经知道写法的伙伴们可以跳着看。
1、wx.navigateTo
保留当前页面,跳转到应用内的某个页面,但是不能跳到 tabbar 页面,一般用来跳转到详情页、支付页等。
<button type="primary" style="margin-top: 30rpx;" class="btn" bindtap="toDetailEvent">navigate / 跳转到详情页</button>
async toDetailEvent()
wx.navigateTo(
// 需要跳转的应用内非 tabBar 的页面的路径
url: '/pages/detail/index',
// 接口调用成功的回调函数
success: (res) => ,
// 接口调用失败的回调函数
fail: (res) => ,
// 接口调用结束的回调函数(调用成功、失败都会执行)
complete: (res) => ,
)
,
跳转前 | 跳转后 |
---|---|
2、wx.redirectTo
关闭当前页面,跳转到应用内的某个页面。 但是不允许跳转到 tabbar 页面。
<button type="primary" class="btn" bindtap="toDetailByRedirectEvent">redirect / 跳转到详情页</button>
async toDetailByRedirectEvent()
wx.redirectTo(
// 需要跳转的应用内非 tabBar 的页面的路径
url: '/pages/detail/index',
// 接口调用成功的回调函数
success: (res) => ,
// 接口调用失败的回调函数
fail: (res) => ,
// 接口调用结束的回调函数(调用成功、失败都会执行)
complete: (res) => ,
)
,
跳转前 | 跳转后 |
---|---|
3、wx.switchTab
跳转到 tabBar 页面,并关闭其他所有非 tabBar 页面。
<button type="primary" class="btn" bindtap="toIndexByswitchTabEvent">switchTab / 主页</button>
async toIndexByswitchTabEvent()
wx.switchTab(
// 需要跳转的 tabBar 页面的路径
url: '/pages/index/index',
// 接口调用成功的回调函数
success: (res) => ,
// 接口调用失败的回调函数
fail: (res) => ,
// 接口调用结束的回调函数(调用成功、失败都会执行)
complete: (res) => ,
)
,
跳转前 | 跳转后 |
---|---|
4、wx.reLaunch
关闭所有页面,打开到应用内的某个页面。
<button plain class="btn" bindtap="toOtherByreLaunchEvent">reLaunch/跳转到其他页面</button>
async toOtherByreLaunchEvent()
wx.reLaunch(
// 关闭所有页面,打开到应用内的某个页面
url: "/pages/other/index",
// 接口调用成功的回调函数
success: (res) => ,
// 接口调用失败的回调函数
fail: (res) => ,
// 接口调用结束的回调函数(调用成功、失败都会执行)
complete: (res) => ,
);
,
5、wx.navigateBack
关闭当前页面,返回上一页面或多级页面。
<button type="warn" plain class="btn" bindtap="navigateBackEvent">回到上一级 d1</button>
async navigateBackEvent()
wx.navigateBack(
// 返回的页面数,如果 delta 大于现有页面数,则返回到首页。
delta: 1,
// 接口调用成功的回调函数
success: (res) => ,
// 接口调用失败的回调函数
fail: (res) => ,
// 接口调用结束的回调函数(调用成功、失败都会执行)
complete: (res) => ,
);
,
6、wx.exitMiniProgram
退出当前小程序。
使用编程式退出有个好处,能够在退出之前做一些收尾操作,如清除缓存、关闭程序任务等。
<button type="warn" plain class="btn" bindtap="exitMiniProgram">退出小程序</button>
exitMiniProgram()
wx.exitMiniProgram(
// 接口调用成功的回调函数
success: (res) =>
// 以同步的方式清理本地数据缓存
wx.clearStorageSync();
console.log("缓存清理成功");
,
// 接口调用失败的回调函数
fail: (res) => ,
// 接口调用结束的回调函数(调用成功、失败都会执行)
complete: (res) => ,
);
,
五、路由传参
页面跳转的时候还支持传参,只需要在路径后加上参数即可,写法与HTTP GET请求一样。参数与路径之间使用 ? 分隔,参数键与参数值用 = 相连,不同参数用 & 分隔;如 ‘path?key=value&key2=value2’。
传入的参数在页面生命周期 onLoad(options)
方法中的 options
参数以对象的形式接收。
注意,并不是所有跳转方式都支持传参。
跳转方式 | 支持传参 |
---|---|
navigate | ✅ |
redirect | ✅ |
switchTab | ❌ |
reLaunch | ✅ |
navigateBack | ❌ |
exit | ❌ |
演示代码 👇
<text>路由传参</text>
<view class="btns params-list">
<view class="params-item">
<label>
<text>Key:</text>
<input class="inp-key" bindinput="inputEvent" data-id="k1"></input>
</label>
<label>
<text>value:</text>
<input class="inp-value" bindinput="inputEvent" data-id="v1"></input>
</label>
</view>
<view class="params-item">
<label>
<text>Key:</text>
<input class="inp-key" bindinput="inputEvent" data-id="k2"></input>
</label>
<label>
以上是关于《微信小程序开发》 页面导航最强详解 | 如何对小程序页面进行跳转?的主要内容,如果未能解决你的问题,请参考以下文章