src/cm/media/js/lib/yui/yui_3.10.3/build/attribute-observable/attribute-observable.js
changeset 525 89ef5ed3c48b
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/cm/media/js/lib/yui/yui_3.10.3/build/attribute-observable/attribute-observable.js	Tue Jul 16 14:29:46 2013 +0200
@@ -0,0 +1,232 @@
+/*
+YUI 3.10.3 (build 2fb5187)
+Copyright 2013 Yahoo! Inc. All rights reserved.
+Licensed under the BSD License.
+http://yuilibrary.com/license/
+*/
+
+YUI.add('attribute-observable', function (Y, NAME) {
+
+    /*For log lines*/
+    /*jshint maxlen:200*/
+
+
+    /**
+     * The attribute module provides an augmentable Attribute implementation, which
+     * adds configurable attributes and attribute change events to the class being
+     * augmented. It also provides a State class, which is used internally by Attribute,
+     * but can also be used independently to provide a name/property/value data structure to
+     * store state.
+     *
+     * @module attribute
+     */
+
+    /**
+     * The `attribute-observable` submodule provides augmentable attribute change event support
+     * for AttributeCore based implementations.
+     *
+     * @module attribute
+     * @submodule attribute-observable
+     */
+    var EventTarget = Y.EventTarget,
+
+        CHANGE = "Change",
+        BROADCAST = "broadcast";
+
+    /**
+     * Provides an augmentable implementation of attribute change events for
+     * AttributeCore.
+     *
+     * @class AttributeObservable
+     * @extensionfor AttributeCore
+     * @uses EventTarget
+     */
+    function AttributeObservable() {
+        // Perf tweak - avoid creating event literals if not required.
+        this._ATTR_E_FACADE = {};
+
+        EventTarget.call(this, {emitFacade:true});
+    }
+
+    AttributeObservable._ATTR_CFG = [BROADCAST];
+
+    AttributeObservable.prototype = {
+
+        /**
+         * Sets the value of an attribute.
+         *
+         * @method set
+         * @chainable
+         *
+         * @param {String} name The name of the attribute. If the
+         * current value of the attribute is an Object, dot notation can be used
+         * to set the value of a property within the object (e.g. <code>set("x.y.z", 5)</code>).
+         *
+         * @param {Any} value The value to set the attribute to.
+         *
+         * @param {Object} opts (Optional) Optional event data to be mixed into
+         * the event facade passed to subscribers of the attribute's change event. This
+         * can be used as a flexible way to identify the source of a call to set, allowing
+         * the developer to distinguish between set called internally by the host, vs.
+         * set called externally by the application developer.
+         *
+         * @return {Object} A reference to the host object.
+         */
+        set : function(name, val, opts) {
+            return this._setAttr(name, val, opts);
+        },
+
+        /**
+         * Allows setting of readOnly/writeOnce attributes. See <a href="#method_set">set</a> for argument details.
+         *
+         * @method _set
+         * @protected
+         * @chainable
+         *
+         * @param {String} name The name of the attribute.
+         * @param {Any} val The value to set the attribute to.
+         * @param {Object} opts (Optional) Optional event data to be mixed into
+         * the event facade passed to subscribers of the attribute's change event.
+         * @return {Object} A reference to the host object.
+         */
+        _set : function(name, val, opts) {
+            return this._setAttr(name, val, opts, true);
+        },
+
+        /**
+         * Sets multiple attribute values.
+         *
+         * @method setAttrs
+         * @param {Object} attrs  An object with attributes name/value pairs.
+         * @param {Object} opts  Properties to mix into the event payload. These are shared and mixed into each set
+         * @return {Object} A reference to the host object.
+         * @chainable
+         */
+        setAttrs : function(attrs, opts) {
+            return this._setAttrs(attrs, opts);
+        },
+
+        /**
+         * Implementation behind the public setAttrs method, to set multiple attribute values.
+         *
+         * @method _setAttrs
+         * @protected
+         * @param {Object} attrs  An object with attributes name/value pairs.
+         * @param {Object} opts  Properties to mix into the event payload. These are shared and mixed into each set
+         * @return {Object} A reference to the host object.
+         * @chainable
+         */
+        _setAttrs : function(attrs, opts) {
+            var attr;
+            for (attr in attrs) {
+                if ( attrs.hasOwnProperty(attr) ) {
+                    this.set(attr, attrs[attr], opts);
+                }
+            }
+            return this;
+        },
+
+        /**
+         * Utility method to help setup the event payload and fire the attribute change event.
+         *
+         * @method _fireAttrChange
+         * @private
+         * @param {String} attrName The name of the attribute
+         * @param {String} subAttrName The full path of the property being changed,
+         * if this is a sub-attribute value being change. Otherwise null.
+         * @param {Any} currVal The current value of the attribute
+         * @param {Any} newVal The new value of the attribute
+         * @param {Object} opts Any additional event data to mix into the attribute change event's event facade.
+         * @param {Object} [cfg] The attribute config stored in State, if already available.
+         */
+        _fireAttrChange : function(attrName, subAttrName, currVal, newVal, opts, cfg) {
+            var host = this,
+                eventName = this._getFullType(attrName + CHANGE),
+                state = host._state,
+                hasOpts = false,
+                facade,
+                broadcast,
+                e;
+
+            if (!cfg) {
+                cfg = state.data[attrName] || {};
+            }
+
+            if (!cfg.published) {
+
+                // PERF: Using lower level _publish() for
+                // critical path performance
+                e = host._publish(eventName);
+
+                e.emitFacade = true;
+                e.defaultTargetOnly = true;
+                e.defaultFn = host._defAttrChangeFn;
+
+                broadcast = cfg.broadcast;
+                if (broadcast !== undefined) {
+                    e.broadcast = broadcast;
+                }
+
+                cfg.published = true;
+            }
+
+            if (opts) {
+                facade = Y.merge(opts);
+                hasOpts = true;
+            } else {
+                facade = host._ATTR_E_FACADE;
+            }
+
+            // Not using the single object signature for fire({type:..., newVal:...}), since
+            // we don't want to override type. Changed to the fire(type, {newVal:...}) signature.
+
+            facade.attrName = attrName;
+            facade.subAttrName = subAttrName;
+            facade.prevVal = currVal;
+            facade.newVal = newVal;
+
+            if (hasOpts) {
+                host.fire(eventName, facade, opts);
+            } else {
+                host.fire(eventName, facade);
+            }
+        },
+
+        /**
+         * Default function for attribute change events.
+         *
+         * @private
+         * @method _defAttrChangeFn
+         * @param {EventFacade} e The event object for attribute change events.
+         */
+        _defAttrChangeFn : function(e) {
+
+            if (!this._setAttrVal(e.attrName, e.subAttrName, e.prevVal, e.newVal, e.details[1])) {
+                // Prevent "after" listeners from being invoked since nothing changed.
+                e.stopImmediatePropagation();
+
+            } else {
+                e.newVal = this.get(e.attrName);
+            }
+        }
+    };
+
+    // Basic prototype augment - no lazy constructor invocation.
+    Y.mix(AttributeObservable, EventTarget, false, null, 1);
+
+    Y.AttributeObservable = AttributeObservable;
+
+    /**
+    The `AttributeEvents` class extension was deprecated in YUI 3.8.0 and is now
+    an alias for the `AttributeObservable` class extension. Use that class
+    extnesion instead. This alias will be removed in a future version of YUI.
+
+    @class AttributeEvents
+    @uses EventTarget
+    @deprecated Use `AttributeObservable` instead.
+    @see AttributeObservable
+    **/
+    Y.AttributeEvents = AttributeObservable;
+
+
+}, '3.10.3', {"requires": ["event-custom"]});