diff -r 000000000000 -r 40c8f766c9b8 src/cm/media/js/lib/yui/yui_3.0.0b1/api/WidgetPosition.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/cm/media/js/lib/yui/yui_3.0.0b1/api/WidgetPosition.html Mon Nov 23 15:14:29 2009 +0100 @@ -0,0 +1,1014 @@ + + + + + API: widget-position WidgetPosition (YUI Library) + + + + + + + + + + +
+
+

Yahoo! UI Library

+

widget-position  3.0.0b1

+ Yahoo! UI Library + > widget-position + > WidgetPosition + +
+
+ Search: +
+   +
+
+
+
+ +
+
+
+
+
+ Filters + + + +
+
+ +

+ + + + + Class WidgetPosition + + + +

+ + + + + +
+ Widget extension, which can be used to add positioning support to the base Widget class, +through the Base.build method. +
+ + +
+
+

Properties

+
+
+

WidgetPosition.ATTRS + - static Object +

+
+
+ Static property used to define the default attribute +configuration introduced by WidgetPosition. +
+
+ + + + +
+
+
+

WidgetPosition.POSITIONED_CLASS_NAME + - static String +

+
+
+ Default class used to mark the boundingBox of a positioned widget. +
+
+ + +
+ Default Value: "yui-widget-positioned" +
+ + +
+
+
+
+ +
+ +
+
+

Methods

+
+
+

+ _afterXYChange

+
+ + protected + + + void + _afterXYChange + ( + + + e + + + ) + + +
+ Default attribute change listener for the xy attribute, responsible +for updating the UI, in response to attribute changes. +
+ +
+ +
+
Parameters:
+
+ e + <EventFacade> + + The event facade for the attribute change +
+
+ +
+
Returns: + + void +
+
+
+ + + + +
+ +
+
+
+
+

+ _bindUIPosition

+
+ + protected + + + void + _bindUIPosition + ( + ) + + +
+ 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. +

+
+ +
+ + +
+
Returns: + + void +
+
+
+ + + + +
+ +
+
+
+
+

+ _getX

+
+ + + + + Number + _getX + ( + ) + + +
+ Default getter for the X attribute. The value is retrieved from +the XY attribute, which is the sole store for the XY state. +
+ +
+ + +
+
Returns: + + Number +
+
The X page co-ordinate value
+
+ + + + +
+ +
+
+
+
+

+ _getY

+
+ + + + + Number + _getY + ( + ) + + +
+ Default getter for the Y attribute. The value is retrieved from +the XY attribute, which is the sole store for the XY state. +
+ +
+ + +
+
Returns: + + Number +
+
The Y page co-ordinate value
+
+ + + + +
+ +
+
+
+
+

+ _renderUIPosition

+
+ + protected + + + void + _renderUIPosition + ( + ) + + +
+ 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. +

+
+ +
+ + +
+
Returns: + + void +
+
+
+ + + + +
+ +
+
+
+
+

+ _setX

+
+ + + + + void + _setX + ( + + + val + + + ) + + +
+ 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. +
+ +
+ +
+
Parameters:
+
+ val + <Number> + + The X page co-ordinate value +
+
+ +
+
Returns: + + void +
+
+
+ + + + +
+ +
+
+
+
+

+ _setY

+
+ + + + + void + _setY + ( + + + val + + + ) + + +
+ 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. +
+ +
+ +
+
Parameters:
+
+ val + <Number> + + The Y page co-ordinate value +
+
+ +
+
Returns: + + void +
+
+
+ + + + +
+ +
+
+
+
+

+ _syncUIPosition

+
+ + protected + + + void + _syncUIPosition + ( + ) + + +
+ 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. +

+
+ +
+ + +
+
Returns: + + void +
+
+
+ + + + +
+ +
+
+
+
+

+ _uiSetXY

+
+ + protected + + + void + _uiSetXY + ( + + + val + + + ) + + +
+ Updates the UI to reflect the XY page co-ordinates passed in. +
+ +
+ +
+
Parameters:
+
+ val + <String> + + The XY page co-ordinates value to be reflected in the UI +
+
+ +
+
Returns: + + void +
+
+
+ + + + +
+ +
+
+
+
+

+ _validateXY

+
+ + + + + boolean + _validateXY + ( + + + val + + + ) + + +
+ Default validator for the XY attribute +
+ +
+ +
+
Parameters:
+
+ val + <Array> + + The XY page co-ordinate value which is being set. +
+
+ +
+
Returns: + + boolean +
+
true if valid, false if not.
+
+ + + + +
+ +
+
+
+
+

+ move

+
+ + + + + void + move + ( + + + x + + + , + y + + + , + x, + + + ) + + +
+ Moves the Widget to the specified page xy co-ordinate position. +
+ +
+ +
+
Parameters:
+
+ x + <Number> + + The new x position +
+
+ y + <Number> + + The new y position +

Or

 +
+
+ x, + <Array> + + y values passed as an array ([x, y]), to support +simple pass through of Node.getXY results +
+
+ +
+
Returns: + + void +
+
+
+ + + + +
+ +
+
+
+
+

+ syncXY

+
+ + + + + void + syncXY + ( + ) + + +
+ Synchronizes the Panel's "xy", "x", and "y" properties with the +Widget's position in the DOM. +
+ +
+ + +
+
Returns: + + void +
+
+
+ + + + +
+ +
+
+
+
+
+ +
+ +
+
+

Events

+
+
+

+ xChange

+
+ + + + + xChange + + ( + + + event + + + ) + + + +
+ Fires when the value for the configuration attribute 'x' is changed. You can listen for the event using the on method if you wish to be notified before the attribute's value has changed, or using the after method if you wish to be notified after the attribute's value has changed. +
+ +
+ + +
+
Parameters:
+
+ event + <Event.Facade> + + An Event Facade object with the following attribute specific properties added:
prevVal
The value of the attribute, prior to it being set
newVal
The value the attribute is to be set to
attrName
The name of the attribute being set
subAttrName
If setting a property within the attribute's value, the name of the sub-attribute property being set
 +
+ +
+ + +
+ +
+
+
+
+

+ xyChange

+
+ + + + + xyChange + + ( + + + event + + + ) + + + +
+ Fires when the value for the configuration attribute 'xy' is changed. You can listen for the event using the on method if you wish to be notified before the attribute's value has changed, or using the after method if you wish to be notified after the attribute's value has changed. +
+ +
+ + +
+
Parameters:
+
+ event + <Event.Facade> + + An Event Facade object with the following attribute specific properties added:
prevVal
The value of the attribute, prior to it being set
newVal
The value the attribute is to be set to
attrName
The name of the attribute being set
subAttrName
If setting a property within the attribute's value, the name of the sub-attribute property being set
 +
+ +
+ + +
+ +
+
+
+
+

+ yChange

+
+ + + + + yChange + + ( + + + event + + + ) + + + +
+ Fires when the value for the configuration attribute 'y' is changed. You can listen for the event using the on method if you wish to be notified before the attribute's value has changed, or using the after method if you wish to be notified after the attribute's value has changed. +
+ +
+ + +
+
Parameters:
+
+ event + <Event.Facade> + + An Event Facade object with the following attribute specific properties added:
prevVal
The value of the attribute, prior to it being set
newVal
The value the attribute is to be set to
attrName
The name of the attribute being set
subAttrName
If setting a property within the attribute's value, the name of the sub-attribute property being set
 +
+ +
+ + +
+ +
+
+
+
+
+ + +
+ +
+
+

Configuration Attributes

+
+
+

x + - number +

+
+
+ 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. +
+
+ + +
+ Default Value: 0 +
+ +
+
+
+

xy + - Array +

+
+
+ Page XY co-ordinate pair for the widget. +
+
+ + +
+ Default Value: [0,0] +
+ +
+
+
+

y + - number +

+
+
+ 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. +
+
+ + +
+ Default Value: 0 +
+ +
+
+ +
+
+ +
+ +
+
+
+
+ + + +
+

Classes

+ +
+ +
+

Files

+ +
+ + + + + +
+

Events

+ +
+ +
+

Configuration Attributes

+ +
+ +
+
+
+
+
+ Copyright © 2009 Yahoo! Inc. All rights reserved. +
+
+ + +