單頁應用(SPA)之所以流行,是因為它能給出接近原生應用的操作感受:點擊導航不刷新、內容無縫切換。AngularJS 用「路由 + 模板注入」兩件套把這件事做得非常輕。本文從零搭一個帶首頁、關於、聯繫我們三頁的 SPA,並順帶說明 SEO 與本地運行兩個實務問題。
我們要做的是:單頁應用、無刷新切換頁面、每個頁面展示不同數據。用原生 JS + Ajax 當然也能實現,但 Angular 讓路由與視圖的管理變成聲明式的。
- script.js // 所有 Angular 代碼 - index.html // 主布局 - pages // 將被注入的頁面 ----- home.html ----- about.html ----- contact.html
<!-- index.html -->
<!DOCTYPE html>
<html>
<head>
<!-- 通過 CDN 加載 bootstrap 與 fontawesome -->
<link rel="stylesheet" href="//netdna.bootstrapcdn.com/bootstrap/3.0.0/css/bootstrap.min.css" />
<link rel="stylesheet" href="//netdna.bootstrapcdn.com/font-awesome/4.0.0/css/font-awesome.css" />
<!-- 加載 angular 與 angular-route -->
<script src="https://ajax.googleapis.com/ajax/libs/angularjs/1.2.10/angular.min.js"></script>
<script src="//ajax.googleapis.com/ajax/libs/angularjs/1.2.10/angular-route.js"></script>
<script src="script.js"></script>
</head>
<body>
<!-- HEADER AND NAVBAR -->
<header>
<nav class="navbar navbar-default">
<div class="container">
<div class="navbar-header">
<a class="navbar-brand" href="/">Angular Routing Example</a>
</div>
<ul class="nav navbar-nav navbar-right">
<li><a href="#"><i class="fa fa-home"></i> Home</a></li>
<li><a href="#about"><i class="fa fa-shield"></i> About</a></li>
<li><a href="#contact"><i class="fa fa-comment"></i> Contact</a></li>
</ul>
</div>
</nav>
</header>
<!-- MAIN CONTENT AND INJECTED VIEWS -->
<div id="main"></div>
<!-- FOOTER -->
<footer class="text-center">
View the tutorial on <a href="https://scotch.io">Scotch.io</a>
</footer>
</body>
</html>
注意導航鏈接用的是 # 而不是真實路徑。這是為了讓瀏覽器不把點擊當成頁面跳轉,路由交給 Angular 接管。
// script.js
// 創建模塊,命名為 scotchApp
var scotchApp = angular.module('scotchApp', ['ngRoute']);
// 配置路由
scotchApp.config(function ($routeProvider) {
$routeProvider
// 首頁
.when('/', {
templateUrl: 'pages/home.html',
controller: 'mainController'
})
// 關於頁
.when('/about', {
templateUrl: 'pages/about.html',
controller: 'aboutController'
})
// 聯繫我們
.when('/contact', {
templateUrl: 'pages/contact.html',
controller: 'contactController'
});
});
// 各頁對應的控制器
scotchApp.controller('mainController', function ($scope) {
$scope.message = 'Everyone come and see how good I look!';
});
scotchApp.controller('aboutController', function ($scope) {
$scope.message = 'Look! I am an about page.';
});
scotchApp.controller('contactController', function ($scope) {
$scope.message = 'Contact us! JK. This is just a demo.';
});
需要特別注意版本差異:從 AngularJS 1.1.6 起,ngRoute 不再包含在核心庫中,必須額外引入 angular-route.js 並在模塊聲明時寫入依賴數組 ['ngRoute'],否則路由完全不生效。
<!-- define angular app -->
<html ng-app="scotchApp">
...
<!-- define angular controller -->
<body ng-controller="mainController">
...
<div id="main">
{{ message }}
</div>
此時在 #main 這個 div 裡就能看到控制器提供的消息,說明應用已正確啟動。
ng-view 是 Angular 的指令,用來承載當前路由對應的模板。它會依據路由配置抓取對應文件,注入到主布局中。
<div id="main"> <!-- angular templating,內容會被注入到這裡 --> <div ng-view></div> </div>
<!-- home.html -->
<div class="jumbotron text-center">
<h1>Home Page</h1>
<p>{{ message }}</p>
</div>
<!-- about.html -->
<div class="jumbotron text-center">
<h1>About Page</h1>
<p>{{ message }}</p>
</div>
<!-- contact.html -->
<div class="jumbotron text-center">
<h1>Contact Page</h1>
<p>{{ message }}</p>
</div>
點擊導航,內容就會按配置切換,全程無刷新。
Angular 路由需要運行在 HTTP 環境下。如果直接雙擊以 file:// 協議打開 index.html,會出現跨域請求相關錯誤。請用 https://localhost 或任意本地服務器訪問。
理想的情況是:這套技術更適合登錄後的應用場景。用戶私人頁面(賬戶設置、後台 CMS)本來就不需要被搜索引擎收錄。
但如果你的 SPA 確實需要 SEO,難點在於內容是瀏覽器動態生成的,爬蟲拿到的初始 HTML 裡沒有實質內容。傳統做法是「HTML 快照」:
這套方案需要長期維護,成本不低。如今更主流的思路是服務端渲染(SSR)或靜態化預渲染,能從根源上解決首屏內容與爬蟲可讀性兩個問題。
路由跑通之後,可以引入 Angular 提供的 ngAnimate 模塊,配合 CSS 動畫為視圖切換添加過渡效果。由於 ngAnimate 會在視圖進入/離開時自動掛上 .ng-enter 與 .ng-leave 類,你只需要寫 CSS,不用改任何業務代碼——這一點在後續文章中會詳細展開。