106 lines
2.8 KiB
JavaScript
106 lines
2.8 KiB
JavaScript
goog.provide('ol.Observable');
|
|
|
|
goog.require('goog.events');
|
|
goog.require('goog.events.EventTarget');
|
|
goog.require('goog.events.EventType');
|
|
|
|
|
|
|
|
/**
|
|
* An event target providing convenient methods for listener registration
|
|
* and unregistration. A generic `change` event is always available through
|
|
* {@link ol.Observable#dispatchChangeEvent}.
|
|
* @constructor
|
|
* @extends {goog.events.EventTarget}
|
|
* @suppress {checkStructDictInheritance}
|
|
* @struct
|
|
* @todo stability experimental
|
|
* @todo api
|
|
*/
|
|
ol.Observable = function() {
|
|
|
|
goog.base(this);
|
|
|
|
/**
|
|
* @private
|
|
* @type {number}
|
|
*/
|
|
this.revision_ = 0;
|
|
|
|
};
|
|
goog.inherits(ol.Observable, goog.events.EventTarget);
|
|
|
|
|
|
/**
|
|
* Dispatches a `change` event. Register a listener for this event to get
|
|
* notified of changes.
|
|
* @fires change
|
|
* @todo stability experimental
|
|
* @todo api
|
|
*/
|
|
ol.Observable.prototype.dispatchChangeEvent = function() {
|
|
++this.revision_;
|
|
this.dispatchEvent(goog.events.EventType.CHANGE);
|
|
};
|
|
|
|
|
|
/**
|
|
* @return {number} Revision.
|
|
* @todo stability experimental
|
|
*/
|
|
ol.Observable.prototype.getRevision = function() {
|
|
return this.revision_;
|
|
};
|
|
|
|
|
|
/**
|
|
* Listen for a certain type of event.
|
|
* @param {string|Array.<string>} type The event type or array of event types.
|
|
* @param {function(?): ?} listener The listener function.
|
|
* @param {Object=} opt_this The object to use as `this` in `listener`.
|
|
* @return {goog.events.Key} Unique key for the listener.
|
|
* @todo stability experimental
|
|
* @todo api
|
|
*/
|
|
ol.Observable.prototype.on = function(type, listener, opt_this) {
|
|
return goog.events.listen(this, type, listener, false, opt_this);
|
|
};
|
|
|
|
|
|
/**
|
|
* Listen once for a certain type of event.
|
|
* @param {string|Array.<string>} type The event type or array of event types.
|
|
* @param {function(?): ?} listener The listener function.
|
|
* @param {Object=} opt_this The object to use as `this` in `listener`.
|
|
* @return {goog.events.Key} Unique key for the listener.
|
|
* @todo stability experimental
|
|
* @todo api
|
|
*/
|
|
ol.Observable.prototype.once = function(type, listener, opt_this) {
|
|
return goog.events.listenOnce(this, type, listener, false, opt_this);
|
|
};
|
|
|
|
|
|
/**
|
|
* Unlisten for a certain type of event.
|
|
* @param {string|Array.<string>} type The event type or array of event types.
|
|
* @param {function(?): ?} listener The listener function.
|
|
* @param {Object=} opt_this The object to use as `this` in `listener`.
|
|
* @todo stability experimental
|
|
* @todo api
|
|
*/
|
|
ol.Observable.prototype.un = function(type, listener, opt_this) {
|
|
goog.events.unlisten(this, type, listener, false, opt_this);
|
|
};
|
|
|
|
|
|
/**
|
|
* Removes an event listener using the key returned by `on()` or `once()`.
|
|
* @param {goog.events.Key} key Key.
|
|
* @todo stability experimental
|
|
* @todo api
|
|
*/
|
|
ol.Observable.prototype.unByKey = function(key) {
|
|
goog.events.unlistenByKey(key);
|
|
};
|