1. 程式人生 > >微信小程式之頁面路由

微信小程式之頁面路由

官網路由介紹

什麼是路由?

我們通常理解的路由指分組資料包從源到目的地時,決定端到端路徑的網路範圍的程序;

借用上面的定義,我們可以理解小程式頁面路由,根據路由規則(路徑)從一個頁面跳轉到另一個頁面的的規則。

通過本篇文章,你可以學習到:

  1. 哪些情況會觸發頁面跳轉
  2. 如何跳轉頁面
  3. 頁面傳參
  4. 頁面棧

一、哪些情況會觸發頁面跳轉

  1. 小程式啟動,初始化第一個頁面
  2. 開啟新頁面,呼叫 API wx.navigateTo 或使用<navigator />元件
  3. 頁面重定向,呼叫 API wx.redirectTo 或使用<navigator />
    元件
  4. 頁面返回,呼叫 API wx.navigateBack或使用者按左上角返回按鈕
  5. tarbar切換

所有頁面都必須在app.json中註冊,例如:

{
    "pages": [
        "pages/index/index",
        "pages/logs/index"
    ]
}

二、如何跳轉頁面

  1. 使用wx.navigateTo介面跳轉,原頁面保留
wx.navigateTo({
        //目的頁面地址
        url: 'pages/logs/index',
        success: function(res){},
        ...
})
  1. 使用wx.redirectTo介面跳轉,關閉原頁面,不能返回
wx.redirectTo({
        //目的頁面地址
        url: 'pages/logs/index',
        success: function(res){},
        ...
})

3.使用元件

<navigator url="pages/logs/index" hover-class="navigator-hover">跳轉</navigator>

當該元件新增redirect屬性時,等同於wx.redirectTo介面;預設redirect屬性為false,等同於wx.navigateTo介面。

  1. 使用者點選左上角返回按鈕,或呼叫wx.navigateBack介面返回上一頁。
wx.navigateBack({
    delta: 1
})

delta為1時表示返回上一頁,為2時表示上上一頁,以此類推;如果dalta大於已開啟的頁面總數,則返回到首頁。返回後,元介面會銷燬。

》》》頁面跳轉傳值

其實這個很簡單,形如:

url?key=value&key1=value1

經過測試,傳遞的引數沒有被URIEncode,傳遞中文沒有亂碼。引數長度未測試。

三、如何正確使用頁面跳轉

官方規定小程式最多隻能有五個頁面同時存在,意思是在不關閉頁面的情況,最多新開五個頁面,頁面深度為5

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

四、頁面棧

頁面棧以棧(先進後出)的形式維護頁面與頁面之間的關係;
小程式提供了getCurrentPages()函式獲取頁面棧,第一個元素為首頁,最後一個元素為當前頁面。

  1. 使用wx.navigateTo每新開一個頁面,頁面棧大小加1,直到頁面棧大小為5為止;

  2. 使用wx.navigateTo重複開啟介面

上圖中,假如使用wx.navigateTo從四級頁面跳轉到二級頁面,此時會在頁面棧頂新增一個與二級頁面初始狀態一樣的介面,但兩個頁面狀態是獨立的。頁面棧大小會加1,如果頁面棧大小為5,則wx.navigateTo無效

  1. 使用wx.redirectTo重定向

上圖中,假如使用wx.redirectTo從四級頁面重定向到二級頁面,此時會將關閉四級頁面,並使用二級頁面替換四級頁面,但兩個頁面狀態是獨立的。此時的頁面棧大小不變,請注意和使用wx.navigateTo的區別。

  1. 使用wx.navigateBack返回

上圖中,假如當前頁面為五級頁面,使用wx.navigateBack:

  • 當delta為1,關閉五級頁面,當前頁面為四級頁面,頁面棧大小減1;
  • 當delta為2,關閉依次五級頁面和四級頁面,當前頁面為三級頁面,頁面棧大小減2;
  • 以此類推,直到棧底為止,也就是首頁。

以上使用wx.navigateTo、wx.redirectTo、wx.navigateBack頁面出入棧操作對頁面棧的影響,平時不一定用得上,但是還是有必要了解背後的原理。

通過學習頁面棧,你至少可以知道:

  • 小程式執行時你可以獲取到已經初始化了的頁面的屬性和方法
  • 動態獲取當前頁面路徑
  • 頁面自動跳轉
  • 你可以通過getCurrentPages()獲取頁面page物件,執行非當前頁js裡的方法

總結

  • wx.navigateTo會增加頁面棧大小,直到頁面棧大小為5
  • wx.redirectTo不會增加頁面棧大小
  • wx.navigateBack會減少頁面棧大小,直到頁面棧大小為1

來源