blossom
Version:
Modern, Cross-Platform Application Framework
41 lines (33 loc) • 1.71 kB
JavaScript
// ==========================================================================
// Project: SproutCore Costello - Property Observing Library
// Copyright: ©2006-2011 Strobe Inc. and contributors.
// Portions ©2008-2010 Apple Inc. All rights reserved.
// License: Licensed under MIT license (see license.js)
// ==========================================================================
var SC = global.SC; // Required to allow foundation to be re-namespaced as BT
// when loaded by the buildtools.
/**
The SC.ObservableProtocol defines optional methods you can implement on your
objects. They will be used if defined but are not required for observing to
work.
*/
SC.ObservableProtocol = {
/**
Generic property observer called whenever a property on the receiver
changes.
If you need to observe a large number of properties on your object, it
is sometimes more efficient to implement this observer only and then to
handle requests yourself. Although this observer will be triggered
more often than an observer registered on a specific property, it also
does not need to be registered which can make it faster to setup your
object instance.
You will often implement this observer using a switch statement on the
key parameter, taking appropriate action.
@param target {Object} the target of the change. usually this
@param key {String} the name of the property that changed
@param value {Object} the new value of the property.
@param revision {Number} a revision you can use to quickly detect changes.
@returns {void}
*/
propertyObserver: function(target, key, value, revision) {}
};