Show:

A base class for PropertyList.

Constructor

A.PropertyList

(
  • config
)

Parameters:

  • config Object

    Object literal specifying widget configuration properties.

Index

Methods

Methods

@renderUI

() protected

Inherited from DataTable.Base: yui3/src/datatable/js/base.js:425

Available since 3.6.0

Instantiates the configured view class that will be responsible for setting up the View class.

_addAttrs

(
  • cfgs
  • values
  • lazy
)
private

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

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>An object with attribute name/configuration pairs.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • values Object

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>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.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • lazy Boolean

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>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>.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_addLazyAttr

(
  • name
  • [lazyCfg]
)
private

Finishes initializing an attribute which has been lazily added.

Parameters:

  • name Object

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The name of the attribute</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • [lazyCfg] Object optional

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>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.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_addOutOfOrder

(
  • name
  • cfg
)
private

Utility method used by get/set to add attributes encountered out of order when calling addAttrs().

For example, if:

this.addAttrs({
                                                     foo: {
                                                         setter: function() {
                                                            // make sure this bar is available when foo is added
                                                            this.get("bar");
                                                         }
                                                     },
                                                     bar: {
                                                         value: ...
                                                     }
                                                });

Parameters:

  • name String

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>attribute name</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • cfg Object

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>attribute configuration</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_addScrollbarPadding

() protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:193

Available since 3.5.0

Adds padding to the last cells in the fixed header for vertically scrolling tables. This padding is equal in width to the scrollbar, so can't be relegated to a stylesheet.

_afterChildSelectedChange

(
  • event
)
protected

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

Parameters:

  • event EventFacade

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The event facade for the attribute change.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_afterColumnsChange

(
  • e
)
protected

Inherited from DataTable: yui3/src/datatable/js/core.js:333

Available since 3.5.0

Updates the _columnMap property in response to changes in the columns attribute.

Parameters:

_afterCssClassChange

(
  • event
)
protected

Fires after the value of the cssClass attribute change.

Parameters:

_afterCurrentIndexChange

(
  • event
)
protected

Fired after the widget's index attribute is changed. Will update the scrollview to show the right item, if it isn't showing it yet.

Parameters:

_afterDataChange

(
  • e
)
protected

Inherited from DataTable: yui3/src/datatable/js/core.js:346

Available since 3.5.0

Updates the modelList attributes of the rendered views in response to the data attribute being assigned a new ModelList.

Parameters:

_afterDisplayColumnsChange

(
  • e
)
protected

Inherited from DataTable.Base: yui3/src/datatable/js/base.js:305

Available since 3.6.0

Updates the _displayColumns property.

Parameters:

_afterFocusedCellChange

(
  • e
)
private

Sets the tabIndex on the focused cell and, if the DataTable has the focus, sets the focus on it.

Parameters:

_afterIndexChange

(
  • event
)
protected

Fired after the scrollview's index attribute is changed. Will update the widget's index accordingly.

Parameters:

_afterKeyNavFocusedChange

(
  • e
)
private

When the DataTable gets the focus, it ensures the correct cell regains the focus.

Parameters:

_afterKeyNavRender

() private

Subscribes to the events on the DataTable elements once they have been rendered, finds out the header section and makes the top-left element focusable.

_afterMessageColumnsChange

(
  • e
)
protected

Inherited from DataTable: yui3/src/datatable/js/message.js:110

Available since 3.5.0

Updates the colspan of the <td> used to display the messages.

Parameters:

_afterMessageDataChange

(
  • e
)
protected

Inherited from DataTable: yui3/src/datatable/js/message.js:133

Available since 3.5.0

Relays to _uiSetMessage to hide or show the message node.

Parameters:

_afterRecordTypeChange

(
  • e
)
protected

Inherited from DataTable: yui3/src/datatable/js/core.js:367

Available since 3.6.0

Assigns to the new recordType as the model for the data ModelList

Parameters:

_afterRenderUI

() protected

Fires after the renderUI event.

_afterResponsiveSwipe

() protected

Fired after the widget's responsive event. This adds back the swipe css class that was removed by _onResponsiveSwipe and then syncs the scroll UI.

_afterScrollableChange

(
  • e
)
protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:218

Available since 3.5.0

Reacts to changes in the scrollable attribute by updating the _xScroll and _yScroll properties and syncing the scrolling structure accordingly.

Parameters:

_afterScrollCaptionChange

(
  • e
)
protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:242

Available since 3.5.0

Reacts to changes in the caption attribute by adding, removing, or syncing the caption table when the table is set to scroll.

Parameters:

_afterScrollColumnsChange

(
  • e
)
protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:257

Available since 3.5.0

Reacts to changes in the columns attribute of vertically scrolling tables by refreshing the fixed headers, scroll container, and virtual scrollbar position.

Parameters:

_afterScrollDataChange

(
  • e
)
protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:277

Available since 3.5.0

Reacts to changes in vertically scrolling table's data ModelList by synchronizing the fixed column header widths and virtual scrollbar height.

Parameters:

_afterScrollHeightChange

(
  • e
)
protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:292

Available since 3.5.0

Reacts to changes in the height attribute of vertically scrolling tables by updating the height of the <div> wrapping the data table and the virtual scrollbar. If scrollable was set to "y" or "xy" but lacking a declared height until the received change, _syncScrollUI is called to create the fixed headers etc.

Parameters:

_afterScrollWidthChange

(
  • e
)
protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:331

Available since 3.5.0

Reacts to changes in the width of scrolling tables by expanding the width of the <div> wrapping the data table for horizontally scrolling tables or upding the position of the virtual scrollbar for vertically scrolling tables.

Parameters:

_afterShowMessagesChange

(
  • e
)
protected

Inherited from DataTable: yui3/src/datatable/js/message.js:145

Available since 3.5.0

Removes the message node if showMessages is false, or relays to _uiSetMessage if true.

Parameters:

_afterSortByChange

(
  • e
)
protected

Inherited from DataTable: yui3/src/datatable/js/sort.js:288

Available since 3.5.0

Sorts the data ModelList based on the new sortBy configuration.

Parameters:

_afterSortDataChange

(
  • e
)
protected

Inherited from DataTable: yui3/src/datatable/js/sort.js:313

Available since 3.5.0

Applies the sorting logic to the new ModelList if the newVal is a new ModelList.

Parameters:

_afterSortRecordChange

(
  • e
)
protected

Inherited from DataTable: yui3/src/datatable/js/sort.js:332

Available since 3.5.0

Checks if any of the fields in the modified record are fields that are currently being sorted by, and if so, resorts the data ModelList.

Parameters:

_afterUITriggerSort

(
  • event
)
protected

Fires after the UITriggerSort event.

Parameters:

_afterWidgetUISetVisible

() protected

Fired after the widget's _uiSetVisible function is called. It prepares the swipe funcionality for use.

_aggregateAttrs

(
  • allAttrs
)
Object private

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

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

Returns:

Object:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The aggregate set of ATTRS definitions for the instance</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_applyParsedConfig

() Object protected

Returns:

Object:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The merged configuration literal</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_applyParser

(
  • config
)
protected

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

Parameters:

  • config Object

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>User configuration object (will be populated with values from Node)</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_attachSwipeEvents

() protected

Listens to the necessary events for the swipe funcionality to work correctly.

_attrCfgHash

() private

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

_baseDestroy

() private

Internal destroy implementation for BaseCore

_baseInit

() private

Internal initialization implementation for BaseCore

_bindAttrUI

(
  • attrs
)
private

Binds after listeners for the list of attributes provided

Parameters:

  • attrs Array

_bindDOM

() protected

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

_bindMessageUI

() protected

Inherited from DataTable: yui3/src/datatable/js/message.js:166

Available since 3.5.0

Binds the events necessary to keep the message node in sync with the current table and configuration state.

_bindScrollbar

() protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:348

Available since 3.5.0

Binds virtual scrollbar interaction to the _yScrollNode's scrollTop and vice versa.

_bindScrollResize

() protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:368

Available since 3.5.0

Binds to the window resize event to update the vertical scrolling table headers and wrapper <div> dimensions.

_bindScrollUI

() protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:385

Available since 3.5.0

Attaches internal subscriptions to keep the scrolling structure up to date with changes in the table's data, columns, caption, or height. The width is taken care of already.

This executes after the table's native bindUI method.

_bindSortUI

() protected

Inherited from DataTable: yui3/src/datatable/js/sort.js:352

Available since 3.5.0

Subscribes to state changes that warrant updating the UI, and adds the click handler for triggering the sort operation from the UI.

_bindUI

() protected

Sets up DOM and CustomEvent listeners for the widget.

_bindUIChild

() protected

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

_clearScrollLock

() protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:413

Available since 3.5.0

Clears the lock and timer used to manage synchronizing the scroll position between the vertical scroll container and the virtual scrollbar.

_cloneDefaultValue

(
  • cfg
)
private

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

_createColumnGroup

() protected

Inherited from DataTable: yui3/src/datatable/js/colwidths.js:175

Available since 3.5.0

Renders the table's <colgroup> and populates the _colgroupNode property.

_createRecordClass

(
  • attrs
)
Model protected

Inherited from DataTable: yui3/src/datatable/js/core.js:391

Available since 3.5.0

Creates a Model subclass from an array of attribute names or an object of attribute definitions. This is used to generate a class suitable to represent the data passed to the data attribute if no recordType is set.

Parameters:

  • attrs String | Object

    Names assigned to the Model subclass's ATTRS or its entire ATTRS definition object

Returns:

_createScrollbar

() Node protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:428

Available since 3.5.0

Creates a virtual scrollbar from the _SCROLLBAR_TEMPLATE, assigning it to the _scrollbarNode property.

Returns:

Node:

The created Node

_createScrollCaptionTable

() Node protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:454

Available since 3.5.0

Creates a separate table to contain the caption when the table is configured to scroll vertically or horizontally.

Returns:

Node:

The created Node

_createUIEvent

(
  • type
)
private

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

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>String representing the name of the event</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_createXScrollNode

() Node protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:476

Available since 3.5.0

Populates the _xScrollNode property by creating the <div> Node described by the _X_SCROLLER_TEMPLATE.

Returns:

Node:

The created Node

_createYScrollHeader

() Node protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:496

Available since 3.5.0

Populates the _yScrollHeader property by creating the <table> Node described by the _Y_SCROLL_HEADER_TEMPLATE.

Returns:

Node:

The created Node

_createYScrollNode

() Node protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:518

Available since 3.5.0

Populates the _yScrollNode property by creating the <div> Node described by the _Y_SCROLLER_TEMPLATE.

Returns:

Node:

The created Node

_defAddColumnFn

(
  • e
)
protected

Inherited from DataTable: yui3/src/datatable/js/mutable.js:394

Available since 3.5.0

Default function for the addColumn event.

Inserts the specified column at the provided index.

Parameters:

  • e EventFacade

    The addColumn event

    • column Object

      The new column definition object

    • index Number | Number[]

      The array index to insert the new column

_defAttrChangeFn

(
  • e
  • eventFastPath
)
private

Default function for attribute change events.

Parameters:

  • e EventFacade

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The event object for attribute change events.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • eventFastPath Boolean

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

_defaultBB

() protected

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

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

Default destroy event handler

Parameters:

  • e EventFacade

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>Event object</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_defInitFn

(
  • e
)
protected

Default init event handler

Parameters:

  • e EventFacade

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>Event object, with a cfg property which refers to the configuration object passed to the constructor.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_defModifyColumnFn

(
  • e
)
protected

Inherited from DataTable: yui3/src/datatable/js/mutable.js:424

Available since 3.5.0

Default function for the modifyColumn event.

Mixes the new column properties into the specified column definition.

Parameters:

  • e EventFacade

    The modifyColumn event

    • column Object | String | Number | Number[]

      The column definition object or identifier

    • newColumnDef Object

      The properties to assign to the column

_defMoveColumnFn

(
  • e
)
protected

Inherited from DataTable: yui3/src/datatable/js/mutable.js:448

Available since 3.5.0

Default function for the moveColumn event.

Removes the specified column from its current location and inserts it at the specified array index (may be an array of indexes for nested headers).

Parameters:

  • e EventFacade

    The moveColumn event

    • column Object | String | Number | Number[]

      The column definition object or identifier

    • index Object

      The destination index to move to

_defRemoveColumnFn

(
  • e
)
protected

Inherited from DataTable: yui3/src/datatable/js/mutable.js:501

Available since 3.5.0

Default function for the removeColumn event.

Splices the specified column from its containing columns array.

Parameters:

_defRenderFn

(
  • e
  • parentNode
)
protected

Default render handler

Parameters:

  • e EventFacade

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The Event object</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • parentNode Node

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

_defRenderViewFn

(
  • e
)
protected

The default behavior of the renderView event. Calls render() on the View instance on the event.

Parameters:

_defSortFn

(
  • e
)
protected

Inherited from DataTable: yui3/src/datatable/js/sort.js:376

Available since 3.5.0

Sets the sortBy attribute from the sort event's e.sortBy value.

Parameters:

_destroyBox

() protected

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

_destroyHierarchy

() private

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

_destroyUIEvents

() private

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

_detachSwipeEvents

() protected

Detaches all events related to the swipe funcionality.

_disableScrolling

() protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:546

Available since 3.5.0

Removes the nodes used to create horizontal and vertical scrolling and rejoins the caption to the main table if needed.

_disableScrollView

() protected

Disables the scroll view, removing the swipe funcionality.

_disableXScrolling

() protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:563

Available since 3.5.0

Removes the nodes used to allow horizontal scrolling.

_disableYScrolling

() protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:574

Available since 3.5.0

Removes the nodes used to allow vertical scrolling.

_enableScrollView

() protected

Enables the scroll view, adding the swipe funcionality.

_extractDisplayColumns

(
  • columns
)
protected

Processes the full column array, distilling the columns down to those that correspond to cell data columns.

Parameters:

  • columns Object

    The full set of table columns

_filterAdHocAttrs

(
  • allAttrs
  • userVals
)
Object private

Parameters:

  • allAttrs Object

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>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.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • userVals Object

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

Returns:

Object:

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

_filterUIEvent

(
  • evt
)
Boolean private

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.

<p>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.</p>

Parameters:

Returns:

Boolean:

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

_fireAttrChange

(
  • attrName
  • subAttrName
  • currVal
  • newVal
  • opts
  • [cfg]
)
private

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

Parameters:

  • attrName String

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The name of the attribute</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • subAttrName String

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The full path of the property being changed, if this is a sub-attribute value being change. Otherwise null.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • currVal Any

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The current value of the attribute</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • newVal Any

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The new value of the attribute</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • opts Object

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>Any additional event data to mix into the attribute change event's event facade.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • [cfg] Object optional

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The attribute config stored in State, if already available.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_focusedCellSetter

(
  • cell
)
private

Setter method for the focusedCell attribute. Checks that the passed value is a Node, either a TD or TH and is contained within the DataTable contentBox.

Parameters:

  • cell Node

    DataTable cell to receive the focus

Returns:

cell or Y.Attribute.INVALID_VALUE

_getAttr

(
  • name
)
Any protected chainable

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

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The name of the attribute.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

Returns:

Any:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The value of the attribute.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_getAttrCfg

(
  • name
)
Object protected

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

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

Returns:

Object:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The configuration properties for the given attribute, or all attributes.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_getAttrCfgs

() Object protected

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

Returns:

Object:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>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.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_getAttrInitVal

(
  • attr
  • cfg
  • initValues
)
Any private

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

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The name of the attribute</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • cfg Object

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The attribute configuration object</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • initValues Object

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

Returns:

Any:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The initial value of the attribute.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_getAttrs

(
  • attrs
)
Object protected

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

Parameters:

  • attrs String | Boolean

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>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.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

Returns:

Object:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>An object with attribute name/value pairs.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_getCellColumnName

(
  • cell
)
protected

Retrieves the column name based from the data attribute on the cell if available. Other wise, extracts the column name from the classname

Parameters:

  • cell Node

    Cell to get column name from

Returns:

String Column name of the provided cell

_getClasses

() Function protected

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

Returns:

Function:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>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.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_getColumns

(
  • columns
  • name
)
protected

Inherited from DataTable: yui3/src/datatable/js/core.js:431

Available since 3.5.0

The getter for the columns attribute. Returns the array of column configuration objects if instance.get('columns') is called, or the specific column object if instance.get('columns.columnKey') is called.

Parameters:

  • columns Object

    The full array of column objects

  • name String

    The attribute name requested (e.g. 'columns' or 'columns.foo');

_getColumnset

(
  • ignored
  • name
)
deprecated protected

Inherited from DataTable: yui3/src/datatable/js/core.js:450

Deprecated: This will be removed with the `columnset` attribute in a future version.

Available since 3.5.0

Relays the get() request for the deprecated columnset attribute to the columns attribute.

THIS BREAKS BACKWARD COMPATIBILITY. 3.4.1 and prior implementations will expect a Columnset instance returned from get('columnset').

Parameters:

  • ignored Object

    The current value stored in the columnset state

  • name String

    The attribute name requested (e.g. 'columnset' or 'columnset.foo');

_getFullType

(
  • type
)
String private

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

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The short type to prefix</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

Returns:

String:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The prefixed type, if a prefix is set, otherwise the type passed in</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_getHtmlParser

() Object private

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

Returns:

Object:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>HTML_PARSER definition for this instance</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_getInstanceAttrCfgs

(
  • allCfgs
)
Object private

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

Parameters:

  • allCfgs Object

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>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.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

Returns:

Object:

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

_getNodeToParse

() Node private

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:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The node reference to apply HTML_PARSER to.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_getRecordType

(
  • val
)
Model

Returns the Model class of the instance's data attribute ModelList. If not set, returns the explicitly configured value.

Parameters:

  • val Model

    The currently configured value

Returns:

_getSortBy

(
  • val
  • detail
)
protected

Inherited from DataTable: yui3/src/datatable/js/sort.js:388

Available since 3.5.0

Getter for the sortBy attribute.

Supports the special subattribute "sortBy.state" to get a normalized JSON version of the current sort state. Otherwise, returns the last assigned value.

For example:

<pre><code>var table = new Y.DataTable({ columns: [ ... ], data: [ ... ], sortBy: 'username' });

table.get('sortBy'); // 'username' table.get('sortBy.state'); // { key: 'username', dir: 1 }

table.sort(['lastName', { firstName: "desc" }]); table.get('sortBy'); // ['lastName', { firstName: "desc" }] table.get('sortBy.state'); // [{ key: "lastName", dir: 1 }, { key: "firstName", dir: -1 }] </code></pre>

Parameters:

  • val String | String | Object | Object

    The current sortBy value

  • detail String

    String passed to get(HERE). to parse subattributes

_getSrcNode

() Node protected

Returns:

Node:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The Node to apply HTML_PARSER to</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_getStateVal

(
  • name
  • [cfg]
)
Any private

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

Parameters:

  • name String

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The name of the attribute</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • [cfg] Object optional

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>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.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

Returns:

Any:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The stored value of the attribute</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_getTHParent

(
  • thCell
)
Node protected

Retrieves the parent cell of the given TH cell. If there is no parent for the provided cell, null is returned.

Parameters:

  • thCell Node

    Cell to find parent of

Returns:

Node:

Parent of the cell provided or null

_getType

() private

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.

_guid

() protected

_hasPotentialSubscribers

(
  • fullType
)
Boolean private

Parameters:

  • fullType String

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The fully prefixed type name</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

Returns:

Boolean:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>Whether the event has potential subscribers or not</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_initAttrHost

(
  • attrs
  • values
  • lazy
)
private

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

Parameters:

  • attrs Object

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>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.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • values Object

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>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.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • lazy Boolean

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

_initAttribute

() private

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

Initializes AttributeCore

_initAttrs

(
  • attrs
  • values
  • lazy
)
protected

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

Parameters:

  • attrs Object

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>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.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • values Object

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>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.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • lazy Boolean

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

_initBase

(
  • config
)
private

Internal construction logic for BaseCore.

Parameters:

  • config Object

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The constructor configuration object</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_initColumns

() protected

Inherited from DataTable: yui3/src/datatable/js/core.js:488

Available since 3.5.0

Initializes the _columnMap property from the configured columns attribute. If columns is not set, but there are records in the data ModelList, use ATTRS of that class.

_initCoreEvents

() protected

Inherited from DataTable: yui3/src/datatable/js/core.js:517

Available since 3.6.0

Sets up the change event subscriptions to maintain internal state.

_initData

() ModelList protected

Inherited from DataTable: yui3/src/datatable/js/core.js:532

Available since 3.6.0

Defaults the data attribute to an empty ModelList if not set during construction. Uses the configured recordType for the ModelList's model proeprty if set.

Returns:

_initDataProperty

(
  • data
)
protected

Inherited from DataTable: yui3/src/datatable/js/core.js:554

Available since 3.6.0

Initializes the instance's data property from the value of the data attribute. If the attribute value is a ModelList, it is assigned directly to this.data. If it is an array, a ModelList is created, its model property is set to the configured recordType class, and it is seeded with the array data. This ModelList is then assigned to this.data.

Parameters:

_initHierarchy

(
  • userVals
)
private

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

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>Object with configuration property name/value pairs</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_initHierarchyData

() private

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.

_initHighlight

() protected

Initializer for the A.DataTable highlighter.

_initMessageNode

() protected

Inherited from DataTable: yui3/src/datatable/js/message.js:203

Available since 3.5.0

Creates the _messageNode property from the configured MESSAGE_TEMPLATE and inserts it before the <table>'s <tbody> node.

_initMessageStrings

() protected

Inherited from DataTable: yui3/src/datatable/js/message.js:224

Available since 3.5.0

Add the messaging related strings to the strings map.

_initSortFn

() protected

Inherited from DataTable: yui3/src/datatable/js/sort.js:477

Available since 3.5.0

Creates a _compare function for the data ModelList to allow custom sorting by multiple fields.

_initSortStrings

() protected

Inherited from DataTable: yui3/src/datatable/js/sort.js:532

Available since 3.5.0

Add the sort related strings to the strings map.

_initUIEvent

(
  • type
)
String private

Sets up infrastructure required to fire a UI event.

Parameters:

  • type String

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>String representing the name of the event</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

Returns:

String:

_isLazyAttr

(
  • name
)
Boolean private

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

Parameters:

  • name String

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The name of the attribute</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

Returns:

Boolean:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>true if it's a lazily added attribute, false otherwise.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_isUIEvent

(
  • type
)
String private

Determines if the specified event is a UI event.

Parameters:

  • type String

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>String representing the name of the event</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

Returns:

String:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>Event Returns the name of the UI Event, otherwise undefined.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_keyMoveColBottom

(
  • e
)
private

Sets the focus on the last cell of the column containing the currently focused cell.

Parameters:

_keyMoveColTop

(
  • e
)
private

Sets the focus on the top-most cell of the column containing the currently focused cell. It would normally be a header cell.

Parameters:

_keyMoveDown

(
  • e
)
private

Sets the focus on the cell below the currently focused one. It will move into the data rows when the bottom of the header rows is reached. Does not wrap, following the WAI-ARIA recommendation.

Parameters:

_keyMoveFirst

() private

Sets the focus on the very first cell in the header of the table.

_keyMoveLeft

(
  • e
)
private

Sets the focus on the cell to the left of the currently focused one. Does not wrap, following the WAI-ARIA recommendation.

Parameters:

_keyMoveRight

(
  • e
)
private

Sets the focus on the cell to the right of the currently focused one. Does not wrap, following the WAI-ARIA recommendation.

Parameters:

_keyMoveRowEnd

(
  • e
)
private

Sets the focus on the right-most cell of the row containing the currently focused cell.

Parameters:

_keyMoveRowStart

(
  • e
)
private

Sets the focus on the left-most cell of the row containing the currently focused cell.

Parameters:

_keyMoveUp

(
  • e
)
private

Sets the focus on the cell above the currently focused one. It will move into the headers when the top of the data rows is reached. Does not wrap, following the WAI-ARIA recommendation.

Parameters:

_keyNavFireEvent

(
  • action
  • e
)
private

If the action associated to a key combination is a string and no method by that name was found in this instance, this method will fire an event using that string and provides extra information to the listener.

Parameters:

  • action String

    Name of the event to fire

  • e EventFacade

    Original facade from the keydown event.

_mapInstance

(
  • The
)
protected

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

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>boundingBox id</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_monitor

(
  • what
  • eventType
  • o
)
private

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

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>'attach', 'detach', 'fire', or 'publish'</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • eventType String | CustomEvent

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The prefixed name of the event being monitored, or the CustomEvent object.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • o Object

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

_normAttrVals

(
  • valueHash
)
Object private

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

Parameters:

  • valueHash Object

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>An object with attribute name/value pairs</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

Returns:

Object:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>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.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_onActiveCellChange

(
  • event
)
protected

Fires on activeCellChange event.

Parameters:

_onDocFocus

(
  • evt
)
protected

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

Parameters:

  • evt EventFacade

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The event facade for the DOM focus event</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_onDocMouseDown

(
  • evt
)
protected

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

Parameters:

  • evt EventFacade

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The event facade for the DOM focus event</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_onKeyNavClick

(
  • e
)
private

In response to a click event, it sets the focus on the clicked cell

Parameters:

_onKeyNavKeyDown

(
  • e
)
private

Responds to a key down event by executing the action set in the keyActions table.

Parameters:

_onResponsiveSwipe

() protected

Fired on the widget's responsive event. This removes the swipe css class, so the responsive code can correctly calculate the widget's size. The css class will be added back by _afterResponsiveSwipe.

_onSelectionKey

(
  • event
)
protected

Callback for the selection key event listener.

Parameters:

_onUITriggerSort

(
  • e
)
protected

Inherited from DataTable: yui3/src/datatable/js/sort.js:545

Available since 3.5.0

Fires the sort event in response to user clicks on sortable column headers.

Parameters:

_parseSortable

() protected

Inherited from DataTable: yui3/src/datatable/js/sort.js:598

Available since 3.5.0

Normalizes the possible input values for the sortable attribute, storing the results in the _sortable property.

_parseType

() private

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

_plugPaginator

() protected

Plugs ScrollViewPaginator if the useScrollViewPaginator is true.

_preAddAttrs

(
  • attrs
  • userVals
  • lazy
)
protected

Implement the BaseCore _preAddAttrs method hook, to add the srcNode and related attributes, so that HTML_PARSER (which relies on this.get("srcNode")) can merge in it's results before the rest of the attributes are added.

Parameters:

  • attrs Object

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The full hash of statically defined ATTRS attributes being added for this instance</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • userVals Object

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The hash of user values passed to the constructor</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • lazy Boolean

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>Whether or not to add the attributes lazily</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_preInitEventCfg

(
  • config
)
private

Handles the special on, after and target properties which allow the user to easily configure on and after listeners as well as bubble targets during construction, prior to init.

Parameters:

  • config Object

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The user configuration object</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_protectAttrs

(
  • attrs
)
Object deprecated protected

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

Deprecated: Use `AttributeCore.protectAttrs()` or `Attribute.protectAttrs()` which are the same static utility method.

Utility method to protect an attribute configuration hash, by merging the entire object and the individual attr config objects.

Parameters:

  • attrs Object

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>A hash of attribute to configuration object pairs.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

Returns:

Object:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>A protected version of the attrs argument.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_publish

(
  • fullType
  • etOpts
  • ceOpts
)
CustomEvent private

The low level event publish implementation. It expects all the massaging to have been done outside of this method. e.g. the type to fullType conversion. It's designed to be a fast path publish, which can be used by critical code paths to improve performance.

Parameters:

  • fullType String

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The prefixed type of the event to publish.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • etOpts Object

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The EventTarget specific configuration to mix into the published event.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • ceOpts Object

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The publish specific configuration to mix into the published event.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

Returns:

CustomEvent:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The published event. If called without <code>etOpts</code> or <code>ceOpts</code>, this will be the default <code>CustomEvent</code> instance, and can be configured independently.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_relayCoreAttrChange

(
  • e
)
protected

Inherited from DataTable.Base: yui3/src/datatable/js/base.js:411

Available since 3.6.0

Relays attribute changes to the instance's view.

Parameters:

_removeLoadingClassNames

() protected

Removes class names representative of the widget's loading state from the boundingBox.

_removeScrollbar

() protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:713

Available since 3.5.0

Removes the virtual scrollbar used by scrolling tables.

_removeScrollCaptionTable

() protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:621

Available since 3.5.0

Removes the table used to house the caption when the table is scrolling.

_removeXScrollNode

() protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:640

Available since 3.5.0

Removes the <div> wrapper used to contain the data table when the table is horizontally scrolling.

_removeYScrollContainer

() protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:659

Available since 3.5.0

Removes the <div> wrapper used to contain the data table and fixed header when the table is vertically scrolling.

_removeYScrollHeader

() protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:678

Available since 3.5.0

Removes the <table> used to contain the fixed column headers when the table is vertically scrolling.

_removeYScrollNode

() protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:694

Available since 3.5.0

Removes the <div> wrapper used to contain the data table when the table is vertically scrolling.

_renderBox

(
  • parentNode
)
private

Helper method to collect the boundingBox and contentBox and append to the provided parentNode, if not already a child. The owner document of the boundingBox, or the owner document of the contentBox will be used as the document into which the Widget is rendered if a parentNode is node is not provided. If both the boundingBox and the contentBox are not currently in the document, and no parentNode is provided, the widget will be rendered to the current document's body.

Parameters:

  • parentNode Node

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The parentNode to render the widget to. If not provided, and both the boundingBox and the contentBox are not currently in the document, the widget will be rendered to the current document's body.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_renderBoxClassNames

() protected

Applies standard class names to the boundingBox and contentBox

_renderSortable

() protected

Inherited from DataTable: yui3/src/datatable/js/sort.js:640

Available since 3.5.0

Initial application of the sortable UI.

_renderUI

() protected

Initializes the UI state for the Widget's bounding/content boxes.

_scrollToCurrentIndex

() protected

Scrolls to the widget's current index.

_set

(
  • name
  • val
  • [opts]
)
Object protected chainable

Allows setting of readOnly/writeOnce attributes. See <a href="#method_set">set</a> for argument details.

Parameters:

  • name String

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The name of the attribute.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • val Any

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The value to set the attribute to.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • [opts] Object optional

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>Optional data providing the circumstances for the change.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

Returns:

Object:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>A reference to the host object.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_setAttr

(
  • name
  • value
  • [opts]
  • force
)
Object protected chainable

Provides the common implementation for the public set and protected _set methods.

See <a href="#method_set">set</a> for argument details.

Parameters:

  • name String

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The name of the attribute.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • value Any

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The value to set the attribute to.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • [opts] Object optional

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>Optional data providing the circumstances for the change.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • force Boolean

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>If true, allows the caller to set values for readOnly or writeOnce attributes which have already been set.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

Returns:

Object:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>A reference to the host object.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_setAttrs

(
  • attrs
  • [opts]
)
Object protected chainable

Implementation behind the public setAttrs method, to set multiple attribute values.

Parameters:

  • attrs Object

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>An object with attributes name/value pairs.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • [opts] Object optional

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>Optional data providing the circumstances for the change</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

Returns:

Object:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>A reference to the host object.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_setAttrUI

(
  • e
)
private

Parameters:

_setAttrVal

(
  • attrName
  • subAttrName
  • prevVal
  • newVal
  • [opts]
  • [attrCfg]
)
Boolean private

Updates the stored value of the attribute in the privately held State object, if validation and setter passes.

Parameters:

  • attrName String

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The attribute name.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • subAttrName String

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The sub-attribute name, if setting a sub-attribute property ("x.y.z").</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • prevVal Any

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The currently stored value of the attribute.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • newVal Any

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The value which is going to be stored.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • [opts] Object optional

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>Optional data providing the circumstances for the change.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • [attrCfg] Object optional

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>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.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

Returns:

Boolean:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>true if the new attribute value was stored, false if not.</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_setBB

(
  • node
)
private

Setter for the boundingBox attribute

Parameters:

  • node Node | String

Returns:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>Node</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_setBox

(
  • id
  • node
  • template
  • isBounding
)
Node private

Helper method to set the bounding/content box, or create it from the provided template if not found.

Parameters:

  • id String

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The node's id attribute</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • node Node | String

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The node reference</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • template String

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>HTML string template for the node</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • isBounding Boolean

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>true if this is the boundingBox, false if it's the contentBox</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

Returns:

Node:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The node</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_setCB

(
  • node
)
private

Setter for the contentBox attribute

Parameters:

  • node Node | String

Returns:

<p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>Node</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_setColumnMap

(
  • columns
)
protected

Inherited from DataTable: yui3/src/datatable/js/core.js:640

Available since 3.6.0

Iterates the array of column configurations to capture all columns with a key property. An map is built with column keys as the property name and the corresponding column object as the associated value. This map is then assigned to the instance's _columnMap property.

Parameters:

  • columns Object | String

    The array of column config objects

_setColumns

(
  • val
)
Null | Object protected

Translates string columns into objects with that string as the value of its key property.

All columns are assigned a _yuid stamp and _id property corresponding to the column's configured name or key property with any spaces replaced with dashes. If the same name or key appears in multiple columns, subsequent appearances will have their _id appended with an incrementing number (e.g. if column "foo" is included in the columns attribute twice, the first will get _id of "foo", and the second an _id of "foo1"). Columns that are children of other columns will have the _parent property added, assigned the column object to which they belong.

Parameters:

  • val Null | Object | String

    Array of config objects or strings

Returns:

Null | Object:

_setColumnset

(
  • val
)
deprecated protected

Inherited from DataTable: yui3/src/datatable/js/core.js:793

Deprecated: This will be removed with the deprecated `columnset` attribute in a later version.

Available since 3.5.0

Relays attribute assignments of the deprecated columnset attribute to the columns attribute. If a Columnset is object is passed, its basic object structure is mined.

Parameters:

  • val Array | Columnset

    The columnset value to relay

_setColumnWidth

(
  • colIndex
  • width
)
protected

Inherited from DataTable: yui3/src/datatable/js/colwidths.js:198

Available since 3.5.0

Sets a columns's <col> element width style. This is needed to get around browser rendering differences.

The colIndex corresponds to the item index of the <col> in the table's <colgroup>.

To unset the width, pass a falsy value for the width.

Parameters:

  • colIndex Number

    The display column index

  • width Number | String

    The desired width

_setData

() protected

Inherited from DataTable: yui3/src/datatable/js/core.js:811

Available since 3.5.0

Accepts an object with each and getAttrs (preferably a ModelList or subclass) or an array of data objects. If an array is passes, it will create a ModelList to wrap the data. In doing so, it will set the created ModelList's model property to the class in the recordType attribute, which will be defaulted if not yet set.

If the data property is already set with a ModelList, passing an array as the value will call the ModelList's reset() method with that array rather than replacing the stored ModelList wholesale.

Any non-ModelList-ish and non-array value is invalid.

_setRecordset

(
  • val
)
deprecated protected

Inherited from DataTable: yui3/src/datatable/js/core.js:854

Deprecated: This will be removed with the deprecated `recordset` attribute in a later version.

Available since 3.5.0

Relays the value assigned to the deprecated recordset attribute to the data attribute. If a Recordset instance is passed, the raw object data will be culled from it.

Parameters:

  • val Object | Recordset

    The recordset value to relay

_setRecordType

(
  • val
)
Function protected

Inherited from DataTable: yui3/src/datatable/js/core.js:882

Available since 3.5.0

Accepts a Base subclass (preferably a Model subclass). Alternately, it will generate a custom Model subclass from an array of attribute names or an object defining attributes and their respective configurations (it is assigned as the ATTRS of the new class).

Any other value is invalid.

Parameters:

  • val Function | String | Object

    The Model subclass, array of attribute names, or the ATTRS definition for a custom model subclass

Returns:

Function:

A Base/Model subclass

_setScrollable

(
  • val
)
String protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:733

Available since 3.5.0

Accepts (case insensitive) values "x", "y", "xy", true, and false. true is translated to "xy" and upper case values are converted to lower case. All other values are invalid.

Parameters:

  • val String | Boolean

    Incoming value for the scrollable attribute

Returns:

String:

_setScrollProperties

() protected

Inherited from DataTable: yui3/src/datatable/js/scroll.js:758

Available since 3.5.0

Assigns the _xScroll and _yScroll properties to true if an appropriate value is set in the scrollable attribute and the height and/or width is set.

_setSortBy

() protected

Inherited from DataTable: yui3/src/datatable/js/sort.js:653

Available since 3.5.0

Parses the current sortBy attribute into a normalized structure for the data ModelList's _compare method. Also updates the column configurations' sortDir properties.

_setStateVal

(
  • name
  • value
)
private

Sets the stored value for the attribute, in either the internal state object, or the state proxy if it exits

Parameters:

  • name String

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The name of the attribute</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

  • value Any

    <p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p><p>The value of the attribute</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_setSwipe

() protected

Sets swipe attribute.

_sortComparator

(
  • item
)
Model protected

Inherited from DataTable: yui3/src/datatable/js/sort.js:744

Available since 3.5.0

Replacement comparator for the data ModelList that defers sorting logic to the _compare method. The deferral is accomplished by returning this.

Parameters: