OLD | NEW |
1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file |
2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
4 | 4 |
5 part of observe; | 5 part of observe; |
6 | 6 |
7 /** | 7 /** |
8 * Use `@observable` to make a field automatically observable. | |
9 */ | |
10 const ObservableProperty observable = const ObservableProperty(); | |
11 | |
12 /** | |
13 * Interface representing an observable object. This is used by data in | 8 * Interface representing an observable object. This is used by data in |
14 * model-view architectures to notify interested parties of [changes]. | 9 * model-view architectures to notify interested parties of [changes]. |
15 * | 10 * |
16 * This object does not require any specific technique to implement | 11 * This object does not require any specific technique to implement |
17 * observability. If you mixin [ObservableMixin], [dirtyCheck] will know to | 12 * observability. If you mixin [ObservableMixin], [dirtyCheck] will know to |
18 * check for changes on the object. You may also implement change notification | 13 * check for changes on the object. You may also implement change notification |
19 * yourself, by calling [notifyChange]. | 14 * yourself, by calling [notifyChange]. |
20 * | 15 * |
21 * You can use [ObservableBase] or [ObservableMixin] to implement this. | 16 * You can use [ObservableBase] or [ObservableMixin] to implement this. |
22 */ | 17 */ |
(...skipping 187 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
210 _notifyPropertyChange(Observable obj, Symbol field, Object oldValue, | 205 _notifyPropertyChange(Observable obj, Symbol field, Object oldValue, |
211 Object newValue) { | 206 Object newValue) { |
212 | 207 |
213 // TODO(jmesserly): should this be == instead of identical, to prevent | 208 // TODO(jmesserly): should this be == instead of identical, to prevent |
214 // spurious loops? | 209 // spurious loops? |
215 if (obj.hasObservers && !identical(oldValue, newValue)) { | 210 if (obj.hasObservers && !identical(oldValue, newValue)) { |
216 obj.notifyChange(new PropertyChangeRecord(field)); | 211 obj.notifyChange(new PropertyChangeRecord(field)); |
217 } | 212 } |
218 return newValue; | 213 return newValue; |
219 } | 214 } |
220 | |
221 | |
222 /** | |
223 * An annotation that is used to make a property observable. | |
224 * Normally this is used via the [observable] constant, for example: | |
225 * | |
226 * class Monster { | |
227 * @observable int health; | |
228 * } | |
229 * | |
230 * If needed, you can subclass this to create another annotation that will also | |
231 * be treated as observable. | |
232 */ | |
233 class ObservableProperty { | |
234 const ObservableProperty(); | |
235 } | |
OLD | NEW |