Table of Contents generated with DocToc

• ObservableArray
  • Constructor
  • Properties
  • Methods

ObservableArray

ObservableArray is an observable wrapper over JavaScript arrays. It allows Twist to know when the contents of the array changes, so that any bindings can be invalidated and reevaluated.

Note that you can't use the normal array indexing with an ObservableArray, because this is restricted to primitive arrays in JavaScript. This means:

• Use observableArray.at(i) where you would use array[i].
• Use observableArray.setAt(i, x) where you would use array[i] = x.
• Use observableArray.forEach(item => ...) where you would use for(var item in array) { ... }.

NOTE: In a <repeat>, however, you can iterate over an ObservableArray in precisely the same way as a normal array. This is because the <repeat> implementation knows about ObservableArray, and can iterate over it correctly.

Constructor

The constructor can optionally be supplied an array:

import { ObservableArray } from '@twist/core';

var array1 = new ObservableArray;
console.log(array1.length); // 0

var array2 = new ObservableArray([ 1, 2 ]);
console.log(array2.length); // 2

Properties

Methods

Methods specific to ObservableArray:

NOTE: If you want a plain array, concatToArray() is more efficient than concat.toArray(), since it avoids the extra copy operation of toArray().

Methods inherited from Array: