DIV CSS 佈局教程網

AngularJS 快速入門:從雙向綁定到 TodoList 實作
編輯:關於JavaScript     

怎麼樣快速了解 AngularJS?

這個問題沒有標準答案,每個人的技術背景不同,切入點自然也不同。我自己先前用過 knockoutjs,第一次看到 AngularJS 的 Hello World 範例時,立刻被那種「宣告式」的語法和強大的雙向綁定給吸住了——原來不用寫一行 JS,畫面就能動起來。

AngularJS 官網首頁那幾個範例其實已經把核心特色展示得很清楚。下面我把它拆成幾個步驟,從最簡單的綁定一路做到模組化,順便把實際專案裡會用到的寫法一起帶過。

第一步:不用一行 JS 的 Hello World

<!doctype html>
<html ng-app>
<head>
<script src="https://ngnice.com/lib/angular/1.2.16/angular.js"></script>
</head>
<body>
<div>
  <label>Name:</label>
  <input type="text" ng-model="yourName" placeholder="Enter a name here">
  <hr>
  <h1>Hello {{yourName}}!</h1>
</div>
</body>
</html>

在輸入框打字,下面的標題會即時變成「Hello 你輸入的內容!」。跟傳統寫法相比,這裡有三個關鍵:

一是 html 標籤上的 ng-app,宣告整個頁面都在 AngularJS 的管轄範圍內。二是 input 上的 ng-model="yourName",它讓輸入框的值與記憶體中的 yourName 綁在一起,雙向同步。三是 {{yourName}},這是 Angular 的表達式語法,把 yourName 的內容渲染進 h1。

如果用傳統做法,你得在 input 上掛 change 事件、拿到值、組字串、再操作 DOM 改 h1 的 innerHTML,中間還要給兩個元素加上 id 以便選取。對比之下,宣告式寫法的優勢非常明顯。

第二步:ng-controller 與 $scope 上場

AngularJS 是個 MV* 框架。yourName 是 Model,HTML 是 View,那 Controller 在哪?改一下上面的例子:

<!doctype html>
<html ng-app>
<head>
<script src="https://ngnice.com/lib/angular/1.2.16/angular.js"></script>
</head>
<body>
<div ng-controller="testCtrl">
  <label>Name:</label>
  <input type="text" ng-model="yourName" placeholder="Enter a name here">
  <button ng-click="clearInputValue()">Clear Input Value</button>
  <hr>
  <h1>Hello {{yourName}}!</h1>
</div>
<script>
function testCtrl($scope) {
    $scope.yourName = "world";
    $scope.clearInputValue = function () {
        $scope.yourName = "";
    }
}
</script>
</body>
</html>

三處改動:ng-controller="testCtrl" 宣告這個 div 內的所有元素都歸 testCtrl 管理;script 裡的 testCtrl 函數帶一個 $scope 參數,它就是 ViewModel 的載體,所有模板要用的變數與方法都掛在它身上——因為初始化時把 yourName 設成 "world",所以輸入框預設就有值;ng-click 則是綁定 click 事件,按下按鈕執行 clearInputValue,把 yourName 清空,輸入框跟著被清空。

這就是 MV* 的落地方式。有沒有覺得比手刻 DOM 事件輕鬆太多?

第三步:我不想每個 controller 都是一個全域函數

聰明的讀者馬上會發現問題:如果頁面上有十個 controller,難不成要宣告十個全域函數?(順帶一提,這種全域函數的寫法在 1.3.x 之後已經被移除了。)AngularJS 早就想過這件事,它有自己的模組載入機制,還引入了依賴注入。

<!doctype html>
<html ng-app="app">
<head>
<meta charset="utf-8"/>
<style>
ul { list-style: none; clear: both; }
ul > li { float: left; margin-left: 15px; display: block; }
.active { background: #1f292e; color: #FFFFFF; }
[ng\:cloak],[ng-cloak],.ng-cloak{display:none !important;}
</style>
</head>
<body ng-cloak>
<div ng-controller="testCtrl">
  <ul>
  <li ng-class="{'active':currentMenu == 'menu1'}"><a href="javascript:;" ng-click="selectMenu('menu1')">菜單1</a></li>
  <li ng-class="{'active':currentMenu == 'menu2'}"><a href="javascript:;" ng-click="selectMenu('menu2')">菜單2</a></li>
  </ul>
  <br><br>
  <div ng-if="currentMenu == 'menu1'">我是菜單1裡面的內容</div>
  <div ng-if="currentMenu == 'menu2'">我是菜單2裡面的內容</div>
</div>
<script src="https://ngnice.com/lib/angular/1.2.16/angular.js"></script>
<script>
angular.module("app", []);
angular.module("app").controller("testCtrl", ["$scope", function ($scope) {
    $scope.currentMenu = "menu1";
    $scope.selectMenu = function (menu) {
        $scope.currentMenu = menu;
    }
}]);
</script>
</body>
</html>

這裡的關鍵是 angular.module("app", []):第一個參數是模組名稱,第二個參數是這個模組所依賴的其他模組清單(沒有依賴就給空陣列)。如果第二個參數省略,那就不是「建立」而是「取得」既有模組——這個差異是新手最常踩的坑之一。

畫面上是兩個頁籤,預設選中第一個,點哪個就顯示對應內容並套用選中樣式。ng-if 表示表達式為真才編譯並渲染裡面的元素,為假就完全不產生 DOM;ng-class="{'active': currentMenu == 'menu1'}" 則是條件成立時加上 active 這個 class。

另外 ng-cloak 搭配那段 CSS 很重要:Angular 在啟動完成前,{{ }} 會原封不動地閃在畫面上,ng-cloak 就是拿來把這個「閃一下」藏起來的。

動手做:TodoList

學到這裡,試著自己做一個待辦清單:預設兩筆(一筆完成、一筆未完成),每筆前面有核取方塊切換完成狀態,下面有輸入框和新增按鈕。先別往下看,自己寫寫看。會用到的新指令是 ng-repeat:

<!DOCTYPE html>
<html ng-app="todoApp">
<head lang="en">
<meta charset="UTF-8">
<style>
.done-true { text-decoration: line-through; color: grey; }
</style>
</head>
<body>
<h2>Todo</h2>
<div ng-controller="TodoController">
  <span>{{remaining()}} of {{todos.length}} remaining</span>
  [ <a href="" ng-click="archive()">archive</a> ]
  <ul class="unstyled">
  <li ng-repeat="todo in todos">
    <input type="checkbox" ng-model="todo.done">
    <span class="done-{{todo.done}}">{{todo.text}}</span>
  </li>
  </ul>
  <form ng-submit="addTodo()">
    <input type="text" ng-model="todoText" size="30" placeholder="add new todo here">
    <input class="btn-primary" type="submit" value="add">
  </form>
</div>
<script src="https://ngnice.com/lib/angular/1.2.16/angular.js"></script>
<script>
angular.module('todoApp', [])
  .controller('TodoController', ['$scope', function($scope) {
    $scope.todos = [
      {text:'learn angular', done:true},
      {text:'build an angular app', done:false}
    ];
    $scope.addTodo = function() {
      $scope.todos.push({text:$scope.todoText, done:false});
      $scope.todoText = '';
    };
    $scope.remaining = function() {
      var count = 0;
      angular.forEach($scope.todos, function(todo) {
        count += todo.done ? 0 : 1;
      });
      return count;
    };
    $scope.archive = function() {
      var oldTodos = $scope.todos;
      $scope.todos = [];
      angular.forEach(oldTodos, function(todo) {
        if (!todo.done) $scope.todos.push(todo);
      });
    };
  }]);
</script>
</body>
</html>

新增那部分的輸入框和按鈕,寫成下面這樣效果一樣:

<input type="text" ng-model="todoText" size="30" placeholder="add new todo here">
<input class="btn-primary" type="button" value="add" ng-click="addTodo()">

官方範例之所以用 <form ng-submit="addTodo()">,是為了讓使用者輸入完直接按 Enter 也能送出。這個細節在真實專案裡很重要,別偷懶。

順帶留意 class="done-{{todo.done}}" 這種寫法:class 名稱由運算式即時組出來,完成的項目會得到 done-true,未完成則是 done-false,樣式表只要針對 .done-true 加刪除線即可,完全不用碰 JS。

接下來還有哪些東西

把上面三個例子都看懂,你已經掌握了 ng-controller、雙向綁定、寫模板,也初步用過 ng-app、ng-controller、ng-model、ng-if、ng-class、ng-click、ng-repeat 這些內建指令。老實說,已經不少了。剩下的可以慢慢探索:

用 ngRoute 寫 SPA(單頁應用程式)、自己封裝自訂 directive、Filter 過濾器、表單驗證、service / provider / factory 三種服務形式、scope 的父子樹狀結構與跨 controller 的事件廣播、$http 與 $resource 跟後端 API 互動、ngAnimate 做動畫,以及單元測試。

最後提醒一件小事:上面的範例為了方便展示,把 JS 和 CSS 全塞在同一個 HTML 裡。真實專案請務必拆成獨立檔案,這不只是整齊的問題,也直接影響快取與可維護性。

我們團隊當初也是在做 Worktile 的過程中一步步摸熟 Angular.js 的,那些必踩的坑幾乎都踩過一遍。不可否認,它是一個非常優秀的前端 MV* 框架——但也要注意它已經進入了維護狀態,新專案可以評估 Angular(2 以後的版本)、Vue 或 React。理解本文這些綁定與 directive 的觀念,換到任何一個現代框架都通用。

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