Yahoo! UI Library

widget-position  3.3.0pr1

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

_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.


_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.


_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

_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

_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.


_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

_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

syncXY

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

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


Copyright © 2010 Yahoo! Inc. All rights reserved.