Class Ember.MutableArray

Uses: Ember.Array , Ember.MutableEnumerable
Defined in: packages/ember-runtime/lib/mixins/mutable_array.js:23
Module: ember

This mixin defines the API for modifying array-like objects. These methods can be applied only to a collection that keeps its items in an ordered set.

Note that an Array can change even if it does not implement this mixin. For example, one might implement a SparseArray that cannot be directly modified, but if its underlying enumerable changes, it will change also.

Show:

@each

Module: ember

Inherited from Ember.Array packages/ember-runtime/lib/mixins/array.js:409

Returns a special object that can be used to observe individual properties on the array. Just get an equivalent property on this object and it will return an enumerable that maps automatically to the named key on the member objects.

If you merely want to watch for any items being added or removed to the array, use the [] property instead of @each.

Boolean

Module: ember

Inherited from Ember.Array packages/ember-runtime/lib/mixins/array.js:299

Becomes true whenever the array currently has observers watching changes on the array.

[]

Module: ember

Inherited from Ember.Enumerable packages/ember-runtime/lib/mixins/enumerable.js:818

returns
this

This property will trigger anytime the enumerable's content changes. You can observe this property to be notified of changes to the enumerables content.

For plain enumerables, this property is read only. Ember.Array overrides this method.

[]

Module: ember

Inherited from Ember.Enumerable packages/ember-runtime/lib/mixins/enumerable.js:818

returns
this

This property will trigger anytime the enumerable's content changes. You can observe this property to be notified of changes to the enumerables content.

For plain enumerables, this property is read only. Ember.Array overrides this method.

firstObject Object

Module: ember

Inherited from Ember.Enumerable packages/ember-runtime/lib/mixins/enumerable.js:109

returns
Object
the object or undefined

Helper method returns the first object from a collection. This is usually used by bindings and other parts of the framework to extract a single object if the enumerable contains only one item.

If you override this method, you should implement it so that it will always return the same value each time it is called. If your enumerable contains only one object, this method should always return that object. If your enumerable is empty, this method should return undefined.

1
2
3
4
5

var arr = ["a", "b", "c"];
arr.get('firstObject');  // "a"

var arr = [];
arr.get('firstObject');  // undefined

hasEnumerableObservers

Module: ember

Inherited from Ember.Enumerable packages/ember-runtime/lib/mixins/enumerable.js:879

Becomes true whenever the array currently has observers watching changes on the array.

lastObject Object

Module: ember

Inherited from Ember.Enumerable packages/ember-runtime/lib/mixins/enumerable.js:140

returns
Object
the last object or undefined

Helper method returns the last object from a collection. If your enumerable contains only one object, this method should always return that object. If your enumerable is empty, this method should return undefined.

1
2
3
4
5

var arr = ["a", "b", "c"];
arr.get('lastObject');  // "c"

var arr = [];
arr.get('lastObject');  // undefined

length

Module: ember

Inherited from Ember.Array packages/ember-runtime/lib/mixins/array.js:51

Your array must support the length property. Your replace methods should set this property whenever it changes.