DIV CSS 佈局教程網

用 AngularJS 打造單頁應用的完整指引(路由 + 模板注入)
編輯:JavaScript綜合知識     

單頁應用(SPA)之所以流行,是因為它能給出接近原生應用的操作感受:點擊導航不刷新、內容無縫切換。AngularJS 用「路由 + 模板注入」兩件套把這件事做得非常輕。本文從零搭一個帶首頁、關於、聯繫我們三頁的 SPA,並順帶說明 SEO 與本地運行兩個實務問題。

目標與文件結構

我們要做的是:單頁應用、無刷新切換頁面、每個頁面展示不同數據。用原生 JS + Ajax 當然也能實現,但 Angular 讓路由與視圖的管理變成聲明式的。

- script.js      // 所有 Angular 代碼
- index.html     // 主布局
- pages          // 將被注入的頁面
  ----- home.html
  ----- about.html
  ----- contact.html

第一步:主布局 index.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'],否則路由完全不生效。

第三步:把模塊與控制器掛到 HTML

<!-- define angular app -->
<html ng-app="scotchApp">
...
<!-- define angular controller -->
<body ng-controller="mainController">
...
<div id="main">
  {{ message }}
</div>

此時在 #main 這個 div 裡就能看到控制器提供的消息,說明應用已正確啟動。

第四步:用 ng-view 留出注入位

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 或任意本地服務器訪問。

關於 SEO

理想的情況是:這套技術更適合登錄後的應用場景。用戶私人頁面(賬戶設置、後台 CMS)本來就不需要被搜索引擎收錄。

但如果你的 SPA 確實需要 SEO,難點在於內容是瀏覽器動態生成的,爬蟲拿到的初始 HTML 裡沒有實質內容。傳統做法是「HTML 快照」:

  1. 爬蟲發現帶有特定標記的 URL。
  2. 爬蟲以特殊方式向服務器請求該 URL 對應的內容。
  3. 服務器返回預先生成的 HTML 快照。
  4. 爬蟲處理快照內容並建立索引。
  5. 搜索結果中展示的仍是原始 URL。

這套方案需要長期維護,成本不低。如今更主流的思路是服務端渲染(SSR)或靜態化預渲染,能從根源上解決首屏內容與爬蟲可讀性兩個問題。

動畫擴展

路由跑通之後,可以引入 Angular 提供的 ngAnimate 模塊,配合 CSS 動畫為視圖切換添加過渡效果。由於 ngAnimate 會在視圖進入/離開時自動掛上 .ng-enter 與 .ng-leave 類,你只需要寫 CSS,不用改任何業務代碼——這一點在後續文章中會詳細展開。

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