微信小程序之頁面路由

小程序的路由可以理解為:根據路由規則(路徑)從一個頁面跳轉到另一個頁面的規則。

一、微信小程序中頁面跳轉的方法:

(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

  1. 對于可逆操作,使用wx.navigateTo,比如從首頁跳轉到二級頁面,從二級頁面返回是不需要重新渲染頁面
  2. 對于不可逆操作,使用wx.redirectTo,比如用戶登錄成功后,關閉登錄頁面,不能返回到登錄界面。
  3. 對于一些介紹性等不常用頁面,使用wx.redirectTo或wx.navigateBack
  4. 對于類似九宮格、列表項,使用<navigator />跳轉
  5. 不要在首頁使用wx.redirectTo,這樣會導致應用無法返回首頁
  6. 簡化需求、簡化流程;核心功能在兩三個頁面完成便是張小龍追求【小而美】的體現

三、頁面棧

頁面棧以棧(先進后出)的形式維護頁面與頁面之間的關系;
小程序提供了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

內容參考自:小程序基礎之頁面路由

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容