小程序的路由可以理解為:根據路由規則(路徑)從一個頁面跳轉到另一個頁面的規則。
一、微信小程序中頁面跳轉的方法:
(1)wx.navigateTo(OBJECT)
保留當前頁面,跳轉到應用內的某個頁面,使用wx.navigateBack可以返回到原頁面。
示例代碼:
wx.navigateTo({
url:'test?id=1'//實際路徑要寫全
})
//test.js
Page({
onload:function(option){
console.log(option.query)
}
})
(2)wx.redirectTo(OBJECT)
關閉當前頁面,跳轉到應用的某個頁面。
示例代碼:
wx.redirectTo({
url:'test?id=1'
})
(3)wx.switchTab(OBJECT)
跳轉到tabBar頁面,并關閉其他所有非tabBar頁面
示例代碼:
{
'tabBar': {
'list': [{
'pagePath':'index',
'test':'首頁'
},{
'pagePath':'other',
'test':'其他'
}]
}
}
wx.switchTab({
url:'/index'
})
(4)wx.navigateBack(OBJECT)
關閉當前頁面,返回上一頁面或多級頁面。可通過getCurrentPages()獲取當前的頁面棧,決定需要返回幾層。
示例代碼:
//注意:調用navigateTo跳轉時,調用該方法的頁面會被加入堆棧,而redirectTo方法則不會。
//此處是A頁面
wx.navigateTo({
url:'B?id=1'
})
//此處是B頁面
wx.navigateTo({
url:'C?id=1'
})
//在C頁面內navigateBack,將返回A頁面
wx.navigateBack({
delta:2
})
(5)使用<navigator/>標簽實現頁面跳轉
可以用open-type屬性指定頁面跳轉方式,可選值‘navigate’、'redirect'、'switchTab',對應于wx.navigateTo、wx.redirectTo、wx.switchTab功能
示例代碼:
<navigator url="navigate?title=navigate" hover-class="navigator-hover">跳轉到新頁面</navigator>
<navigator url="navigate?title=redirect" open-type="redirect" hover-class="other-navigator-hover">在當前頁打開</navigator>
<navigator url="index" open-type="switchTab" hover-class="navigator-hover">切換</navigator>
二、如何正確使用頁面跳轉
官方規定小程序最多只能有五個頁面同時存在,意思是在不關閉頁面的情況下,最多新開五個頁面,頁面深度為5。
- 對于可逆操作,使用wx.navigateTo,比如從首頁跳轉到二級頁面,從二級頁面返回是不需要重新渲染頁面
- 對于不可逆操作,使用wx.redirectTo,比如用戶登錄成功后,關閉登錄頁面,不能返回到登錄界面。
- 對于一些介紹性等不常用頁面,使用wx.redirectTo或wx.navigateBack
- 對于類似九宮格、列表項,使用
<navigator />
跳轉 - 不要在首頁使用wx.redirectTo,這樣會導致應用無法返回首頁
- 簡化需求、簡化流程;核心功能在兩三個頁面完成便是張小龍追求【小而美】的體現
三、頁面棧
頁面棧以棧(先進后出)的形式維護頁面與頁面之間的關系;
小程序提供了getCurrentPages()函數獲取頁面棧,第一個元素為首頁,最后一個元素為當前頁面。
1、使用wx.navigateTo每新開一個頁面,頁面棧大小加1,直到頁面棧大小為5為止;
2、使用wx.navigateTo重復打開頁面
上圖中,假如使用wx.navigateTo從四級頁面跳轉到二級頁面,此時會在頁面棧頂添加一個與二級頁面初始狀態一樣的界面,但兩個頁面狀態是獨立的。頁面棧大小會加1,如果頁面棧大小為5,則wx.navigateTo無效
使用wx.redirectTo重定向
3、使用wx.redirectTo重定向
上圖中,假如使用wx.redirectTo從四級頁面重定向到二級頁面,此時會將關閉四級頁面,并使用二級頁面替換四級頁面,但兩個頁面狀態是獨立的。此時的頁面棧大小不變,請注意和使用wx.navigateTo的區別。
使用wx.navigateBack返回
4、使用wx.navigateBack返回
上圖中,假如當前頁面為五級頁面,使用wx.navigateBack:
當delta為1,關閉五級頁面,當前頁面為四級頁面,頁面棧大小減1;
當delta為2,關閉依次五級頁面和四級頁面,當前頁面為三級頁面,頁面棧大小減2;
以此類推,直到棧底為止,也就是首頁。
總結
- wx.navigateTo會增加頁面棧大小,直到頁面棧大小為5
- wx.redirectTo不會增加頁面棧大小
- wx.navigateBack會減少頁面棧大小,直到頁面棧大小為1
內容參考自:小程序基礎之頁面路由