Panel

`_addAttrs`

(

cfgs
values
lazy

)

private

Inherited from AttributeCore: yui3/src/attribute/js/AttributeCore.js:877

Implementation behind the public addAttrs method. This method is invoked directly by get if it encounters a scenario in which an attribute's valueFn attempts to obtain the value an attribute in the same group of attributes, which has not yet been added (on demand initialization).

Parameters:

cfgs Object

An object with attribute name/configuration pairs.
values Object

An object with attribute name/value pairs, defining the initial values to apply. Values defined in the cfgs argument will be over-written by values in this argument unless defined as read only.
lazy Boolean

Whether or not to delay the intialization of these attributes until the first call to get/set. Individual attributes can over-ride this behavior by defining a lazyAdd configuration property in their configuration. See <a href="#method_addAttr">addAttr</a>.

`_addLazyAttr`

(

name
[lazyCfg]

)

private

Inherited from AttributeCore: yui3/src/attribute/js/AttributeCore.js:360

Finishes initializing an attribute which has been lazily added.

Parameters:

name Object

The name of the attribute
[lazyCfg] Object optional

Optional config hash for the attribute. This is added for performance along the critical path, where the calling method has already obtained lazy config from state.

`_addOutOfOrder`

(

name
cfg

)

private

Inherited from AttributeCore: yui3/src/attribute/js/AttributeCore.js:550

Utility method used by get/set to add attributes encountered out of order when calling addAttrs(). For example, if: <pre><code>this.addAttrs({ foo: { setter: function() { // make sure this bar is available when foo is added this.get("bar"); } }, bar: { value: ... } });</code></pre>

Parameters:

name String

attribute name
cfg Object

attribute configuration

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

(

e

)

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`

(

e

)

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`

(

e

)

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

`_afterButtonsChange`

(

e

)

protected

Inherited from WidgetButtons: yui3/src/widget-buttons/js/widget-buttons.js:1188

Available since 3.4.0

Handles this widget's buttonsChange event which fires anytime the buttons attribute is modified.

Note: This method special-cases the buttons modifications caused by addButton() and removeButton(), both of which set the src property on the event facade to "add" and "remove" respectively.

Parameters:

e EventFacade

`_afterChildSelectedChange`

(

event

)

protected

Inherited from Widget: yui3/src/widget-child/js/Widget-Child.js:327

Default attribute change listener for the <code>selected</code> attribute, responsible for updating the UI, in response to attribute changes.

Parameters:

event EventFacade

The event facade for the attribute change.

`_afterConstrainChange`

(

e

)

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

`_afterContentChangeButtons`

(

e

)

protected

Inherited from WidgetButtons: yui3/src/widget-buttons/js/widget-buttons.js:1237

Available since 3.5.0

Handles this widget's headerContentChange, bodyContentChange, footerContentChange events by making sure the buttons remain rendered after changes to the content areas.

These events are very chatty, so extra caution is taken to avoid doing extra work or getting into an infinite loop.

Parameters:

e EventFacade

`_afterDefaultButtonChange`

(

e

)

protected

Inherited from WidgetButtons: yui3/src/widget-buttons/js/widget-buttons.js:1261

Available since 3.5.0

Handles this widget's defaultButtonChange event by adding the "yui3-button-primary" CSS class to the new defaultButton and removing it from the old default button.

Parameters:

e EventFacade

`_afterFillHeightChange`

(

e

)

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

`_afterFocusOnChange`

()

Inherited from WidgetModality: yui3/src/widget-modality/js/Widget-Modality.js:582

Default function called when focusOn Attribute is changed. Remove existing listeners and create new listeners.

`_afterFooterChange`

(

e

)

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`

(

e

)

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

`_afterHideOnChange`

() protected

Inherited from WidgetAutohide: yui3/src/widget-autohide/js/Widget-Autohide.js:218

Default function called when hideOn Attribute is changed. Remove existing listeners and create new listeners.

`_afterHostVisibleChangeAutohide`

() protected

Inherited from WidgetAutohide: yui3/src/widget-autohide/js/Widget-Autohide.js:206

Default function called when the visibility of the widget changes. Determines whether to attach or detach event listeners based on the visibility of the widget.

`_afterHostVisibleChangeModal`

(

e

)

Inherited from WidgetModality: yui3/src/widget-modality/js/Widget-Modality.js:490

Default function that is called when visibility is changed on the widget.

Parameters:

e EventFacade

The event facade of the change

`_afterHostZIndexChangeModal`

(

e

)

Inherited from WidgetModality: yui3/src/widget-modality/js/Widget-Modality.js:501

Default function that is called when z-index is changed on the widget.

Parameters:

e EventFacade

The event facade of the change

`_afterShimChange`

(

e

)

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

`_afterVisibleChangeButtons`

(

e

)

protected

Inherited from WidgetButtons: yui3/src/widget-buttons/js/widget-buttons.js:1275

Available since 3.5.0

Handles this widget's visibleChange event by focusing the defaultButton if there is one.

Parameters:

e EventFacade

`_afterXYChange`

(

e

)

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`

(

e

)

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

`_aggregateAttrs`

(

allAttrs

)

Object private

Inherited from BaseCore: yui3/src/base/js/BaseCore.js:618

A helper method, used by _initHierarchyData to aggregate attribute configuration across the instances class hierarchy. The method will protect the attribute configuration value to protect the statically defined default value in ATTRS if required (if the value is an object literal, array or the attribute configuration has cloneDefaultValue set to shallow or deep).

Parameters:

allAttrs Array

An array of ATTRS definitions across classes in the hierarchy (subclass first, Base last)

Returns:

Object:

The aggregate set of ATTRS definitions for the instance

`_applyParsedConfig`

() Object protected

Inherited from Widget: yui3/src/widget/js/WidgetHTMLParser.js:121

Returns:

Object:

The merged configuration literal

`_applyParser`

(

config

)

protected

Inherited from Widget: yui3/src/widget/js/WidgetHTMLParser.js:130

Utility method used to apply the <code>HTML_PARSER</code> configuration for the instance, to retrieve config data values.

Parameters:

config Object

User configuration object (will be populated with values from Node)

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

`_attachUIHandlesAutohide`

() protected

Inherited from WidgetAutohide: yui3/src/widget-autohide/js/Widget-Autohide.js:143

Iterates through all objects in the hideOn attribute and creates event listeners.

`_attachUIHandlesModal`

()

Inherited from WidgetModality: yui3/src/widget-modality/js/Widget-Modality.js:419

Attaches UI Listeners for "clickoutside" and "focusoutside" on the widget. When these events occur, and the widget is modal, focus is shifted back onto the widget.

`_attrCfgHash`

() private

Inherited from BaseCore: yui3/src/base/js/BaseCore.js:581

Utility method to define the attribute hash used to filter/whitelist property mixes for this class for iteration performance reasons.

`_baseDestroy`

() private

Inherited from BaseCore: yui3/src/base/js/BaseCore.js:364

Internal destroy implementation for BaseCore

`_baseInit`

() private

Inherited from BaseCore: yui3/src/base/js/BaseCore.js:336

Internal initialization implementation for BaseCore

`_bindAttrUI`

(

attrs

)

private

Inherited from Widget: yui3/src/widget/js/Widget.js:1185

Binds after listeners for the list of attributes provided

Parameters:

attrs Array

`_bindDOM`

() protected

Inherited from Widget: yui3/src/widget/js/Widget.js:917

Sets up DOM listeners, on elements rendered by the widget.

`_bindUI`

() protected

Inherited from Widget: yui3/src/widget/js/Widget.js:898

Sets up DOM and CustomEvent listeners for the widget.

`_bindUIAutohide`

() protected

Inherited from WidgetAutohide: yui3/src/widget-autohide/js/Widget-Autohide.js:95

Binds event listeners to the widget. This method in invoked after bindUI is invoked for the Widget class using YUI's aop infrastructure.

`_bindUIButtons`

() protected

Inherited from WidgetButtons: yui3/src/widget-buttons/js/widget-buttons.js:496

Available since 3.4.0

Binds UI event listeners. This method is inserted via AOP, and will execute after bindUI().

`_bindUIChild`

() protected

Inherited from Widget: yui3/src/widget-child/js/Widget-Child.js:356

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

`_bindUIModal`

() protected

Inherited from WidgetModality: yui3/src/widget-modality/js/Widget-Modality.js:224

Hooks up methods to be executed when the widget's visibility or z-index changes This method in invoked after bindUI is invoked for the Widget class using YUI's aop infrastructure.

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

`_blockIFrameFocus`

() protected

Inherited from WidgetModality: yui3/src/widget-modality/js/Widget-Modality.js:370

Blocks iframes on the page from getting focused by setting their tabIndex attribute to -1. The previous value of tabIndex is saved so it can be restored later.

`_blur`

()

Inherited from WidgetModality: yui3/src/widget-modality/js/Widget-Modality.js:282

Blurs the widget.

`_cloneDefaultValue`

(

cfg

)

private

Inherited from BaseCore: yui3/src/base/js/BaseCore.js:592

This method assumes that the value has already been checked to be an object. Since it's on a critical path, we don't want to re-do the check.

Parameters:

cfg Object

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

(

e

)

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

`_createButton`

(

button

)

Node protected

Inherited from WidgetButtons: yui3/src/widget-buttons/js/widget-buttons.js:516

Available since 3.5.0

Returns a button node based on the specified button node or configuration.

The button node will either be created via Y.Plugin.Button.createNode(), or when button is specified as a node already, it will by plug()ed with Y.Plugin.Button.

Parameters:

button Node | Object

Button node or configuration object.

Returns:

Node:

The button node.

`_createUIEvent`

(

type

)

private

Inherited from Widget: yui3/src/widget/js/WidgetUIEvents.js:73

Binds a delegated DOM event listener of the specified type to the Widget's outtermost DOM element to facilitate the firing of a Custom Event of the same type for the Widget instance.

Parameters:

type String

String representing the name of the event

`_defAttrChangeFn`

(

e
eventFastPath

)

private

Inherited from AttributeObservable: yui3/src/attribute/js/AttributeObservable.js:185

Default function for attribute change events.

Parameters:

e EventFacade

The event object for attribute change events.
eventFastPath Boolean

Whether or not we're using this as a fast path in the case of no listeners or not

`_defaultBB`

() protected

Inherited from Widget: yui3/src/widget/js/Widget.js:776

Returns the default value for the boundingBox attribute.

For the Widget class, this will most commonly be null (resulting in a new boundingBox node instance being created), unless a srcNode was provided and CONTENT_TEMPLATE is null, in which case it will be srcNode. This behavior was introduced in @VERSION@ to accomodate single-box widgets whose BB & CB both point to srcNode (e.g. Y.Button).

`_defaultCB`

() protected

Inherited from Widget: yui3/src/widget/js/Widget.js:795

Returns the default value for the contentBox attribute.

For the Widget class, this will be the srcNode if provided, otherwise null (resulting in a new contentBox node instance being created)

`_defDestroyFn`

(

e

)

protected

Inherited from BaseObservable: yui3/src/base/js/BaseObservable.js:202

Default destroy event handler

Parameters:

e EventFacade

Event object

`_defInitFn`

(

e

)

protected

Inherited from BaseObservable: yui3/src/base/js/BaseObservable.js:190

Default init event handler

Parameters:

e EventFacade

Event object, with a cfg property which refers to the configuration object passed to the constructor.

`_defRenderFn`

(

e
parentNode

)

protected

Inherited from Widget: yui3/src/widget/js/Widget.js:567

Default render handler

Parameters:

e EventFacade

The Event object
parentNode Node

The parent node to render to, if passed in to the <code>render</code> method

`_destroyBox`

() protected

Inherited from Widget: yui3/src/widget/js/Widget.js:472

Removes and destroys the widgets rendered boundingBox, contentBox, and detaches bound UI events.

`_destroyHierarchy`

() private

Inherited from BaseCore: yui3/src/base/js/BaseCore.js:782

Destroys the class hierarchy for this instance by invoking the destructor method on the prototype of each class in the hierarchy.

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

`_destroyUIEvents`

() private

Inherited from Widget: yui3/src/widget/js/WidgetUIEvents.js:20

Destructor logic for UI event infrastructure, invoked during Widget destruction.

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

`_detachUIHandlesAutohide`

() protected

Inherited from WidgetAutohide: yui3/src/widget-autohide/js/Widget-Autohide.js:192

Detaches all event listeners created by this extension

`_detachUIHandlesModal`

()

Inherited from WidgetModality: yui3/src/widget-modality/js/Widget-Modality.js:478

Detaches all UI Listeners that were set in _attachUIHandlesModal from the widget.

`_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").

`_filterAdHocAttrs`

(

allAttrs
userVals

)

Object private

Inherited from BaseCore: yui3/src/base/js/BaseCore.js:470

Parameters:

allAttrs Object

The set of all attribute configurations for this instance. Attributes will be removed from this set, if they belong to the filtered class, so that by the time all classes are processed, allCfgs will be empty.
userVals Object

The config object passed in by the user, from which adhoc attrs are to be filtered.

Returns:

Object:

The set of adhoc attributes passed in, in the form of an object with attribute name/configuration pairs.

`_filterUIEvent`

(

evt

)

Boolean private

Inherited from Widget: yui3/src/widget/js/WidgetUIEvents.js:117

This method is used to determine if we should fire the UI Event or not. The default implementation makes sure that for nested delegates (nested unrelated widgets), we don't fire the UI event listener more than once at each level.

For example, without the additional filter, if you have nested widgets, each widget will have a delegate listener. If you click on the inner widget, the inner delegate listener's filter will match once, but the outer will match twice (based on delegate's design) - once for the inner widget, and once for the outer.

Parameters:

evt DOMEventFacade

Returns:

Boolean:

true if it's OK to fire the custom UI event, false if not.

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

`_fireAttrChange`

(

attrName
subAttrName
currVal
newVal
opts
[cfg]

)

private

Inherited from AttributeObservable: yui3/src/attribute/js/AttributeObservable.js:120

Utility method to help setup the event payload and fire the attribute change event.

Parameters:

attrName String

The name of the attribute
subAttrName String

The full path of the property being changed, if this is a sub-attribute value being change. Otherwise null.
currVal Any

The current value of the attribute
newVal Any

The new value of the attribute
opts Object

Any additional event data to mix into the attribute change event's event facade.
[cfg] Object optional

The attribute config stored in State, if already available.

`_focus`

()

Inherited from WidgetModality: yui3/src/widget-modality/js/Widget-Modality.js:269

Provides mouse and tab focus to the widget's bounding box.

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

`_getAttr`

(

name

)

Any protected chainable

Inherited from AttributeCore: yui3/src/attribute/js/AttributeCore.js:587

Provides the common implementation for the public get method, allowing Attribute hosts to over-ride either method. See <a href="#method_get">get</a> for argument details.

Parameters:

name String

The name of the attribute.

Returns:

Any:

The value of the attribute.

`_getAttrCfg`

(

name

)

Object protected

Inherited from AttributeExtras: yui3/src/attribute/js/AttributeExtras.js:125

Returns an object with the configuration properties (and value) for the given attribute. If attrName is not provided, returns the configuration properties for all attributes.

Parameters:

name String

Optional. The attribute name. If not provided, the method will return the configuration for all attributes.

Returns:

Object:

The configuration properties for the given attribute, or all attributes.

`_getAttrCfgs`

() Object protected

Inherited from BaseCore: yui3/src/base/js/BaseCore.js:394

Returns an aggregated set of attribute configurations, by traversing the class hierarchy.

Returns:

Object:

The hash of attribute configurations, aggregated across classes in the hierarchy This value is cached the first time the method, or _getClasses, is invoked. Subsequent invocations return the cached value.

`_getAttrInitVal`

(

attr
cfg
initValues

)

Any private

Inherited from AttributeCore: yui3/src/attribute/js/AttributeCore.js:986

Returns the initial value of the given attribute from either the default configuration provided, or the over-ridden value if it exists in the set of initValues provided and the attribute is not read-only.

Parameters:

attr String

The name of the attribute
cfg Object

The attribute configuration object
initValues Object

The object with simple and complex attribute name/value pairs returned from _normAttrVals

Returns:

Any:

The initial value of the attribute.

`_getAttrs`

(

attrs

)

Object protected

Inherited from AttributeCore: yui3/src/attribute/js/AttributeCore.js:815

Implementation behind the public getAttrs method, to get multiple attribute values.

Parameters:

attrs String | Boolean

Optional. An array of attribute names. If omitted, all attribute values are returned. If set to true, all attributes modified from their initial values are returned.

Returns:

Object:

An object with attribute name/value pairs.

`_getButtonContainer`

(

section
create

)

Node protected

Inherited from WidgetButtons: yui3/src/widget-buttons/js/widget-buttons.js:581

Available since 3.5.0

Returns the buttons container for the specified section, passing a truthy value for create will create the node if it does not already exist.

Note: It is up to the caller to properly insert the returned container node into the content section.

Parameters:

section String

The WidgetStdMod section (header/body/footer).
create Boolean

Whether the buttons container should be created if it does not already exist.

Returns:

Node:

The buttons container node for the specified section.

`_getButtonDefault`

(

button

)

Boolean protected

Inherited from WidgetButtons: yui3/src/widget-buttons/js/widget-buttons.js:616

Available since 3.5.0

Returns whether or not the specified button is configured to be the default button.

When a button node is specified, the button's getData() method will be used to determine if the button is configured to be the default. When a button config object is specified, the isDefault prop will determine whether the button is the default.

Note: <button data-default="true"></button> is supported via the button.getData('default') API call.

Parameters:

button Node | Object

The button node or configuration object.

Returns:

Boolean:

Whether the button is configured to be the default button.

`_getButtonName`

(

button

)

String protected

Inherited from WidgetButtons: yui3/src/widget-buttons/js/widget-buttons.js:645

Available since 3.5.0

Returns the name of the specified button.

When a button node is specified, the button's getData('name') method is preferred, but will fallback to get('name'), and the result will determine the button's name. When a button config object is specified, the name prop will determine the button's name.

Note: <button data-name="foo"></button> is supported via the button.getData('name') API call.

Parameters:

button Node | Object

The button node or configuration object.

Returns:

String:

The name of the button.

`_getButtons`

(

buttons

)

Object protected

Inherited from WidgetButtons: yui3/src/widget-buttons/js/widget-buttons.js:674

Available since 3.5.0

Getter for the buttons attribute. A copy of the buttons object is returned so the stored state cannot be modified by the callers of get('buttons').

This will recreate a copy of the buttons object, and each section array (the button nodes are not copied/cloned.)

Parameters:

buttons Object

The widget's current buttons state.

Returns:

Object:

A copy of the widget's current buttons state.

`_getClasses`

() Function protected

Inherited from BaseCore: yui3/src/base/js/BaseCore.js:378

Returns the class hierarchy for this object, with BaseCore being the last class in the array.

Returns:

Function:

An array of classes (constructor functions), making up the class hierarchy for this object. This value is cached the first time the method, or _getAttrCfgs, is invoked. Subsequent invocations return the cached value.

`_getFullType`

(

type

)

String private

Inherited from EventTarget: yui3/src/event-custom/js/event-target.js:564

Returns the fully qualified type, given a short type string. That is, returns "foo:bar" when given "bar" if "foo" is the configured prefix. NOTE: This method, unlike _getType, does no checking of the value passed in, and is designed to be used with the low level _publish() method, for critical path implementations which need to fast-track publish for performance reasons.

Parameters:

type String

The short type to prefix

Returns:

String:

The prefixed type, if a prefix is set, otherwise the type passed in

`_getHtmlParser`

() Object private

Inherited from Widget: yui3/src/widget/js/WidgetHTMLParser.js:187

Gets the HTML_PARSER definition for this instance, by merging HTML_PARSER definitions across the class hierarchy.

Returns:

Object:

HTML_PARSER definition for this instance

`_getInstanceAttrCfgs`

(

allCfgs

)

Object private

Inherited from BaseCore: yui3/src/base/js/BaseCore.js:411

A helper method used to isolate the attrs config for this instance to pass to <code>addAttrs</code>, from the static cached ATTRS for the class.

Parameters:

allCfgs Object

The set of all attribute configurations for this instance. Attributes will be removed from this set, if they belong to the filtered class, so that by the time all classes are processed, allCfgs will be empty.

Returns:

Object:

The set of attributes to be added for this instance, suitable for passing through to <code>addAttrs</code>.

`_getMaskNode`

() Node

Inherited from WidgetModality: yui3/src/widget-modality/js/Widget-Modality.js:292

Returns the Y.Node instance of the maskNode

Returns:

Node:

The Y.Node instance of the mask, as returned from WidgetModal._GET_MASK

`_getNodeToParse`

() Node private

Inherited from Widget: yui3/src/widget/js/WidgetHTMLParser.js:172

Determines whether we have a node reference which we should try and parse.

The current implementation does not parse nodes generated from CONTENT_TEMPLATE, only explicitly set srcNode, or contentBox attributes.

Returns:

Node:

The node reference to apply HTML_PARSER to.

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

`_getSrcNode`

() Node protected

Inherited from Widget: yui3/src/widget/js/WidgetHTMLParser.js:74

Returns:

Node:

The Node to apply HTML_PARSER to

`_getStateVal`

(

name
[cfg]

)

Any private

Inherited from AttributeCore: yui3/src/attribute/js/AttributeCore.js:641

Gets the stored value for the attribute, from either the internal state object, or the state proxy if it exits

Parameters:

name String

The name of the attribute
[cfg] Object optional

Optional config hash for the attribute. This is added for performance along the critical path, where the calling method has already obtained the config from state.

Returns:

Any:

The stored value of the attribute

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

`_getType`

() private

Inherited from EventTarget: yui3/src/event-custom/js/event-target.js:36

If the instance has a prefix attribute and the event type is not prefixed, the instance prefix is applied to the supplied type.

`_getUIEventNode`

() protected

Inherited from Widget but overwritten in yui3/src/widget/js/WidgetUIEvents.js:62

Returns the node on which to bind delegate listeners.

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

`_guid`

() protected

Inherited from Widget: yui3/src/widget/js/Widget.js:1168

`_hasPotentialSubscribers`

(

fullType

)

Boolean private

Inherited from EventTarget: yui3/src/event-custom/js/event-facade.js:643

Parameters:

fullType String

The fully prefixed type name

Returns:

Boolean:

Whether the event has potential subscribers or not

`_initAttrHost`

(

attrs
values
lazy

)

private

Inherited from AttributeCore: yui3/src/attribute/js/AttributeCore.js:140

Constructor logic for attributes. Initializes the host state, and sets up the inital attributes passed to the constructor.

Parameters:

attrs Object

The attributes to add during construction (passed through to <a href="#method_addAttrs">addAttrs</a>). These can also be defined on the constructor being augmented with Attribute by defining the ATTRS property on the constructor.
values Object

The initial attribute values to apply (passed through to <a href="#method_addAttrs">addAttrs</a>). These are not merged/cloned. The caller is responsible for isolating user provided values if required.
lazy Boolean

Whether or not to add attributes lazily (passed through to <a href="#method_addAttrs">addAttrs</a>).

`_initAttribute`

() private

Inherited from BaseObservable but overwritten in yui3/src/base/js/BaseCore.js:309

Initializes AttributeCore

`_initAttrs`

(

attrs
values
lazy

)

protected

Inherited from AttributeCore: yui3/src/attribute/js/AttributeCore.js:1052

Utility method to set up initial attributes defined during construction, either through the constructor.ATTRS property, or explicitly passed in.

Parameters:

attrs Object

The attributes to add during construction (passed through to <a href="#method_addAttrs">addAttrs</a>). These can also be defined on the constructor being augmented with Attribute by defining the ATTRS property on the constructor.
values Object

The initial attribute values to apply (passed through to <a href="#method_addAttrs">addAttrs</a>). These are not merged/cloned. The caller is responsible for isolating user provided values if required.
lazy Boolean

Whether or not to add attributes lazily (passed through to <a href="#method_addAttrs">addAttrs</a>).

`_initBase`

(

config

)

private

Inherited from BaseCore: yui3/src/base/js/BaseCore.js:274

Internal construction logic for BaseCore.

Parameters:

config Object

The constructor configuration object

`_initHierarchy`

(

userVals

)

private

Inherited from BaseCore: yui3/src/base/js/BaseCore.js:702

Initializes the class hierarchy for the instance, which includes initializing attributes for each class defined in the class's static <a href="#property_BaseCore.ATTRS">ATTRS</a> property and invoking the initializer method on the prototype of each class in the hierarchy.

Parameters:

userVals Object

Object with configuration property name/value pairs

`_initHierarchyData`

() private

Inherited from BaseCore: yui3/src/base/js/BaseCore.js:500

A helper method used by _getClasses and _getAttrCfgs, which determines both the array of classes and aggregate set of attribute configurations across the class hierarchy for the instance.

`_initUIEvent`

(

type

)

String private

Inherited from Widget: yui3/src/widget/js/WidgetUIEvents.js:176

Sets up infrastructure required to fire a UI event.

Parameters:

type String

String representing the name of the event

Returns:

String:

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

`_isLazyAttr`

(

name

)

Boolean private

Inherited from AttributeCore: yui3/src/attribute/js/AttributeCore.js:347

Checks whether or not the attribute is one which has been added lazily and still requires initialization.

Parameters:

name String

The name of the attribute

Returns:

Boolean:

true if it's a lazily added attribute, false otherwise.

`_isUIEvent`

(

type

)

String private

Inherited from Widget: yui3/src/widget/js/WidgetUIEvents.js:143

Determines if the specified event is a UI event.

Parameters:

type String

String representing the name of the event

Returns:

String:

Event Returns the name of the UI Event, otherwise undefined.

`_mapButton`

(

button
section

)

protected

Inherited from WidgetButtons: yui3/src/widget-buttons/js/widget-buttons.js:700

Available since 3.5.0

Adds the specified button to the buttons map (both name -> button and section:name -> button), and sets the button as the default if it is configured as the default button.

Note: If two or more buttons are configured with the same name and/or configured to be the default button, the last one wins.

Parameters:

button Node

The button node to map.
section String

The WidgetStdMod section (header/body/footer).

`_mapButtons`

(

buttons

)

protected

Inherited from WidgetButtons: yui3/src/widget-buttons/js/widget-buttons.js:730

Available since 3.5.0

Adds the specified buttons to the buttons map (both name -> button and section:name -> button), and set the a button as the default if one is configured as the default button.

Note: This will clear all previous button mappings and null-out any previous default button! If two or more buttons are configured with the same name and/or configured to be the default button, the last one wins.

Parameters:

buttons Node[]

The button nodes to map.

`_mapInstance`

(

The

)

protected

Inherited from Widget: yui3/src/widget/js/Widget.js:410

Utility method used to add an entry to the boundingBox id to instance map.

This method can be used to populate the instance with lazily created boundingBox Node references.

Parameters:

The String

boundingBox id

`_mergeButtonConfig`

(

config

)

Object protected

Inherited from WidgetButtons: yui3/src/widget-buttons/js/widget-buttons.js:757

Available since 3.5.0

Returns a copy of the specified config object merged with any defaults provided by a srcNode and/or a predefined configuration for a button with the same name on the BUTTONS property.

Parameters:

config Object | String

Button configuration object, or string name.

Returns:

Object:

A copy of the button configuration object merged with any defaults.

`_monitor`

(

what
eventType
o

)

private

Inherited from EventTarget: yui3/src/event-custom/js/event-target.js:636

This is the entry point for the event monitoring system. You can monitor 'attach', 'detach', 'fire', and 'publish'. When configured, these events generate an event. click -> click_attach, click_detach, click_publish -- these can be subscribed to like other events to monitor the event system. Inividual published events can have monitoring turned on or off (publish can't be turned off before it it published) by setting the events 'monitor' config.

Parameters:

what String

'attach', 'detach', 'fire', or 'publish'
eventType String | CustomEvent

The prefixed name of the event being monitored, or the CustomEvent object.
o Object

Information about the event interaction, such as fire() args, subscription category, publish config

`_normAttrVals`

(

valueHash

)

Object private

Inherited from AttributeCore: yui3/src/attribute/js/AttributeCore.js:938

Utility method to normalize attribute values. The base implementation simply merges the hash to protect the original.

Parameters:

valueHash Object

An object with attribute name/value pairs

Returns:

Object:

An object literal with 2 properties - "simple" and "complex", containing simple and complex attribute values respectively keyed by the top level attribute name, or null, if valueHash is falsey.

`_onDocFocus`

(

evt

)

protected

Inherited from Widget: yui3/src/widget/js/Widget.js:1096

DOM focus event handler, used to sync the state of the Widget with the DOM

Parameters:

evt EventFacade

The event facade for the DOM focus event

`_onDocMouseDown`

(

evt

)

protected

Inherited from Widget: yui3/src/widget/js/Widget.js:1083

"mousedown" event handler for the owner document of the widget's bounding box.

Parameters:

evt EventFacade

The event facade for the DOM focus event

`_parseButtons`

(

srcNode

)

Null | Object protected

Inherited from WidgetButtons: yui3/src/widget-buttons/js/widget-buttons.js:806

Available since 3.5.0

HTML_PARSER implementation for the buttons attribute.

Note: To determine a button node's name its data-name and name attributes are examined. Whether the button should be the default is determined by its data-default attribute.

Parameters:

srcNode Node

This widget's srcNode to search for buttons.

Returns:

Null | Object:

buttons Config object parsed from this widget's DOM.

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

`_parseType`

() private

Inherited from EventTarget: yui3/src/event-custom/js/event-target.js:52

Returns an array with the detach key (if provided), and the prefixed event name from _getType Y.on('detachcategory| menu:click', fn)

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

APIs

Panel Class

Constructor

Index

Methods

Properties

Attributes

Events

Methods

_addAttrs

Parameters:

_addLazyAttr

Parameters:

_addOutOfOrder

Parameters:

_addShimResizeHandlers

_addStdModContent

Parameters:

_afterAlignChange

Parameters:

_afterAlignOnChange

Parameters:

_afterBodyChange

Parameters:

_afterButtonsChange

Parameters:

_afterChildSelectedChange

Parameters:

_afterConstrainChange

Parameters:

_afterContentChangeButtons

Parameters:

_afterDefaultButtonChange

Parameters:

_afterFillHeightChange

Parameters:

_afterFocusOnChange

_afterFooterChange

Parameters:

_afterHeaderChange

Parameters:

_afterHideOnChange

_afterHostVisibleChangeAutohide

_afterHostVisibleChangeModal

Parameters:

_afterHostZIndexChangeModal

Parameters:

_afterShimChange

Parameters:

_afterVisibleChangeButtons

Parameters:

_afterXYChange

Parameters:

_afterZIndexChange

Parameters:

_aggregateAttrs

Parameters:

Returns:

_applyParsedConfig

Returns:

_applyParser

Parameters:

_applyStdModParsedConfig

_attachPosAlignUIHandles

_attachUIHandlesAutohide

_attachUIHandlesModal

_attrCfgHash

_baseDestroy

_baseInit

_bindAttrUI

Parameters:

_bindDOM

_bindUI

_bindUIAutohide

_bindUIButtons

_bindUIChild

_bindUIModal

_bindUIPosAlign

_bindUIPosConstrained

`Panel`

`_addAttrs`

`_addLazyAttr`

`_addOutOfOrder`

`_addShimResizeHandlers`

`_addStdModContent`

`_afterAlignChange`

`_afterAlignOnChange`

`_afterBodyChange`

`_afterButtonsChange`

`_afterChildSelectedChange`

`_afterConstrainChange`

`_afterContentChangeButtons`

`_afterDefaultButtonChange`

`_afterFillHeightChange`

`_afterFocusOnChange`

`_afterFooterChange`

`_afterHeaderChange`

`_afterHideOnChange`

`_afterHostVisibleChangeAutohide`

`_afterHostVisibleChangeModal`

`_afterHostZIndexChangeModal`

`_afterShimChange`

`_afterVisibleChangeButtons`

`_afterXYChange`

`_afterZIndexChange`

`_aggregateAttrs`

`_applyParsedConfig`

`_applyParser`

`_applyStdModParsedConfig`

`_attachPosAlignUIHandles`

`_attachUIHandlesAutohide`

`_attachUIHandlesModal`

`_attrCfgHash`

`_baseDestroy`

`_baseInit`

`_bindAttrUI`

`_bindDOM`

`_bindUI`

`_bindUIAutohide`

`_bindUIButtons`

`_bindUIChild`

`_bindUIModal`

`_bindUIPosAlign`

`_bindUIPosConstrained`

`_bindUIPosition`

`_bindUIStack`

`_bindUIStdMod`

`_blockIFrameFocus`

`_blur`

`_cloneDefaultValue`

`_constrain`

`_constrainOnXYChange`

`_createButton`

`_createUIEvent`

`_defAttrChangeFn`

`_defaultBB`

`_defaultCB`

`_defDestroyFn`

`_defInitFn`

`_defRenderFn`

`_destroyBox`

`_destroyHierarchy`

`_destroyShim`

`_destroyUIEvents`

`_detachPosAlignUIHandles`

`_detachStackHandles`

`_detachUIHandlesAutohide`

`_detachUIHandlesModal`

`_doAlign`

`_enableConstraints`

`_eraseStdMod`

`_fillHeight`

`_filterAdHocAttrs`

`_filterUIEvent`

`_findStdModSection`

`_fireAttrChange`

`_focus`

`_getAlignedXY`

`_getAlignToXY`