diff -r 000000000000 -r 40c8f766c9b8 src/cm/media/js/lib/yui/yui_3.0.0b1/build/widget/widget-position.js --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/cm/media/js/lib/yui/yui_3.0.0b1/build/widget/widget-position.js Mon Nov 23 15:14:29 2009 +0100 @@ -0,0 +1,270 @@ +/* +Copyright (c) 2009, Yahoo! Inc. All rights reserved. +Code licensed under the BSD License: +http://developer.yahoo.net/yui/license.txt +version: 3.0.0b1 +build: 1163 +*/ +YUI.add('widget-position', function(Y) { + +/** + * Provides basic XY positioning support for Widgets, though an extension + * + * @module widget-position + */ + var Lang = Y.Lang, + Widget = Y.Widget, + + XY_COORD = "xy", + + POSITIONED = "positioned", + BOUNDING_BOX = "boundingBox", + + RENDERUI = "renderUI", + BINDUI = "bindUI", + SYNCUI = "syncUI", + + UI = Widget.UI_SRC, + + XYChange = "xyChange"; + + /** + * Widget extension, which can be used to add positioning support to the base Widget class, + * through the Base.build method. + * + * @class WidgetPosition + * @param {Object} config User configuration object + */ + function Position(config) { + this._posNode = this.get(BOUNDING_BOX); + + // WIDGET METHOD OVERLAP + Y.after(this._renderUIPosition, this, RENDERUI); + Y.after(this._syncUIPosition, this, SYNCUI); + Y.after(this._bindUIPosition, this, BINDUI); + } + + /** + * Static property used to define the default attribute + * configuration introduced by WidgetPosition. + * + * @property WidgetPosition.ATTRS + * @static + * @type Object + */ + Position.ATTRS = { + + /** + * @attribute x + * @type number + * @default 0 + * + * @description Page X co-ordinate for the widget. This attribute acts as a facade for the + * xy attribute. Changes in position can be monitored by listening for xyChange events. + */ + x: { + setter: function(val) { + this._setX(val); + }, + getter: function() { + return this._getX(); + } + }, + + /** + * @attribute y + * @type number + * @default 0 + * + * @description Page Y co-ordinate for the widget. This attribute acts as a facade for the + * xy attribute. Changes in position can be monitored by listening for xyChange events. + */ + y: { + setter: function(val) { + this._setY(val); + }, + getter: function() { + return this._getY(); + } + }, + + /** + * @attribute xy + * @type Array + * @default [0,0] + * + * @description Page XY co-ordinate pair for the widget. + */ + xy: { + value:[0,0], + validator: function(val) { + return this._validateXY(val); + } + } + }; + + /** + * Default class used to mark the boundingBox of a positioned widget. + * + * @property WidgetPosition.POSITIONED_CLASS_NAME + * @type String + * @default "yui-widget-positioned" + * @static + */ + Position.POSITIONED_CLASS_NAME = Widget.getClassName(POSITIONED); + + Position.prototype = { + + /** + * Creates/Initializes the DOM to support xy page positioning. + *

+ * This method in invoked after renderUI is invoked for the Widget class + * using YUI's aop infrastructure. + *

+ * @method _renderUIPosition + * @protected + */ + _renderUIPosition : function() { + this._posNode.addClass(Position.POSITIONED_CLASS_NAME); + }, + + /** + * Synchronizes the UI to match the Widgets xy page position state. + *

+ * This method in invoked after syncUI is invoked for the Widget class + * using YUI's aop infrastructure. + *

+ * @method _syncUIPosition + * @protected + */ + _syncUIPosition : function() { + this._uiSetXY(this.get(XY_COORD)); + }, + + /** + * Binds event listeners responsible for updating the UI state in response to + * Widget position related state changes. + *

+ * This method in invoked after bindUI is invoked for the Widget class + * using YUI's aop infrastructure. + *

+ * @method _bindUIPosition + * @protected + */ + _bindUIPosition :function() { + this.after(XYChange, this._afterXYChange); + }, + + /** + * Moves the Widget to the specified page xy co-ordinate position. + * + * @method move + * + * @param {Number} x The new x position + * @param {Number} y The new y position + *

Or

+ * @param {Array} x, y values passed as an array ([x, y]), to support + * simple pass through of Node.getXY results + */ + move: function () { + var args = arguments, + coord = (Lang.isArray(args[0])) ? args[0] : [args[0], args[1]]; + this.set(XY_COORD, coord); + }, + + /** + * Synchronizes the Panel's "xy", "x", and "y" properties with the + * Widget's position in the DOM. + * + * @method syncXY + */ + syncXY : function () { + this.set(XY_COORD, this._posNode.getXY(), {src: UI}); + }, + + /** + * Default validator for the XY attribute + * + * @method _validateXY + * @param {Array} val The XY page co-ordinate value which is being set. + * @return {boolean} true if valid, false if not. + */ + _validateXY : function(val) { + return (Lang.isArray(val) && Lang.isNumber(val[0]) && Lang.isNumber(val[1])); + }, + + /** + * Default setter for the X attribute. The setter passes the X value through + * to the XY attribute, which is the sole store for the XY state. + * + * @method _setX + * @param {Number} val The X page co-ordinate value + */ + _setX : function(val) { + this.set(XY_COORD, [val, this.get(XY_COORD)[0]]); + }, + + /** + * Default setter for the Y attribute. The setter passes the Y value through + * to the XY attribute, which is the sole store for the XY state. + * + * @method _setY + * @param {Number} val The Y page co-ordinate value + */ + _setY : function(val) { + this.set(XY_COORD, [this.get(XY_COORD)[1], val]); + }, + + /** + * Default getter for the X attribute. The value is retrieved from + * the XY attribute, which is the sole store for the XY state. + * + * @method _getX + * @return {Number} The X page co-ordinate value + */ + _getX : function() { + return this.get(XY_COORD)[0]; + }, + + /** + * Default getter for the Y attribute. The value is retrieved from + * the XY attribute, which is the sole store for the XY state. + * + * @method _getY + * @return {Number} The Y page co-ordinate value + */ + _getY : function() { + return this.get(XY_COORD)[1]; + }, + + /** + * Default attribute change listener for the xy attribute, responsible + * for updating the UI, in response to attribute changes. + * + * @method _afterXYChange + * @protected + * @param {EventFacade} e The event facade for the attribute change + */ + _afterXYChange : function(e) { + if (e.src != UI) { + this._uiSetXY(e.newVal); + } + }, + + /** + * Updates the UI to reflect the XY page co-ordinates passed in. + * + * @method _uiSetXY + * @protected + * @param {String} val The XY page co-ordinates value to be reflected in the UI + */ + _uiSetXY : function(val) { + this._posNode.setXY(val); + } + }; + + Y.WidgetPosition = Position; + + + +}, '3.0.0b1' ,{requires:['widget']});