介绍 编辑页面


英文原文:http://emberjs.com/guides/enumerables/

枚举

在Ember.js中,任何包含子对象集合的,并允许使用Ember.Enumerable接口来访问这些子对象的对象称为枚举。在大部分应用中最为常见的枚举是Ember.js为了确保枚举接口的一致性,而进行过扩展的Javascript的原生数组。

通过提供一个标准接口来处理枚举,Ember.js允许在不改变应用程序其他使用到枚举的部分的情况下,完全的改变数据的存储方式。

例如,在开发过程中,显示的列表条目是通过固定的测试数据来加载。当将该列表条目数据从同步的测试数据切换为从服务器延迟加载的模式来获取的时候,试图、模板和控制器代码不需要进行任何修改。

枚举API尽可能的遵从ECMAScript规范,这将与其他库的不兼容情况降至最低,并且允许Ember.js使用浏览器自身实现的数组。

例如,所有的枚举都支持标准的forEach方法:

1
2
3
4
5
6
7
[1,2,3].forEach(function(item) {
  console.log(item);
});

//=> 1
//=> 2
//=> 3

通常情况下,类似forEach这样的枚举方法都支持一个可选第二参数,该参数值将用作回调函数里的this

1
2
3
4
5
6
7
8
9
var array = [1,2,3];

array.forEach(function(item) {
  console.log(item, this.indexOf(item));
}, array)

//=> 1 0
//=> 2 1
//=> 3 2

Ember.js中的枚举

通常,代表一个列表的对象实现枚举接口。例如:

  • Array - Ember采用枚举接口扩展Javascript原生Array(除非显示关闭prototype扩展)
  • Ember.ArrayController - 一种控制器其包裹了一个数组和其他一些视图层的辅助功能。
  • Ember.Set - 一种数据结构其可以高效的回答是否包含某一个对象。

API概要

在本指南中,将讲述一些最为常用的枚举惯例。完整的内容请查看Ember.Enumerable API参考文档

遍历枚举

为了遍历枚举对象的所有值,可以使用forEach方法:

1
2
3
4
5
6
7
8
9
var food = ["Poi", "Ono", "Adobo Chicken"];

food.forEach(function(item, index) {
  console.log('Menu Item %@: %@'.fmt(index+1, item));
});

// Menu Item 1: Poi
// Menu Item 2: Ono
// Menu Item 3: Adobo Chicken

拷贝数组

可以通过调用实现了Ember.Enumerable接口的任意对象的toArray()方法来将其创建一个原生的数组。

1
2
3
4
5
6
7
var states = Ember.Set.create();

states.add("Hawaii");
states.add("California")

states.toArray()
//=> ["Hawaii", "California"]

注意在很多枚举中,例如在本例中使用的Ember.Set,生成的数组元素的顺序无法得到保证。

首尾对象

所有枚举提供firstObjectlastObject属性来获取首尾对象。

1
2
3
4
5
6
7
8
9
var animals = ["rooster", "pig"];

animals.get('lastObject');
//=> "pig"

animals.pushObject("peacock");

animals.get('lastObject');
//=> "peacock"

映射

通过使用map()方法,可以方便的转换枚举中的每个元素。该方法使用对每个元素进行处理后的结果创建一个新的数组。

1
2
3
4
5
6
var words = ["goodbye", "cruel", "world"];

var emphaticWords = words.map(function(item) {
  return item + "!";
});
// ["goodbye!", "cruel!", "world!"]

如果枚举由对象构成,那么通过mapBy()方法可以抽取对象指定的属性,来形成一个新的数组:

1
2
3
4
5
6
7
8
9
10
11
12
var hawaii = Ember.Object.create({
  capital: "Honolulu"
});

var california = Ember.Object.create({
  capital: "Sacramento"
});

var states = [hawaii, california];

states.mapBy('capital');
//=> ["Honolulu", "Sacramento"]

过滤

另外一个常规任务是将一个枚举作为输入,为其设定一些过滤条件来返回一个新的数组。

对于采用filter方法的任意过滤。如果回调方法返回true,那么Ember将在返回结果中包含该元素,如果返回false或者undefined则不包含。

1
2
3
4
5
6
7
var arr = [1,2,3,4,5];

arr.filter(function(item, index, self) {
  if (item < 4) { return true; }
})

// returns [1,2,3]

当处理一个Ember对象的集合时,经常需要基于对象的某些属性值来过滤。filterBy方法可以快速的实现此过滤。

1
2
3
4
5
6
7
8
9
10
11
12
13
Todo = Ember.Object.extend({
  title: null,
  isDone: false
});

todos = [
  Todo.create({ title: 'Write code', isDone: true }),
  Todo.create({ title: 'Go to sleep' })
];

todos.filterBy('isDone', true);

// returns an Array containing only items with `isDone == true`

如果只想返回第一个匹配的值,而不是一个包含所有匹配值的数组,可以使用findfindBy方法,其工作原理与filterfilterBy一样,不同的是只返回一个元素。

聚合信息(全部或者部分)

如果希望检查是否所有的枚举的元素都符合某些条件,可以使用every方法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Person = Ember.Object.extend({
  name: null,
  isHappy: false
});

var people = [
  Person.create({ name: 'Yehuda', isHappy: true }),
  Person.create({ name: 'Majd', isHappy: false })
];

people.every(function(person, index, self) {
  if(person.get('isHappy')) { return true; }
});

// returns false

如果希望检查是否枚举的元素至少有一个符合某些条件,那么可以使用some方法:

1
2
3
4
5
people.some(function(person, index, self) {
  if(person.get('isHappy')) { return true; }
});

// returns true

如同过滤方法一样,everysome也有isEveryisAny方法。

1
2
people.isEvery('isHappy', true) // false
people.isAny('isHappy', true)  // true