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>

嚐試一下 »

Note 使用 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>

嚐試一下 »

Note 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 元素上需要添加自定義指令名。

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

AngularJS 實例

<body ng-app="myApp">

<runoob-directive></runoob-directive>

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

</body>

嚐試一下 »

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

  • 元素名
  • 屬性
  • 類名
  • 注釋

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

元素名

<runoob-directive></runoob-directive>

嚐試一下 »

屬性

<div runoob-directive></div>

嚐試一下 »

類名

<div class="runoob-directive"></div>

嚐試一下 »

注釋

<!-- directive: runoob-directive -->

嚐試一下 »

限製使用

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

實例

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

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

嚐試一下 »

restrict 值可以是以下幾種:

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

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