天天看点

七步从AngularJS菜鸟到专家(4和5):指令和表达式

本文由  伯乐在线  -  兔米酱  翻译自  ng-newsletter 。欢迎加入 技术翻译小组 。转载请参见文章末尾处的要求。

这一篇包含了"AngularJS - 七步从菜鸟到专家"系列的第四篇(指令)和第五篇(表达式)。

之前的几篇展示了我们应用的核心组件,以及如何设置搭建一个Angular.js应用。在这一部分,我们会厘清一些术语,然后深入探讨很多Angular.js提供的核心功能。

通过这整个系列的教程,我们会开发一个NPR(美国全国公共广播电台)广播的音频播放器,它能显示Morning Edition节目里现在播出的最新故事,并在我们的浏览器里播放它们。完成版的Demo可以看这里(http://www.ng-newsletter.com/code/beginner_series/)

第四部分 指令属性

目前为止,我们已提到过几次“指令属性”的概念,但从未深入探讨过它到底是什么。实际上,“指令属性”就是绑定在DOM元素上的函数,它可以调用方法、定义行为、绑定controller及$scope对象、操作DOM,等等等等。

当浏览器启动、开始解析HTML(像平时一样)时,DOM元素上的指令属性就会跟其他属性一样被解析。

当一个Angular.js应用启动,Angular编译器就会遍历DOM树(从有ng-app指令属性的那个DOM元素开始,如我们在本系列第一篇里所提过的),解析HTML,寻找这些指令属性函数。

当在一个DOM元素上找到一个或多个这样的指令属性函数,它们就会被收集起来、排序,然后按照优先级顺序被执行。

每个指令属性都有自己的优先级,在我们关于指令属性的专题文章里(http://www.ng-newsletter.com/posts/directives.html),你可以找到更深入的信息。

Angular.js应用的动态性和响应能力,都要归功于指令属性。之前我们已经看过一些指令属性的用例:

ng-model

1 2

<

input

ng-model

=

"name"

name

=

"Name"

placeholder

=

"Enter your name"

/>

<

h4

>Your name: {{ name }}</

h4

>

试试看 

七步从AngularJS菜鸟到专家(4和5):指令和表达式

ng-model指令属性(我们在之前的章节使用过它),被用来将DOM文本输入框的值,跟controller里的$scope model绑定起来。具体的实现过程,是在这个值上绑定了一个$watch函数(类似JavaScript里的事件监听函数)。

$watch函数(在使用时)运行在Angular.js的事件循环(即$digest循环)里,让Angular.js能够对DOM进行相应的更新。请关注我们关于$digest循环的高级文章!

在Angular.js应用的开发中,我们用指令属性来将行为绑定到DOM上。指令属性的使用,是一个 应用能否拥有动态性、响应能力的关键。Angular.js提供了很多缺省的指令属性,现在让我们来看看其中几个,以及如何使用它们。

几个常见的指令属性

{{ 表达式 }}

这个双大括号指令属性,使用$watch()函数,给括号内的表达式注册了一个监听器。正是这个$watch函数,让Angular.js能够实时自动更新view。

那么,到底什么算是个表达式?

第五部分 表达式

要想理解指令属性的运作,我们必须先理解表达式,所以这里我们就绕个路,看看本系列的第五部分——表达式。在之前的例子里我们已经见过表达式,例如 {{ person.name }} 和 {{ clock }}。

1 2 3

{{

8

+

1

}}

9

{{ person }}{

"name"

:

"Ari Lerner"

}

{{

10

*

3.3

| currency }}$

33.00

最后的例子里 (10 * 3.3 | currency) 用了一个过滤器。本系列之后的部分,会深入介绍过滤器。

表达式粗略来看有点像 eval(javascript) 的结果。它们会经过Angular.js的处理,从而拥有以下重要而独特的性质:

  • 所有表达式都在scope这个context里被执行,因此可以使用所有本地 $scope 中的变量。
  • 如果一个表达式的执行导致类型错误或引用错误,这些错误将不会被抛出。
  • 表达式里不允许任何控制函数流程的功能(如if/else等条件语句)
  • 表达式可接受一个或多个串联起来的过滤器。

试试看 

七步从AngularJS菜鸟到专家(4和5):指令和表达式

试试输入“person“,“clock“或其他数学算式如2+4。你甚至可以操作scope,例如,试试输入person.name = ”Ari”; person.age = 28; person 或 clock

表达式都运行在调用它们的scope里,所以一个表达式可访问并操作其scope上的一切。由此,你可以使用表达式遍历其scope的属性(我们在ng-repeat中会看到这一应用)、调用scope里的函数,或者对scope中的变量进行数学运算。

现在,让我们回到指令属性…

ng-init

ng-init指令属性是一个在启动时运行的函数(在程序进入运行阶段之前)。它让我们能够在程序运行前设定初始变量的值:

1

<b ng-init=

'name = "Ari Lerner"'

>Hello, {{ name }}</b>

试试看 

七步从AngularJS菜鸟到专家(4和5):指令和表达式

ng-click

ng-click指令属性给DOM元素注册了一个点击事件的监听器。当此DOM元素上有点击事件发生(即当此button或link被点击时),Angular.js就会执行表达式的内容,并相应地更新view。

1 2

<button ng-click=

"counter = counter + 1"

>Add one</button>

Current counter: {{ counter }}

试试看

七步从AngularJS菜鸟到专家(4和5):指令和表达式

我们也可以用ng-click 来调用在controller里写好并绑定在$scope上的函数,例如:

1

<button ng-click=

"sayHello()"

>Say hello</button>

controller 里的函数:

1 2 3 4 5

app.controller(

'MyController'

,

function

($scope) {

$scope.sayHello =

function

() {

alert(

"hello!"

);

}

});

试试看

七步从AngularJS菜鸟到专家(4和5):指令和表达式

ng-show / ng-hide

The ng-show and ng-hide directives show or hide a portion of the DOM depending on whether the expression is truthy.

ng-show和ng-hide指令,根据赋予它们的表达式的值的真假性(truthy),来显示和隐藏它们所属的那一部分DOM。

我们在这里不会深入,但你应该熟悉JavaScript中变量值的“truthy”和“falsy”概念。

1 2 3 4 5 6

<button ng-init=

"shouldShow = true"

ng-click=

"shouldShow = !shouldShow"

>Flip the shouldShow variable</button>

<div ng-show=

"shouldShow"

>

<h3>Showing {{ shouldShow }}</h3>

</div> <div ng-hide=

"shouldShow"

>

<h3>Hiding {{ shouldShow }}</h3>

</div>

试试看

图6

ng-repeat

ng-repeat指令遍历一个数据集合中的每个数据元素,加载HTML模版把数据渲染出来。被重复使用的模版元素,就是我们绑定了这个指令属性的DOM元素。每一个使用模版渲染的DOM元素都有自己的scope。

在更多的解释之前,我们先看一个例子。假设我们的controller里有这样一个数据元素的数组:

1 2 3 4 5 6

$scope.roommates = [

{ name:

'Ari'

},

{ name:

'Q'

},

{ name:

'Sean'

},

{ name:

'Anand'

}

];

在view里我们可以用ng-repeat来遍历这个集合里的数据:

1 2

<ul>

<li ng-repeat=

"person in roommates"

>{{ person.name }}</li> </ul>

请看

  • Ari
  • Q
  • Sean
  • Anand

对赋予ng-repeat的表达式稍作改动,我们还可以用它遍历一个由成对的key-value数据组成的集合。例如,假设我们有一个人名和他们最喜欢的颜色的数据集合:

1 2 3 4 5

$scope.people = {

'Ari'

:

'orange'

,

'Q'

:

'purple'

,

'Sean'

:

'green'

}

要遍历它,我们可以给ng-repeat指令属性赋予这个表达式: (key, value) in object:

1 2 3 4

<ul>

<li ng-repeat=

"(name, color) in people"

>{{ name }}'s favorite color is {{ color }}

</li>

</ul>

请看

  • Ari’s favorite color is orange
  • Q’s favorite color is blue
  • Sean’s favorite color is green

Angular.js提供的直接可用的指令属性并不多,但它让我们可以很容易地创建自己的指令属性。请到这里查看我们的指令属性创建指南:http://www.ng-newsletter.com/posts/directives.html

我们应用中的指令属性

在上一篇中,我们的收音机应用只从NPR API取回了最新的音频节目列表:

1

$scope.programs = data.list.story;

现在我们学了遍历一个list的实现方法,可以在我们的收音机应用里,像刚才那样用ng-repeat来遍历这个节目列表了:

1 2 3 4 5

<ul id=

"programs_list"

class=

""

>

<li ng-repeat=

"program in programs"

>

<span class=

"large-12"

>{{ program.title.$text }}</span>

</li>

</ul>

NPR API给我们的是一个有title+$text的列表,这个结构是NPR API所特有的,而不是Angular.js的。

现在我们列出了节目和它们的标题,但还不能点击并播放它们。用ng-click我们可以给HTML元素加上一个点击功能:

1 2 3 4 5

<ul id=

"programs_list"

class=

""

>

<li ng-repeat=

"program in programs"

ng-click=

"play(program)"

>

<span class=

"large-12"

>{{ program.title.$text }}</span>

</li>

</ul>

通过这一步,我们把一个play动作函数绑定到了列表里的<li>DOM元素上。现在,我们在PlayerController里创建这个play动作函数,然后我们就有了一个功能完备的音频应用:

1 2 3 4 5 6 7 8

// format.mp4.$text是NPR API给我们的到这个音频mp4文件的路径 $scope.play = function(program) {

if

($scope.playing) audio.pause();

var

url = program.audio[0].format.mp4.$text;

audio.src = url;

audio.play();

// 储存播放器的状态为正在播放

$scope.playing =

true

;

}

现在这个应用功能完备了,但是还不太好看。而且随着我们继续添加新功能,代码也会膨胀,变得难以管理。我们可以创建自己的指令属性,来帮助我们减少复杂性。

想更多地学习自定义指令属性,可以看看我们深入探讨指令属性的文章:http://www.ng-newsletter.com/posts/directives.html

创建自定义指令属性,我们使用app对象的directive方法:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

app.directive(

'nprLink'

,

function

() {

return

{

restrict:

'EA'

,

require: [

'^ngModel'

],

replace

:

true

,

scope: {

ngModel:

'='

,

play:

'&'

},

templateUrl:

'/views/nprListItem.html'

,

link:

function

(scope, ele, attr) {

scope.duration = scope.ngModel.audio[

].duration.$text;

}

}

});

我们不会逐个解释每个选项的意义,因为我们有一篇专门的深入文章来介绍它们(http://www.ng-newsletter.com/posts/directives.html)。这里我们只需要明白,现在我们就能在HTML里使用这个自定义的指令属性了,它会将它所在的DOM元素替换为我们给定的templateUrl所指向的模版里的内容(在 /views/nprListItem 中)。

现在,我们的主HTML文件可以保持整洁,而将用来渲染列表内容的view,创建在这个单独提取出来的模版文件里:

1 2 3 4 5 6 7 8 9 10 11 12 13 14

<div

class

=

"nprLink row"

ng-click=

"play(ngModel)"

>

<span

class

=

"name large-8 columns"

>

<button

class

=

"large-2 small-2 playButton columns"

><div

class

=

"triangle"

></div></button>

<div

class

=

"large-10 small-10 columns"

>

<div

class

=

"row"

>

<span

class

=

"large-12"

>{{ ngModel.title.$text }}</span>

</div>

<div

class

=

"row"

>

<div

class

=

"small-1 columns"

></div>

<div

class

=

"small-2 columns push-8"

><a href=

"{{ ngModel.link[0].$text }}"

>Link</a></div>

</div>

</div>

</span>

</div>

注意我们在模版文件里用ngModel来指向之前的program数据,因为在创建自定义指令属性时,我们做了设置。

现在,我们在主HTML文件里就不用再写上面那么多HTML,而只要简单地换上我们的自定义指令属性npr-link:

1 2 3 4 5

<ul id=

"programs_list"

class=

""

>

<li ng-repeat=

"program in programs"

>

<span npr-link play=

'play(program)'

ng-model=

"program"

></span>

</li>

</ul>

在下一章中,我们会介绍Service的用法,以及如何在我们应用的多个controller之间通讯。

本系列的官方代码库可从GitHub上下载:

https://github.com/auser/ng-newsletter-beginner-series.

要将这个代码库保存到本地,请先确保安装了git,clone此代码库,然后check out其中的part5分支。我们使用XHR获取模版,所以你需要在本地服务器上运行这一章的代码。在part5分支里我们提供了服务器端代码:

1 2

git clone https:

//github

.com

/auser/ng-newsletter-beginner-series

.git git checkout -b part5

.

/bin/server

.sh