angular指令(二)--内置指令

一、基础ng 属性指令:

 ng-href
 ng-src
 ng-disabled
 ng-checked
 ng-readonly
 ng-selected
 ng-class
 ng-style

布尔属性的有:

ng-disabled、ng-readonly、ng-checked、ng-selected

类布尔属性有:

ng-href、ng-src

二、在指令中使用子作用域

 ng-app

 ng-controller

 ng-include

使用ng-include可以加载、编译并包含外部HTML片段到当前的应用中。模板的URL被限制
在与应用文档相同的域和协议下,可以通过白名单或包装成被信任的值来突破限制。更进一步,
需要考虑跨域资源共享(Cross-Origin Resource Sharing,CORS)和同源规则(Same Origin Policy)
来确保模板可以在任何浏览器中正常加载。例如,所有浏览器都不能进行跨域的请求,部分浏览
器也不能访问file://协议的资源。

在开发中,可以通过命令行命令chrome --allow-file-access-from-files来
禁止CORS错误。只在紧急情况下使用这个方法,比如你的老板正站在你身后,
并且所有事情都无法正常工作。

在同一个元素上添加onload属性可以在模板加载完成后执行一个表达式。
要记住,使用ng-include时AngularJS会自动创建一个子作用域。如果你想使用某个特定的作
用域,例如ControllerA的作用域,必须在同一个DOM元素上添加ng-controller ="ControllerA"
指令,这样当模板加载完成后,不会像往常一样从外部作用域继承并创建一个新的子作用域。下
面看一个例子:

<div ng-include="/myTemplateName.html"
ng-controller="MyController"
ng-init="name = 'World'">
Hello {{ name }}
</div>

 ng-switch

这个指令和ng-switch-when及on="propertyName"一起使用,可以在propertyName发生变
化时渲染不同指令到视图中。在下面的例子中,当person.name是Ari时,文本域下面的div会显
示出来,并且这个人会获得胜利:

<input type="text" ng-model="person.name"/>
<div ng-switch on="person.name">
<p ng-switch-default>And the winner is</p>
<h1 ng-switch-when="Ari">{{ person.name }}</h1>
</div>

注意,在switch被调用之前我们用ng-switch-default来输出默认值。

 ng-view

ng-view指令用来设置将被路由管理和放置在HTML中的视图的位置。
 ng-if

使用ng-if指令可以完全根据表达式的值在DOM中生成或移除一个元素。如果赋值给ng-if
的表达式的值是false,那对应的元素将会从DOM中移除,否则对应元素的一个克隆将被重新插
入DOM中。
ng-if同no-show和ng-hide指令最本质的区别是,它不是通过CSS显示或隐藏DOM节点,而
是真正生成或移除节点。
当一个元素被ng-if从DOM中移除,同它关联的作用域也会被销毁。而且当它重新加入DOM
中时,会通过原型继承从它的父作用域生成一个新的作用域。
同时有一个重要的细节需要知道,ngIf重新创建元素时用的是它们编译后的状态。如果ng-if

内部的代码加载之后被jQuery修改过(例如用.addClass),那么当ng-if的表达式值为false时,
这个DOM元素会被移除,表达式再次成为true时这个元素及其内部的子元素会被重新插入
DOM,此时这些元素的状态会是它们的原始状态,而不是它们上次被移除时的状态。也就是说
无论用jQuery的.addClass添加了什么类都不会存在了。

<div ng-if="2+2===5">
Won't see this DOM node, not even in the source code
</div>
<div ng-if="2+2===4">
Hi, I do exist
</div>

 ng-repeat

ng-repeat用来遍历一个集合或为集合中的每个元素生成一个模板实例。集合中的每个元素
都会被赋予自己的模板和作用域。同时每个模板实例的作用域中都会暴露一些特殊的属性。
 $index:遍历的进度(0...length-1)。
 $first:当元素是遍历的第一个时值为true。
 $middle:当元素处于第一个和最后元素之间时值为true。
 $last:当元素是遍历的最后一个时值为true。
 $even:当$index值是偶数时值为true。
 $odd:当$index值是奇数时值为true。
下面的例子展示了如何用$odd和$even来制作一个红蓝相间的列表。记住,JavaScript中数组
的索引从0开始,因此我们用!$even和!$odd来将$even和$odd的布尔值反转。

<ul ng-controller="PeopleController">
<li ng-repeat="person in people" ng-class="{even: !$even, odd: !$odd}">
{{person.name}} lives in {{person.city}}
</li>
</ul>
.odd {
background-color: blue;
}
.even {
background-color: red;
}
angular.module('myApp',[])
.controller('PeopleController',function($scope) {
$scope.people = [
{name: "Ari", city: "San Francisco"},
{name: "Erik", city: "Seattle"}
];
});

 ng-init

ng-init指令用来在指令被调用时设置内部作用域的初始状态。

 ng-bind

尽管可以在视图中使用{{ }}模板语法(AngularJS内置的方式),我们也可以通过ng-bind
指令实现同样的行为。

<body ng-init="greeting='HelloWorld'">
<p ng-bind="greeting"></p>
</body>

HTML加载含有{{ }}语法的元素后并不会立刻渲染它们,导致未渲染内容闪烁(Flash of
Unrendered Content,FOUC)。我可以用ng-bind将内容同元素绑定在一起避免FOUC。内容会被
当作子文本节点渲染到含有ng-bind指令的元素内。

 ng-cloak

除使用ng-bind来避免未渲染元素闪烁,还可以在含有{{ }}的元素上使用ng-cloak指令:
<body ng-init="greeting='HelloWorld'">
<p ng-cloak>{{ greeting }}</p>
</body>
ng-cloak指令会将内部元素隐藏,直到路由调用对应的页面时才显示出来。

 ng-bind-template

<div
ng-bind-template="{{message}}{{name}}">
</div>

 ng-model

ng-model指令用来将input、select、text area或自定义表单控件同包含它们的作用域中
的属性进行绑定。它可以提供并处理表单验证功能,在元素上设置相关的CSS类(ng-valid、
ng-invalid等),并负责在父表单中注册控件。
它将当前作用域中运算表达式的值同给定的元素进行绑定。如果属性并不存在,它会隐式创
建并将其添加到当前作用域中。
我们应该始终用ngModel来绑定$scope上一个数据模型内的属性,而不是$scope上的属性,
这可以避免在作用域或后代作用域中发生属性覆盖。
例如:

<input type="text"
ng-model="modelName.someProperty" />

 ng-show/ng-hide

ng-show和ng-hide根据所给表达式的值来显示或隐藏HTML元素。当赋值给ng-show指令的
值为false时元素会被隐藏。类似地,当赋值给ng-hide指令的值为true时元素也会被隐藏。
元素的显示或隐藏是通过移除或添加ng-hide这个CSS类来实现的。.ng-hide类被预先定义
在了AngularJS的CSS文件中,并且它的display属性的值为none(用了!important标记)。

<div ng-show="2 + 2 == 5">
2 + 2 isn't 5, don't show
</div>
<div ng-show="2 + 2 == 4">
2 + 2 is 4, do show
</div>
<div ng-hide="2 + 2 == 5">
2 + 2 isn't 5, don't hide
</div>
<div ng-hide="2 + 2 == 4">
2 + 2 is 4, do hide
</div>

  ng-change

这个指令会在表单输入发生变化时计算给定表达式的值。因为要处理表单输入,这个指令要
和ngModel联合起来使用。

<div ng-controller="EquationController">
<input type="text" ng-model="equation.x"
ng-change="change()" />
<code>{{ equation.output }}</code>
</div>
angular.module('myApp',[])
.controller('EquationController',function($scope) {
$scope.equation = {};
$scope.change = function() {
$scope.equation.output
= parseInt($scope.equation.x) + 2;
};
});

上面的例子中,只要文本输入字段中的内容发生了变化就会改变equation.x的值,进而运
行change()函数。

 ng-form

ng-form用来在一个表单内部嵌套另一个表单。普通的HTML <form>标签不允许嵌套,但
ng-form可以。
这意味着内部所有的子表单都合法时,外部的表单才会合法。这对于用ng-repeat动态创建
表单是非常有用的。
由于不能通过字符插值来给输入元素动态地生成name属性,所以需要将ng-form指令内每组
重复的输入字段都包含在一个外部表单元素内。
下面的CSS类会根据表单的验证状态自动设置:
 表单合法时设置ng-valid;
 表单不合法时设置ng-invlid;
 表单未进行修改时设置ng-pristion;
 表单进行过修改时设置ng-dirty。
Angular不会将表单提交到服务器,除非它指定了action属性。要指定提交表单时调用哪个
JavaScript方法,使用下面两个指令中的一个。
 ng-submit:在表单元素上使用。
 ng-click:在第一个按钮或submit类型(input[type=submit])的输入字段上使用。
为了避免处理程序被多次调用,只使用下面两个指令中的一个。
下面的例子展示了如何通过服务器返回的JSON数据动态生成一个表单。我们用ng-loop来遍
历从服务器取回的所有数据。由于不能动态生成name属性,而我们又需要这个属性做验证,所以
在循环的过程中会为每一个字段都生成一个新表单。
由于AngularJS中用来取代<form>的ng-form指令可以嵌套,并且外部表单在所有子表单都合
法之前一直处于不合法状态,因此我们可以在动态生成子表单的同时使用表单验证功能。是的,
鱼和熊掌可以兼得。
下面先看一下我们硬编码的JSON数据,把它假设成是从服务器返回的:

angular.module('myApp',[])
.controller('FormController',function($scope) {
$scope.fields = [
{placeholder: 'Username', isRequired: true},
{placeholder: 'Password', isRequired: true},
{placeholder: 'Email (optional)', isRequired: false}
];
$scope.submitForm = function() {
alert("it works!");
};
});

下面用这些数据生成一个有验证功能的动态表单:

<form name="signup_form"
ng-controller="FormController"
ng-submit="submitForm()" novalidate>
<div ng-repeat="field in fields"
ng-form="signup_form_input">
<input type="text"
name="dynamic_input"
ng-required="field.isRequired"
ng-model="field.name"
placeholder="{{field.placeholder}}" />
<div
ng-show="signup_form_input.dynamic_input.$dirty &&
signup_form_input.dynamic_input.$invalid">
<span class="error"
ng-show="signup_form_input.dynamic_input.$error.required">
The field is required.
</span>
</div>
</div>
<button type="submit"
ng-disabled="signup_form.$invalid">
Submit All
</button>
</form>
input.ng-invalid {
border: 1px solid red;
}
input.ng-valid {
border: 1px solid green;
} 

  ng-click

ng-click用来指定一个元素被点击时调用的方法或表达式。

<div ng-controller="CounterController">
<button ng-click="count = count + 1"
ng-init="count=0">
Increment
</button>
count: {{ count }}
<button ng-click="decrement()"> Decrement
</button>
<div>
angular.module('myApp',[])
.controller('CounterController', function($scope) {
$scope.decrement = function() {
$scope.count = $scope.count - 1;
};
})

  ng-select

ng-select用来将数据同HTML的<select>元素进行绑定。这个指令可以和ng-model以及
ng-options指令一同使用,构建精细且表现优良的动态表单。
ng-options的值可以是一个内涵表达式(comprehension expression),其实这只是一种有趣
的说法,简单来说就是它可以接受一个数组或对象,并对它们进行循环,将内部的内容提供给
select标签内部的选项。它可以是下面两种形式。
 数组作为数据源:
 用数组中的值做标签;
 用数组中的值作为选中的标签;
 用数组中的值做标签组;
 用数组中的值作为选中的标签组。
 对象作为数据源:
 用对象的键值(key-value)做标签;
 用对象的键值作为选中的标签;
 用对象的键值作为标签组;
 用对象的键值作为选中的标签组。
下面看一个ng-select指令的实例:

<div ng-controller="CityController">
<select ng-model="city"
ng-options="city.name for city in cities">
<option value="">Choose City</option>
</select>
Best City: {{ city.name }}
</div>
angular.module('myApp',[])
.controller('CityController',function($scope) {
$scope.cities = [
{name: 'Seattle'},
{name: 'San Francisco'},
{name: 'Chicago'},
{name: 'New York'},
{name: 'Boston'}
];
}); 

  ng-submit

ng-submit用来将表达式同onsubmit事件进行绑定。这个指令同时会阻止默认行为(发送请
求并重新加载页面),除非表单不含有action属性。

<form ng-submit="submit()"
ng-controller="FormController">
Enter text and hit enter:
<input type="text"
ng-model="person.name"
name="person.name" />
<input type="submit"
name="person.name"
value="Submit" />
<code>people={{people}}</code>
<ul ng-repeat="(index, object) in people">
<li>{{ object.name }}</li>
</ul>
</form>
angular.module('myApp',[])
.controller('FormController',function($scope) {
$scope.person = {
name: null
};
$scope.people = [];
$scope.submit = function() {
if ($scope.person.name) {
$scope.people.push({name: $scope.person.name});
$scope.person.name = '';
}
};
});

  ng-class

使用ng-class 动态设置元素的类,方法是绑定一个代表所有需要添加的类的表达式。重复
的类不会添加。当表达式发生变化,先前添加的类会被移除,新类会被添加。
下面的例子会用ng-class在一个随机数大于5时将.red类添加到一个div上:

<div ng-controller="LotteryController">
<div ng-class="{red: x > 5}"
ng-if="x > 5">
You won!
</div>
<button ng-click="x = generateNumber()"
ng-init="x = 0">
Draw Number
</button>
<p>Number is: {{ x }}</p>
</div> .red {
background-color: red;
}
angular.module('myApp',[])
.controller('LotteryController', function($scope) {
$scope.generateNumber = function() {
return Math.floor((Math.random()*10)+1);
};
});

  ng-attr-(suffix)

当AngularJS编译DOM时会查找花括号{{ some expression }}内的表达式。这些表达式会
被自动注册到$watch服务中并更新到$digest循环中,成为它的一部分:
<-- updated when`someExpression` on the$scope
is updated -->
<h1>Hello{{someExpression}}</h1>
有时浏览器会对属性会进行很苛刻的限制。SVG就是一个例子:
<svg>
<circle cx="{{ cx }}"></circle>
</svg>
运行上面的代码会抛出一个错误,指出我们有一个非法属性。可以用ng-attr-cx来解决这
个问题。注意,cx位于这个名称的尾部。在这个属性中,通过用{{ }}来写表达式,达到前面提
到的目的。
<svg>
<circle ng-attr-cx="{{ cx }}"><circle>
</svg>

上一篇:MJPhotoBrowser BUG修复


下一篇:lift and throw