Show:

Abstract class BaseCellEditor.

Constructor

A.BaseCellEditor

(
  • config
)

Parameters:

  • config Object

    Object literal specifying widget configuration properties.

Index

Methods

Methods

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

  • values Object

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

  • lazy Boolean

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

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

  • [lazyCfg] Object optional

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

_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>attribute name</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>attribute configuration</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_addShimResizeHandlers

() private

Sets up event listeners to resize the shim when the size of the Widget changes. <p> 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. </p>

_addStdModContent

(
  • node
  • children
  • where
)
private

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

    <p><p>The section Node to be updated.</p></p>

  • children Node | NodeList | String

    <p><p>The new content Node, NodeList or String to be added to section Node provided.</p></p>

  • where String

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

_afterAlignChange

(
  • e
)
protected

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

Parameters:

_afterAlignOnChange

(
  • e
)
protected

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

Parameters:

_afterBodyChange

(
  • e
)
protected

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

Parameters:

  • e EventFacade

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

_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>The event facade for the attribute change.</p></p></p></p></p></p></p></p></p></p></p>

_afterConstrainChange

(
  • e
)
protected

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

Parameters:

_afterFillHeightChange

(
  • e
)
protected

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

Parameters:

  • e EventFacade

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

_afterFooterChange

(
  • e
)
protected

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

Parameters:

  • e EventFacade

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

_afterHeaderChange

(
  • e
)
protected

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

Parameters:

  • e EventFacade

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

_afterRender

() protected

Fires after the render event. Initializes validation and toolbar.

_afterShimChange

(
  • e
)
protected

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

Parameters:

  • e EventFacade

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

_afterXYChange

(
  • e
)
protected

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

Parameters:

  • e EventFacade

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

_afterZIndexChange

(
  • e
)
protected

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

Parameters:

  • e EventFacade

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

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

Returns:

Object:

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

_applyParsedConfig

() Object protected

Returns:

Object:

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

_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>User configuration object (will be populated with values from Node)</p></p></p></p></p></p></p></p></p></p></p>

_applyStdModParsedConfig

() private

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

Attaches the alignment-syncing event handlers.

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

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

_bindUIInputTextControl

() protected

Bind the events on the InputTextControl UI. Lifecycle.

_bindUIPosAlign

() protected

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

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

_bindUIPosition

() protected

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

_bindUIStack

() protected

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

_bindUIStdMod

() protected

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

_clearInterval

() private

Clears the query interval

_clearSelection

() protected

When <a href="Autocomplete.html#config_forceSelection">forceSelection</a> is true and the user tries to leave the input element without selecting an item from the results, the user selection is cleared.

_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

_constrain

(
  • val
  • axis
  • nodeRegion
  • constrainingRegion
)
Number protected

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

Parameters:

  • val Number

    <p><p>The value to constrain</p></p>

  • axis String

    <p><p>The axis to use for constrainment</p></p>

  • nodeRegion Region

    <p><p>The region of the node to constrain</p></p>

  • constrainingRegion Region

    <p><p>The region of the node (or viewport) to constrain to</p></p>

Returns:

Number:

<p><p>The constrained value</p></p>

_constrainOnXYChange

(
  • e
)
protected

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

Parameters:

  • e EventFacade

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

_createEditor

(
  • config
)
Y.TabsDataEditor protected

Creates a Y.TabsDataEditor using the given configuration object, or a default configuration if none is given.

Parameters:

  • config Object

Returns:

Y.TabsDataEditor:

_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>String representing the name of the event</p></p></p></p></p></p></p></p></p></p></p>

_debounceVisibleChange

(
  • event
)
protected

Fires after the visibleChange event. Binds the mousedown event listener and keydown event listener for the escape key.

See: _onDocMouseDownExt and _onEscKey for details.

Parameters:

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

  • eventFastPath Boolean

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

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

_defCancelFn

(
  • event
)
protected

Default callback for the cancel event. Hides the A.BaseCellEditor.

Parameters:

_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>Event object</p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p></p>

_defInitEditFn

(
  • event
)
protected

Default callback for initEdit event of A.BaseCellEditor.

Parameters:

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

_defInitToolbarFn

(
  • event
)
protected

Default callback for the initToolbar event. Initializes the Toolbar using the config from the toolbar attribute.

Parameters:

_defInitValidatorFn

(
  • event
)
protected

Default callback for the initValidator event. Initializes the FormValidator using the config from the validator attribute.

Parameters:

_defRenderFn

(
  • e
  • parentNode
)
protected

Default render handler

Parameters:

  • e EventFacade

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

  • parentNode Node

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

_defSaveFn

(
  • event
)
protected

Default callback for the save event. Conditionally hides the A.BaseCellEditor based on the hideOnSave attribute.

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.

_destroyShim

() private

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

_destroyUIEvents

() private

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

_detachPosAlignUIHandles

() protected

Detaches the alignment-syncing event handlers.

_detachStackHandles

(
  • String
)
private

Detaches any handles stored for the provided key

Parameters:

  • String Object

    <p><p>handleKey The key defining the group of handles which should be detached</p></p>

_doAlign

(
  • xy
)
private

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

Parameters:

  • xy Array

    <p><p>XY page coordinates to align to.</p></p>

_enableConstraints

(
  • enable
)
private

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

    <p><p>Enable or disable constraints</p></p>

_enableIntervalDetection

() protected

Enables query interval detection for IME support.

_eraseStdMod

(
  • section
)
protected

Removes the DOM node for the given section.

Parameters:

  • section String

    <p><p>The section to remove. Either WidgetStdMod.HEADER, WidgetStdMod.BODY or WidgetStdMod.FOOTER.</p></p>

_extractQuery

(
  • query
)
String protected

Extracts the right most query from the delimited string in the input.

Parameters:

  • query String

    String to parse

Returns:

String:

_fillHeight

() private

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

Parameters:

  • allAttrs Object

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

  • userVals Object

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

Returns:

Object:

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

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

_findStdModSection

(
  • section
)
Node private

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

Parameters:

  • section String

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

Returns:

Node:

<p><p>The rendered node for the given section, or null if not found.</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>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>

  • subAttrName String

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

  • currVal Any

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

  • newVal Any

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

  • opts Object

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

  • [cfg] Object optional

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

_focus

() protected

Focuses the input element.

_getAlignedXY

(
  • [node]
  • points
)
Array protected

Returns Widget alignment coordinates realative to the given Node.

Parameters:

  • [node] Node | String | Null optional

    <p><p>The node to align to, or null to indicate the viewport.</p></p>

  • points Array

    <p><p>The alignment points.</p></p>

Returns:

Array:

<p><p>the coordinates.</p></p>

_getAlignToXY

(
  • 'Node'
  • [point]
  • 'Node'
  • 'Node'
)
Array private

Returns coordinates realative to the passed Node alignment.

Parameters:

  • 'Node' Node

    <p><p>The node to align to.</p></p>

  • [point] Array optional

    <p><p>The node alignment points.</p></p>

  • 'Node' Number

    <p><p>x coordinate.</p></p>

  • 'Node' Number

    <p><p>y coordinate.</p></p>

Returns:

Array:

<p><p>the coordinates.</p></p>

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

Returns:

Any:

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

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

Returns:

Object:

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

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

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

  • cfg Object

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

  • initValues Object

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

Returns:

Any:

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

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

Returns:

Object:

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

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

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

Returns:

String:

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

_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>HTML_PARSER definition for this instance</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>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>

Returns:

Object:

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

_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>The node reference to apply HTML_PARSER to.</p></p></p></p></p></p></p></p></p></p></p>

_getPreciseHeight

(
  • node
)
Number private

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

    <p><p>The node for which the precise height is required.</p></p>

Returns:

Number:

<p><p>The height of the Node including borders and padding, possibly a float.</p></p>

_getRegion

(
  • [node]
)
Object private

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

Parameters:

  • [node] Node optional

    <p><p>The node to get the region of.</p></p>

Returns:

Object:

<p><p>The node's region.</p></p>

_getShimTemplate

() Node private

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

Returns:

Node:

<p><p>node A new shim Node instance.</p></p>

_getSrcNode

() Node protected

Returns:

Node:

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

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

  • [cfg] Object optional

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

Returns:

Any:

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

_getStdModContent

(
  • section
)
Node private

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

Parameters:

  • section String

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

Returns:

Node:

<p><p>The child node collection of the standard module section.</p></p>

_getStdModTemplate

(
  • section
)
Node protected

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

Parameters:

  • section String

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

Returns:

Node:

<p><p>The new Node instance for the section</p></p>

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

_getX

() Number protected

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:

<p><p>The X page co-ordinate value</p></p>

_getY

() Number protected

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:

<p><p>The Y page co-ordinate value</p></p>

_guid

() protected

_handleCancelEvent

() protected

Fires the click event.

_handleEditEvent

() protected

Fires the edit event.

_handleInitEditEvent

() protected

Fires the initEdit event when the A.BaseCellEditor is rendered.

_handleInitToolbarEvent

() protected

Fires the initToolbar event when the A.BaseCellEditor is rendered and the toolbar is visible.

_handleInitValidatorEvent

() protected

Fires the initValidator event when the A.BaseCellEditor is rendered.

_handleSaveEvent

() protected

Fires the save event when the cell values are valid.

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

Returns:

Boolean:

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

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

  • values Object

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

  • lazy Boolean

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

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

  • values Object

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

  • lazy Boolean

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

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

_initEvents

() protected

publish() custom events during initializer.

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

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

_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>String representing the name of the event</p></p></p></p></p></p></p></p></p></p></p>

Returns:

String:

_insertStdModSection

(
  • contentBox
  • section
  • sectionNode
)
private

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

Parameters:

  • contentBox Node

    <p><p>A reference to the Widgets content box.</p></p>

  • section String

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

  • sectionNode Node

    <p><p>The Node for the section.</p></p>

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

Returns:

Boolean:

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

_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>String representing the name of the event</p></p></p></p></p></p></p></p></p></p></p>

Returns:

String:

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

_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>boundingBox id</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>'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>

  • eventType String | CustomEvent

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

  • o Object

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

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

Returns:

Object:

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

_onButtonMouseDown

(
  • event
)
protected

Called when the user mouses down on the button element in the combobox.

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>The event facade for the DOM focus event</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>The event facade for the DOM focus event</p></p></p></p></p></p></p></p></p></p></p>

_onDocMouseDownExt

(
  • event
)
protected

Fires after the visibleChange event binding the mousedown event.

Parameters:

_onEscKey

(
  • event
)
protected

Fires the keydown event listener for the esc key.

Parameters:

_onInterval

() protected

Enables the query to be triggered based on detecting text input via intervals instead of via key events.

_onSubmit

(
  • event
)
protected

Fires the submit event.

Parameters:

_onTextboxBlur

(
  • event
)
protected

Handles the input element losing focus.

Parameters:

_onTextboxFocus

(
  • event
)
protected

Handles the input element gaining focus.

Parameters:

_onTextboxKeyDown

(
  • event
)
protected

Handles the keydown events on the input element for functional keys.

Parameters:

_onTextboxKeyPress

(
  • event
)
protected

Handles the key press events of the input element.

Parameters:

_onTextboxKeyUp

(
  • event
)
protected

Handles the keyup events of the input element.

Parameters:

_parseStdModHTML

(
  • section
)
String private

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

Parameters:

  • section String

Returns:

String:

<p><p>Inner HTML string with the contents of the section</p></p>

_parseType

() private

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

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

Parameters:

  • srcNode Node

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

Returns:

Mixed:

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

_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>The full hash of statically defined ATTRS attributes being added for this instance</p></p></p></p></p></p></p></p></p></p></p>

  • userVals Object

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

  • lazy Boolean

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

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

_preventOverlap

(
  • val
  • axis
  • nodeRegion
  • constrainingRegion
)
Number protected

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

Parameters:

  • val Number

    <p><p>The value being constrain</p></p>

  • axis String

    <p><p>The axis to being constrained</p></p>

  • nodeRegion Region

    <p><p>The region of the node being constrained</p></p>

  • constrainingRegion Region

    <p><p>The region of the node (or viewport) we need to constrain to</p></p>

Returns:

Number:

<p><p>The constrained value</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>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>

Returns:

Object:

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

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

  • etOpts Object

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

  • ceOpts Object

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

Returns:

CustomEvent:

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

_removeLoadingClassNames

() protected

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

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

_renderBoxClassNames

() protected

Applies standard class names to the boundingBox and contentBox

_renderInput

() protected

Handles the rendering of the input element.

_renderShim

() private

Creates the shim element and adds it to the DOM

_renderShimDeferred

() private

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

_renderStdMod

(
  • section
)
Node protected

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

Parameters:

  • section String

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

Returns:

Node:

<p><p>A reference to the added section node</p></p>

_renderUI

() protected

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

_renderUIInputTextControl

() protected

Create the DOM structure for the InputTextControl. Lifecycle.

_renderUIPosition

() protected

Creates/Initializes the DOM to support xy page positioning. <p> This method in invoked after renderUI is invoked for the Widget class using YUI's aop infrastructure. </p>

_renderUIStack

() protected

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

_renderUIStdMod

() protected

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

_sendQuery

(
  • query
)
protected

Makes a query request to the data source.

Parameters:

  • query String

    The query string

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

  • val Any

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

  • [opts] Object optional

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

Returns:

Object:

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

_setAlignCenter

(
  • val
)
Boolean | Node protected

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

Parameters:

  • val Boolean | Node

    <p><p>The Attribute value being set.</p></p>

Returns:

Boolean | Node:

<p><p>the value passed in.</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>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>

  • value Any

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

  • [opts] Object optional

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

  • force Boolean

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

Returns:

Object:

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

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

  • [opts] Object optional

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

Returns:

Object:

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

_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>The attribute name.</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>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>

  • prevVal Any

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

  • newVal Any

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

  • [opts] Object optional

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

  • [attrCfg] Object optional

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

Returns:

Boolean:

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

_setBB

(
  • node
)
private

Setter for the boundingBox attribute

Parameters:

  • node Node | String

Returns:

<p><p><p><p><p><p><p><p><p><p><p>Node</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>The node's id attribute</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>The node reference</p></p></p></p></p></p></p></p></p></p></p>

  • template String

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

  • isBounding Boolean

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

Returns:

Node:

<p><p><p><p><p><p><p><p><p><p><p>The node</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>Node</p></p></p></p></p></p></p></p></p></p></p>

_setConstrain

(
  • val
)
protected

The setter implementation for the "constrain" attribute.

Parameters:

  • val Node | boolean

    <p><p>The attribute value</p></p>

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

  • value Any

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

_setToolbar

(
  • val
)
protected

Setter for Toolbar attribute.

Parameters:

  • val Object

_setValidator

(
  • val
)
protected

Setter for Validator attribute.

Parameters:

  • val Object

_setX

(
  • val
)
protected

Default setter for the X attribute. The setter passes the X value through to the XY attribute, which is the sole store for the XY state.

Parameters:

  • val Number

    <p><p>The X page co-ordinate value</p></p>

_setY

(
  • val
)
protected

Default setter for the Y attribute. The setter passes the Y value through to the XY attribute, which is the sole store for the XY state.

Parameters:

  • val Number

    <p><p>The Y page co-ordinate value</p></p>

_setZIndex

(
  • zIndex
)
Number protected

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

Parameters:

Returns:

Number:

<p><p>Normalized zIndex</p></p>

_simulateDrag

(
  • test
  • dragHandle
  • dropNode
  • above
)
protected

Simulates dragging an option on top of another.

Parameters:

  • test Y.Test.Case
  • dragHandle Node
  • dropNode Node
  • above Boolean

_simulateInputChange

(
  • input
  • text
  • callback
)
protected

Simulates a valuechange event for the given input.

Parameters:

  • input Node

    The input node to simulate the event for.

  • text String

    The text that should be set as the input's final value.

  • callback Function

    The function to be called when the simulation is done.

_simulateInputChange

(
  • input
  • text
  • callback
)
protected

Simulates a valuechange event for the given input.

Parameters:

  • input Node

    The input node to simulate the event for.

  • text String

    The text that should be set as the input's final value.

  • callback Function

    The function to be called when the simulation is done.

_simulateInputChange

(
  • input
  • text
  • callback
)
protected

Simulates a valuechange event for the given input.

Parameters:

  • input Node

    The input node to simulate the event for.

  • text String

    The text that should be set as the input's final value.

  • callback Function

    The function to be called when the simulation is done.

_strSetter

(
  • strings
)
String protected

The default setter for the strings attribute. Merges partial sets into the full string set, to allow users to partial sets of strings

Parameters:

  • strings Object

Returns:

String:

<p><p><p><p><p><p><p><p><p><p><p>The full set of strings to set</p></p></p></p></p></p></p></p></p></p></p>

_syncAttrUI

(
  • attrs
)
private

Invokes the _uiSet=ATTR NAME> method for the list of attributes provided

Parameters:

  • attrs Array

_syncElementsFocus

() protected

Syncs the element focus.

_syncElementsName

() protected

Syncs the name attribute of form input.

_syncFocus

() protected

Syncs the cell editor focus.

_syncUI

() protected

Updates the widget UI to reflect the attribute state.

_syncUIChild

() protected

Synchronizes the UI to match the WidgetChild state. <p> This method is invoked after bindUI is invoked for the Widget class using YUI's aop infrastructure. </p>

_syncUIPosAlign

() protected

Synchronizes the current align Attribute value to the DOM.

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

_syncUIPosition

() protected

Synchronizes the UI to match the Widgets xy page position state. <p> This method in invoked after syncUI is invoked for the Widget class using YUI's aop infrastructure. </p>

_syncUIStack

() protected

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

_syncUIStdMod

() protected

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

_typeAhead

(
  • elListItem
  • query
)
protected

Updates in the input element with the first result as the user types, selecting the text the user has not typed yet.

Parameters:

  • elListItem Node

    The selected list item

  • query String

    The query string

_uiSetAlign

(
  • [node]
  • points
)
protected

Updates the UI to reflect the align value passed in.

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

Parameters:

  • [node] Node | String | Null optional

    <p><p>The node to align to, or null to indicate the viewport.</p></p>

  • points Array

    <p><p>The alignment points.</p></p>

_uiSetChildSelected

(
  • selected
)
protected

Updates the UI to reflect the <code>selected</code> attribute value.

Parameters:

  • selected Number

    <p><p><p><p><p><p><p><p><p><p><p>The selected value to be reflected in the UI.</p></p></p></p></p></p></p></p></p></p></p>

_uiSetDim

(
  • dim
  • val
)
private

Parameters:

  • dim String

    <p><p><p><p><p><p><p><p><p><p><p>The dimension - "width" or "height"</p></p></p></p></p></p></p></p></p></p></p>

  • val Number | String

    <p><p><p><p><p><p><p><p><p><p><p>The value to set</p></p></p></p></p></p></p></p></p></p></p>

_uiSetDisabled

(
  • val
)
protected

Sets the disabled state for the UI

Parameters:

  • val Boolean

_uiSetEditable

(
  • val
)
protected

Syncs the name attribute of form input.

Parameters:

  • val Object