DIV CSS 佈局教程網

Backbone.js Router 路由機制完整解讀
編輯:JavaScript基礎知識     

在單頁應用裡,URL 不僅僅是地址,更是應用狀態的外化表現。Backbone 用 Router 承擔了這份職責:它攔截 URL 中 # 之後的片段,把它翻譯成對應的處理函數,讓瀏覽器的「后退/前進」重新變得可用。

一、Router 的最小可用形態

一個 Router 至少由兩部分構成:一份 URL 與 Action 的映射表,以及若干被映射的函數。理解 Backbone 路由的關鍵前提是——# 之後的任意字符都會被 Router 接收並解釋。

<script>
var AppRouter = Backbone.Router.extend({
  routes: {
    "*actions": "defaultRoute"  // 匹配 https://example.com/#anything-here
  }
});

var app_router = new AppRouter;

app_router.on('route:defaultRoute', function(actions) {
  alert(actions);
});

// 啟動 URL 監聽
Backbone.history.start();
</script>

此時 Router 已具備「兜底」能力:任何無法被更具體規則匹配的錨點,都會落到 defaultRoute 上。但要讓它真正做事,還需要定義具體規則。

二、帶參數的動態路由

實務中最常見的需求是「根據 id 載入某條記錄」,例如 https://example.com/#/posts/12。Backbone 支援在規則裡聲明參數佔位符,並把解析結果直接傳入 Action:

<script>
var AppRouter = Backbone.Router.extend({
  routes: {
    "posts/:id": "getPost",
    "*actions": "defaultRoute"   // Backbone 按聲明順序匹配路由
  }
});

var app_router = new AppRouter;

app_router.on('route:getPost', function (id) {
  // 參數由路由解析後傳入
  alert("Get post number " + id);
});

app_router.on('route:defaultRoute', function (actions) {
  alert(actions);
});

Backbone.history.start();
</script>

三、兩類匹配規則:冒號與星號

Backbone 提供兩種動態變數寫法:

  • :(冒號):匹配兩個斜線之間的一段內容,精確且受分隔符約束。
  • *(星號):匹配斜線之後的所有剩餘部分,較為寬鬆,因此匹配優先級最低。

兩者解析出的結果都會以參數形式傳給 Action。冒號規則可能產生一個或多個參數;星號規則則把整段匹配結果作為單一參數返回。

routes: {
  "posts/:id": "getPost",              // #/posts/121
  "download/*path": "downloadFile",    // #/download/user/images/hey.gif
  ":route/:action": "loadView"         // #/dashboard/graph
},

app_router.on('route:getPost', function(id) {
  alert(id);          // 121
});

app_router.on('route:downloadFile', function(path) {
  alert(path);        // user/images/hey.gif(整段作為一個參數)
});

app_router.on('route:loadView', function(route, action) {
  alert(route + "_" + action);   // dashboard_graph
});

四、Router 與 History 的分工

「路由」一詞常被誤解為網路設備,但在前端語境中,它指的是把不同 URL 錨點分派到不同處理邏輯的機制——許多服務端框架也提供類似能力,只是 Backbone.Router 更側重於單頁應用的前端導航。

Backbone 的導航能力由兩個類協作完成:

  • Router:定義與解析路由規則,把 URL 映射到 Action。
  • History:監聽 URL 變化並觸發對應 Action。

通常不需要手動建立 History 實例。第一次建立 Router 實例時,Backbone 會自動建立 History 單例,並可透過 Backbone.history 存取。

使用流程很直接:先定義 Router 類,在 routes 屬性中宣告 URL 規則(Key)與對應的 Action 名稱(Value),再建立實例,最後呼叫 Backbone.history.start() 開始監聽。

五、Hash 規則的內部轉換

規則匹配的是當前 URL 的 Hash(錨點)片段。除了普通字符串,還有兩種需要特別留意的動態寫法:

以斜線分隔的每一段,在 Router 內部會被轉換為 ([^\/]+) 形式;若該段以冒號開頭,則這段內容會作為參數傳給 Action。例如設定規則 topic/:id,當錨點為 #topic/1023 時,1023 會作為 id 傳入。雖然 Router 並不要求參數名與函數形參一致,但保持同名能顯著提升可讀性。

星號在內部被轉換為 (.*?),代表零個或多個任意字符,且不受斜線分隔的限制。由於使用了非貪婪模式,星號還能與冒號規則組合使用,例如 *type/:id 可以匹配 #hot/1023,並把 hot 與 1023 分別作為兩個參數傳入。

每條規則都對應一個 Action 方法名,該方法必須定義在 Router 物件上。History 內部預設透過 onhashchange 事件監聽錨點變化;對於不支援該事件的舊版瀏覽器(如 IE6),則退回到 setInterval 輪詢的方式。

六、pushState 模式

Backbone.History 同樣支援 HTML5 的 pushState。相比只改動錨點,pushState 能操作完整的 URL 而不觸發頁面刷新,讓單頁應用的位址欄看起來更像傳統多頁站點。相關能力定義在 window.history 上:

  • pushState():新增一條 history 記錄並指向指定 URL。
  • replaceState():把當前 history 記錄替換為指定 URL。

要注意的是,這兩個方法只改寫位址欄,並不會真正導航到該 URL,因此用后退/前進按鈕也不會跳轉到那些 URL;由它們引起的位址變化需要透過 onpopstate 事件來捕捉。

七、常用路由方法

1. route():動態註冊規則

規則並非只能靜態宣告。需要執行期動態新增時,可呼叫 Router.route(),第三個參數直接傳入處理函數,規則本身除字符串外也可以是正則表達式:

router.route('topic/:pageno/:pagesize', 'page', function(pageno, pagesize) {
  // todo
});

router.route(/^topic\/(.*?)\/(.*?)$/, 'page', function(pageno, pagesize) {
  // todo
});

2. navigate():程式化導航

前面所有示例都依賴使用者手動改寫 URL。真實業務中常需要由程式主動跳轉,這時使用:

router.navigate('topic/1000', { trigger: true });

這段程式碼把 URL 改為 https://localhost/index.html#topic/1000,並觸發對應的 Action。第二個參數中的 trigger 決定「改 URL」與「觸發 Action」是否同時發生——設為 false 時只改位址、不執行回調。

3. stop():停止監聽

路由監聽由 Backbone.history.start() 開啟,自然也能隨時關閉:

router.route('topic/:pageno/:pagesize', 'page', function(pageno, pagesize) {
  Backbone.history.stop();
});

執行這段程式碼後訪問 https://localhost/index.html#topic/5/20,你會發現該 Action 被觸發之後,後續的 URL 變化不再引起任何反應。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved