Javascript for Episerver 7.5 cms

AnchorSelectionEditor (constructor)

Location

epi-cms/form/AnchorSelectionEditor

Extends

Properties

_aroundNode

The node to display the popup around. Can be set via a data-dojo-attach-point assignment. If missing, then domNode will be used.

_arrowWrapperNode

Will set CSS class dijitUpArrow, dijitDownArrow, dijitRightArrow etc. on this node depending on where the drop down is set to be positioned. Can be set via a data-dojo-attach-point assignment. If missing, then _buttonNode will be used.

_attrPairNames

_blankGif

Path to a blank 1x1 image. Used by <img> nodes in templates that really get their image via CSS background-image.

_buttonInputDisabled

_buttonNode

The button/icon/node to click to display the drop down. Can be set via a data-dojo-attach-point assignment. If missing, then either focusNode or domNode (if focusNode is also missing) will be used.

_childrenLoaded

Whether or not our children have been loaded

_earlyTemplatedStartup

A fallback to preserve the 1.0 - 1.3 behavior of children in templates having their startup called before the parent widget fires postCreate. Defaults to 'false', causing child widgets to have their .startup() called immediately before a parent widget .startup(), but always after the parent .postCreate(). Set to 'true' to re-enable to previous, arguably broken, behavior.

_focusManager

_isLoaded

Whether or not we have been loaded

_popupStateNode

The node to set the popupActive class on. Can be set via a data-dojo-attach-point assignment. If missing, then focusNode or _buttonNode (if focusNode is missing) will be used.

_setClassAttr

_setDirAttr

_setIdAttr

_setLangAttr

_setTabIndexAttr

_setTypeAttr

_skipNodeCache

_started

startup() has completed.

_stopClickEvents

When set to false, the click events will not be stopped, in case you want to use them in your subclass

active

True if mouse was pressed while over this widget, and hasn't been released yet

actualValue

alt

Corresponds to the native HTML <input> element's attribute.

aria-label

attributeMap

Deprecated. Instead of attributeMap, widget should have a _setXXXAttr attribute for each XXX attribute to be mapped to the DOM.

attributeMap sets up a "binding" between attributes (aka properties) of the widget and the widget's DOM. Changes to widget attributes listed in attributeMap will be reflected into the DOM.

For example, calling set('title', 'hello') on a TitlePane will automatically cause the TitlePane's DOM to update with the new title.

attributeMap is a hash where the key is an attribute of the widget, and the value reflects a binding to a:

  • DOM node attribute

    focus: {node: "focusNode", type: "attribute"} Maps this.focus to this.focusNode.focus

  • DOM node innerHTML

    title: { node: "titleNode", type: "innerHTML" } Maps this.title to this.titleNode.innerHTML

  • DOM node innerText

    title: { node: "titleNode", type: "innerText" } Maps this.title to this.titleNode.innerText

  • DOM node CSS class

    myClass: { node: "domNode", type: "class" } Maps this.myClass to this.domNode.className

If the value is an array, then each element in the array matches one of the formats of the above list.

There are also some shorthands for backwards compatibility:

  • string --> { node: string, type: "attribute" }, for example:
"focusNode" ---> { node: "focusNode", type: "attribute" }
  • "" --> { node: "domNode", type: "attribute" }

autoWidth

Set to true to make the drop down at least as wide as this widget. Set to false if the drop down should just be its default width

baseClass

This class name is applied to the widget's domNode and also may be used to generate names for sub nodes, for example dijitTabContainer-content.

class

containerNode

Designates where children of the source DOM node will be placed. "Children" in this case refers to both DOM nodes and widgets. For example, for myWidget:

<div data-dojo-type=myWidget>
    <b> here's a plain DOM node
    <span data-dojo-type=subWidget>and a widget</span>
    <i> and another plain DOM node </i>
</div>

containerNode would point to:

<b> here's a plain DOM node
<span data-dojo-type=subWidget>and a widget</span>
<i> and another plain DOM node </i>

In templated widgets, "containerNode" is set via a data-dojo-attach-point assignment.

containerNode must be defined for any widget that accepts innerHTML (like ContentPane or BorderContainer or even Button), and conversely is null for widgets that don't, like TextBox.

cssStateNodes

List of sub-nodes within the widget that need CSS classes applied on mouse hover/press and focus

Each entry in the hash is a an attachpoint names (like "upArrowButton") mapped to a CSS class names (like "dijitUpArrowButton"). Example:

{
    "upArrowButton": "dijitUpArrowButton",
    "downArrowButton": "dijitDownArrowButton"
}

The above will set the CSS class dijitUpArrowButton to the this.upArrowButton DOMNode when it

is hovered, etc.

dir

Bi-directional support, as defined by the HTML DIR attribute. Either left-to-right "ltr" or right-to-left "rtl". If undefined, widgets renders in page's default direction.

disabled

Should this widget respond to user input? In markup, this is specified as "disabled='disabled'", or just "disabled".

dndType

Defines a type of widget.

domNode

This is our visible representation of the widget! Other DOM Nodes may by assigned to other properties, usually through the template system's data-dojo-attach-point syntax, but the domNode property is the canonical "top level" node in widget UI.

dropDown

The widget to display as a popup. This widget must be defined before the startup function is called.

dropDownPosition

This variable controls the position of the drop down. It's an array of strings with the following values:

  • before: places drop down to the left of the target node/widget, or to the right in the case of RTL scripts like Hebrew and Arabic
  • after: places drop down to the right of the target node/widget, or to the left in the case of RTL scripts like Hebrew and Arabic
  • above: drop down goes above target node
  • below: drop down goes below target node

The list is positions is tried, in order, until a position is found where the drop down fits within the viewport.

emptyLabel

What to display in an "empty" dropdown

focused

This widget or a widget it contains has focus, or is "active" because it was recently clicked.

forceWidth

Set to true to make the drop down exactly as wide as this widget. Overrides autoWidth.

hovering

True if cursor is over this widget

id

A unique, opaque ID string that can be assigned by users or by the system. If the developer passes an ID which is known not to be unique, the specified ID is ignored and the system-generated ID is used instead.

intermediateChanges

Fires onChange for each value change or only on demand

isLayoutContainer

Indicates that this widget is going to call resize() on its children widgets, setting their size, when they become visible.

labelAttr

The entries in the drop down list come from this attribute in the dojo.store items. If store is set, labelAttr must be set too, unless store is an old-style dojo.data store rather than a new dojo/store.

lang

Rarely used. Overrides the default Dojo locale used to render this widget, as defined by the HTML LANG attribute. Value must be among the list of locales specified during by the Dojo bootstrap, formatted according to RFC 3066 (like en-us).

loadChildrenOnOpen

By default loadChildren is called when the items are fetched from the store. This property allows delaying loadChildren (and the creation of the options/menuitems) until the user clicks the button to open the dropdown.

maxHeight

message

Currently displayed error/prompt message

missingMessage

Message which is displayed when required is true and value is empty.

multiple

Whether or not we are multi-valued

name

Name used when submitting form; same as "name" attribute or plain HTML elements

onFetch

A callback to do with an onFetch - but before any items are actually iterated over (i.e. to filter even further what you want to add)

onLoadDeferred

This is the dojo.Deferred returned by setStore(). Calling onLoadDeferred.then() registers your callback to be called only once, when the prior setStore completes.

options

The set of options for our select item. Roughly corresponds to the html <option> tag.

ownerDocument

The document this widget belongs to. If not specified to constructor, will default to srcNodeRef.ownerDocument, or if no sourceRef specified, then to dojo/_base/window::doc

query

A query to use when fetching items from our store

queryOptions

Query options to use when fetching from the store

readOnly

Should this widget respond to user input? In markup, this is specified as "readOnly". Similar to disabled except readOnly form values are submitted.

required

Can be true or false, default is false.

scrollOnFocus

On focus, should this widget scroll into view?

sortByLabel

Flag to sort the options returned from a store by the label of the store.

srcNodeRef

pointer to original DOM node

state

"Incomplete" if this select is required but unset (i.e. blank value), "" otherwise

store

A store to use for getting our list of options - rather than reading them from the <option> html tags. Should support getIdentity(). For back-compat store can also be a dojo/data/api/Identity.

style

HTML style attributes as cssText string or name/value hash

tabIndex

Order fields are traversed when user hits the tab key

templatePath

Path to template (HTML file) for this widget relative to dojo.baseUrl. Deprecated: use templateString with require([... "dojo/text!..."], ...) instead

templateString

textDir

Bi-directional support, the main variable which is responsible for the direction of the text. The text direction can be different than the GUI direction by using this parameter in creation of a widget.

Allowed values:

  1. "ltr"
  2. "rtl"
  3. "auto" - contextual the direction of a text defined by first strong letter.

By default is as the page direction.

title

HTML title attribute.

For form widgets this specifies a tooltip to display when hovering over the widget (just like the native HTML title attribute).

For TitlePane or for when this widget is a child of a TabContainer, AccordionContainer, etc., it's used to specify the tab label, accordion pane title, etc.

tooltip

When this widget's title attribute is used to for a tab label, accordion pane title, etc., this specifies the tooltip to appear when the mouse is hovered over that text.

tooltipPosition

See description of dijit/Tooltip.defaultPosition for details on this parameter.

type

Corresponds to the native HTML <input> element's attribute.

value

Methods

public inherited method _addOptionForItem ( item )

Creates (and adds) the option for the given item

Parameters

public inherited method _addOptionItem ( option )

For the given option, add an option to our dropdown. If the option doesn't have a value, then a separator is added in that place.

Parameters

public inherited method _beforeFillContent ( )


public inherited method _changeAttrValue ( name , value )

Internal helper for directly changing an attribute value.

Parameters

public inherited method _cssMouseEvent ( event )

Handler for CSS event on this.domNode. Sets hovering and active properties depending on mouse state, which triggers _setStateClass() to set appropriate CSS classes for this.domNode.

Parameters

public inherited method _fillContent ( )

Set the value to be the first, or the selected index


public inherited method _get ( name , names )

Private function that does a get based off a hash of names

Parameters

public inherited method _getChildren ( )


public inherited method _getDisplayedValueAttr ( )

returns the displayed value of the widget


public inherited method _getMenuItemForOption ( option )

For the given option, return the menu item that should be used to display it.

Parameters

public inherited method _getOptionObjForItem ( item )

Returns an option object based off the given item. The "value" of the option item will be the identity of the item, the "label" of the option will be the label of the item.

Parameters

public inherited method _getSelectedOptionsAttr ( )

hooks into this.attr to provide a mechanism for getting the option items for the current value of the widget.


public inherited method _getValueFromOpts ( )

Returns the value of the widget by reading the options for the selected flag.


public inherited method _layoutHackIE7 ( )

Work around table sizing bugs on IE7 by forcing redraw


public inherited method _loadChildren ( loadMenuItems )

Resets the menu and the length attribute of the button - and ensures that the label is appropriately set.

Parameters

public method _onBlur ( )

This is where widgets do processing for when they stop being active, such as changing CSS classes. See onBlur() for more details.


public inherited method _onDeleteItem ( item )

Parameters

public inherited method _onDropDownClick ( e )

Parameters

public inherited method _onDropDownMouseDown ( e )

Callback when the user mousedown's on the arrow icon

Parameters

public inherited method _onDropDownMouseUp ( e )

Callback when the user lifts their mouse after mouse down on the arrow icon. If the drop down is a simple menu and the mouse is over the menu, we execute it, otherwise, we focus our drop down widget. If the event is missing, then we are not a mouseup event.

This is useful for the common mouse movement pattern with native browser <select> nodes:

  1. mouse down on the select node (probably on the arrow)
  2. move mouse to a menu item while holding down the mouse button
  3. mouse up. this selects the menu item as though the user had clicked it.
Parameters

public method _onFocus ( )

This is where widgets do processing for when they start being active, such as changing CSS classes. See onFocus() for more details.


public inherited method _onKey ( e )

Callback when the user presses a key while focused on the button node

Parameters

public inherited method _onKeyDown ( e )

Parameters

public inherited method _onKeyUp ( )


public inherited method _onMap ( type )

Maps on() type parameter (ex: "mousemove") to method name (ex: "onMouseMove"). If type is a synthetic event like touch.press then returns undefined.

Parameters

public inherited method _onNewItem ( item , parentInfo )

Parameters

public inherited method _onSetItem ( item )

Parameters

public inherited method _onShow ( )

Internal method called when this widget is made visible. See onShow for details.


public inherited method _pseudoLoadChildren ( items )

a function that will "fake" loading children, if needed, and if we have set to not load children until the widget opens.

Parameters

public inherited method _refreshState ( )


public inherited method _removeOptionItem ( option )

User-overridable function which, for the given option, removes its item from the select.

Parameters

public inherited method _set ( name , value )

Helper function to set new value for specified attribute, and call handlers registered with watch() if the value has changed.

Parameters

public inherited method _setDisabledAttr ( value )

Parameters

public inherited method _setDisplay ( newDisplay )

sets the display for the given value (or values)

Parameters

public inherited method _setFocusedAttr ( val )

Parameters

public inherited method _setOptionsAttr ( options )

Parameters

public inherited method _setOwnerDocumentAttr ( val )

Parameters

public inherited method _setReadOnlyAttr ( value )

Parameters

public inherited method _setRequiredAttr ( value )

Parameters

public inherited method _setSelectionsAttr ( newSelections )

Parameters

public inherited method _setStateClass ( )

Update the visual state of the widget by setting the css classes on this.domNode (or this.stateNode if defined) by combining this.baseClass with various suffixes that represent the current widget state(s).


public inherited method _setStyleAttr ( value )

Sets the style attribute of the widget according to value, which is either a hash like {height: "5px", width: "3px"} or a plain string

Parameters

public inherited method _setupChild ( child )

Common setup for initial children and children which are added after startup

Parameters

public inherited method _setValueAttr ( value , priorityChange )

Set the value of the widget. If a non-object is passed, then we set our value from looking it up.

Parameters

public inherited method _subnodeCssMouseEvent ( node , clazz , evt )

Handler for hover/active mouse event on widget's subnode

Parameters

public inherited method _trackMouseState ( node , clazz )

Track mouse/focus events on specified node and set CSS class on that node to indicate current state. Usually not called directly, but via cssStateNodes attribute.

Parameters

public inherited method _updateSelection ( )

Sets the "selected" class on the item for styling purposes.


public inherited method addChild ( child , insertIndex )

Parameters

public inherited method addOption ( option )

Adds an option or options to the end of the select. If value of the option is empty or missing, a separator is created instead. Passing in an array of options will yield slightly better performance since the children are only loaded once.

Parameters

public inherited method applyTextDir ( element , text )

The function overridden in the _BidiSupport module, originally used for setting element.dir according to this.textDir. In this case does nothing.

Parameters

public inherited method attr ( name , value )

Set or get properties on a widget instance.

Parameters

public inherited method buildRendering ( )


public inherited method closeDropDown ( )


public inherited method compare ( val1 , val2 )

Compare 2 values (as returned by get('value') for this widget).

Parameters

public inherited method connect ( obj , event , method )

Deprecated, will be removed in 2.0, use this.own(on(...)) or this.own(aspect.after(...)) instead.

Connects specified obj/event to specified method of this object and registers for disconnect() on widget destroy.

Provide widget-specific analog to dojo.connect, except with the implicit use of this widget as the target object. Events connected with this.connect are disconnected upon destruction.

Parameters
Examples
var btn = new Button();
// when foo.bar() is called, call the listener we're going to
// provide in the scope of btn
btn.connect(foo, "bar", function(){
    console.debug(this.toString());
});

public inherited method constructor ( params , srcNodeRef )

Create the widget.

Parameters

public inherited method defer ( fcn , delay )

Wrapper to setTimeout to avoid deferred functions executing after the originating widget has been destroyed. Returns an object handle with a remove method (that returns null) (replaces clearTimeout).

Parameters

public inherited method destroy ( preserveDom )

Destroy this widget, but not its descendants. This method will, however, destroy internal widgets such as those used within a template.

Parameters

public inherited method destroyDescendants ( preserveDom )

Recursively destroy the children of this widget and their descendants.

Parameters

public inherited method destroyRecursive ( preserveDom )

Destroy this widget and its descendants

Parameters

public inherited method destroyRendering ( preserveDom )

Destroys the DOM nodes associated with this widget

Parameters

public inherited method disconnect ( handle )

Deprecated, will be removed in 2.0, use handle.remove() instead.

Disconnects handle created by connect.

Parameters

public inherited method displayMessage ( _8 )

Parameters

public inherited method emit ( type , eventObj , callbackArgs )

Used by widgets to signal that a synthetic event occurred, ex:

myWidget.emit("attrmodified-selectedChildWidget", {}).

Emits an event on this.domNode named type.toLowerCase(), based on eventObj. Also calls onType() method, if present, and returns value from that method. By default passes eventObj to callback, but will pass callbackArgs instead, if specified. Modifies eventObj by adding missing parameters (bubbles, cancelable, widget).

Parameters

public inherited method focus ( )

Put focus on this widget


public inherited method get ( name )

Get a property from a widget.

Parameters

public inherited method getChildren ( )

Returns all the widgets contained by this, i.e., all widgets underneath this.containerNode. Does not return nested widgets, nor widgets that are part of this widget's template.


public inherited method getDescendants ( )

Returns all the widgets contained by this, i.e., all widgets underneath this.containerNode. This method should generally be avoided as it returns widgets declared in templates, which are supposed to be internal/hidden, but it's left here for back-compat reasons.


public inherited method getErrorMessage ( _a )

Parameters

public inherited method getIndexInParent ( )

Returns the index of this widget within its container parent. It returns -1 if the parent does not exist, or if the parent is not a dijit._Container


public inherited method getIndexOfChild ( child )

Gets the index of the child in this container or -1 if not found

Parameters

public inherited method getNextSibling ( )

Returns null if this is the last child of the parent, otherwise returns the next element sibling to the "right".


public inherited method getOptions ( valueOrIdx )

Returns a given option (or options).

Parameters

public inherited method getParent ( )

Returns the parent widget of this widget


public inherited method getPreviousSibling ( )

Returns null if this is the first child of the parent, otherwise returns the next element sibling to the "left".


public inherited method getTextDir ( text , originalDir )

Return direction of the text. The function overridden in the _BidiSupport module, its main purpose is to calculate the direction of the text, if was defined by the programmer through textDir.

Parameters

public inherited method getValue ( )

Deprecated. Use get('value') instead.


public inherited method hasChildren ( )

Returns true if widget has child widgets, i.e. if this.containerNode contains widgets.


public inherited method isFocusable ( )

Return true if this widget can currently be focused and false if not


public inherited method isLeftToRight ( )

Return this widget's explicit or implicit orientation (true for LTR, false for RTL)


public inherited method isLoaded ( )


public method isValid ( )

Overidden base class for validate function


public inherited method layout ( )


public inherited method loadAndOpenDropDown ( )

Creates the drop down if it doesn't exist, loads the data if there's an href and it hasn't been loaded yet, and then opens the drop down. This is basically a callback when the user presses the down arrow button to open the drop down.


public inherited method loadDropDown ( loadCallback )

populates the menu

Parameters

public inherited method on ( type , func )

Parameters

public inherited method onBlur ( )

Called when the widget stops being "active" because focus moved to something outside of it, or the user clicked somewhere outside of it, or the widget was hidden.


public inherited method onChange ( newValue )

Callback when this widget's value is changed.

Parameters

public inherited method onClick ( event )

Connect to this function to receive notifications of mouse click events.

Parameters

public inherited method onClose ( )

Called when this widget is being displayed as a popup (ex: a Calendar popped up from a DateTextBox), and it is hidden. This is called from the dijit.popup code, and should not be called directly.

Also used as a parameter for children of dijit/layout/StackContainer or subclasses. Callback if a user tries to close the child. Child will be closed if this function returns true.


public inherited method onDblClick ( event )

Connect to this function to receive notifications of mouse double click events.

Parameters

public inherited method onFocus ( )

Called when the widget becomes "active" because it or a widget inside of it either has focus, or has recently been clicked.


public inherited method onHide ( )

Called when another widget becomes the selected pane in a dijit/layout/TabContainer, dijit/layout/StackContainer, dijit/layout/AccordionContainer, etc.

Also called to indicate hide of a dijit.Dialog, dijit.TooltipDialog, or dijit.TitlePane.


public inherited method onKeyDown ( event )

Connect to this function to receive notifications of keys being pressed down.

Parameters

public inherited method onKeyPress ( event )

Connect to this function to receive notifications of printable keys being typed.

Parameters

public inherited method onKeyUp ( event )

Connect to this function to receive notifications of keys being released.

Parameters

public inherited method onLayoutChanged ( )


public inherited method onMouseDown ( event )

Connect to this function to receive notifications of when the mouse button is pressed down.

Parameters

public inherited method onMouseEnter ( event )

Connect to this function to receive notifications of when the mouse moves onto this widget.

Parameters

public inherited method onMouseLeave ( event )

Connect to this function to receive notifications of when the mouse moves off of this widget.

Parameters

public inherited method onMouseMove ( event )

Connect to this function to receive notifications of when the mouse moves over nodes contained within this widget.

Parameters

public inherited method onMouseOut ( event )

Connect to this function to receive notifications of when the mouse moves off of nodes contained within this widget.

Parameters

public inherited method onMouseOver ( event )

Connect to this function to receive notifications of when the mouse moves onto nodes contained within this widget.

Parameters

public inherited method onMouseUp ( event )

Connect to this function to receive notifications of when the mouse button is released.

Parameters

public inherited method onSetStore ( )

a function that can be connected to in order to receive a notification that the store has finished loading and all options from that store are available


public inherited method onShow ( )

Called when this widget becomes the selected pane in a dijit/layout/TabContainer, dijit/layout/StackContainer, dijit/layout/AccordionContainer, etc.

Also called to indicate display of a dijit.Dialog, dijit.TooltipDialog, or dijit.TitlePane.


public inherited method openDropDown ( )

Opens the dropdown for this widget. To be called only when this.dropDown has been created and is ready to display (ie, it's data is loaded).


public inherited method own ( )

Track specified handles and remove/destroy them when this instance is destroyed, unless they were already removed/destroyed manually.


public inherited method placeAt ( reference , position )

Place this widget somewhere in the DOM based on standard domConstruct.place() conventions.

Parameters
Examples
// create a Button with no srcNodeRef, and place it in the body:
var button = new Button({ label:"click" }).placeAt(win.body());
// now, 'button' is still the widget reference to the newly created button
button.on("click", function(e){ console.log('click'); }));
// create a button out of a node with id="src" and append it to id="wrapper":
var button = new Button({},"src").placeAt("wrapper");
// place a new button as the first element of some div
var button = new Button({ label:"click" }).placeAt("wrapper","first");
// create a contentpane and add it to a TabContainer
var tc = dijit.byId("myTabs");
new ContentPane({ href:"foo.html", title:"Wow!" }).placeAt(tc)

public inherited method postCreate ( )


public inherited method postMixInProperties ( )

Set options based on the selections passed through.


public inherited method removeChild ( child )

Parameters

public inherited method removeOption ( valueOrIdx )

Removes the given option or options. You can remove by string (in which case the value is removed), number (in which case the index in the options array is removed), or select option (in which case, the select option with a matching value is removed). You can also pass in an array of those values for a slightly better performance since the children are only loaded once.

Parameters

public inherited method reset ( )

Overridden so that the state will be cleared.


public inherited method resize ( changeSize , resultSize )

Call this to resize a widget, or after its size has changed.

Parameters

public inherited method set ( name , value )

Set a property on a widget

Parameters

public inherited method setAttribute ( attr , value )

Deprecated. Use set() instead.

Parameters

public inherited method setDisabled ( disabled )

Deprecated. Use set('disabled', ...) instead.

Parameters

public inherited method setStore ( store , selectedValue , fetchArgs )

Sets the store you would like to use with this select widget. The selected value is the value of the new store to set. This function returns the original store, in case you want to reuse it or something.

Parameters

public inherited method setValue ( value )

Deprecated. Use set('value', ...) instead.

Parameters

public inherited method startup ( )

Called after all the widgets have been instantiated and their dom nodes have been inserted somewhere under win.doc.body.

Widgets should override this method to do any initialization dependent on other widgets existing, and then call this superclass method to finish things off.

startup() in subclasses shouldn't do anything size related because the size of the widget hasn't been set yet.


public inherited method subscribe ( t , method )

Deprecated, will be removed in 2.0, use this.own(topic.subscribe()) instead.

Subscribes to the specified topic and calls the specified method of this object and registers for unsubscribe() on widget destroy.

Provide widget-specific analog to dojo.subscribe, except with the implicit use of this widget as the target object.

Parameters
Examples
var btn = new Button();
// when /my/topic is published, this button changes its label to
// be the parameter of the topic.
btn.subscribe("/my/topic", function(v){
    this.set("label", v);
});

public inherited method toggleDropDown ( )

Callback when the user presses the down arrow button or presses the down arrow key to open/close the drop down. Toggle the drop-down widget; if it is up, close it, if not, open it


public inherited method toString ( )

Returns a string that represents the widget


public inherited method undo ( )

Restore the value to the last value passed to onChange


public inherited method uninitialize ( )

Deprecated. Override destroy() instead to implement custom widget tear-down behavior.


public inherited method unsubscribe ( handle )

Deprecated, will be removed in 2.0, use handle.remove() instead.

Unsubscribes handle created by this.subscribe. Also removes handle from this widget's list of subscriptions

Parameters

public inherited method updateOption ( newOption )

Updates the values of the given option. The option to update is matched based on the value of the entered option. Passing in an array of new options will yield better performance since the children will only be loaded once.

Parameters

public inherited method validate ( isFocused )

Called by oninit, onblur, and onkeypress, and whenever required/disabled state changes

Parameters

public method validator ( value , flags )

Validate the value is match with anchor type.

Parameters

public inherited method watch ( name , callback )

Watches a property for changes

Parameters