DIV CSS 佈局教程網

用 JavaScript 寫一個簡易的前端路由器
編輯:關於JavaScript     

單頁應用要在不重載頁面的情況下切換內容,靠的是 location.hash:改寫 hash 不會觸發請求,又能被瀏覽器記錄到歷史紀錄,還能被 hashchange 事件攔下來。以下實作一個極簡路由器,用「規則 → 函式」的對應表來決定 hash 該交給誰處理。

實作程式碼

var wawa = {};

wawa.Router = function () {
    function Router() {}

    /**
     * 註冊路由表
     * @param routemap    物件,key 為規則(會被轉成正則),value 為處理函式
     * @param defaultFunc 沒有任何規則命中時的處理函式
     */
    Router.prototype.setup = function (routemap, defaultFunc) {
        var that = this, rule;
        this.routemap = [];
        this.defaultFunc = defaultFunc;
        for (rule in routemap) {
            if (!routemap.hasOwnProperty(rule)) continue;
            that.routemap.push({
                rule: new RegExp(rule, 'i'),   // 規則字串轉為不區分大小寫的正則
                func: routemap[rule]
            });
        }
    };

    /** 依目前 hash 找出對應的處理函式並執行 */
    Router.prototype.start = function () {
        var hash = location.hash, route, matchResult;
        for (var routeIndex in this.routemap) {
            route = this.routemap[routeIndex];
            matchResult = hash.match(route.rule);
            if (matchResult) {
                // 把捕獲群組當成參數傳給處理函式
                route.func.apply(window, matchResult.slice(1));
                return;
            }
        }
        this.defaultFunc();
    };

    return Router;
}();

var router = new wawa.Router();

router.setup({
    '#/list/(.*)/(.*)': function (cate, id) {
        console.log('list', cate, id);
    },
    '#/show/(.*)': function (id) {
        console.log('show', id);
    }
}, function () {
    console.log('default router');
});

router.start();

它是怎麼運作的

註冊階段把每條規則字串包成 RegExp,例如 '#/list/(.*)/(.*)' 會變成能從 hash 中抓出兩個群組的正則。執行階段拿目前的 hash 去逐一比對,命中後用 matchResult.slice(1) 去掉完整匹配的那一項,剩下的捕獲群組正好就是路由參數,用 apply 展開傳入即可。

這個設計的優點是擴充容易——新增頁面只要在 setup 的物件裡加一條規則;缺點也很明顯:規則是循序比對、先命中先贏,順序會影響結果,而且完全沒有參數型別轉換與錯誤處理。

要能用在真實專案,還需要補上

1. 監聽 hash 變化。目前只在 start() 時比對一次,使用者點了頁內連結後畫面不會變。應該補上:

window.addEventListener('hashchange', function () { router.start(); }, false);

2. 支援 history API。hash 路由的缺點是網址帶一個 #,也不方便在伺服器端設定。若想走 /user/123 這種乾淨的 URL,可改用 history.pushState 搭配 popstate 事件。

3. 未命中時的畫面。目前 defaultFunc 只 log 一行字,實務上應該渲染一個 404 畫面,並把 HTTP 狀態或頁標題一併更新。

4. 參數解碼。hash 中的中文或特殊字元建議用 decodeURIComponent 還原,並在比對前先 encode,避免規則匹配失敗。

如果不想自己維護,成熟方案如 Vue Router、React Router 已處理好巢狀路由、路由守衛、延遲載入與滾動行為等細節。但理解這個百來行的版本,對掌握「前端路由到底在做什麼」很有幫助。

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