Class MutableArray
publicimport MutableArray from '@ember/array/mutable'; |
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. It builds upon the Array mixin and adds methods to modify the array. One concrete implementations of this class include ArrayProxy.
It is important to use the methods in this class to modify arrays so that changes are observable. This allows the binding system in Ember to function correctly.
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.
@each public
Inherited from EmberArray packages/ember-runtime/lib/mixins/array.js:1205
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 array that maps automatically to the named key on the member objects.
@each
should only be used in a non-terminal context. Example:
1 2 3 |
myMethod: computed('posts.@each.author', function(){ ... }); |
If you merely want to watch for the array being changed, like an object being
replaced, added or removed, use []
instead of @each
.
1 2 3 |
myMethod: computed('posts.[]', function(){ ... }); |
[] public
Inherited from EmberArray packages/ember-runtime/lib/mixins/array.js:250
- returns
- this
This is the handler for the special array content property. If you get this property, it will return this. If you set this property to a new array, it will replace the current content.
firstObject Object | undefined public
Inherited from EmberArray packages/ember-runtime/lib/mixins/array.js:269
- returns
- Object | undefined
- The first object in the array
The first object in the array, or undefined
if the array is empty.
hasArrayObservers public
Inherited from EmberArray packages/ember-runtime/lib/mixins/array.js:470
Becomes true whenever the array currently has observers watching changes on the array.
lastObject Object | undefined public
Inherited from EmberArray packages/ember-runtime/lib/mixins/array.js:280
- returns
- Object | undefined
- The last object in the array
The last object in the array, or undefined
if the array is empty.
length public
Inherited from EmberArray packages/ember-runtime/lib/mixins/array.js:188
Required. You must implement this method to apply this mixin.
Your array must support the length
property. Your replace methods should
set this property whenever it changes.