commit | 8c9596121f624b6b21cec9a7d45621bbdcd89535 | [log] [tgz] |
---|---|---|
author | Kevin Moore <kevmoo@google.com> | Tue Apr 04 12:56:41 2017 -0700 |
committer | Kevin Moore <kevmoo@google.com> | Tue Apr 04 12:56:41 2017 -0700 |
tree | 6b4069c3b61e6a1b07362214095db946f2f387c9 | |
parent | 2ab668c197e347453244385fa9846d167b8fc29f [diff] |
prepare for release
Support for detecting and being notified when an object is mutated.
An observable is a way to be notified of a continuous stream of events over time.
Some suggested uses for this library:
You may want to look at the former TC39 proposal Observe.observe, which was deprecated.
There are two general ways to detect changes:
Observable.changes
and be notified when an object changesDiffer.diff
to determine changes between two objectsOperations on Lists:
import 'package:observable/observable.dart'; void main() { var changes; ObservableList<String> list = new ObservableList<String>.from(['a', 'b', 'c']); StreamSubscription sub = list.listChanges.listen((c) => changes = c); ListChangeRecord _delta( int index, { List removed: const [], int addedCount: 0, }) { return new ListChangeRecord( list, index, removed: removed, addedCount: addedCount, ); } list.insertAll(1, ['y', 'z']); // changes == [_delta(1, addedCount: 2)] }
Diffing two maps:
import 'package:observable/observable.dart'; void main() { final map1 = { 'key-a': 'value-a', 'key-b': 'value-b-old', }; final map2 = { 'key-a': 'value-a', 'key-b': 'value-b-new', }; var diffResult = diff(map1, map2); // [ new MapChangeRecord('key-b', 'value-b-old', 'value-b-new')] }
Diffing two sets:
import 'package:observable/observable.dart'; void main() { diff( new Set<String>.from(['a', 'b']), new Set<String>.from(['a']), ); // [ new SetChangeRecord.remove('b') ] }