OverlayMask

Extends: OverlayBase

Defined in: alloy-ui/src/aui-overlay-deprecated/js/aui-overlay-mask-deprecated.js:35

Module: aui-overlay-mask
Parent Module: aui-overlay

A base class for OverlayMask, providing: <ul> <li>Widget Lifecycle (initializer, renderUI, bindUI, syncUI, destructor)</li> <li>Cross browser mask functionality to cover an element or the entire page</li> <li>Customizable mask (i.e., background, opacity)</li> </ul>

Quick Example:

<pre><code>var instance = new A.OverlayMask().render();</code></pre>

Check the list of <a href="OverlayMask.html#configattributes">Configuration Attributes</a> available for OverlayMask.

Constructor

`OverlayMask`

(

config

)

Defined in alloy-ui/src/aui-overlay-deprecated/js/aui-overlay-mask-deprecated.js:35

Parameters:

config Object

Object literal specifying widget configuration properties.

Index

Methods

`_addShimResizeHandlers`

() private

Inherited from WidgetStack: yui3/src/widget-stack/js/Widget-Stack.js:329

Sets up event listeners to resize the shim when the size of the Widget changes. NOTE: This method is only used for IE6 currently, since IE6 doesn't support a way to resize the shim purely through CSS, when the Widget does not have an explicit width/height set.

`_addStdModContent`

(

node
children
where

)

private

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:546

Helper method to add content to a StdMod section node. The content is added either before, after or replaces the existing node content based on the value of the <code>where</code> argument.

Parameters:

node Node

The section Node to be updated.
children Node | NodeList | String

The new content Node, NodeList or String to be added to section Node provided.
where String

Optional. Either WidgetStdMod.AFTER, WidgetStdMod.BEFORE or WidgetStdMod.REPLACE. If not provided, the content will replace existing content in the Node.

`_afterAlignChange`

(

)

protected

Inherited from WidgetPositionAlign: yui3/src/widget-position-align/js/Widget-PositionAlign.js:654

Handles alignChange events by updating the UI in response to align Attribute changes.

Parameters:

e EventFacade

`_afterAlignOnChange`

(

)

protected

Inherited from WidgetPositionAlign: yui3/src/widget-position-align/js/Widget-PositionAlign.js:669

Handles alignOnChange events by updating the alignment-syncing event handlers.

Parameters:

e EventFacade

`_afterBodyChange`

(

)

protected

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:345

Default attribute change listener for the bodyContent attribute, responsible for updating the UI, in response to attribute changes.

Parameters:

e EventFacade

The event facade for the attribute change

`_afterConstrainChange`

(

)

protected

Inherited from WidgetPositionConstrain: yui3/src/widget-position-constrain/js/Widget-PositionConstrain.js:277

After change listener for the "constrain" attribute, responsible for updating the UI, in response to attribute changes.

Parameters:

e EventFacade

The event facade

`_afterFillHeightChange`

(

)

protected

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:373

Default attribute change listener for the fillHeight attribute, responsible for updating the UI, in response to attribute changes.

Parameters:

e EventFacade

The event facade for the attribute change

`_afterFooterChange`

(

)

protected

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:359

Default attribute change listener for the footerContent attribute, responsible for updating the UI, in response to attribute changes.

Parameters:

e EventFacade

The event facade for the attribute change

`_afterHeaderChange`

(

)

protected

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:331

Default attribute change listener for the headerContent attribute, responsible for updating the UI, in response to attribute changes.

Parameters:

e EventFacade

The event facade for the attribute change

`_afterShimChange`

(

)

protected

Inherited from WidgetStack: yui3/src/widget-stack/js/Widget-Stack.js:239

Default attribute change listener for the shim attribute, responsible for updating the UI, in response to attribute changes.

Parameters:

e EventFacade

The event facade for the attribute change

`_afterTargetChange`

(

event

)

protected

Defined in alloy-ui/src/aui-overlay-deprecated/js/aui-overlay-mask-deprecated.js:344

Fires after the value of the <a href="Paginator.html#config_target">target</a> attribute change.

Parameters:

event EventFacade

`_afterVisibleChange`

(

event

)

protected

Defined in alloy-ui/src/aui-overlay-deprecated/js/aui-overlay-mask-deprecated.js:358

Fires after the value of the <a href="Paginator.html#config_visible">visible</a> attribute change.

Parameters:

event EventFacade

`_afterXYChange`

(

)

protected

Inherited from WidgetPosition: yui3/src/widget-position/js/Widget-Position.js:245

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

`_afterZIndexChange`

(

)

protected

Inherited from WidgetStack: yui3/src/widget-stack/js/Widget-Stack.js:251

Default attribute change listener for the zIndex attribute, responsible for updating the UI, in response to attribute changes.

Parameters:

e EventFacade

The event facade for the attribute change

`_applyStdModParsedConfig`

() private

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:638

This method is injected before the _applyParsedConfig step in the application of HTML_PARSER, and sets up the state to identify whether or not we should remove the current DOM content or not, based on whether or not the current content attribute value was extracted from the DOM, or provided by the user configuration

`_attachPosAlignUIHandles`

() protected

Inherited from WidgetPositionAlign: yui3/src/widget-position-align/js/Widget-PositionAlign.js:570

Attaches the alignment-syncing event handlers.

`_bindUIPosAlign`

() protected

Inherited from WidgetPositionAlign: yui3/src/widget-position-align/js/Widget-PositionAlign.js:251

Bind event listeners responsible for updating the UI state in response to the widget's position-align related state changes.

This method is invoked after bindUI has been invoked for the Widget class using the AOP infrastructure.

`_bindUIPosConstrained`

() protected

Inherited from WidgetPositionConstrain: yui3/src/widget-position-constrain/js/Widget-PositionConstrain.js:261

Binds event listeners responsible for updating the UI state in response to Widget constrained positioning related state changes. This method is invoked after bindUI is invoked for the Widget class using YUI's aop infrastructure.

`_bindUIPosition`

() protected

Inherited from WidgetPosition: yui3/src/widget-position/js/Widget-Position.js:146

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.

`_bindUIStack`

() protected

Inherited from WidgetStack: yui3/src/widget-stack/js/Widget-Stack.js:157

Binds event listeners responsible for updating the UI state in response to Widget stack related state changes. This method is invoked after bindUI is invoked for the Widget class using YUI's aop infrastructure.

`_bindUIStdMod`

() protected

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:311

Binds event listeners responsible for updating the UI state in response to Widget standard module related state changes. This method is invoked after bindUI is invoked for the Widget class using YUI's aop infrastructure.

`_constrain`

(

val
axis
nodeRegion
constrainingRegion

)

Number protected

Inherited from WidgetPositionConstrain: yui3/src/widget-position-constrain/js/Widget-PositionConstrain.js:166

The method which performs the actual constrain calculations for a given axis ("x" or "y") based on the regions provided.

Parameters:

val Number

The value to constrain
axis String

The axis to use for constrainment
nodeRegion Region

The region of the node to constrain
constrainingRegion Region

The region of the node (or viewport) to constrain to

Returns:

Number:

The constrained value

`_constrainOnXYChange`

(

)

protected

Inherited from WidgetPositionConstrain: yui3/src/widget-position-constrain/js/Widget-PositionConstrain.js:307

The on change listener for the "xy" attribute. Modifies the event facade's newVal property with the constrained XY value.

Parameters:

e EventFacade

The event facade for the attribute change

`_destroyShim`

() private

Inherited from WidgetStack: yui3/src/widget-stack/js/Widget-Stack.js:389

Removes the shim from the DOM, and detaches any related event listeners.

`_detachPosAlignUIHandles`

() protected

Inherited from WidgetPositionAlign: yui3/src/widget-position-align/js/Widget-PositionAlign.js:598

Detaches the alignment-syncing event handlers.

`_detachStackHandles`

(

String

)

private

Inherited from WidgetStack: yui3/src/widget-stack/js/Widget-Stack.js:352

Detaches any handles stored for the provided key

Parameters:

String Object

handleKey The key defining the group of handles which should be detached

`_doAlign`

(

xy

)

private

Inherited from WidgetPositionAlign: yui3/src/widget-position-align/js/Widget-PositionAlign.js:614

Helper method, used to align the given point on the widget, with the XY page coordinates provided.

Parameters:

xy Array

XY page coordinates to align to.

`_enableConstraints`

(

enable

)

private

Inherited from WidgetPositionConstrain: yui3/src/widget-position-constrain/js/Widget-PositionConstrain.js:289

Updates the UI if enabling constraints, and sets up the xyChange event listeners to constrain whenever the widget is moved. Disabling constraints removes the listeners.

Parameters:

enable Boolean

Enable or disable constraints

`_eraseStdMod`

(

section

)

protected

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:490

Removes the DOM node for the given section.

Parameters:

section String

The section to remove. Either WidgetStdMod.HEADER, WidgetStdMod.BODY or WidgetStdMod.FOOTER.

`_fillHeight`

() private

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:423

Updates the rendered UI, to resize the current section specified by the fillHeight attribute, so that the standard module fills out the Widget height. If a height has not been set on Widget, the section is not resized (height is set to "auto").

`_findStdModSection`

(

section

)

Node private

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:599

Helper method to to find the rendered node for the given section, if it exists.

Parameters:

section String

The section for which the render Node is to be found. Either WidgetStdMod.HEADER, WidgetStdMod.BODY or WidgetStdMod.FOOTER.

Returns:

Node:

The rendered node for the given section, or null if not found.

`_getAlignedXY`

(

[node]
points

)

Array protected

Inherited from WidgetPositionAlign: yui3/src/widget-position-align/js/Widget-PositionAlign.js:425

Returns Widget alignment coordinates realative to the given Node.

Parameters:

[node] Node | String | Null optional

The node to align to, or null to indicate the viewport.
points Array

The alignment points.

Returns:

Array:

the coordinates.

`_getAlignToXY`

(

'Node'
[point]
'Node'
'Node'

)

Array private

Inherited from WidgetPositionAlign: yui3/src/widget-position-align/js/Widget-PositionAlign.js:340

Returns coordinates realative to the passed Node alignment.

Parameters:

'Node' Node

The node to align to.
[point] Array optional

The node alignment points.
'Node' Number

x coordinate.
'Node' Number

y coordinate.

Returns:

Array:

the coordinates.

`_getPreciseHeight`

(

node

)

Number private

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:576

Helper method to obtain the precise height of the node provided, including padding and border. The height could be a sub-pixel value for certain browsers, such as Firefox 3.

Parameters:

node Node

The node for which the precise height is required.

Returns:

Number:

The height of the Node including borders and padding, possibly a float.

`_getRegion`

(

[node]

)

Object private

Inherited from WidgetPositionConstrain but overwritten in yui3/src/widget-position-align/js/Widget-PositionAlign.js:628

Returns the region of the passed-in Node, or the viewport region if calling with passing in a Node.

Parameters:

[node] Node optional

The node to get the region of.

Returns:

Object:

The node's region.

`_getShimTemplate`

() Node private

Inherited from WidgetStack: yui3/src/widget-stack/js/Widget-Stack.js:423

Creates a cloned shim node, using the SHIM_TEMPLATE html template, for use on a new instance.

Returns:

Node:

node A new shim Node instance.

`_getStdModContent`

(

section

)

Node private

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:657

Retrieves the child nodes (content) of a standard module section

Parameters:

section String

The standard module section whose child nodes are to be retrieved. Either WidgetStdMod.HEADER, WidgetStdMod.BODY or WidgetStdMod.FOOTER.

Returns:

Node:

The child node collection of the standard module section.

`_getStdModTemplate`

(

section

)

Node protected

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:533

Gets a new Node reference for the given standard module section, by cloning the stored template node.

Parameters:

section String

The section to create a new node for. Either WidgetStdMod.HEADER, WidgetStdMod.BODY or WidgetStdMod.FOOTER.

Returns:

Node:

The new Node instance for the section

`_getX`

() Number protected

Inherited from WidgetPosition: yui3/src/widget-position/js/Widget-Position.js:221

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 protected

Inherited from WidgetPosition: yui3/src/widget-position/js/Widget-Position.js:233

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

`_insertStdModSection`

(

contentBox
section
sectionNode

)

private

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:505

Helper method to insert the Node for the given section into the correct location in the contentBox.

Parameters:

contentBox Node

A reference to the Widgets content box.
section String

The section to create/render. Either WidgetStdMod.HEADER, WidgetStdMod.BODY or WidgetStdMod.FOOTER.
sectionNode Node

The Node for the section.

`_parseStdModHTML`

(

section

)

String private

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:612

Utility method, used by WidgetStdMods HTML_PARSER implementation to extract data for each section from markup.

Parameters:

section String

Returns:

String:

Inner HTML string with the contents of the section

`_parseZIndex`

(

srcNode

)

Mixed protected

Inherited from WidgetStack: yui3/src/widget-stack/js/Widget-Stack.js:185

Parses a zIndex attribute value from this widget's srcNode.

Parameters:

srcNode Node

The node to parse a <code>zIndex</code> value from.

Returns:

Mixed:

The parsed <code>zIndex</code> value.

`_preventOverlap`

(

val
axis
nodeRegion
constrainingRegion

)

Number protected

Inherited from WidgetPositionConstrain: yui3/src/widget-position-constrain/js/Widget-PositionConstrain.js:210

The method which performs the preventOverlap calculations for a given axis ("x" or "y") based on the value and regions provided.

Parameters:

val Number

The value being constrain
axis String

The axis to being constrained
nodeRegion Region

The region of the node being constrained
constrainingRegion Region

The region of the node (or viewport) we need to constrain to

Returns:

Number:

The constrained value

`_renderShim`

() private

Inherited from WidgetStack: yui3/src/widget-stack/js/Widget-Stack.js:370

Creates the shim element and adds it to the DOM

`_renderShimDeferred`

() private

Inherited from WidgetStack: yui3/src/widget-stack/js/Widget-Stack.js:303

Sets up change handlers for the visible attribute, to defer shim creation/rendering until the Widget is made visible.

`_renderStdMod`

(

section

)

Node protected

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:467

Creates the DOM node for the given section, and inserts it into the correct location in the contentBox.

Parameters:

section String

The section to create/render. Either WidgetStdMod.HEADER, WidgetStdMod.BODY or WidgetStdMod.FOOTER.

Returns:

Node:

A reference to the added section node

`_renderUIPosition`

() protected

Inherited from WidgetPosition: yui3/src/widget-position/js/Widget-Position.js:116

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.

`_renderUIStack`

() protected

Inherited from WidgetStack: yui3/src/widget-stack/js/Widget-Stack.js:172

Creates/Initializes the DOM to support stackability. This method in invoked after renderUI is invoked for the Widget class using YUI's aop infrastructure.

`_renderUIStdMod`

() protected

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:285

Creates/Initializes the DOM for standard module support. This method is invoked after renderUI is invoked for the Widget class using YUI's aop infrastructure.

`_setAlignCenter`

(

val

)

Boolean | Node protected

Inherited from WidgetPositionAlign: yui3/src/widget-position-align/js/Widget-PositionAlign.js:513

Default setter for center Attribute changes. Sets up the appropriate value, and passes it through the to the align attribute.

Parameters:

val Boolean | Node

The Attribute value being set.

Returns:

Boolean | Node:

the value passed in.

`_setConstrain`

(

val

)

protected

Inherited from WidgetPositionConstrain: yui3/src/widget-position-constrain/js/Widget-PositionConstrain.js:155

The setter implementation for the "constrain" attribute.

Parameters:

val Node | boolean

The attribute value

`_setOpacity`

(

)

Number protected

Defined in alloy-ui/src/aui-overlay-deprecated/js/aui-overlay-mask-deprecated.js:307

Setter for <a href="Paginator.html#config_opacity">opacity</a>.

Parameters:

v Number

Returns:

Number:

`_setX`

(

val

)

protected

Inherited from WidgetPosition: yui3/src/widget-position/js/Widget-Position.js:197

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`

(

val

)

protected

Inherited from WidgetPosition: yui3/src/widget-position/js/Widget-Position.js:209

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

`_setZIndex`

(

zIndex

)

Number protected

Inherited from WidgetStack: yui3/src/widget-stack/js/Widget-Stack.js:220

Default setter for zIndex attribute changes. Normalizes zIndex values to numbers, converting non-numerical values to 0.

Parameters:

zIndex String | Number

Returns:

Number:

Normalized zIndex

`_syncUIPosAlign`

() protected

Inherited from WidgetPositionAlign: yui3/src/widget-position-align/js/Widget-PositionAlign.js:267

Synchronizes the current align Attribute value to the DOM.

This method is invoked after syncUI has been invoked for the Widget class using the AOP infrastructure.

`_syncUIPosition`

() protected

Inherited from WidgetPosition: yui3/src/widget-position/js/Widget-Position.js:129

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.

`_syncUIStack`

() protected

Inherited from WidgetStack: yui3/src/widget-stack/js/Widget-Stack.js:145

Synchronizes the UI to match the Widgets stack state. This method in invoked after syncUI is invoked for the Widget class using YUI's aop infrastructure.

`_syncUIStdMod`

() protected

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:258

Synchronizes the UI to match the Widgets standard module state. This method is invoked after syncUI is invoked for the Widget class using YUI's aop infrastructure.

`_uiSetAlign`

(

[node]
points

)

protected

Inherited from WidgetPositionAlign: yui3/src/widget-position-align/js/Widget-PositionAlign.js:533

Updates the UI to reflect the align value passed in.

Note: See the align Attribute documentation, for the Object structure expected.

Parameters:

[node] Node | String | Null optional

The node to align to, or null to indicate the viewport.
points Array

The alignment points.

`_uiSetFillHeight`

(

fillSection

)

protected

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:399

Updates the rendered UI, to resize the provided section so that the standard module fills out the specified widget height. Note: This method does not check whether or not a height is set on the Widget.

Parameters:

fillSection String

A valid section specifier - one of WidgetStdMod.HEADER, WidgetStdMod.BODY or WidgetStdMod.FOOTER

`_uiSetShim`

(

enable

)

protected

Inherited from WidgetStack: yui3/src/widget-stack/js/Widget-Stack.js:274

Updates the UI to enable/disable the shim. If the widget is not currently visible, creation of the shim is deferred until it is made visible, for performance reasons.

Parameters:

enable Boolean

If true, creates/renders the shim, if false, removes it.

`_uiSetStdMod`

(

section
content
where

)

protected

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:440

Updates the rendered UI, adding the provided content (either an HTML string, or node reference), to the specified section. The content is either added before, after or replaces existing content in the section, based on the value of the <code>where</code> argument.

Parameters:

section String

The section to be updated. Either WidgetStdMod.HEADER, WidgetStdMod.BODY or WidgetStdMod.FOOTER.
content String | Node

The new content (either as an HTML string, or Node reference) to add to the section
where String

Optional. Either WidgetStdMod.AFTER, WidgetStdMod.BEFORE or WidgetStdMod.REPLACE. If not provided, the content will replace existing content in the section.

`_uiSetVisible`

(

val

)

protected

Defined in alloy-ui/src/aui-overlay-deprecated/js/aui-overlay-mask-deprecated.js:323

Invoke the <code>OverlayMask.superclass._uiSetVisible</code>. Used to reset the <code>opacity</code> to work around IE bugs when set opacity of hidden elements.

Parameters:

val Boolean

`_uiSetVisiblePosAlign`

(

visible

)

protected

Inherited from WidgetPositionAlign: yui3/src/widget-position-align/js/Widget-PositionAlign.js:553

Attaches or detaches alignment-syncing event handlers based on the widget's visible Attribute state.

Parameters:

visible Boolean

The current value of the widget's <code>visible</code> Attribute.

`_uiSetXY`

(

event

)

protected

Inherited from WidgetPosition but overwritten in alloy-ui/src/aui-overlay-deprecated/js/aui-overlay-mask-deprecated.js:372

UI Setter for the <a href="Paginator.html#config_xy">XY</a> attribute.

Parameters:

event EventFacade

`_uiSetZIndex`

(

zIndex

)

protected

Inherited from WidgetStack: yui3/src/widget-stack/js/Widget-Stack.js:263

Updates the UI to reflect the zIndex value passed in.

Parameters:

zIndex Number

The zindex to be reflected in the UI

`_validateFillHeight`

(

val

)

protected

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:385

Default validator for the fillHeight attribute. Verifies that the value set is a valid section specifier - one of WidgetStdMod.HEADER, WidgetStdMod.BODY or WidgetStdMod.FOOTER, or a falsey value if fillHeight is to be disabled.

Parameters:

val String

The section which should be setup to fill height, or false/null to disable fillHeight

Returns:

true if valid, false if not

`_validateXY`

(

val

)

Boolean protected

Inherited from WidgetPosition: yui3/src/widget-position/js/Widget-Position.js:185

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.

`align`

(

[node]
[points]

)

chainable

Inherited from WidgetPositionAlign: yui3/src/widget-position-align/js/Widget-PositionAlign.js:288

Aligns this widget to the provided Node (or viewport) using the provided points. This method can be invoked with no arguments which will cause the widget's current align Attribute value to be synced to the DOM.

Parameters:

[node] Node | String | Null optional

A reference (or selector String) for the <code>Node</code> which with the widget is to be aligned. If null is passed in, the widget will be aligned with the viewport.
[points] Array2 optional

A two item array specifying the points on the widget and <code>Node</code>/viewport which will to be aligned. The first entry is the point on the widget, and the second entry is the point on the <code>Node</code>/viewport. Valid point references are defined as static constants on the <code>WidgetPositionAlign</code> extension.

Example:

Aligning to the top-left corner of the <body>:

myWidget.align('body',
                                                    [Y.WidgetPositionAlign.TL, Y.WidgetPositionAlign.TR]);

`bindUI`

() protected

Defined in alloy-ui/src/aui-overlay-deprecated/js/aui-overlay-mask-deprecated.js:188

Bind the events on the OverlayMask UI. Lifecycle.

`centered`

(

[node]

)

chainable

Inherited from WidgetPositionAlign: yui3/src/widget-position-align/js/Widget-PositionAlign.js:324

Centers the widget in the viewport, or if a Node is passed in, it will be centered to that Node.

Parameters:

[node] Node | String optional

A <code>Node</code> reference or selector String defining the <code>Node</code> which the widget should be centered. If a <code>Node</code> is not passed in, then the widget will be centered to the viewport.

`constrain`

(

xy
node

)

Inherited from WidgetPositionConstrain: yui3/src/widget-position-constrain/js/Widget-PositionConstrain.js:130

Constrains the widget's bounding box to a node (or the viewport). If xy or node are not passed in, the current position and the value of "constrain" will be used respectively.

The widget's position will be changed to the constrained position.

Parameters:

xy Array

Optional. The xy values to constrain
node Node | boolean

Optional. The node to constrain to, or true for the viewport

`fillHeight`

(

node

)

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:713

Sets the height on the provided header, body or footer element to fill out the height of the Widget. It determines the height of the widgets bounding box, based on it's configured height value, and sets the height of the provided section to fill out any space remaining after the other standard module section heights have been accounted for.

NOTE: This method is not designed to work if an explicit height has not been set on the Widget, since for an "auto" height Widget, the heights of the header/body/footer will drive the height of the Widget.

Parameters:

node Node

The node which should be resized to fill out the height of the Widget bounding box. Should be a standard module section node which belongs to the widget.

`getConstrainedXY`

(

xy
node

)

Array

Inherited from WidgetPositionConstrain: yui3/src/widget-position-constrain/js/Widget-PositionConstrain.js:108

Calculates the constrained positions for the XY positions provided, using the provided node argument is passed in. If no node value is passed in, the value of the "constrain" attribute is used.

Parameters:

xy Array

The xy values to constrain
node Node | boolean

Optional. The node to constrain to, or true for the viewport

Returns:

Array:

The constrained xy values

`getStdModNode`

(

section
forceCreate

)

Node

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:687

Returns the node reference for the specified section.

Note: The DOM is not queried for the node reference. The reference stored by the widget instance is returned if it was set. Passing a truthy for forceCreate will create the section node if it does not already exist.

Parameters:

section String

The section whose node reference is required. Either <code>WidgetStdMod.HEADER</code>, <code>WidgetStdMod.BODY</code>, or <code>WidgetStdMod.FOOTER</code>.
forceCreate Boolean

Whether the section node should be created if it does not already exist.

Returns:

Node:

The node reference for the <code>section</code>, or null if not set.

`getTargetSize`

() Object

Defined in alloy-ui/src/aui-overlay-deprecated/js/aui-overlay-mask-deprecated.js:226

Get the size of the <a href="OverlayMask.html#config_target">target</a>. Used to dimension the mask node.

Returns:

Object:

Object containing the { height: height, width: width }.

`move`

(

x
[y]

)

Inherited from WidgetPosition: yui3/src/widget-position/js/Widget-Position.js:160

Moves the Widget to the specified page xy co-ordinate position.

Parameters:

x Number | Number[]

The new x position or [x, y] values passed as an array to support simple pass through of Node.getXY results
[y] Number optional

The new y position

`refreshMask`

()

Defined in alloy-ui/src/aui-overlay-deprecated/js/aui-overlay-mask-deprecated.js:267

Repaint the OverlayMask UI, respecting the <a href="OverlayMask.html#config_target">target</a> size and the <a href="OverlayMask.html#config_alignPoints">alignPoints</a>.

`setStdModContent`

(

section
content
where

)

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:669

Updates the body section of the standard module with the content provided (either an HTML string, or node reference). This method can be used instead of the corresponding section content attribute if you'd like to retain the current content of the section, and insert content before or after it, by specifying the <code>where</code> argument.

Parameters:

section String

The standard module section whose content is to be updated. Either WidgetStdMod.HEADER, WidgetStdMod.BODY or WidgetStdMod.FOOTER.
content String | Node

The content to be added, either an HTML string or a Node reference.
where String

Optional. Either WidgetStdMod.AFTER, WidgetStdMod.BEFORE or WidgetStdMod.REPLACE. If not provided, the content will replace existing content in the section.

`sizeShim`

()

Inherited from WidgetStack: yui3/src/widget-stack/js/Widget-Stack.js:406

For IE6, synchronizes the size and position of iframe shim to that of Widget bounding box which it is protecting. For all other browsers, this method does not do anything.

`syncUI`

() protected

Defined in alloy-ui/src/aui-overlay-deprecated/js/aui-overlay-mask-deprecated.js:208

Sync the OverlayMask UI. Lifecycle.

`syncXY`

()

Inherited from WidgetPosition: yui3/src/widget-position/js/Widget-Position.js:175

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

Properties

`_posAlignUIHandles`

Array protected

Inherited from WidgetPositionAlign: yui3/src/widget-position-align/js/Widget-PositionAlign.js:225

Holds the alignment-syncing event handles.

Default: null

`OverlayMask.ATTRS`

Object static

Defined in alloy-ui/src/aui-overlay-deprecated/js/aui-overlay-mask-deprecated.js:66

Static property used to define the default attribute configuration for the OverlayMask.

`OverlayMask.NAME`

String static

Defined in alloy-ui/src/aui-overlay-deprecated/js/aui-overlay-mask-deprecated.js:57

Static property provides a string to identify the class.

Attributes

`align`

Object

Inherited from WidgetPositionAlign: yui3/src/widget-position-align/js/Widget-PositionAlign.js:40

The alignment configuration for this widget.

The align attribute is used to align a reference point on the widget, with the reference point on another Node, or the viewport. The object which align expects has the following properties:

__node__: The Node to which the widget is to be aligned. If set to null, or not provided, the widget is aligned to the viewport.
__points__: A two element Array, defining the two points on the widget and Node/viewport which are to be aligned. The first element is the point on the widget, and the second element is the point on the Node/viewport. Supported alignment points are defined as static properties on WidgetPositionAlign.

Default: null

Example:

Aligns the top-right corner of the widget with the top-left corner of the viewport:

myWidget.set('align', {
                                                    points: [Y.WidgetPositionAlign.TR, Y.WidgetPositionAlign.TL]
                                                });

`alignOn`

Array

Inherited from WidgetPositionAlign: yui3/src/widget-position-align/js/Widget-PositionAlign.js:89

An Array of Objects corresponding to the Nodes and events that will cause the alignment of this widget to be synced to the DOM.

The alignOn Attribute is expected to be an Array of Objects with the following properties:

__eventName__: The String event name to listen for.
__node__: The optional Node that will fire the event, it can be a Node reference or a selector String. This will default to the widget's boundingBox.

Default: []

Example:

Sync this widget's alignment on window resize:

myWidget.set('alignOn', [
                                                    {
                                                        node     : Y.one('win'),
                                                        eventName: 'resize'
                                                    }
                                                ]);

`alignPoints`

Array

Defined in alloy-ui/src/aui-overlay-deprecated/js/aui-overlay-mask-deprecated.js:75

Points to align the <a href="Overlay.html">Overlay</a> used as mask.

Default: [ 'tl', 'tl' ]

`background`

String

Defined in alloy-ui/src/aui-overlay-deprecated/js/aui-overlay-mask-deprecated.js:88

Background color of the mask.

Default: null

`bodyContent`

HTML

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:164

The content to be added to the body section. This will replace any existing content in the body. If you want to append, or insert new content, use the <a href="#method_setStdModContent">setStdModContent</a> method.

Default: undefined

`centered`

Boolean | Node

Inherited from WidgetPositionAlign: yui3/src/widget-position-align/js/Widget-PositionAlign.js:71

A convenience Attribute, which can be used as a shortcut for the align Attribute.

If set to true, the widget is centered in the viewport. If set to a Node reference or valid selector String, the widget will be centered within the Node. If set to false, no center positioning is applied.

Default: false

`constrain`

Boolean | Node

Inherited from WidgetPositionConstrain: yui3/src/widget-position-constrain/js/Widget-PositionConstrain.js:51

The node to constrain the widget's bounding box to, when setting xy. Can also be set to true, to constrain to the viewport.

Default: null

`fillHeight`

String

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:175

The section (WidgetStdMod.HEADER, WidgetStdMod.BODY or WidgetStdMod.FOOTER) which should be resized to fill the height of the standard module, when a height is set on the Widget. If a height is not set on the widget, then all sections are sized based on their content.

Default: WidgetStdMod.BODY

`footerContent`

HTML

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:153

The content to be added to the footer section. This will replace any existing content in the footer. If you want to append, or insert new content, use the <a href="#method_setStdModContent">setStdModContent</a> method.

Default: undefined

`headerContent`

HTML

Inherited from WidgetStdMod: yui3/src/widget-stdmod/js/Widget-StdMod.js:142

The content to be added to the header section. This will replace any existing content in the header. If you want to append, or insert new content, use the <a href="#method_setStdModContent">setStdModContent</a> method.

Default: undefined

`opacity`

Number

Defined in alloy-ui/src/aui-overlay-deprecated/js/aui-overlay-mask-deprecated.js:135

CSS opacity of the mask.

Default: .5

`preventOverlap`

Boolean

Inherited from WidgetPositionConstrain: yui3/src/widget-position-constrain/js/Widget-PositionConstrain.js:63

If set to true, and WidgetPositionAlign is also added to the Widget, constrained positioning will attempt to prevent the widget's bounding box from overlapping the element to which it has been aligned, by flipping the orientation of the alignment for corner based alignments

`shim`

Boolean

Inherited from WidgetStack but overwritten in alloy-ui/src/aui-overlay-deprecated/js/aui-overlay-mask-deprecated.js:150

Use shim option.

Default: True on IE.

`target`

Node | String

Defined in alloy-ui/src/aui-overlay-deprecated/js/aui-overlay-mask-deprecated.js:108

Node where the mask will be positioned and re-dimensioned. The default is the document, which means that if not specified the mask takes the full screen.

Default: document

`visible`

Boolean

Defined in alloy-ui/src/aui-overlay-deprecated/js/aui-overlay-mask-deprecated.js:161

If true the Overlay is visible by default after the render phase. Inherited from <a href="Overlay.html">Overlay</a>.

Default: false

`x`

Number

Inherited from WidgetPosition: yui3/src/widget-position/js/Widget-Position.js:44

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: 0

`xy`

Array

Inherited from WidgetPosition: yui3/src/widget-position/js/Widget-Position.js:80

Page XY co-ordinate pair for the widget.

Default: [0,0]

`y`

Number

Inherited from WidgetPosition: yui3/src/widget-position/js/Widget-Position.js:62

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: 0

`zIndex`

Number

Inherited from WidgetStack but overwritten in alloy-ui/src/aui-overlay-deprecated/js/aui-overlay-mask-deprecated.js:173

zIndex of the OverlayMask.

Default: 1000

APIs

OverlayMask Class

Constructor

Parameters:

Index

Methods

Properties

Attributes

Methods

_addShimResizeHandlers

_addStdModContent

Parameters:

_afterAlignChange

Parameters:

_afterAlignOnChange

Parameters:

_afterBodyChange

Parameters:

_afterConstrainChange

Parameters:

_afterFillHeightChange

Parameters:

_afterFooterChange

Parameters:

_afterHeaderChange

Parameters:

_afterShimChange

Parameters:

_afterTargetChange

Parameters:

_afterVisibleChange

Parameters:

_afterXYChange

Parameters:

_afterZIndexChange

Parameters:

_applyStdModParsedConfig

_attachPosAlignUIHandles

_bindUIPosAlign

_bindUIPosConstrained

_bindUIPosition

_bindUIStack

_bindUIStdMod

_constrain

Parameters:

Returns:

_constrainOnXYChange

Parameters:

_destroyShim

_detachPosAlignUIHandles

_detachStackHandles

Parameters:

_doAlign

Parameters:

_enableConstraints

Parameters:

_eraseStdMod

Parameters:

_fillHeight

_findStdModSection

Parameters:

Returns:

_getAlignedXY

Parameters:

Returns:

_getAlignToXY

Parameters:

Returns:

_getPreciseHeight

Parameters:

Returns:

_getRegion

Parameters:

Returns:

_getShimTemplate

Returns:

_getStdModContent

Parameters:

Returns:

`OverlayMask`

`_addShimResizeHandlers`

`_addStdModContent`

`_afterAlignChange`

`_afterAlignOnChange`

`_afterBodyChange`

`_afterConstrainChange`

`_afterFillHeightChange`

`_afterFooterChange`

`_afterHeaderChange`

`_afterShimChange`

`_afterTargetChange`

`_afterVisibleChange`

`_afterXYChange`

`_afterZIndexChange`

`_applyStdModParsedConfig`

`_attachPosAlignUIHandles`

`_bindUIPosAlign`

`_bindUIPosConstrained`

`_bindUIPosition`

`_bindUIStack`

`_bindUIStdMod`

`_constrain`

`_constrainOnXYChange`

`_destroyShim`

`_detachPosAlignUIHandles`

`_detachStackHandles`

`_doAlign`

`_enableConstraints`

`_eraseStdMod`

`_fillHeight`

`_findStdModSection`

`_getAlignedXY`

`_getAlignToXY`

`_getPreciseHeight`

`_getRegion`

`_getShimTemplate`

`_getStdModContent`

`_getStdModTemplate`

`_getX`

`_getY`

`_insertStdModSection`

`_parseStdModHTML`

`_parseZIndex`

`_preventOverlap`

`_renderShim`

`_renderShimDeferred`

`_renderStdMod`

`_renderUIPosition`

`_renderUIStack`

`_renderUIStdMod`

`_setAlignCenter`

`_setConstrain`

`_setOpacity`

`_setX`

`_setY`

`_setZIndex`

`_syncUIPosAlign`

`_syncUIPosition`

`_syncUIStack`

`_syncUIStdMod`

`_uiSetAlign`

`_uiSetFillHeight`

`_uiSetShim`

`_uiSetStdMod`

`_uiSetVisible`

`_uiSetVisiblePosAlign`

`_uiSetXY`

`_uiSetZIndex`

`_validateFillHeight`

`_validateXY`

`align`