萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

AngularJS 單頁應用(SPA)開發完整指引:路由、模板與控制器實戰

SPA 核心優勢

  • 無刷新切換:頁面跳轉不重載資源,體驗接近原生 App
  • 前後端分離:後端只提供 API,前端負責渲染與狀態
  • 狀態保持:路由切換不銷毀全局服務、緩存、用戶登錄態

項目結構規劃

spa-demo/
├── index.html          # 主布局(含 ng-view)
├── script.js           # Angular 應用啟動、路由配置、控制器
├── pages/              # 子視圖模板
│   ├── home.html
│   ├── about.html
│   └── contact.html
└── assets/
    └── style.css

主布局 index.html

<!DOCTYPE html>
<html ng-app="scotchApp">
<head>
  <meta charset="utf-8">
  <title>AngularJS SPA Demo</title>
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@3.3.7/dist/css/bootstrap.min.css">
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/font-awesome@4.7.0/css/font-awesome.min.css">
  <script src="https://cdn.jsdelivr.net/npm/angular@1.7.9/angular.min.js"></script>
  <script src="https://cdn.jsdelivr.net/npm/angular-route@1.7.9/angular-route.min.js"></script>
  <script src="script.js"></script>
</head>
<body ng-controller="mainController">
  <!-- 導航欄 -->
  <header>
    <nav class="navbar navbar-default">
      <div class="container">
        <a class="navbar-brand" href="#/">Angular Routing</a>
        <ul class="nav navbar-nav navbar-right">
          <li><a href="#/"><i class="fa fa-home"></i> 首頁</a></li>
          <li><a href="#/about"><i class="fa fa-shield"></i> 關於</a></li>
          <li><a href="#/contact"><i class="fa fa-comment"></i> 聯系</a></li>
        </ul>
      </div>
    </nav>
  </header>
  
  <!-- 視圖容器:路由匹配的模板將注入此處 -->
  <div id="main" class="container">
    <div ng-view></div>
  </div>
  
  <footer class="text-center">Powered by AngularJS 1.x</footer>
</body>
</html>

應用邏輯 script.js

// 1. 創建模塊,注入 ngRoute
var scotchApp = angular.module('scotchApp', ['ngRoute']);

// 2. 配置路由
scotchApp.config(['$routeProvider', function($routeProvider) {
  $routeProvider
    .when('/', {
      templateUrl: 'pages/home.html',
      controller: 'homeController'
    })
    .when('/about', {
      templateUrl: 'pages/about.html',
      controller: 'aboutController'
    })
    .when('/contact', {
      templateUrl: 'pages/contact.html',
      controller: 'contactController'
    })
    .otherwise({ redirectTo: '/' }); // 404 重定向
}]);

// 3. 主控制器(導航高亮等全局邏輯)
scotchApp.controller('mainController', ['$scope', '$location', function($scope, $location) {
  $scope.isActive = function(path) {
    return $location.path() === path;
  };
}]);

// 4. 各頁面控制器
scotchApp.controller('homeController', ['$scope', function($scope) {
  $scope.message = '歡迎來到首頁!這裡展示核心業務概覽。';
}]);

scotchApp.controller('aboutController', ['$scope', function($scope) {
  $scope.team = [
    { name: '張三', role: '前端架構師' },
    { name: '李四', role: '後端專家' },
    { name: '王五', role: 'UI 設計師' }
  ];
}]);

scotchApp.controller('contactController', ['$scope', function($scope) {
  $scope.formData = {};
  $scope.submit = function() {
    alert('提交內容:' + JSON.stringify($scope.formData));
  };
}]);

子視圖模板

pages/home.html

<div class="jumbotron text-center">
  <h1>{{ message }}</h1>
  <p><a class="btn btn-primary btn-lg" href="#/about" role="button">了解我們 <i class="fa fa-arrow-right"></i></a></p>
</div>
<div class="row">
  <div class="col-md-4"><h3>特性一</h3><p>模塊化路由配置</p></div>
  <div class="col-md-4"><h3>特性二</h3><p>控制器隔離作用域</p></div>
  <div class="col-md-4"><h3>特性三</h3><p>模板按需加載</p></div>
</div>

pages/about.html

<div class="page-header"><h2>團隊成員</h2></div>
<div class="row">
  <div class="col-md-4" ng-repeat="member in team">
    <div class="thumbnail text-center">
      <div class="caption">
        <h4>{{ member.name }}</h4>
        <p>{{ member.role }}</p>
      </div>
    </div>
  </div>
</div>

pages/contact.html

<div class="page-header"><h2>聯系我們</h2></div>
<form ng-submit="submit()" class="form-horizontal">
  <div class="form-group">
    <label class="col-sm-2 control-label">姓名</label>
    <div class="col-sm-10">
      <input type="text" class="form-control" ng-model="formData.name" placeholder="您的姓名">
    </div>
  </div>
  <div class="form-group">
    <label class="col-sm-2 control-label">郵箱</label>
    <div class="col-sm-10">
      <input type="email" class="form-control" ng-model="formData.email" placeholder="您的郵箱">
    </div>
  </div>
  <div class="form-group">
    <label class="col-sm-2 control-label">留言</label>
    <div class="col-sm-10">
      <textarea class="form-control" ng-model="formData.message" rows="5"></textarea>
    </div>
  </div>
  <div class="form-group">
    <div class="col-sm-offset-2 col-sm-10">
      <button type="submit" class="btn btn-success">發送</button>
    </div>
  </div>
</form>

進階:路由參數與嵌套視圖

帶參數路由

.when('/user/:userId', {
  templateUrl: 'pages/user-detail.html',
  controller: 'userDetailController'
})

// 控制器獲取參數
.controller('userDetailController', ['$scope', '$routeParams', function($scope, $routeParams) {
  $scope.userId = $routeParams.userId;
  // 根據 ID 請求詳情 API
}]);

嵌套視圖(需 ui-router,ngRoute 不支持)

// ui-router 配置
$stateProvider
  .state('dashboard', {
    url: '/dashboard',
    templateUrl: 'pages/dashboard.html',
    controller: 'dashboardCtrl'
  })
  .state('dashboard.reports', { // 子狀態
    url: '/reports',
    templateUrl: 'pages/dashboard.reports.html'
  })
  .state('dashboard.settings', {
    url: '/settings',
    templateUrl: 'pages/dashboard.settings.html'
  });

生產環境優化清單

  1. 模板緩存:使用 $templateCache 或構建工具 將 HTML 內聯為 JS 字符串,減少 HTTP 請求
  2. 路由懶加載:配合 ocLazyLoad 或 Webpack import() 按需加載控制器代碼
  3. HTML5 模式:$locationProvider.html5Mode(true) 移除 URL 中的 #,需服務端配置 fallback 到 index.html
  4. 路由解析:resolve: { user: ['UserService', '$route', function(s, r) { return s.get(r.current.params.userId); }] } 預取數據再實例化控制器
  5. 錯誤邊界:$routeChangeError 事件統一處理路由失敗跳轉

總結

AngularJS + ngRoute 構建 SPA 的核心流程:定義模塊 → 配置路由映射 → 編寫控制器 → 創建模板 → ng-view 承載。掌握路由參數傳遞、控制器隔離、模板復用,即可開發出結構清晰、體驗流暢的單頁應用。現代項目建議遷移至 Angular (2+)/Vue/React,但 AngularJS 的路由思想(狀態驅動視圖)仍具參考價值。

copyright © 萬盛學電腦網 all rights reserved