一位同事在學 AngularJS,卡在路由與模板這一段,於是寫了個例子順手分享出來,給同樣在摸索的人參考。
用 AngularJS 開發專案其實很過癮,爽點在於它的開發模式讓程式碼更清晰、可讀性更高、更簡潔也更好維護。但也有些地方挺折磨人:目前前端生態仍以 jQuery 為主,好用的插件幾乎都依賴 jQuery,AngularJS 的插件相對稀少(除了 AngularUI 之外我知道的有限,若有人熟悉歡迎指教)。為了讓 Controller 保持乾淨,我們團隊規定 Controller 裡不允許操作 DOM,所以每次要動 DOM 都得寫成 directive。結果就是把大量 jQuery 插件改寫成 directive 這件事,變成了一件非常惱人的工程。
好像扯遠了。回到正題。
本文目錄:
1. AngularJS 路由介紹
2. AngularJS 路由實例
3. 用 HTML5 模式路由搭配 Web Server 重定向簡化網址
AngularJS 的路由跟後端 MVC 的路由不是一回事。
AngularJS 是純前端路由:在模板頁的 ng-app 裡預先定義路由規則(routeProvider),然後依不同的 URL 決定要載入哪個 HTML 片段,再渲染進 ng-view 這個檢視容器。
而 MVC 路由是:不同的 URL 請求進來,依路由規則找到 Controller 的 Action,再由 Action 回傳 View。兩者的執行位置完全不同,一個在瀏覽器裡,一個在伺服器上。
先建一個 app.js:
1 angular.module("app", [ 2 'ngRoute' 3 ]) 4 .config(['$routeProvider', function ($routeProvider) { 5 $routeProvider.when("/list", { 6 template: "這是列表頁" 7 }).when("/detail", { 8 template: "這是詳情頁" 9 })10 .otherwise({11 redirectTo: "/list"12 })13 }])
再建 index.html:

1 <!DOCTYPE html> 2 <html xmlns="https://www.w3.org/1999/xhtml" ng-app="app"> 3 <head> 4 <title></title> 5 </head> 6 <body> 7 <header> 8 <h2>這是頭部</h2> 9 </header>10 <content>11 <div ng-view></div>12 </content>13 <footer>14 <h3>這是底部</h3>15 </footer>16 </body>17 </html>18 <script src="/scripts/angular/angular.min.js"></script>19 <script src="/scripts/angular-route/angular-route.min.js"></script>20 <script src="/scripts/app.js"></script>
執行後,在瀏覽器分別拜訪 https://localhost:2987/index.html#/detail 與 https://localhost:2987/index.html#/list,會看到:

這裡有個容易漏的細節:路由要能運作,除了 angular.js 還必須引入 angular-route.js,並在 module 的依賴陣列裡宣告 'ngRoute'。少了任何一項,ng-view 都只會是空白。
看圖就知道,這種帶井號的網址實在不好看。對有某種程度强迫症的我來說難以接受,於是決定改造。
AngularJS 預設不開啟 HTML5 路由模式,透過 $locationProvider.html5Mode(true) 開啟:
1 angular.module("app", [ 2 'ngRoute' 3 ]) 4 .config(['$routeProvider', '$locationProvider', function ($routeProvider, $locationProvider) { 5 //開啟html5路由模式 6 $locationProvider.html5Mode(true) 7 $routeProvider.when("/list", { 8 template: "這是列表頁" 9 }).when("/detail", {10 template: "這是詳情頁"11 })12 .otherwise({13 redirectTo: "/404.html"14 })15 }])
改完去掉井號再重新整理,會發現跳 404。原因不難理解:像 /detail 這樣的請求送到 IIS,伺服器在實體檔案系統裡找不到對應的檔案,就直接回傳 404 了。
因此必須在 web.config 裡加上重寫規則,把符合條件的路徑導回 index.html:
1 <system.webServer> 2 <rewrite> 3 <rules> 4 <rule name="name" > 5 <match url="^list|detail*" ignoreCase="true"/> 6 <conditions logicalGrouping="MatchAll"> 7 <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true"/> 8 <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true"/> 9 </conditions>10 <action type="Rewrite" url="/index.html"/>11 </rule>12 </rules>13 </rewrite>14 </system.webServer>
<match url="^list|detail*" ignoreCase="true"/> 的意思是:只要請求路徑中包含 list 或 detail(正則表達式可依需求自行調整),就重寫到 index.html。這樣拜訪 https://localhost:2987/detail 時,IIS 會先回傳模板頁,再由 AngularJS 接手做前端路由。
那兩個 negate="true" 的條件同樣關鍵:意思是「當請求的目標不是一個真實存在的檔案、也不是一個真實存在的目錄時」才套用重寫。少了這個判斷,連 CSS、JS、圖片都會被導去 index.html,整站就壞了。
改完再拜訪一次,發現還是沒出現預期結果——路由沒匹配上。
查了很久才找到解法:在 html 的 head 裡補上一個 <base> 標籤。
1 <!DOCTYPE html> 2 <html xmlns="https://www.w3.org/1999/xhtml" ng-app="app"> 3 <head> 4 <title></title> 5 <base href="/" /> 6 </head> 7 <body> 8 <header> 9 <h2>這是頭部</h2>10 </header>11 <content>12 <div ng-view></div>13 </content>14 <footer>15 <h3>這是底部</h3>16 </footer>17 </body>18 </html>19 <script src="/scripts/angular/angular.min.js"></script>20 <script src="/scripts/angular-route/angular-route.min.js"></script>21 <script src="/scripts/app.js"></script>
這樣在瀏覽器輸入 https://localhost:2987/detail 並回車,就能看到預期的畫面:

這裡補上原本的疑問。<base> 標籤的作用是為頁面上所有相對路徑提供一個計算基準。
在帶井號的模式下,瀏覽器眼中真正的路徑一直是 /index.html,井號後面的東西不會送到伺服器,所以相對路徑的解析基準從頭到尾都沒變。
但改成 HTML5 模式後,位址列變成 /detail,瀏覽器計算相對路徑的基準也跟著變成 /detail/。這時候 AngularJS 內部動態載入的模板片段、以及頁面裡寫相對路徑的資源,都會被解析成 /detail/xxx 這種不存在的路徑,於是 404。加上 <base href="/" /> 把基準強制釘回根目錄,問題就解決了。
這也解釋了為什麼這個標籤必須放在 head 裡、且要在任何相對路徑之前——HTML 規範中 base 只認第一個,位置太後就來不及生效了。
以上就是這次路由簡化的完整記錄。哪裡寫得不對,歡迎盡情吐槽。