[学习笔记] 七步从AngularJS菜鸟到专家(4和5):指令和表达式 [转]

时间:2021-12-11 09:17:31

这一篇包含了"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>

试试看 

Hello, Ari Lerner

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[0].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