單頁應用要在不重載頁面的情況下切換內容,靠的是 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 已處理好巢狀路由、路由守衛、延遲載入與滾動行為等細節。但理解這個百來行的版本,對掌握「前端路由到底在做什麼」很有幫助。