Print Friendly

Class YAHOO.widget.MenuItem

Package:YAHOO.widget
Class:MenuItem
Extends:Object
Subclasses:ContextMenuItem, MenuBarItem
Defined In:menu.js
Creates an item for a menu.

Public Properties

Property Defined By
  CHECKED_IMAGE_ALT_TEXT : String MenuItem
@description String representing the alt text for the image to be used for the checked image. @default "Checked." @final
  CHECKED_IMAGE_PATH : String MenuItem
@description String representing the path to the image to be used for the checked state. @default "nt/ic/ut/bsc/menuc...
  COLLAPSED_SUBMENU_INDICATOR_ALT_TEXT : String MenuItem
@description String representing the alt text for the image to be used for the submenu arrow indicator. @default "Col...
  CSS_CLASS_NAME : String MenuItem
@description String representing the CSS class(es) to be applied to the <li> element of the menu item. @defau...
  DISABLED_CHECKED_IMAGE_ALT_TEXT : String MenuItem
@description String representing the alt text for the image to be used for the checked image when the item is disable...
  DISABLED_CHECKED_IMAGE_PATH : String MenuItem
@description String representing the path to the image to be used for the disabled checked state. @default "nt/ic/ut/...
  DISABLED_SUBMENU_INDICATOR_ALT_TEXT : String MenuItem
@description String representing the alt text for the image to be used for the submenu arrow indicator when the menu ...
  DISABLED_SUBMENU_INDICATOR_IMAGE_PATH : String MenuItem
@description String representing the path to the image to be used for the submenu arrow indicator when the menu item ...
  EXPANDED_SUBMENU_INDICATOR_ALT_TEXT : String MenuItem
@description String representing the alt text for the image to be used for the submenu arrow indicator when the subme...
  IMG_ROOT : String MenuItem
@description String representing the prefix path to use for non-secure images. @default "http://us.i1.yimg.com/us.yim...
  IMG_ROOT_SSL : String MenuItem
@description String representing the prefix path to use for securely served images. @default "https://a248.e.akamai.n...
  SELECTED_CHECKED_IMAGE_PATH : String MenuItem
@description String representing the path to the image to be used for the selected checked state. @default "nt/ic/ut/...
  SELECTED_SUBMENU_INDICATOR_IMAGE_PATH : String MenuItem
@description String representing the path to the image to be used for the submenu arrow indicator when the menu item ...
  SUBMENU_INDICATOR_IMAGE_PATH : String MenuItem
@description String representing the path to the image to be used for the menu item's submenu arrow indicator. @defau...
  SUBMENU_TYPE : YAHOO.widget.Menu MenuItem
@description Object representing the type of menu to instantiate and add when parsing the child nodes of the menu ite...
  browser : String MenuItem
@description String representing the browser.
  configHelpText : String| MenuItem
@config helptext @description String specifying additional instructional text to accompany the text for the nenu item...
  configSubmenu : Menu|String|Object| MenuItem
@config submenu @description Object specifying the submenu to be appended to the menu item. The value can be one of ...
  constructor : YAHOO.widget.MenuItem MenuItem
@description Object reference to the menu item's constructor function. @default YAHOO.widget.MenuItem
  element : MenuItem
@description Object reference to the menu item's <li> element. @default HTMLLIElement
  groupIndex : Number MenuItem
@description Number indicating the index of the group to which the menu item belongs. @default null
  imageRoot : String MenuItem
@description String representing the root path for all of the menu item's images.
  index : Number MenuItem
@description Number indicating the ordinal position of the menu item in its group. @default null
  isSecure : Boolean MenuItem
@description Boolean representing whether or not the current browsing context is secure (HTTPS).
  parent : YAHOO.widget.Menu MenuItem
@description Object reference to the menu item's parent menu. @default null
  srcElement : MenuItem
@description Object reference to the HTML element (either <li>, <optgroup> or <option>) used ...
  submenuIndicator : MenuItem
@description Object reference to the <img> element used to create the submenu indicator for the menu item. @d...
  value : Object MenuItem
@description Object reference to the menu item's value. @default null

Public Methods

Method Defined By
  MenuItem() MenuItem
  blur() : void MenuItem
@description Causes the menu item to lose focus and fires the onblur event.
  configChecked(String p_sType, Array p_aArgs, YAHOO.widget.MenuItem p_oItem) : void MenuItem
@description Event handler for when the "checked" configuration property of the menu item changes.
  configDisabled(String p_sType, Array p_aArgs, YAHOO.widget.MenuItem p_oItem) : void MenuItem
@description Event handler for when the "disabled" configuration property of the menu item changes.
  configEmphasis(String p_sType, Array p_aArgs, YAHOO.widget.MenuItem p_oItem) : void MenuItem
@description Event handler for when the "emphasis" configuration property of the menu item changes.
  configHelpText(String p_sType, Array p_aArgs, YAHOO.widget.MenuItem p_oItem) : void MenuItem
@description Event handler for when the "helptext" configuration property of the menu item changes.
  configSelected(String p_sType, Array p_aArgs, YAHOO.widget.MenuItem p_oItem) : void MenuItem
@description Event handler for when the "selected" configuration property of the menu item changes.
  configStrongEmphasis(String p_sType, Array p_aArgs, YAHOO.widget.MenuItem p_oItem) : void MenuItem
@description Event handler for when the "strongemphasis" configuration property of the menu item changes.
  configSubmenu(String p_sType, Array p_aArgs, YAHOO.widget.MenuItem p_oItem) : void MenuItem
@description Event handler for when the "submenu" configuration property of the menu item changes.
  configTarget(String p_sType, Array p_aArgs, YAHOO.widget.MenuItem p_oItem) : void MenuItem
@description Event handler for when the "target" configuration property of the menu item changes.
  configText(String p_sType, Array p_aArgs, YAHOO.widget.MenuItem p_oItem) : void MenuItem
@description Event handler for when the "text" configuration property of the menu item changes.
  configURL(String p_sType, Array p_aArgs, YAHOO.widget.MenuItem p_oItem) : void MenuItem
@description Event handler for when the "url" configuration property of the menu item changes.
  destroy() : void MenuItem
@description Removes the menu item's <li> element from its parent <ul> element.
  focus() : void MenuItem
@description Causes the menu item to receive the focus and fires the focus event.
  getNextEnabledSibling() : YAHOO.widget.MenuItem MenuItem
@description Finds the menu item's next enabled sibling.
  getPreviousEnabledSibling() : YAHOO.widget.MenuItem MenuItem
@description Finds the menu item's previous enabled sibling.
  init(String p_oObject, , MenuItem
@description The MenuItem class's initialization method. This method is automatically called by the constructor, and ...
  initDefaultConfig() : void MenuItem
@description Initializes an item's configurable properties.
  toString() : String MenuItem
@description Returns a string representing the menu item.

Public Events

Event Defined By
  blurEvent : () MenuItem
@description Fires when the menu item loses the input focus.
  clickEvent : () MenuItem
@description Fires when the user clicks the on the menu item. Passes back the DOM Event object as an argument.
  destroyEvent : () MenuItem
@description Fires when the menu item's <li> element is removed from its parent <ul> element.
  focusEvent : () MenuItem
@description Fires when the menu item receives focus.
  keyDownEvent : () MenuItem
@description Fires when the user presses a key when the menu item has focus. Passes back the DOM Event object as an ...
  keyPressEvent : () MenuItem
@description Fires when the user presses an alphanumeric key when the menu item has focus. Passes back the DOM Event...
  keyUpEvent : () MenuItem
@description Fires when the user releases a key when the menu item has focus. Passes back the DOM Event object as an...
  mouseDownEvent : () MenuItem
@description Fires when the user mouses down on the menu item. Passes back the DOM Event object as an argument.
  mouseOutEvent : () MenuItem
@description Fires when the mouse has left the menu item. Passes back the DOM Event object as an argument.
  mouseOverEvent : () MenuItem
@description Fires when the mouse has entered the menu item. Passes back the DOM Event object as an argument.
  mouseUpEvent : () MenuItem
@description Fires when the user releases a mouse button while the mouse is over the menu item. Passes back the DOM ...

Property Details

CHECKED_IMAGE_ALT_TEXT

public String CHECKED_IMAGE_ALT_TEXT
@description String representing the alt text for the image to be used for the checked image. @default "Checked." @final
This property is defined by MenuItem.

CHECKED_IMAGE_PATH

public String CHECKED_IMAGE_PATH
@description String representing the path to the image to be used for the checked state. @default "nt/ic/ut/bsc/menuchk8_nrm_1.gif" @final
This property is defined by MenuItem.

COLLAPSED_SUBMENU_INDICATOR_ALT_TEXT

public String COLLAPSED_SUBMENU_INDICATOR_ALT_TEXT
@description String representing the alt text for the image to be used for the submenu arrow indicator. @default "Collapsed. Click to expand." @final
This property is defined by MenuItem.

CSS_CLASS_NAME

public String CSS_CLASS_NAME
@description String representing the CSS class(es) to be applied to the <li> element of the menu item. @default "yuimenuitem" @final
This property is defined by MenuItem.

DISABLED_CHECKED_IMAGE_ALT_TEXT

public String DISABLED_CHECKED_IMAGE_ALT_TEXT
@description String representing the alt text for the image to be used for the checked image when the item is disabled. @default "Checked. (Item disabled.)" @final
This property is defined by MenuItem.

DISABLED_CHECKED_IMAGE_PATH

public String DISABLED_CHECKED_IMAGE_PATH
@description String representing the path to the image to be used for the disabled checked state. @default "nt/ic/ut/bsc/menuchk8_dim_1.gif" @final
This property is defined by MenuItem.

DISABLED_SUBMENU_INDICATOR_ALT_TEXT

public String DISABLED_SUBMENU_INDICATOR_ALT_TEXT
@description String representing the alt text for the image to be used for the submenu arrow indicator when the menu item is disabled. @default "Disabled." @final
This property is defined by MenuItem.

DISABLED_SUBMENU_INDICATOR_IMAGE_PATH

public String DISABLED_SUBMENU_INDICATOR_IMAGE_PATH
@description String representing the path to the image to be used for the submenu arrow indicator when the menu item is disabled. @default "nt/ic/ut/alt1/menuarorght8_dim_1.gif" @final
This property is defined by MenuItem.

EXPANDED_SUBMENU_INDICATOR_ALT_TEXT

public String EXPANDED_SUBMENU_INDICATOR_ALT_TEXT
@description String representing the alt text for the image to be used for the submenu arrow indicator when the submenu is visible. @default "Expanded. Click to collapse." @final
This property is defined by MenuItem.

IMG_ROOT

public String IMG_ROOT
@description String representing the prefix path to use for non-secure images. @default "http://us.i1.yimg.com/us.yimg.com/i/"
This property is defined by MenuItem.

IMG_ROOT_SSL

public String IMG_ROOT_SSL
@description String representing the prefix path to use for securely served images. @default "https://a248.e.akamai.net/sec.yimg.com/i/"
This property is defined by MenuItem.

SELECTED_CHECKED_IMAGE_PATH

public String SELECTED_CHECKED_IMAGE_PATH
@description String representing the path to the image to be used for the selected checked state. @default "nt/ic/ut/bsc/menuchk8_hov_1.gif" @final
This property is defined by MenuItem.

SELECTED_SUBMENU_INDICATOR_IMAGE_PATH

public String SELECTED_SUBMENU_INDICATOR_IMAGE_PATH
@description String representing the path to the image to be used for the submenu arrow indicator when the menu item is selected. @default "nt/ic/ut/alt1/menuarorght8_hov_1.gif" @final
This property is defined by MenuItem.

SUBMENU_INDICATOR_IMAGE_PATH

public String SUBMENU_INDICATOR_IMAGE_PATH
@description String representing the path to the image to be used for the menu item's submenu arrow indicator. @default "nt/ic/ut/alt1/menuarorght8_nrm_1.gif" @final
This property is defined by MenuItem.

SUBMENU_TYPE

public YAHOO.widget.Menu SUBMENU_TYPE
@description Object representing the type of menu to instantiate and add when parsing the child nodes of the menu item's source HTML element. @final
This property is defined by MenuItem.

browser

public String browser
@description String representing the browser.
This property is defined by MenuItem.

configSubmenu

public Menu|String|Object|
This property is defined by MenuItem.

constructor

public YAHOO.widget.MenuItem constructor
@description Object reference to the menu item's constructor function. @default YAHOO.widget.MenuItem
This property is defined by MenuItem.

groupIndex

public Number groupIndex
@description Number indicating the index of the group to which the menu item belongs. @default null
This property is defined by MenuItem.

imageRoot

public String imageRoot
@description String representing the root path for all of the menu item's images.
This property is defined by MenuItem.

index

public Number index
@description Number indicating the ordinal position of the menu item in its group. @default null
This property is defined by MenuItem.

isSecure

public Boolean isSecure
@description Boolean representing whether or not the current browsing context is secure (HTTPS).
This property is defined by MenuItem.

parent

public YAHOO.widget.Menu parent
@description Object reference to the menu item's parent menu. @default null
This property is defined by MenuItem.

value

public Object value
@description Object reference to the menu item's value. @default null
This property is defined by MenuItem.

Constructor Details

MenuItem

public function MenuItem()
Parameters:
  • None.

Method Details

blur

public function blur()
@description Causes the menu item to lose focus and fires the onblur event.
Parameters:
  • None.
Returns:
  • void
This method is defined by MenuItem.

configChecked

public function configChecked(String p_sType, Array p_aArgs, YAHOO.widget.MenuItem p_oItem)
@description Event handler for when the "checked" configuration property of the menu item changes.
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 fired the event.
Returns:
  • void
This method is defined by MenuItem.

configDisabled

public function configDisabled(String p_sType, Array p_aArgs, YAHOO.widget.MenuItem p_oItem)
@description Event handler for when the "disabled" configuration property of the menu item changes.
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 fired the event.
Returns:
  • void
This method is defined by MenuItem.

configEmphasis

public function configEmphasis(String p_sType, Array p_aArgs, YAHOO.widget.MenuItem p_oItem)
@description Event handler for when the "emphasis" configuration property of the menu item changes.
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 fired the event.
Returns:
  • void
This method is defined by MenuItem.

configHelpText

public function configHelpText(String p_sType, Array p_aArgs, YAHOO.widget.MenuItem p_oItem)
@description Event handler for when the "helptext" configuration property of the menu item changes.
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 fired the event.
Returns:
  • void
This method is defined by MenuItem.

configSelected

public function configSelected(String p_sType, Array p_aArgs, YAHOO.widget.MenuItem p_oItem)
@description Event handler for when the "selected" configuration property of the menu item changes.
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 fired the event.
Returns:
  • void
This method is defined by MenuItem.

configStrongEmphasis

public function configStrongEmphasis(String p_sType, Array p_aArgs, YAHOO.widget.MenuItem p_oItem)
@description Event handler for when the "strongemphasis" configuration property of the menu item changes.
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 fired the event.
Returns:
  • void
This method is defined by MenuItem.

configSubmenu

public function configSubmenu(String p_sType, Array p_aArgs, YAHOO.widget.MenuItem p_oItem)
@description Event handler for when the "submenu" configuration property of the menu item changes.
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 fired the event.
Returns:
  • void
This method is defined by MenuItem.

configTarget

public function configTarget(String p_sType, Array p_aArgs, YAHOO.widget.MenuItem p_oItem)
@description Event handler for when the "target" configuration property of the menu item changes.
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 fired the event.
Returns:
  • void
This method is defined by MenuItem.

configText

public function configText(String p_sType, Array p_aArgs, YAHOO.widget.MenuItem p_oItem)
@description Event handler for when the "text" configuration property of the menu item changes.
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 fired the event.
Returns:
  • void
This method is defined by MenuItem.

configURL

public function configURL(String p_sType, Array p_aArgs, YAHOO.widget.MenuItem p_oItem)
@description Event handler for when the "url" configuration property of the menu item changes.
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 fired the event.
Returns:
  • void
This method is defined by MenuItem.

destroy

public function destroy()
@description Removes the menu item's <li> element from its parent <ul> element.
Parameters:
  • None.
Returns:
  • void
This method is defined by MenuItem.

focus

public function focus()
@description Causes the menu item to receive the focus and fires the focus event.
Parameters:
  • None.
Returns:
  • void
This method is defined by MenuItem.

getNextEnabledSibling

public function getNextEnabledSibling()
@description Finds the menu item's next enabled sibling.
Parameters:
  • None.
Returns:
  • YAHOO.widget.MenuItem
This method is defined by MenuItem.

getPreviousEnabledSibling

public function getPreviousEnabledSibling()
@description Finds the menu item's previous enabled sibling.
Parameters:
  • None.
Returns:
  • YAHOO.widget.MenuItem
This method is defined by MenuItem.

init

public function init(String p_oObject, , @description The MenuItem class's initialization method. This method is automatically called by the constructor, and sets up all DOM references for pre-existing markup, and creates required markup if it is not already present.
  • href="http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929/level- : one-html.html#ID-38450247">HTMLOptGroupElement} p_oObject Object specifying the <optgroup> element of the menu item.
  • href="http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929/level- : one-html.html#ID-70901257">HTMLOptionElement} p_oObject Object specifying the <option> element of the menu item.
  • p_oConfig : Object
    Optional. Object literal specifying the configuration for the menu item. See configuration class documentation for more details.
  • Returns:
    • void
    This method is defined by MenuItem.

    initDefaultConfig

    public function initDefaultConfig()
    @description Initializes an item's configurable properties.
    Parameters:
    • None.
    Returns:
    • void
    This method is defined by MenuItem.

    toString

    public function toString()
    @description Returns a string representing the menu item.
    Parameters:
    • None.
    Returns:
    • String
    This method is defined by MenuItem.

    Event Details

    blurEvent

    public event blurEvent
    @description Fires when the menu item loses the input focus.
    Subscribers will be called with the following parameters:
    • None.
    This event is defined by MenuItem.

    clickEvent

    public event clickEvent
    @description Fires when the user clicks the on the menu item. Passes back the DOM Event object as an argument.
    Subscribers will be called with the following parameters:
    • None.
    This event is defined by MenuItem.

    destroyEvent

    public event destroyEvent
    @description Fires when the menu item's <li> element is removed from its parent <ul> element.
    Subscribers will be called with the following parameters:
    • None.
    This event is defined by MenuItem.

    focusEvent

    public event focusEvent
    @description Fires when the menu item receives focus.
    Subscribers will be called with the following parameters:
    • None.
    This event is defined by MenuItem.

    keyDownEvent

    public event keyDownEvent
    @description Fires when the user presses a key when the menu item has focus. Passes back the DOM Event object as an argument.
    Subscribers will be called with the following parameters:
    • None.
    This event is defined by MenuItem.

    keyPressEvent

    public event keyPressEvent
    @description Fires when the user presses an alphanumeric key when the menu item has focus. Passes back the DOM Event object as an argument.
    Subscribers will be called with the following parameters:
    • None.
    This event is defined by MenuItem.

    keyUpEvent

    public event keyUpEvent
    @description Fires when the user releases a key when the menu item has focus. Passes back the DOM Event object as an argument.
    Subscribers will be called with the following parameters:
    • None.
    This event is defined by MenuItem.

    mouseDownEvent

    public event mouseDownEvent
    @description Fires when the user mouses down on the menu item. Passes back the DOM Event object as an argument.
    Subscribers will be called with the following parameters:
    • None.
    This event is defined by MenuItem.

    mouseOutEvent

    public event mouseOutEvent
    @description Fires when the mouse has left the menu item. Passes back the DOM Event object as an argument.
    Subscribers will be called with the following parameters:
    • None.
    This event is defined by MenuItem.

    mouseOverEvent

    public event mouseOverEvent
    @description Fires when the mouse has entered the menu item. Passes back the DOM Event object as an argument.
    Subscribers will be called with the following parameters:
    • None.
    This event is defined by MenuItem.

    mouseUpEvent

    public event mouseUpEvent
    @description Fires when the user releases a mouse button while the mouse is over the menu item. Passes back the DOM Event object as an argument.
    Subscribers will be called with the following parameters:
    • None.
    This event is defined by MenuItem.

    Copyright © 2006 Jack Slocum. All rights reserved.