AngularJS 指令

AngularJS 通過被稱為指令的新屬性來擴展 HTML。

AngularJS 通過內置的指令來為應用添加功能。

AngularJS 允許你自定義指令。

AngularJS 指令

AngularJS 指令是擴展的 HTML 屬性，帶有首碼 ng-。

ng-app 指令初始化一個 AngularJS 應用程式。

ng-init 指令初始化應用程式數據。

ng-model 指令把元素值（比如輸入域的值）綁定到應用程式。

完整的指令內容可以參閱 AngularJS 參考手冊。

AngularJS 實例

<div ng-app="" ng-init="firstName='John'"> <p>在輸入框中嘗試輸入：</p> <p>姓名：<input type="text" ng-model="firstName"></p> <p>你輸入的為： {{ firstName }}</p> </div>

ng-app 指令告訴 AngularJS，<div> 元素是 AngularJS 應用程式 的"所有者"。

數據綁定

上面實例中的 {{ firstName }} 運算式是一個 AngularJS 數據綁定運算式。

AngularJS 中的數據綁定，同步了 AngularJS 運算式與 AngularJS 數據。

{{ firstName }} 是通過 ng-model="firstName" 進行同步。

在下一個實例中，兩個文本域是通過兩個 ng-model 指令同步的：

AngularJS 實例

<div ng-app="" ng-init="quantity=1;price=5"> <h2>價格計算器</h2> 數量： <input type="number" ng-model="quantity"> 價格： <input type="number" ng-model="price"> <p><b>總價：</b> {{ quantity * price }}</p> </div>

	使用 ng-init 不是很常見。您將在控制器一章中學習到一個更好的初始化數據的方式。

重複 HTML 元素

ng-repeat 指令會重複一個 HTML 元素：

AngularJS 實例

<div ng-app="" ng-init="names=['Jani','Hege','Kai']"> <p>使用 ng-repeat 來迴圈數組</p> <ul> <li ng-repeat="x in names"> {{ x }} </li> </ul> </div>

ng-repeat 指令用在一個對象數組上：

AngularJS 實例

<div ng-app="" ng-init="names=[ {name:'Jani',country:'Norway'}, {name:'Hege',country:'Sweden'}, {name:'Kai',country:'Denmark'}]"> <p>迴圈對象：</p> <ul> <li ng-repeat="x in names"> {{ x.name + ', ' + x.country }} </li> </ul> </div>

	AngularJS 完美支持資料庫的 CRUD（增加Create、讀取Read、更新Update、刪除Delete）應用程式。把實例中的對象想像成數據庫中的記錄。

ng-app 指令

ng-app 指令定義了 AngularJS 應用程式的 根元素。

ng-app 指令在網頁加載完畢時會自動引導（自動初始化）應用程式。

稍後您將學習到 ng-app 如何通過一個值（比如 ng-app="myModule"）連接到代碼模組。

ng-init 指令

ng-init 指令為 AngularJS 應用程式定義了 初始值。

通常情況下，不使用 ng-init。您將使用一個控制器或模組來代替它。

稍後您將學習更多有關控制器和模組的知識。

ng-model 指令

ng-model 指令 綁定 HTML 元素 到應用程式數據。

ng-model 指令也可以：

為應用程式數據提供類型驗證（number、email、required）。
為應用程式數據提供狀態（invalid、dirty、touched、error）。
為 HTML 元素提供 CSS 類。
綁定 HTML 元素到 HTML 表單。

ng-repeat 指令

ng-repeat 指令對於集合中（數組中）的每個項會 克隆一次 HTML 元素。

創建自定義的指令

除了 AngularJS 內置的指令外，我們還可以創建自定義指令。

你可以使用 .directive 函數來添加自定義的指令。

要調用自定義指令，HTML 元素上需要添加自定義指令名。

使用駝峰法來命名一個指令， zaixianDirective, 但在使用它時需要以 - 分割, zaixian-directive:

AngularJS 實例

<body ng-app="myApp">

<zaixian-directive></zaixian-directive>

<script>
var app = angular.module("myApp", []);
app.directive("zaixianDirective", function() {
    return {
        template : "<h1>自定義指令!</h1>"
    };
});
</script>

</body>

你可以通過以下方式來調用指令：

元素名
屬性
類名
注釋

以下實例方式也能輸出同樣結果:

元素名

<zaixian-directive></zaixian-directive>

屬性

類名

注釋

限制使用

你可以限制你的指令只能通過特定的方式來調用。

實例

通過添加 restrict 屬性,並設置值為 "A", 來設置指令只能通過屬性的方式來調用:

var app = angular.module("myApp", []);
app.directive("zaixianDirective", function() {
    return {
        restrict : "A",
        template : "<h1>自定義指令!</h1>"
    };
});

restrict 值可以是以下幾種:

E 作為元素名使用
A 作為屬性使用
C 作為類名使用
M 作為注釋使用

restrict 默認值為 EA, 即可以通過元素名和屬性名來調用指令。

AngularJS 實例

AngularJS 參考手冊

AngularJS 指令