AngularJS 指令
AngularJS 通過被稱為 指令 的新屬性來擴充 HTML。
AngularJS 通過內建的指令來為應用添加功能。
AngularJS 允許你自訂指令。
AngularJS 指令
AngularJS 指令是擴充的 HTML 屬性,帶有首碼 ng-。
ng-app 指令初始化一個 AngularJS 應用程式。
ng-init 指令初始化應用程式資料。
ng-model 指令把元素值(比如輸入欄位的值)綁定到應用程式。
完整的指令內容可以參閱 AngularJS 參考手冊。
AngularJS 執行個體
<!DOCTYPE html><html><head><meta charset="utf-8"><script src="http://apps.bdimg.com/libs/angular.js/1.4.6/angular.min.js"></script> </head><body><div ng-app="" ng-init="firstName='John'"><p>在輸入框中嘗試輸入:</p><p>姓名: <input type="text" ng-model="firstName"></p><p>你輸入的為: {{ firstName }}</p></div></body></html>
運行結果:
在輸入框中嘗試輸入:
姓名:
你輸入的為: John
ng-app 指令告訴 AngularJS,<div> 元素是 AngularJS 應用程式 的"所有者"。
注意: 一個網頁可以包含多個運行在不同元素中的 AngularJS 應用程式。
資料繫結
上面執行個體中的 {{ firstName }} 運算式是一個 AngularJS 資料繫結運算式。
AngularJS 中的資料繫結,同步了 AngularJS 運算式與 AngularJS 資料。
{{ firstName }} 是通過 ng-model="firstName" 進行同步。
在下一個執行個體中,兩個文本域是通過兩個 ng-model 指令同步的:
AngularJS 執行個體
<!DOCTYPE html><html><head><meta charset="utf-8"><script src="http://apps.bdimg.com/libs/angular.js/1.4.6/angular.min.js"></script> </head><body><div data-ng-app="" data-ng-init="quantity=1;price=5">價格計算機 數量: <input type="number" ng-model="quantity">價格: <input type="number" ng-model="price"><p><b>總價:</b> {{quantity * price}}</p></div></body></html>
運行結果:
價格計算機
數量: 價格:
總價: 5
注意: 使用 ng-init 不是很常見。您將在控制器一章中學習到一個更好的初始化資料的方式。
重複 HTML 元素
ng-repeat 指令會重複一個 HTML 元素:
AngularJS 執行個體
<!DOCTYPE html><html><head><meta charset="utf-8"><script src="http://apps.bdimg.com/libs/angular.js/1.4.6/angular.min.js"></script> </head><body><div data-ng-app="" data-ng-init="names=['Jani','Hege','Kai']"> <p>使用 ng-repeat 來迴圈數組</p> <ul> <li data-ng-repeat="x in names"> {{ x }} </li> </ul></div></body></html>
使用 ng- repeat 來迴圈數組
ng-repeat 指令用在一個對象數組上:
AngularJS 執行個體
<!DOCTYPE html><html><head><meta charset="utf-8"><script src="http://apps.bdimg.com/libs/angular.js/1.4.6/angular.min.js"></script> </head><body><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></body></html>
迴圈對象:
- Jani, Norway
- Hege, Sweden
- Kai, Denmark
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 執行個體
<!DOCTYPE html><html><head><meta charset="utf-8"><script src="http://apps.bdimg.com/libs/angular.js/1.4.6/angular.min.js"></script> </head><body><body ng-app="myApp"><runoob-directive></runoob-directive><script>var app = angular.module("myApp", []);app.directive("runoobDirective", function() { return { template : "自訂指令!" };});</script></body></body></html>
運行結果:
自訂指令!
你可以通過以下方式來調用指令:
元素名
屬性
類名
注釋
以下執行個體方式也能輸出同樣結果:
元素名
<!DOCTYPE html><html><head><meta charset="utf-8"><script src="http://apps.bdimg.com/libs/angular.js/1.4.6/angular.min.js"></script> </head><body><body ng-app="myApp"><runoob-directive></runoob-directive><script>var app = angular.module("myApp", []);app.directive("runoobDirective", function() { return { template : "自訂指令!" };});</script></body></body></html>
運行結果:
自訂指令!
屬性:
<!DOCTYPE html><html><head><meta charset="utf-8"><script src="http://apps.bdimg.com/libs/angular.js/1.4.6/angular.min.js"></script> </head><body><body ng-app="myApp"><div runoob-directive></div><script>var app = angular.module("myApp", []);app.directive("runoobDirective", function() { return { template : "自訂指令!" };});</script></body></body></html>
運行結果:
自訂指令!
類名:
<!DOCTYPE html><html><head><meta charset="utf-8"><script src="http://apps.bdimg.com/libs/angular.js/1.4.6/angular.min.js"></script> </head><body ng-app="myApp"><div class="runoob-directive"></div><script>var app = angular.module("myApp", []);app.directive("runoobDirective", function() { return { restrict : "C", template : "自訂指令!" };});</script><p><strong>注意:</strong> 你必須設定 <b>restrict</b> 的值為 "C" 才能通過類名來調用指令。</p></body></html>
自訂指令!
注意: 你必須設定 restrict 的值為 "C" 才能通過類名來調用指令。
注釋:
<!DOCTYPE html><html><head><meta charset="utf-8"><script src="http://apps.bdimg.com/libs/angular.js/1.4.6/angular.min.js"></script> </head><body ng-app="myApp"><!-- directive: runoob-directive --><script>var app = angular.module("myApp", []);app.directive("runoobDirective", function() { return { restrict : "M", replace : true, template : "自訂指令!" };});</script><p><strong>注意:</strong> 我們需要在該執行個體添加 <strong>replace</strong> 屬性, 否則評論是不可見的。</p><p><strong>注意:</strong> 你必須設定 <b>restrict</b> 的值為 "M" 才能通過注釋來調用指令。</p></body></html>
運行結果:
自訂指令!
注意: 我們需要在該執行個體添加 replace 屬性, 否則評論是不可見的。
注意: 你必須設定 restrict 的值為 "M" 才能通過注釋來調用指令。
限制使用
你可以限制你的指令只能通過特定的方式來調用。
執行個體
通過添加 restrict 屬性,並設定只值為 "A", 來設定指令只能通過屬性的方式來調用:
執行個體代碼:
<!DOCTYPE html><html><head><meta charset="utf-8"><script src="http://apps.bdimg.com/libs/angular.js/1.4.6/angular.min.js"></script> </head><body ng-app="myApp"><runoob-directive></runoob-directive><div runoob-directive></div><script>var app = angular.module("myApp", []);app.directive("runoobDirective", function() { return { restrict : "A", template : "自訂指令!" };});</script><p><strong>注意:</strong> 通過設定 <strong>restrict</strong> 屬性值為 "A" 來設定指令只能通過 HTML 元素的屬性來調用。</p></body></html>
運行結果:
自訂指令!
注意: 通過設定 restrict 屬性值為 "A" 來設定指令只能通過 HTML 元素的屬性來調用。
restrict 值可以是以下幾種:
E 只限元素名使用
A 只限屬性使用
C 只限類名使用
M 只限注釋使用
restrict 預設值為 EA, 即可以通過元素名和屬性名稱來調用指令。
以上就是對AngularJS 指令 資料整理,後續繼續補充