英文原文:http://emberjs.com/guides/object-model/computed-properties-and-aggregate-data/
Computed Properties and Aggregate Data
计算属性和带@each的集合数据
Often, you may have a computed property that relies on all of the items in an array to determine its value. For example, you may want to count all of the todo items in a controller to determine how many of them are completed.
计算属性时常依赖一个数组中的全部元素来计算其值。例如,要知道有多少已经完成的待办事项,那么需要计算控制器中所有的待办事项才能得出结果。
Here’s what that computed property might look like:
下面是一个计算属性的示例:
App.TodosController = Ember.Controller.extend({
todos: [
Ember.Object.create({ isDone: false })
],
remaining: function() {
var todos = this.get('todos');
return todos.filterBy('isDone', false).get('length');
}.property('todos.@each.isDone')
});
Note here that the dependent key (todos.@each.isDone
) contains the special
key @each
. This instructs Ember.js to update bindings and fire observers for
this computed property when one of the following four events occurs:
这里需要注意的是依赖(todos.@each.isDone
)中包含一个特殊的关键字@each
。使用了@each
意味着Ember.js在下述的四种情况下,将更新计算属性的绑定和触发其观察器:
- The
isDone
property of any of the objects in thetodos
array changes. - An item is added to the
todos
array. - An item is removed from the
todos
array. The
todos
property of the controller is changed to a different array.todos
数组中任意一个元素的isDone
属性发生改变;todos
数组中添加了一个新成员;todos
数组中有一个成员被移除了;- 控制器的
todos
数组变为了另外一个不同的数组。
In the example above, the remaining
count is 1
:
在上面的示例中,remaining
为1
:
App.todosController = App.TodosController.create();
App.todosController.get('remaining');
// 1
If we change the todo’s isDone
property, the remaining
property is updated
automatically:
如果改变待办事项的isDone
属性,remaining
属性会被自动更新:
var todos = App.todosController.get('todos');
var todo = todos.objectAt(0);
todo.set('isDone', true);
App.todosController.get('remaining');
// 0
todo = Ember.Object.create({ isDone: false });
todos.pushObject(todo);
App.todosController.get('remaining');
// 1
Note that @each
only works one level deep. You cannot use nested forms
like todos.@each.owner.name
or todos.@each.owner.@each.name
.
注意@each
只工作在第一级。不能嵌套使用,如:todos.@each.owner.name
或者todos.@each.owner.@each.name
。