在这一步中,你将添加一个功能,让你的用户控制手机列表中的项目的排序。这个动态排序由创建一个新模块属性来实现,用迭代器接通它们,并且让数据绑定来完成剩余工作。
把工作空间重置到第四步
git checkout -f step-4
刷新你的浏览器或在线检查这一步:Step 4 Live Demo
下面列出了第四步和第五步之间的最重要的区别。你可以在GitHub里看到完整的差异。
app/index.html
:
Search: <input ng-model="query">
Sort by:
<select ng-model="orderProp">
<option value="name">Alphabetical</option>
<option value="age">Newest</option>
</select>
<ul class="phones">
<li ng-repeat="phone in phones | filter:query | orderBy:orderProp">
<span>{{phone.name}}</span>
<p>{{phone.snippet}}</p>
</li>
</ul>
我们制作以下对index.html
模板的改变:
<select>
html元素,命名为orderProp
,因此我们的用户可以从两个提供的排序选择中选一个。filter
筛选器连与orderBy
?筛选器连缀,以更进一步处理输入到迭代器的处理。orderBy
是一个筛选器,取用一个输入数组,复制它,之后返回一个副本,重排序这个副本。Angular在select
元素以及orderProp
模块之间创建了双路数据绑定。然后orderProp
被用作针对orderBy
筛选器的输入。
正如我们在这一节第三步中讨论的,关于数据绑定和迭代器,每当模块变化时(比如说因为用户通过选择下拉菜单改变了顺序),Angular的数据绑定将导致该视图自动更新。不臃肿的DOM操作代码是必要的!
app/js/controllers.js
:
var phonecatApp = angular.module('phonecatApp', []);
phonecatApp.controller('PhoneListCtrl', function ($scope) {
$scope.phones = [
{'name': 'Nexus S',
'snippet': 'Fast just got faster with Nexus S.',
'age': 1},
{'name': 'Motorola XOOM? with Wi-Fi',
'snippet': 'The Next, Next Generation tablet.',
'age': 2},
{'name': 'MOTOROLA XOOM?',
'snippet': 'The Next, Next Generation tablet.',
'age': 3}
];
$scope.orderProp = 'age';
});
我们修改了phones
模块——手机的数组——并把一个age
属性添加到每个手机记录中。属性被用于根据年代排序手机。
我们给控制器添加了一行,把orderProp
的默认值设置为age
。如果我们还没有在这里设置一个默认值,orderBy
筛选器会保持未初始化,直到我们的用户从下拉菜单中挑了一个选项。
这是讲解双路数据绑定的好时候。注意,当应用在浏览器中载入的时候,下拉菜单中的“最新”被选中。这是因为我们在控制器中把orderProp
设置为'age'
。从我们的模块到UI的方向中的绑定工作也同样。现在,如果你选择了下拉菜单中的“Alphabetically(字母表排序)”,模块也将被更新,而且重排序了手机。这是数据绑定在反方向中所做的工作——从UI到模块。
我们所做的变化将在单元测试和端到端测试中被验证。让我们先看一看单元测试。
test/unit/controllersSpec.js
:
describe('PhoneCat controllers', function() {
describe('PhoneListCtrl', function(){
var scope, ctrl;
beforeEach(module('phonecatApp'));
beforeEach(inject(function($controller) {
scope = {};
ctrl = $controller('PhoneListCtrl', {$scope: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');
});
});
});
单元测试现在核实了默认的排序属性设置。
我们使用Jasmins的API,把控制器架构抽出到beforeEach
块,它由所有的父describe
块中的测试共享。
现在你应该在Karma选项卡中看到了以下输出:
Chrome 22.0: Executed 2 of 2 SUCCESS (0.021 secs / 0.001 secs)
让我们把注意力带回到端到端测试。
test/e2e/scenarios.js
:
...
it('should be possible to control phone order via the drop down select box', function() {
var phoneNameColumn = element.all(by.repeater('phone in phones').column('phone.name'));
var query = element(by.model('query'));
function getNames() {
return phoneNameColumn.map(function(elm) {
return elm.getText();
});
}
query.sendKeys('tablet'); //let's narrow the dataset to make the test assertions shorter
expect(getNames()).toEqual([
"Motorola XOOM\u2122 with Wi-Fi",
"MOTOROLA XOOM\u2122"
]);
element(by.model('orderProp')).element(by.css('option[value="name"]')).click();
expect(getNames()).toEqual([
"MOTOROLA XOOM\u2122",
"Motorola XOOM\u2122 with Wi-Fi"
]);
});...
端到端测试核实了选择框的排序机制正在正常工作。
现在你可以重新运行npm run protractor
以查看测试运行。
在PhoneListCtrl
控制器中,移除设置orderProp
值的状态,你将看到Angular给下拉列表临时地添加了一个新的空白("unknown")选项,而且排序将默认为无序/自然排序。
把一个{{orderProp}}
绑定到index.html
模板上,从而把它的当前值显示为文本。
-
符号来逆转排序顺序:<option value="-age">Oldest</option>
现在我们已经添加了列表排序,并测试了应用,前往第五步 XHR和依赖注入以学习关于Angular服务,以及Angular如何使用依赖性注入。