开始学习AngularJS的一个好方法是创建经典应用程序“Hello World!”:
源代码
ng-app>
Hello {{'World'}}!
请在您的浏览器中运行以上代码查看效果。
现在让我们仔细看看代码,看看到底怎么回事。 当加载该页时,标记ng-app
告诉angularjs处理整个HTML页并引导应用:
ng-app>
这行载入AngularJS脚本:
(想了解AngularJS处理整个HTML页的细节,请看Bootstrap。)
最后,标签中的正文是应用的模板,在UI中显示我们的问候语:
Hello {{'World'}}!
注意,使用双大括号标记{{}}
的内容是问候语中绑定的表达式,这个表达式是一个简单的字符串‘World’。
下面,让我们看一个更有趣的例子:使用AngularJS对我们的问候语文本绑定一个动态表达式。
本示例演示AngularJS的双向数据绑定(bi-directional data binding):
源代码
ng-app>
Your name: type="text" ng-model="yourname" placeholder="World">
Hello {{yourname || 'World'}}!
请在您的浏览器中运行以上代码查看效果。
该示例有一下几点重要的注意事项:
绑定到一个叫yourname
的模型变量。yourname
模型变量添加到问候语文本。现在试着在输入框中键入您的名称,您键入的名称将立即更新显示在问候语中。 这就是AngularJS双向数据绑定的概念。 输入框的任何更改会立即反映到模型变量(一个方向),模型变量的任何更改都会立即反映到问候语文本中(另一方向)。
本节描述AngularJS应用程序的三个组成部分,并解释它们如何映射到模型-视图-控制器设计模式:
模板是您用HTML和CSS编写的文件,展现应用的视图。 您可给HTML添加新的元素、属性标记,作为AngularJS编译器的指令。 AngularJS编译器是完全可扩展的,这意味着通过AngularJS您可以在HTML中构建您自己的HTML标记!
应用程序逻辑和行为是您用JavaScript定义的控制器。AngularJS与标准AJAX应用程序不同,您不需要另外编写侦听器或DOM控制器,因为它们已经内置到AngularJS中了。这些功能使您的应用程序逻辑很容易编写、测试、维护和理解。
模型是从AngularJS作用域对象的属性引申的。模型中的数据可能是javascript对象、数组或基本类型,这都不重要,重要的是,他们都属于AngularJS作用域对象。
AngularJS通过作用域来保持数据模型与视图界面UI的双向同步。一旦模型状态发生改变,AngularJS会立即刷新反映在视图界面中,反之亦然。
无论是Mac、Linux或Windows环境中,您均可遵循本教程学习编程。您可以使用源代码管理版本控制系统Git获取本教程项目的源代码文件,或直接从网上下载本教程项目源代码文件的镜像归档压缩包。
您需要安装Node.js和Testacular来运行本项目,请到Node.js官方网站下载并安装最新版,然后把node可执行程序路径添加到系统环境变量PATH
中,完成后在命令行中运行一下命令可以查看是否安装成功:
node -version
然后安装Testacular单元测试程序,请运行如下命令:
npm install -g testacular
安装Git工具,然后用以下命令从Github复制本教程项目的源代码文件:
git clone git://github.com/angular/angular-phonecat.git
您也可以直接从网上下载本教程项目源代码的镜像归档压缩包。这个命令会在您当前文件夹中建立新文件夹angular-phonecat
。
最后一件事要做的就是确保您的计算机安装了web浏览器和文本编辑器。
进入教程源代码文件包angular-phonecat,运行服务器后台程序,开始学习AngularJS!
cd angular-phonecat
node scripts/web-server.js
我们现在开始准备编写AngularJS应用——phonecat。这一步骤(步骤0),您将会熟悉重要的源代码文件,学习启动包含AngularJS种子项目的开发环境,并在浏览器端运行应用。
进入angular-phonecat目录,运行如下命令:
git checkout -f step-0
该命令将重置phonecat项目的工作目录,建议您在每一学习步骤运行此命令,将命令中的数字改成您学习步骤对应的数字,该命令将清除您在工作目录内做的任何更改。
运行以下命令:
node scripts/web-server.js
来启动服务器,启动后命令行终端将会提示Http Server running at http://localhost:8000
,请不要关闭该终端,关闭该终端即关闭了服务器。在浏览器中输入http://localhost:8000/app/index.html来访问我们的phonecat应用。
现在,在浏览器中您应该已经看到了我们的初始应用,很简单,但说明我们的项目已经可以运行了。
应用中显示的“Nothing here yet!”是由如下HTML代码构建而成,代码中包含了AngularJS的关键元素,正是我们需要学习的。
app/index.html
lang="en" ng-app>
charset="utf-8">
My HTML File
rel="stylesheet" href="css/app.css">
rel="stylesheet" href="css/bootstrap.css">
Nothing here {{'yet' + '!'}}
ng-app
指令: lang="en" ng-app>
这行代码载入angular.js脚本,当浏览器将整个HTML页面载入完毕后将会执行该angular.js脚本,angular.js脚本运行后将会寻找含有 这行代码演示了AngularJS模板的核心功能——绑定,这个绑定由双大括号 这个绑定告诉AngularJS需要运算其中的表达式并将结果插入DOM中,接下来的步骤我们将看到,DOM可以随着表达式运算结果的改变而实时更新。 AngularJS表达式Angular expression是一种类似于JavaScript的代码片段,AngularJS表达式仅在AngularJS的作用域中运行,而不是在整个DOM中运行。 通过ngApp指令来自动引导AngularJS应用是一种简洁的方式,适合大多数情况。在高级开发中,例如使用脚本装载应用,您也可以使用bootstrap手动引导AngularJS应用。 AngularJS应用引导过程有3个重要点: 一旦AngularJS应用引导完毕,它将继续侦听浏览器的HTML触发事件,如鼠标点击事件、按键事件、HTTP传入响应等改变DOM模型的事件。这类事件一旦发生,AngularJS将会自动检测变化,并作出相应的处理及更新。 上面这个应用的结构非常简单。该模板包仅含一个指令和一个静态绑定,其中的模型也是空的。下一步我们尝试稍复杂的应用! 上面的应用来自于AngularJS种子项目,我们通常可以使用AngularJS种子项目来创建新项目。种子项目包括最新的AngularJS代码库、测试库、脚本和一个简单的应用程序示例,它包含了开发一个典型的web应用程序所需的基本配置。 对于本教程,我们对AngularJS种子项目进行了下列更改: 试试把关于数学运算的新表达式添加到index.html: 现在让我们转到步骤1,将一些内容添加到web应用程序。 为了说明angularJS如何增强了标准HTML,我们先将创建一个静态HTML页面模板,然后把这个静态HTML页面模板转换成能动态显示的AngularJS模板。 在本步骤中,我们往HTML页面中添加两个手机的基本信息,用以下命令将工作目录重置到步骤1。 请编辑app/index.html文件,将下面的代码添加到index.html文件中,然后运行该应用查看效果。 app/index.html 尝试添加多个静态HTML代码到index.html, 例如: 本步骤往应用中添加了静态HTML手机列表, 现在让我们转到步骤2以了解如何使用AngularJS动态生成相同的列表。 是时候给这些网页来点动态特性了——用AngularJS!我们这里为后面要加入的控制器添加了一个测试。 一个应用的代码架构有很多种。对于AngularJS应用,我们鼓励使用模型-视图-控制器(MVC)模式解耦代码和分离关注点。考虑到这一点,我们用AngularJS来为我们的应用添加一些模型、视图和控制器。 请重置工作目录: 我们的应用现在有了一个包含三部手机的列表。 步骤1和步骤2之间最重要的不同在下面列出。,你可以到GitHub去看完整的差别。 在AngularJS中,一个视图是模型通过HTML**模板**渲染之后的映射。这意味着,不论模型什么时候发生变化,AngularJS会实时更新结合点,随之更新视图。 比如,视图组件被AngularJS用下面这个模板构建出来: 我们刚刚把静态编码的手机列表替换掉了,因为这里我们使用ngRepeat指令和两个用花括号包裹起来的AngularJS表达式—— 在 app/js/controller.js: 尽管控制器看起来并没有起到什么控制的作用,但是它在这里起到了至关重要的作用。通过给定我们数据模型的语境,控制器允许我们建立模型和视图之间的数据绑定。我们是这样把表现层,数据和逻辑部件联系在一起的: AngularJS的作用域理论非常重要:一个作用域可以视作模板、模型和控制器协同工作的粘接器。AngularJS使用作用域,同时还有模板中的信息,数据模型和控制器。这些可以帮助模型和视图分离,但是他们两者确实是同步的!任何对于模型的更改都会即时反映在视图上;任何在视图上的更改都会被立刻体现在模型中。 想要更加深入理解AngularJS的作用域,请参看AngularJS作用域文档。 “AngularJS方式”让开发时代码测试变得十分简单。让我们来瞅一眼下面这个为控制器新添加的单元测试: test/unit/controllersSpec.js: 这个测试验证了我们的手机数组里面有三条记录(暂时无需弄明白这个测试脚本)。这个例子显示出为AngularJS的代码创建一个单元测试是多么的容易。正因为测试在软件开发中是必不可少的环节,所以我们使得在AngularJS可以轻易地构建测试,来鼓励开发者多写它们。 在写测试的时候,AngularJS的开发者倾向于使用Jasmine行为驱动开发(BBD)框架中的语法。尽管AngularJS没有强迫你使用Jasmine,但是我们在教程里面所有的测试都使用Jasmine编写。你可以在Jasmine的官方主页或者Jasmine Wiki上获得相关知识。 基于AngularJS的项目被预先配置为使用JsTestDriver来运行单元测试。你可以像下面这样运行测试: 选择“Capture this browser in strict mode”。 这个时候,你可以抛开你的窗口不管然后把这事忘了。JsTestDriver会自己把测试跑完并且把结果输出在你的终端里。 运行 你应当看到类似于如下的结果: 耶!测试通过了!或者没有... 注意:如果在你运行测试之后发生了错误,关闭浏览器然后回到终端关了脚本,然后在重新来一边上面的步骤。 为 创建一个新的数据模型属性,并且把它绑定到模板上。例如: 更新你的浏览器,确保显示出来“Hello, World!” 用一个迭代器创建一个简单的表: 现在让数据模型表达式的 确定把 你现在拥有一个模型,视图,控制器分离的动态应用了,并且你随时进行了测试。现在,你可以进入到步骤3来为应用加入全文检索功能了。 我们在上一步做了很多基础性的训练,所以现在我们可以来做一些简单的事情喽。我们要加入全文检索功能(没错,这个真的非常简单!)。同时,我们也会写一个端到端测试,因为一个好的端到端测试可以帮上很大忙。它监视着你的应用,并且在发生回归的时候迅速报告。 请重置工作目录: 我们的应用现在有了一个搜索框。注意到页面上的手机列表随着用户在搜索框中的输入而变化。 步骤2和步骤3之间最重要的不同在下面列出。你可以在GitHub里看到完整的差别。 我们对控制器不做任何修改。 app/index.html 我们现在添加了一个 这样允许用户输入一个搜索条件,立刻就能看到对电话列表的搜索结果。我们来解释一下新的代码: 数据绑定: 这是AngularJS的一个核心特性。当页面加载的时候,AngularJS会根据输入框的属性值名字,将其与数据模型中相同名字的变量绑定在一起,以确保两者的同步性。 在这段代码中,用户在输入框中输入的数据名字称作 使用 在步骤2,我们学习了编写和运行一个测试的方法。单元测试用来测试我们用js编写的控制器和其他组件都非常方便,但是不能方便的对DOM操作和应用集成进行测试。对于这些来说,端到端测试是一个更好的选择。 搜索特性是完全通过模板和数据绑定实现的,所以我们的第一个端到端测试就来验证这些特性是否符合我们的预期。 test/e2e/scenarios.js: 尽管这段测试代码的语法看起来和我们之前用Jasmine写的单元测试非常像,但是端到端测试使用的是AngularJS端到端测试器提供的接口。 运行一个端到端测试,在浏览器新标签页中打开下面任意一个: 这个测试验证了搜素框和迭代器被正确地集成起来。你可以发现,在AngularJS里写一个端到端测试多么的简单。尽管这个例子仅仅是一个简单的测试,但是用它来构建任何一个复杂、可读的端到端测试都很容易。 现在我们来看一下我们怎么让 你或许认为像下面这样在 但是,当你重载页面的时候,你根本没办法得到期望的结果。这是因为 如果你想让 一定要注意把 当绑定两个花括号在 在 刷新浏览器,端到端测试器会报告测试失败。为了让测试通过,编辑 在端到端测试里面加一条 我们现在添加了全文搜索功能,并且完成一个测试证明了搜索是对的!现在让我们继续到步骤4来看看给我们的手机应用增加排序功能。 在这一步你会增加一个让用户控制手机列表显示顺序的特性。动态排序可以这样实现,添加一个新的模型属性,把它和迭代器集成起来,然后让数据绑定完成剩下的事情。 请重置工作目录: 你应该发现除了搜索框之外,你的应用多了一个下来菜单,它可以允许控制电话排列的顺序。 步骤3和步骤4之间最重要的不同在下面列出。你可以在GitHub里看到完整的差别。 app/index.html {{phone.snippet}} 我们在index.html中做了如下更改: AngularJS在 正如我们在步骤3中讨论数据绑定和迭代器的时候所说的一样,无论什么时候数据模型发生了改变(比如用户在下拉菜单中选了不同的顺序),AngularJS的数据绑定会让视图自动更新。没有任何笨拙的DOM操作! app/js/controllers.js: 我们在控制器代码里加了一行让 现在我们该好好谈谈双向数据绑定了。注意到当应用在浏览器中加载时,“Newest”在下拉菜单中被选中。这是因为我们在控制器中把 我们所做的更改可以通过一个单元测试或者一个端到端测试来验证正确性。我们首先来看看单元测试: test/unit/controllersSpec.js: 单元测试现在验证了默认值被正确设置。 我们使用Jasmine的接口把 运行这些单元测试,跟以前一样,执行 现在我们把注意力转移到端到端测试上来。 test/e2e/scenarios.js: 端到端测试验证了选项框的排序机制是正确的。 你现在可以刷新你的浏览器,然后重新跑一遍端到端测试,或者你可以在AngularJS的服务器上运行一下。ng-app
指令标记了AngularJS脚本的作用域,在中添加
ng-app
属性即说明整个都是AngularJS脚本作用域。开发者也可以在局部使用
ng-app
指令,如 AngularJS脚本标签:
ng-app
指令的HTML标签,该标签即定义了AngularJS应用的作用域。 双大括号绑定的表达式:
Nothing here {{'yet' + '!'}}
{{}}
和表达式'yet' + '!'
组成。 引导AngularJS应用
我工作目录中这些文件是干什么的?
练习
1 + 2 = {{ 1 + 2 }}
总结
(四)静态模板
git checkout -f step-1
Nexus S
Fast just got faster with Nexus S.
Motorola XOOM™ with Wi-Fi
The Next, Next Generation tablet.
练习
Total number of phones: 2
总结
(五)AngularJS模板
git checkout -f step-2
视图和模板
ng-app>
...
ng-controller="PhoneListCtrl">
{{phone.name}}
和{{phone.snippet}}
——能达到同样的效果。
标签里面的
ng-repeat="phone in phones"
语句是一个AngularJS迭代器。这个迭代器告诉AngularJS用第一个标签作为模板为列表中的每一部手机创建一个
元素。
phone.name
和phone.snippet
周围的花括号标识着数据绑定。和常量计算不同的是,这里的表达式实际上是我们应用的一个数据模型引用,这些我们在PhoneListCtrl
控制器里面都设置好了。 模型和控制器
PhoneListCtrl
控制器里面初始化了数据模型(这里只不过是一个包含了数组的函数,数组中存储的对象是手机数据列表):function PhoneListCtrl($scope) {
$scope.phones = [
{"name": "Nexus S",
"snippet": "Fast just got faster with Nexus S."},
{"name": "Motorola XOOM™ with Wi-Fi",
"snippet": "The Next, Next Generation tablet."},
{"name": "MOTOROLA XOOM™",
"snippet": "The Next, Next Generation tablet."}
];}
PhoneListCtrl
——控制器方法的名字(在JS文件controllers.js
中)和标签里面的ngController指令的值相匹配。
$scope
)相关联。当应用启动之后,会有一个根作用域被创建出来,而控制器的作用域是根作用域的一个典型后继。这个控制器的作用域对所有标记内部的数据绑定有效。
测试
describe('PhoneCat controllers', function() {
describe('PhoneListCtrl', function(){
it('should create "phones" model with 3 phones', function() {
var scope = {},
ctrl = new PhoneListCtrl(scope);
expect(scope.phones.length).toBe(3);
});
});});
angular-phonecat
目录并且运行./scripts/test-server.sh
来启动测试(Windows命令行下请输入.\scripts\test-server.bat
来运行脚本,后面脚本命令运行方式类似);./scripts/test.sh
进行测试 。Chrome: Runner reset..Total 1 tests (Passed: 1; Fails: 0; Errors: 0) (2.00 ms)
Chrome 19.0.1084.36 Mac OS: Run 1 tests (Passed: 1; Fails: 0; Errors 0) (2.00 ms)
练习
index.html
添加另一个数据绑定。例如:Total number of phones: {{phones.length}}
$scope.hello = "Hello, World!"
row number ng-repeat="i in [0, 1, 2, 3, 4, 5, 6, 7]"> {{i}} i
增加1:
row number ng-repeat="i in [0, 1, 2, 3, 4, 5, 6, 7]"> {{i+1}} toBe(3)
改成toBe(4)
之后单元测试失败,然后重新跑一遍./scripts/test.sh
脚本 总结
(六)双向绑定
git checkout -f step-3
控制器
模板
class="phones">
标签,并且使用AngularJS的$filter函数来处理ngRepeat指令的输入。
query
,会立刻作为列表迭代器(phone in phones | filter:
query`)其过滤器的输入。当数据模型引起迭代器输入变化的时候,迭代器可以高效得更新DOM将数据模型最新的状态反映出来。
filter
过滤器:filter函数使用query
的值来创建一个只包含匹配query
记录的新数组。ngRepeat
会根据filter
过滤器生成的手机记录数据数组来自动更新视图。整个过程对于开发者来说都是透明的。 测试
describe('PhoneCat App', function() {
describe('Phone list view', function() {
beforeEach(function() {
browser().navigateTo('../../app/index.html');
});
it('should filter the phone list as user types into the search box', function() {
expect(repeater('.phones li').count()).toBe(3);
input('query').enter('nexus');
expect(repeater('.phones li').count()).toBe(1);
input('query').enter('motorola');
expect(repeater('.phones li').count()).toBe(2);
});
});});
http://localhost:[port-number]/[context-path]/test/e2e/runner.html
练习
index.html
模板中添加一个{{query}}
绑定来实时显示query
模型的当前值,然后观察他们是如何根据输入框中的值而变化。query
模型的值出现在HTML的页面标题上。title
标签上加上一个绑定就行了:query
模型仅仅在body
元素定义的作用域内才有效。 ng-controller="PhoneListCtrl">
元素绑定上query
模型,你必须把ngController
声明移动到HTML
元素上,因为它是title
和body
元素的共同祖先。 ng-app ng-controller="PhoneListCtrl">
body
元素上的ng-controller
声明给删了。title
元素上可以实现我们的目标,但是你或许发现了,页面正加载的时候它们已经显示给用户看了。一个更好的解决方案是使用ngBind或者ngBindTemplate指令,它们在页面加载时对用户是不可见的:test/e2e/scenarios.js
的describe
块中加入下面这些端到端测试代码:it('should display the current filter value within an element with id "status"',
function() {
expect(element('#status').text()).toMatch(/Current filter: \s*$/);
input('query').enter('nexus');
expect(element('#status').text()).toMatch(/Current filter: nexus\s*$/);
//alternative version of the last assertion that tests just the value of the binding
using('#status').expect(binding('query')).toBe('nexus');});
index.html
,添加一个id为“status”
的div
或者p
元素,内容是一个query
绑定,再加上Current filter:
前缀。例如:pause();
语句,重新跑一遍。你将发现测试器暂停了!这样允许你有机会在测试运行过程中查看你应用的状态。测试应用是实时的!你可以更换搜索内容来证明。稍有经验你就会知道,这对于在端到端测试中迅速找到问题是多么的关键。 总结
git checkout -f step-4
模板
Search: <input ng-model="query">Sort by:<select ng-model="orderProp">
<option value="name">Alphabetical</option>
option></select>
p>
</li>
ul>
orderProp
的标签,这样我们的用户就可以选择我们提供的两种排序方法。
filter
过滤器后面添加一个orderBy过滤器用其来处理进入迭代器的数据。orderBy
过滤器以一个数组作为输入,复制一份副本,然后把副本重排序再输出到迭代器。select
元素和orderProp
模型之间创建了一个双向绑定。而后,orderProp
会被用作orderBy
过滤器的输入。 控制器
function PhoneListCtrl($scope) {
$scope.phones = [
{"name": "Nexus S",
"snippet": "Fast just got faster with Nexus S.",
"age": 0},
{"name": "Motorola XOOM™ with Wi-Fi",
"snippet": "The Next, Next Generation tablet.",
"age": 1},
{"name": "MOTOROLA XOOM™",
"snippet": "The Next, Next Generation tablet.",
"age": 2}
];
$scope.orderProp = 'age';}
phones
模型—— 手机的数组 ——为每一个手机记录其增加了一个age
属性。我们会根据age
属性来对手机进行排序。orderProp
的默认值为age
。如果我们不设置默认值,这个模型会在我们的用户在下拉菜单选择一个顺序之前一直处于未初始化状态。orderProp
设置成了‘age’。所以绑定在从我们模型到用户界面的方向上起作用——即数据从模型到视图的绑定。现在当你在下拉菜单中选择“Alphabetically”,数据模型会被同时更新,并且手机列表数组会被重新排序。这个时候数据绑定从另一个方向产生了作用——即数据从视图到模型的绑定。 测试
describe('PhoneCat controllers', function() {
describe('PhoneListCtrl', function(){
var scope, ctrl;
beforeEach(function() {
scope = {},
ctrl = new PhoneListCtrl(scope);
});
it('should create "phones" model with 3 phones', function() {
expect(scope.phones.length).toBe(3);
});
it('should set the default value of orderProp model', function() {
expect(scope.orderProp).toBe('age');
});
});});
PhoneListCtrl
控制器提取到一个beforeEach
块中,这个块会被所有的父块describe
中的所有测试所共享。./scripts/test.sh
脚本,你应该会看到如下输出(注意:要在浏览器打开http://localhost:9876并进入严格模式,测试才会运行!):Chrome: Runner reset...Total 2 tests (Passed: 2; Fails: 0; Errors: 0) (3.00 ms)
Chrome 19.0.1084.36 Mac OS: Run 2 tests (Passed: 2; Fails: 0; Errors 0) (3.00 ms)
...
it('should be possible to control phone order via the drop down select box',
function() {
//let's narrow the dataset to make the test assertions shorter
input('query').enter('tablet');
expect(repeater('.phones li', 'Phone List').column('phone.name')).
toEqual(["Motorola XOOM\u2122 with Wi-Fi",
"MOTOROLA XOOM\u2122"]);
select('orderProp').option('Alphabetical');
expect(repeater('.phones li', 'Phone List').column('phone.name')).
toEqual(["MOTOROLA XOOM\u2122",
"Motorola XOOM\u2122 with Wi-Fi"]);
});...
练习
PhoneListCtrl
控制器中,把设置orderProp
那条语句删掉,你会看到AngularJS会在下拉菜单中临时添加一个空白的选项,并且排序顺序是默认排序(即未排序)。index.html
模板里面添加一个`{{orderProp}}绑定来实时显示它的值。 总
结