單頁應用(SPA)的靈魂在於路由:網址改變時不重新載入頁面,只替換某個區域的內容。AngularJS 提供的 $routeProvider 就是做這件事的。本文用一個「列表頁 → 點進詳情頁」的最小範例,把路由的關鍵概念走一遍。
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<title>route</title>
</head>
<body ng-app="routeApp" class="ng-app:routeApp" id="routeApp">
<h1>Route Demo index</h1>
<!-- 這個 ng-view 就是路由的「插槽」,會被換成 list.html 或 detail.html -->
<div ng-view></div>
<script src="js/angular.min.js"></script>
<script>
var routeApp = angular.module('routeApp', []);
routeApp.config(['$routeProvider', function ($routeProvider) {
$routeProvider
.when('/list', {
templateUrl: 'list.html',
controller: 'RouteListCtl'
})
.when('/list/:id', {
templateUrl: 'detail.html',
controller: 'RouteDetailCtl'
})
.otherwise({
redirectTo: '/list'
});
}]);
// controller
routeApp.controller('RouteListCtl', function($scope) {
});
routeApp.controller('RouteDetailCtl', function($scope, $routeParams) {
$scope.id = $routeParams.id;
});
</script>
</body>
</html>
<hr/>
<h3>Route : List.html</h3>
<ul>
<li ng-repeat="id in [1, 2, 3 ]">
<a href="#/list/{{ id }}"> ID{{ id }}</a>
</li>
</ul>
<hr/>
<h3>Route <span style="color: red;">{{id}}</span>: detail.html </h3>
ng-view 是佔位符。它是路由系統唯一的輸出點,比對網址後對應的 templateUrl 會被載入並塞進這個元素裡。沒寫 ng-view,路由不會有任何可見效果。
when() 定義路由規則。每條規則包含 templateUrl(要載入的片段)與 controller(要綁定的控制器)。otherwise() 是最後的兜底,網址都不符合時就導向預設頁,避免白屏。
:id 是路由參數。'/list/:id' 中的冒號前綴代表動態片段,#/list/2 會讓 id 等於 "2"。在控制器裡注入 $routeParams 就能用 $routeParams.id 取出來,範例正是這樣把它放進 $scope.id 再於模板中顯示。
config 階段要 DI 註明。routeApp.config(['$routeProvider', function($routeProvider){...}]) 這種「陣列寫法」不是多此一舉——它讓 Angular 在壓縮(minify)後仍能正確辨識要注入的服務名稱。若直接寫 function($routeProvider),參數名被改成 a、b 之後就會壞掉。
範例裡引用了 html5shiv 與 json2 來做舊 IE 相容,那段註解也提到「發現不管用」。事實上 AngularJS 1.x 對 IE8 以下的支援本來就非常有限,與其花時間補 polyfill,不如直接不支援過時的瀏覽器。
另外,AngularJS 1.x 已於 2021 年底停止維護。新專案請改用 Angular(2+)或 Vue、React 等仍在更新的框架。不過 $routeProvider 這套「路由表 → 模板 → 控制器」的心智模型,在各家框架裡都找得到對應物,學過一次終身受用。