萬盛學電腦網

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

AngularJS 實作多步驟表單嚮導:UI Router 與 ngAnimate 完整範例

將冗長表單拆分為多個步驟,配合動畫過渡,能顯著提升使用者完成率。本文示範結合 UI Router 巢狀狀態、ngAnimate 動畫模組、Bootstrap 樣式 打造響應式多步驟表單嚮導。

專案結構

index.html        // 主版面,載入資源與 ui-view
form.html         // 表單外殼模板(含導航列)
form-profile.html // 步驟 1:基本資料
form-interests.html // 步驟 2:興趣偏好
form-payment.html // 步驟 3:付款資訊
app.js            // 路由配置與主控制器
style.css         // 自訂樣式與動畫定義

主版面 index.html

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <link rel="stylesheet" href="//netdna.bootstrapcdn.com/bootswatch/3.1.1/darkly/bootstrap.min.css">
  <link rel="stylesheet" href="style.css">
  <script src="//ajax.googleapis.com/ajax/libs/angularjs/1.2.16/angular.min.js"></script>
  <script src="//cdnjs.cloudflare.com/ajax/libs/angular-ui-router/0.2.10/angular-ui-router.min.js"></script>
  <script src="//ajax.googleapis.com/ajax/libs/angularjs/1.2.16/angular-animate.min.js"></script>
  <script src="app.js"></script>
</head>
<body ng-app="formApp">
  <div class="container">
    <div ui-view></div> <!-- 子視圖注入點 -->
  </div>
</body>
</html>

路由配置 app.js

angular.module('formApp', ['ngAnimate', 'ui.router'])
.config(function($stateProvider, $urlRouterProvider) {
  $stateProvider
    .state('form', {
      url: '/form',
      templateUrl: 'form.html',
      controller: 'formController'
    })
    .state('form.profile', { url: '/profile', templateUrl: 'form-profile.html' })
    .state('form.interests', { url: '/interests', templateUrl: 'form-interests.html' })
    .state('form.payment', { url: '/payment', templateUrl: 'form-payment.html' });
  $urlRouterProvider.otherwise('/form/profile');
})
.controller('formController', function($scope) {
  $scope.formData = {}; // 集中儲存所有步驟資料
  $scope.processForm = function() { alert('awesome!'); };
});

表單外殼 form.html(含導航與動畫鉤子)

<div class="row">
  <div class="col-sm-8 col-sm-offset-2">
    <!-- 步驟導航列 -->
    <ul class="nav nav-pills">
      <li ng-class="{active: $state.includes('form.profile')}">Profile</li>
      <li ng-class="{active: $state.includes('form.interests')}">Interests</li>
      <li ng-class="{active: $state.includes('form.payment')}">Payment</li>
    </ul>

    <!-- 步驟內容區,ngAnimate 監聽 enter/leave -->
    <div class="form-animate" ui-view></div>

    <!-- 導航按鈕 -->
    <div class="text-center">
      <button class="btn btn-default" ng-click="prevStep()" ng-show="$state.includes('form.interests') || $state.includes('form.payment')">Previous</button>
      <button class="btn btn-primary" ng-click="nextStep()" ng-show="$state.includes('form.profile') || $state.includes('form.interests')">Next</button>
      <button class="btn btn-success" ng-click="processForm()" ng-show="$state.includes('form.payment')">Submit</button>
    </div>
  </div>
</div>

動畫樣式 style.css

.form-animate.ng-enter { transition: all 0.3s ease; opacity: 0; transform: translateX(20px); }
.form-animate.ng-enter.ng-enter-active { opacity: 1; transform: translateX(0); }
.form-animate.ng-leave { transition: all 0.3s ease; opacity: 1; transform: translateX(0); }
.form-animate.ng-leave.ng-leave-active { opacity: 0; transform: translateX(-20px); }

關鍵技術點總結

  • 巢狀狀態: form.profile 等子狀態自動注入父狀態 form.html 的 ui-view,實現版面複用
  • 共享模型: 父控制器 formController 的 $scope.formData 被所有子步驟繼承,資料自動匯聚
  • 動畫觸發: ngAnimate 偵測 ui-view 內容替換,自動套用 .ng-enter/.ng-leave 類別
  • 導航控制: 使用 $state.includes() 判斷當前步驟顯示對應按鈕

此架構易於擴充步驟、驗證邏輯與 API 整合,是企業級表單嚮導的最佳實踐範本。

copyright © 萬盛學電腦網 all rights reserved