commit | 3f513713b85c9ed450594d815b96e68b09f2899a | [log] [tgz] |
---|---|---|
author | Kevin Moore <kevmoo@users.noreply.github.com> | Thu Feb 23 06:19:12 2017 |
committer | Matan Lurey <matanlurey@users.noreply.github.com> | Thu Feb 23 06:19:12 2017 |
tree | 4bca1c7b4fd4a1860669d7f654923f98e23f9ded | |
parent | f24b489dac0c1bcd4a7dcbb24da8f03b426d89e6 [diff] |
Update tested SDK, added travis badge to README (#37)
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') ] }