Yahoo! UI Library

Button  2.5.2

Yahoo! UI Library > button > YAHOO.widget.Button

Show Private Show Protected

Class YAHOO.widget.Button - extends YAHOO.util.Element

The Button class creates a rich, graphical button.

Constructor

YAHOO.widget.Button ( p_oElement , p_oAttributes )
Parameters:
p_oElement <String> String specifying the id attribute of the <input>, <button>, <a>, or <span> element to be used to create the button.
p_oElement <HTMLInputElement| HTMLButtonElement|HTMLElement> Object reference for the <input>, <button>, <a>, or <span> element to be used to create the button.
p_oElement <Object> Object literal specifying a set of configuration attributes used to create the button.
p_oAttributes <Object> Optional. Object literal specifying a set of configuration attributes used to create the button.

Properties

_activationButtonPressed - protected Boolean

Boolean indicating if the mouse button that toggles the button's "active" state has been pressed.
Default Value: false

_activationKeyPressed - protected Boolean

Boolean indicating if the key(s) that toggle the button's "active" state have been pressed.
Default Value: false

_button - protected HTMLAnchorElement|HTMLButtonElement

Object reference to the button's internal <a> or <button> element.
Default Value: null

_hasKeyEventHandlers - protected Boolean

Boolean indicating if the button's "blur", "keydown" and "keyup" event handlers are assigned
Default Value: false

_hasMouseEventHandlers - protected Boolean

Boolean indicating if the button's "mouseout," "mousedown," and "mouseup" event handlers are assigned
Default Value: false

_hiddenFields - protected HTMLInputElement|Array

Object reference to the <input> element, or array of HTML form elements used to represent the button when its parent form is submitted.
Default Value: null

_menu - protected {YAHOO.widget.Overlay| YAHOO.widget.Menu}

Object reference to the button's menu.
Default Value: null

_onclickAttributeValue - protected Object

Object reference to the button's current value for the "onclick" configuration attribute.
Default Value: null

ACTIVATION_KEYS - final Array

Array of numbers representing keys that (when presed) toggle the button's "active" state.
Default Value: [13, 32]

CHECK_ACTIVATION_KEYS - final Array

Array of numbers representing keys that (when pressed) toggle the button's "checked" attribute.
Default Value: [32]

CHECKBOX_CHECKED_TITLE - final String

String representing the title applied to buttons of type "checkbox" when checked.
Default Value: "Checked. Click to uncheck."

CHECKBOX_DEFAULT_TITLE - final String

String representing the default title applied to buttons of type "checkbox."
Default Value: "Unchecked. Click to check."

CSS_CLASS_NAME - final String

String representing the CSS class(es) to be applied to the button's root element.
Default Value: "yui-button"

MENUBUTTON_DEFAULT_TITLE - final String

String representing the default title applied to buttons of type "menu."
Default Value: "Menu collapsed. Click to expand."

MENUBUTTON_MENU_VISIBLE_TITLE - final String

String representing the title applied to buttons of type "menu" when the button's menu is visible.
Default Value: "Menu expanded. Click or press Esc to collapse."

NODE_NAME - final String

The name of the node to be used for the button's root element.
Default Value: "SPAN"

OPTION_AREA_WIDTH - final Number

Width (in pixels) of the area of a split button that when pressed will display a menu.
Default Value: 20

RADIO_CHECKED_TITLE - final String

String representing the title applied to buttons of type "radio" when checked.
Default Value: "Checked. Click another button to uncheck"

RADIO_DEFAULT_TITLE - final String

String representing the default title applied to buttons of type "radio."
Default Value: "Unchecked. Click to check."

SPLITBUTTON_DEFAULT_TITLE - final String

String representing the default title applied to buttons of type "split."
Default Value: "Menu collapsed. Click inside option region or press Ctrl + Shift + M to show the menu."

SPLITBUTTON_OPTION_VISIBLE_TITLE - final String

String representing the title applied to buttons of type "split" when the button's menu is visible.
Default Value: "Menu expanded. Press Esc or Ctrl + Shift + M to hide the menu."

SUBMIT_TITLE - final String

String representing the title applied to buttons of type "submit."
Default Value: "Click to submit form."

Properties inherited from YAHOO.util.Element:

DOM_EVENTS

Properties inherited from YAHOO.util.AttributeProvider:

_configs

Properties inherited from YAHOO.util.EventProvider:

__yui_events, __yui_subscribers

Methods

_addListenersToForm

protected void _addListenersToForm ( )
Adds event handlers to the button's form.
Returns: void

_hideMenu

protected void _hideMenu ( )
Hides the button's menu.
Returns: void

_isActivationKey

protected Boolean _isActivationKey ( p_nKeyCode )
Determines if the specified keycode is one that toggles the button's "active" state.
Parameters:
p_nKeyCode <Number> Number representing the keycode to be evaluated.
Returns: Boolean

_isSplitButtonOptionKey

protected Boolean _isSplitButtonOptionKey ( p_oEvent )
Determines if the specified keycode is one that toggles the display of the split button's menu.
Parameters:
p_oEvent <Event> Object representing the DOM event object passed back by the event utility (YAHOO.util.Event).
Returns: Boolean

_onAppendTo

protected void _onAppendTo ( p_oEvent )
"appendTo" event handler for the button.
Parameters:
p_oEvent <Event> Object representing the DOM event object passed back by the event utility (YAHOO.util.Event).
Returns: void

_onBlur

protected void _onBlur ( p_oEvent )
"blur" event handler for the button.
Parameters:
p_oEvent <Event> Object representing the DOM event object passed back by the event utility (YAHOO.util.Event).
Returns: void

_onClick

protected void _onClick ( p_oEvent )
"click" event handler for the button.
Parameters:
p_oEvent <Event> Object representing the DOM event object passed back by the event utility (YAHOO.util.Event).
Returns: void

_onDocumentKeyUp

protected void _onDocumentKeyUp ( p_oEvent )
"keyup" event handler for the document.
Parameters:
p_oEvent <Event> Object representing the DOM event object passed back by the event utility (YAHOO.util.Event).
Returns: void

_onDocumentMouseDown

protected void _onDocumentMouseDown ( p_oEvent )
"mousedown" event handler for the document.
Parameters:
p_oEvent <Event> Object representing the DOM event object passed back by the event utility (YAHOO.util.Event).
Returns: void

_onDocumentMouseUp

protected void _onDocumentMouseUp ( p_oEvent )
"mouseup" event handler for the button.
Parameters:
p_oEvent <Event> Object representing the DOM event object passed back by the event utility (YAHOO.util.Event).
Returns: void

_onFocus

protected void _onFocus ( p_oEvent )
"focus" event handler for the button.
Parameters:
p_oEvent <Event> Object representing the DOM event object passed back by the event utility (YAHOO.util.Event).
Returns: void

_onFormReset

protected void _onFormReset ( p_oEvent )
"reset" event handler for the button's form.
Parameters:
p_oEvent <Event> Object representing the DOM event object passed back by the event utility (YAHOO.util.Event).
Returns: void

_onKeyDown

protected void _onKeyDown ( p_oEvent )
"keydown" event handler for the button.
Parameters:
p_oEvent <Event> Object representing the DOM event object passed back by the event utility (YAHOO.util.Event).
Returns: void

_onKeyUp

protected void _onKeyUp ( p_oEvent )
"keyup" event handler for the button.
Parameters:
p_oEvent <Event> Object representing the DOM event object passed back by the event utility (YAHOO.util.Event).
Returns: void

_onMenuClick

private void _onMenuClick ( p_sType , p_aArgs )
"click" event handler for the button's menu.
Parameters:
p_sType <String> String representing the name of the event that was fired.
p_aArgs <Array> Array of arguments sent when the event was fired.
Returns: void

_onMenuHide

private void _onMenuHide ( p_sType )
"hide" event handler for the button's menu.
Parameters:
p_sType <String> String representing the name of the event that was fired.
Returns: void

_onMenuItemAdded

private void _onMenuItemAdded ( p_sType , p_aArgs , p_oItem )
"itemadded" event handler for the button's menu.
Parameters:
p_sType <String> String representing the name of the event that was fired.
p_aArgs <Array> Array of arguments sent when the event was fired.
p_oItem < YAHOO.widget.MenuItem> Object representing the menu item that subscribed to the event.
Returns: void

_onMenuItemSelected

private void _onMenuItemSelected ( p_sType , p_aArgs , p_oItem )
"selectedchange" event handler for each item in the button's menu.
Parameters:
p_sType <String> String representing the name of the event that was fired.
p_aArgs <Array> Array of arguments sent when the event was fired.
p_oItem <MenuItem> Object representing the menu item that subscribed to the event.
Returns: void

_onMenuKeyDown

private void _onMenuKeyDown ( p_sType , p_aArgs )
"keydown" event handler for the button's menu.
Parameters:
p_sType <String> String representing the name of the event that was fired.
p_aArgs <Array> Array of arguments sent when the event was fired.
Returns: void

_onMenuRender

private void _onMenuRender ( p_sType )
"render" event handler for the button's menu.
Parameters:
p_sType <String> String representing the name of the event thatwas fired.
Returns: void

_onMenuShow

private void _onMenuShow ( p_sType )
"show" event handler for the button's menu.
Parameters:
p_sType <String> String representing the name of the event that was fired.
Returns: void

_onMouseDown

protected void _onMouseDown ( p_oEvent )
"mousedown" event handler for the button.
Parameters:
p_oEvent <Event> Object representing the DOM event object passed back by the event utility (YAHOO.util.Event).
Returns: void

_onMouseOut

protected void _onMouseOut ( p_oEvent )
"mouseout" event handler for the button.
Parameters:
p_oEvent <Event> Object representing the DOM event object passed back by the event utility (YAHOO.util.Event).
Returns: void

_onMouseOver

protected void _onMouseOver ( p_oEvent )
"mouseover" event handler for the button.
Parameters:
p_oEvent <Event> Object representing the DOM event object passed back by the event utility (YAHOO.util.Event).
Returns: void

_onMouseUp

protected void _onMouseUp ( p_oEvent )
"mouseup" event handler for the button.
Parameters:
p_oEvent <Event> Object representing the DOM event object passed back by the event utility (YAHOO.util.Event).
Returns: void

_onOption

protected void _onOption ( p_oEvent )
"option" event handler for the button.
Parameters:
p_oEvent <Event> Object representing the DOM event object passed back by the event utility (YAHOO.util.Event).
Returns: void

_onOverlayBeforeShow

private void _onOverlayBeforeShow ( p_sType )
"beforeshow" event handler for the YAHOO.widget.Overlay instance serving as the button's menu.
Parameters:
p_sType <String> String representing the name of the event that was fired.
Returns: void

_setChecked

protected void _setChecked ( p_bChecked )
Sets the value of the button's "target" attribute.
Parameters:
p_bChecked <Boolean> Boolean indicating the value for the button's "checked" attribute.
Returns: void

_setDisabled

protected void _setDisabled ( p_bDisabled )
Sets the value of the button's "disabled" attribute.
Parameters:
p_bDisabled <Boolean> Boolean indicating the value for the button's "disabled" attribute.
Returns: void

_setHref

protected void _setHref ( p_sHref )
Sets the value of the button's "href" attribute.
Parameters:
p_sHref <String> String indicating the value for the button's "href" attribute.
Returns: void

_setLabel

protected void _setLabel ( p_sLabel )
Sets the value of the button's "label" attribute.
Parameters:
p_sLabel <String> String indicating the value for the button's "label" attribute.
Returns: void

_setMenu

protected void _setMenu ( p_oMenu )
Sets the value of the button's "menu" attribute.
Parameters:
p_oMenu <Object> Object indicating the value for the button's "menu" attribute.
Returns: void

_setOnClick

protected void _setOnClick ( p_oObject )
Sets the value of the button's "onclick" attribute.
Parameters:
p_oObject <Object> Object indicating the value for the button's "onclick" attribute.
Returns: void

_setSelectedMenuItem

protected void _setSelectedMenuItem ( p_nIndex )
Sets the value of the button's "selectedMenuItem" attribute.
Parameters:
p_nIndex <Number> Number representing the index of the item in the button's menu that is currently selected.
Returns: void

_setTabIndex

protected void _setTabIndex ( p_nTabIndex )
Sets the value of the button's "tabindex" attribute.
Parameters:
p_nTabIndex <Number> Number indicating the value for the button's "tabindex" attribute.
Returns: void

_setTarget

protected void _setTarget ( p_sTarget )
Sets the value of the button's "target" attribute.
Parameters:
p_sTarget <String> String indicating the value for the button's "target" attribute.
Returns: void

_setTitle

protected void _setTitle ( p_nTabIndex )
Sets the value of the button's "title" attribute.
Parameters:
p_nTabIndex <String> Number indicating the value for the button's "title" attribute.
Returns: void

_setType

protected void _setType ( p_sType )
Sets the value of the button's "type" attribute.
Parameters:
p_sType <String> String indicating the value for the button's "type" attribute.
Returns: void

_showMenu

protected void _showMenu ( p_oEvent )
Shows the button's menu.
Parameters:
p_oEvent <Event> Object representing the DOM event object passed back by the event utility (YAHOO.util.Event) that triggered the display of the menu.
Returns: void

addStateCSSClasses

void addStateCSSClasses ( )
Appends state-specific CSS classes to the button's root DOM element.
Returns: void

blur

void blur ( )
Causes the button to lose focus and fires the button's "blur" event.
Returns: void

createButtonElement

HTMLElement createButtonElement ( p_sType )
Creates the button's HTML elements.
Parameters:
p_sType <String> String indicating the type of element to create.
Returns: HTMLElement