API: menu menuitem.js (YUI Library)

# Yahoo! UI Library

### Menu 2.2.2

Yahoo! UI Library > menu > menuitem.js (source view)

    (function() {

    var Dom = YAHOO.util.Dom,
        Module = YAHOO.widget.Module,
        Menu = YAHOO.widget.Menu,
        CustomEvent = YAHOO.util.CustomEvent,
        Lang = YAHOO.lang;

    /**
    * Creates an item for a menu.
    *
    * @param {String} p_oObject String specifying the text of the menu item.
    * @param {<a href="http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929/level-
    * one-html.html#ID-74680021">HTMLLIElement</a>} p_oObject Object specifying
    * the <code>&#60;li&#62;</code> element of the menu item.
    * @param {<a href="http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929/level-
    * one-html.html#ID-38450247">HTMLOptGroupElement</a>} p_oObject Object
    * specifying the <code>&#60;optgroup&#62;</code> element of the menu item.
    * @param {<a href="http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929/level-
    * one-html.html#ID-70901257">HTMLOptionElement</a>} p_oObject Object
    * specifying the <code>&#60;option&#62;</code> element of the menu item.
    * @param {Object} p_oConfig Optional. Object literal specifying the
    * configuration for the menu item. See configuration class documentation
    * for more details.
    * @class MenuItem
    * @constructor
    */
    YAHOO.widget.MenuItem = function(p_oObject, p_oConfig) {

        if(p_oObject) {

            if(p_oConfig) {

                this.parent = p_oConfig.parent;
                this.value = p_oConfig.value;
                this.id = p_oConfig.id;

            }

            this.init(p_oObject, p_oConfig);

        }

    };

    /**
    * Constant representing the name of the MenuItem's events
    * @property YAHOO.widget.MenuItem._EVENT_TYPES
    * @private
    * @final
    * @type Object
    */
    YAHOO.widget.MenuItem._EVENT_TYPES = {

        "MOUSE_OVER": "mouseover",
        "MOUSE_OUT": "mouseout",
        "MOUSE_DOWN": "mousedown",
        "MOUSE_UP": "mouseup",
        "CLICK": "click",
        "KEY_PRESS": "keypress",
        "KEY_DOWN": "keydown",
        "KEY_UP": "keyup",
        "ITEM_ADDED": "itemAdded",
        "ITEM_REMOVED": "itemRemoved",
        "FOCUS": "focus",
        "BLUR": "blur",
        "DESTROY": "destroy"

    };

    /**
    * Constant representing the MenuItem's configuration properties
    * @property YAHOO.widget.MenuItem._DEFAULT_CONFIG
    * @private
    * @final
    * @type Object
    */
    YAHOO.widget.MenuItem._DEFAULT_CONFIG = {

        "TEXT": {
            key: "text",
            value: "",
            validator: Lang.isString,
            suppressEvent: true
        },

        "HELP_TEXT": {
            key: "helptext"
        },

        "URL": {
            key: "url",
            value: "#",
            suppressEvent: true
        },

        "TARGET": {
            key: "target",
            suppressEvent: true
        },

        "EMPHASIS": {
            key: "emphasis",
            value: false,
            validator: Lang.isBoolean,
            suppressEvent: true
        },

        "STRONG_EMPHASIS": {
            key: "strongemphasis",
            value: false,
            validator: Lang.isBoolean,
            suppressEvent: true
        },

        "CHECKED": {
            key: "checked",
            value: false,
            validator: Lang.isBoolean,
            suppressEvent: true,
            supercedes:["disabled"]
        },

        "DISABLED": {
            key: "disabled",
            value: false,
            validator: Lang.isBoolean,
            suppressEvent: true
        },

        "SELECTED": {
            key: "selected",
            value: false,
            validator: Lang.isBoolean,
            suppressEvent: true
        },

        "SUBMENU": {
            key: "submenu"
        },

        "ONCLICK": {
            key: "onclick"
        },

        "CLASS_NAME": {
            key: "classname",
            value: null,
            validator: Lang.isString
        }

    };

    YAHOO.widget.MenuItem.prototype = {

        // Constants

        /**
        * @property COLLAPSED_SUBMENU_INDICATOR_TEXT
        * @description String representing the text for the <code>&#60;em&#62;</code>
        * element used for the submenu arrow indicator.
        * @default "Submenu collapsed.  Click to expand submenu."
        * @final
        * @type String
        */
        COLLAPSED_SUBMENU_INDICATOR_TEXT:
            "Submenu collapsed.  Click to expand submenu.",

        /**
        * @property EXPANDED_SUBMENU_INDICATOR_TEXT
        * @description String representing the text for the submenu arrow indicator
        * element (<code>&#60;em&#62;</code>) when the submenu is visible.
        * @default "Submenu expanded.  Click to collapse submenu."
        * @final
        * @type String
        */
        EXPANDED_SUBMENU_INDICATOR_TEXT:
            "Submenu expanded.  Click to collapse submenu.",

        /**
        * @property DISABLED_SUBMENU_INDICATOR_TEXT
        * @description String representing the text for the submenu arrow indicator
        * element (<code>&#60;em&#62;</code>) when the menu item is disabled.
        * @default "Submenu collapsed.  (Item disabled.)."
        * @final
        * @type String
        */
        DISABLED_SUBMENU_INDICATOR_TEXT: "Submenu collapsed.  (Item disabled.)",

        /**
        * @property CHECKED_TEXT
        * @description String representing the text to be used for the checked
        * indicator element (<code>&#60;em&#62;</code>).
        * @default "Checked."
        * @final
        * @type String
        */
        CHECKED_TEXT: "Menu item checked.",

        /**
        * @property DISABLED_CHECKED_TEXT
        * @description String representing the text to be used for the checked
        * indicator element (<code>&#60;em&#62;</code>) when the menu item
        * is disabled.
        * @default "Checked. (Item disabled.)"
        * @final
        * @type String
        */
        DISABLED_CHECKED_TEXT: "Checked. (Item disabled.)",

        /**
        * @property CSS_CLASS_NAME
        * @description String representing the CSS class(es) to be applied to the
        * <code>&#60;li&#62;</code> element of the menu item.
        * @default "yuimenuitem"
        * @final
        * @type String
        */
        CSS_CLASS_NAME: "yuimenuitem",

        /**
        * @property 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
        * @type YAHOO.widget.Menu
        */
        SUBMENU_TYPE: null,

        // Private member variables

        /**
        * @property _oAnchor
        * @description Object reference to the menu item's
        * <code>&#60;a&#62;</code> element.
        * @default null
        * @private
        * @type <a href="http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929/level-
        * one-html.html#ID-48250443">HTMLAnchorElement</a>
        */
        _oAnchor: null,

        /**
        * @property _oText
        * @description Object reference to the menu item's text node.
        * @default null
        * @private
        * @type TextNode
        */
        _oText: null,

        /**
        * @property _oHelpTextEM
        * @description Object reference to the menu item's help text
        * <code>&#60;em&#62;</code> element.
        * @default null
        * @private
        * @type <a href="http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929/level-
        * one-html.html#ID-58190037">HTMLElement</a>
        */
        _oHelpTextEM: null,

        /**
        * @property _oSubmenu
        * @description Object reference to the menu item's submenu.
        * @default null
        * @private
        * @type YAHOO.widget.Menu
        */
        _oSubmenu: null,

        /**
        * @property _oCheckedIndicator
        * @description Object reference to the menu item's checkmark image.
        * @default <a href="http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929/
        * level-one-html.html#ID-58190037">HTMLElement</a>
        * @private
        * @type <a href="http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929/
        * level-one-html.html#ID-58190037">HTMLElement</a>
        */
        _oCheckedIndicator: null,

        /**
        * @property _oOnclickAttributeValue
        * @description Object reference to the menu item's current value for the
        * "onclick" configuration attribute.
        * @default null
        * @private
        * @type Object
        */
        _oOnclickAttributeValue: null,

        /**
        * @property _sClassName
        * @description The current value of the "classname" configuration attribute.
        * @default null
        * @private
        * @type String
        */
        _sClassName: null,

        // Public properties

    	/**
        * @property constructor
    	* @description Object reference to the menu item's constructor function.
        * @default YAHOO.widget.MenuItem
    	* @type YAHOO.widget.MenuItem
    	*/
    	constructor: YAHOO.widget.MenuItem,

        /**
        * @property index
        * @description Number indicating the ordinal position of the menu item in
        * its group.
        * @default null
        * @type Number
        */
        index: null,

        /**
        * @property groupIndex
        * @description Number indicating the index of the group to which the menu
        * item belongs.
        * @default null
        * @type Number
        */
        groupIndex: null,

        /**
        * @property parent
        * @description Object reference to the menu item's parent menu.
        * @default null
        * @type YAHOO.widget.Menu
        */
        parent: null,

        /**
        * @property element
        * @description Object reference to the menu item's
        * <code>&#60;li&#62;</code> element.
        * @default <a href="http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929/level
        * -one-html.html#ID-74680021">HTMLLIElement</a>
        * @type <a href="http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929/level-
        * one-html.html#ID-74680021">HTMLLIElement</a>
        */
        element: null,

        /**
        * @property srcElement
        * @description Object reference to the HTML element (either
        * <code>&#60;li&#62;</code>, <code>&#60;optgroup&#62;</code> or
        * <code>&#60;option&#62;</code>) used create the menu item.
        * @default <a href="http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929/
        * level-one-html.html#ID-74680021">HTMLLIElement</a>|<a href="http://www.
        * w3.org/TR/2000/WD-DOM-Level-1-20000929/level-one-html.html#ID-38450247"
        * >HTMLOptGroupElement</a>|<a href="http://www.w3.org/TR/2000/WD-DOM-
        * Level-1-20000929/level-one-html.html#ID-70901257">HTMLOptionElement</a>
        * @type <a href="http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929/level-
        * one-html.html#ID-74680021">HTMLLIElement</a>|<a href="http://www.w3.
        * org/TR/2000/WD-DOM-Level-1-20000929/level-one-html.html#ID-38450247">
        * HTMLOptGroupElement</a>|<a href="http://www.w3.org/TR/2000/WD-DOM-
        * Level-1-20000929/level-one-html.html#ID-70901257">HTMLOptionElement</a>
        */
        srcElement: null,

        /**
        * @property value
        * @description Object reference to the menu item's value.
        * @default null
        * @type Object
        */
        value: null,

        /**
        * @property submenuIndicator
        * @description Object reference to the <code>&#60;em&#62;</code> element
        * used to create the submenu indicator for the menu item.
        * @default <a href="http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929/
        * level-one-html.html#ID-58190037">HTMLElement</a>
        * @type <a href="http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929/
        * level-one-html.html#ID-58190037">HTMLElement</a>
        */
        submenuIndicator: null,

    	/**
        * @property browser
    	* @description String representing the browser.
    	* @type String
    	*/
    	browser: Module.prototype.browser,

        /**
        * @property id
        * @description Id of the menu item's root <code>&#60;li&#62;</code>
        * element.  This property should be set via the constructor using the
        * configuration object literal.  If an id is not specified, then one will
        * be created using the "generateId" method of the Dom utility.
        * @default null
        * @type String
        */
        id: null,

        // Events

        /**
        * @event destroyEvent
        * @description Fires when the menu item's <code>&#60;li&#62;</code>
        * element is removed from its parent <code>&#60;ul&#62;</code> element.
        * @type YAHOO.util.CustomEvent
        */
        destroyEvent: null,

        /**
        * @event mouseOverEvent
        * @description Fires when the mouse has entered the menu item.  Passes
        * back the DOM Event object as an argument.
        * @type YAHOO.util.CustomEvent
        */
        mouseOverEvent: null,

        /**
        * @event mouseOutEvent
        * @description Fires when the mouse has left the menu item.  Passes back
        * the DOM Event object as an argument.
        * @type YAHOO.util.CustomEvent
        */
        mouseOutEvent: null,

        /**
        * @event mouseDownEvent
        * @description Fires when the user mouses down on the menu item.  Passes
        * back the DOM Event object as an argument.
        * @type YAHOO.util.CustomEvent
        */
        mouseDownEvent: null,

        /**
        * @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.
        * @type YAHOO.util.CustomEvent
        */
        mouseUpEvent: null,

        /**
        * @event clickEvent
        * @description Fires when the user clicks the on the menu item.  Passes
        * back the DOM Event object as an argument.
        * @type YAHOO.util.CustomEvent
        */
        clickEvent: null,

        /**
        * @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.
        * @type YAHOO.util.CustomEvent
        */
        keyPressEvent: null,

        /**
        * @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.
        * @type YAHOO.util.CustomEvent
        */
        keyDownEvent: null,

        /**
        * @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.
        * @type YAHOO.util.CustomEvent
        */
        keyUpEvent: null,

        /**
        * @event focusEvent
        * @description Fires when the menu item receives focus.
        * @type YAHOO.util.CustomEvent
        */
        focusEvent: null,

        /**
        * @event blurEvent
        * @description Fires when the menu item loses the input focus.
        * @type YAHOO.util.CustomEvent
        */
        blurEvent: null,

        /**
        * @method init
        * @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.
        * @param {String} p_oObject String specifying the text of the menu item.
        * @param {<a href="http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929/level-
        * one-html.html#ID-74680021">HTMLLIElement</a>} p_oObject Object specifying
        * the <code>&#60;li&#62;</code> element of the menu item.
        * @param {<a href="http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929/level-
        * one-html.html#ID-38450247">HTMLOptGroupElement</a>} p_oObject Object
        * specifying the <code>&#60;optgroup&#62;</code> element of the menu item.
        * @param {<a href="http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929/level-
        * one-html.html#ID-70901257">HTMLOptionElement</a>} p_oObject Object
        * specifying the <code>&#60;option&#62;</code> element of the menu item.
        * @param {Object} p_oConfig Optional. Object literal specifying the
        * configuration for the menu item. See configuration class documentation
        * for more details.
        */
        init: function(p_oObject, p_oConfig) {

            if(!this.SUBMENU_TYPE) {

                this.SUBMENU_TYPE = Menu;

            }

            // Create the config object

            this.cfg = new YAHOO.util.Config(this);

            this.initDefaultConfig();

            var oConfig = this.cfg;

            if(Lang.isString(p_oObject)) {

                this._createRootNodeStructure();

                oConfig.setProperty("text", p_oObject);

            }
            else if(this._checkDOMNode(p_oObject)) {

                switch(p_oObject.tagName.toUpperCase()) {

                    case "OPTION":

                        this._createRootNodeStructure();

                        oConfig.setProperty("text", p_oObject.text);

                        this.srcElement = p_oObject;

                    break;

                    case "OPTGROUP":

                        this._createRootNodeStructure();

                        oConfig.setProperty("text", p_oObject.label);

                        this.srcElement = p_oObject;

                        this._initSubTree();

                    break;

                    case "LI":

                        // Get the anchor node (if it exists)

                        var oAnchor = this._getFirstElement(p_oObject, "A"),
                            sURL = "#",
                            sTarget,
                            sText;

                        // Capture the "text" and/or the "URL"

                        if(oAnchor) {

                            sURL = oAnchor.getAttribute("href");
                            sTarget = oAnchor.getAttribute("target");

                            if(oAnchor.innerText) {

                                sText = oAnchor.innerText;

                            }
                            else {

                                var oRange = oAnchor.ownerDocument.createRange();

                                oRange.selectNodeContents(oAnchor);

                                sText = oRange.toString();

                            }

                        }
                        else {

                            var oText = p_oObject.firstChild;

                            sText = oText.nodeValue;

                            oAnchor = document.createElement("a");

                            oAnchor.setAttribute("href", sURL);

                            p_oObject.replaceChild(oAnchor, oText);

                            oAnchor.appendChild(oText);

                        }

                        this.srcElement = p_oObject;
                        this.element = p_oObject;
                        this._oAnchor = oAnchor;

                        // Check if emphasis has been applied to the MenuItem

                        var oEmphasisNode = this._getFirstElement(oAnchor),
                            bEmphasis = false,
                            bStrongEmphasis = false;

                        if(oEmphasisNode) {

                            // Set a reference to the text node

                            this._oText = oEmphasisNode.firstChild;

                            switch(oEmphasisNode.tagName.toUpperCase()) {

                                case "EM":

                                    bEmphasis = true;

                                break;

                                case "STRONG":

                                    bStrongEmphasis = true;

                                break;

                            }

                        }
                        else {

                            // Set a reference to the text node

                            this._oText = oAnchor.firstChild;

                        }

                        /*
                            Set these properties silently to sync up the
                            configuration object without making changes to the
                            element's DOM
                        */

                        oConfig.setProperty("text", sText, true);
                        oConfig.setProperty("url", sURL, true);
                        oConfig.setProperty("target", sTarget, true);
                        oConfig.setProperty("emphasis", bEmphasis, true);
                        oConfig.setProperty(
                            "strongemphasis",
                            bStrongEmphasis,
                            true
                        );

                        this._initSubTree();

                    break;

                }

            }

            if(this.element) {

                var sId = this.element.id;

                if(!sId) {

                    sId = this.id || Dom.generateId();

                    this.element.id = sId;

                }

                this.id = sId;

                Dom.addClass(this.element, this.CSS_CLASS_NAME);

                // Create custom events

                var EVENT_TYPES = YAHOO.widget.MenuItem._EVENT_TYPES;

                this.mouseOverEvent = new CustomEvent(EVENT_TYPES.MOUSE_OVER, this);
                this.mouseOutEvent = new CustomEvent(EVENT_TYPES.MOUSE_OUT, this);
                this.mouseDownEvent = new CustomEvent(EVENT_TYPES.MOUSE_DOWN, this);
                this.mouseUpEvent = new CustomEvent(EVENT_TYPES.MOUSE_UP, this);
                this.clickEvent = new CustomEvent(EVENT_TYPES.CLICK, this);
                this.keyPressEvent = new CustomEvent(EVENT_TYPES.KEY_PRESS, this);
                this.keyDownEvent = new CustomEvent(EVENT_TYPES.KEY_DOWN, this);
                this.keyUpEvent = new CustomEvent(EVENT_TYPES.KEY_UP, this);
                this.focusEvent = new CustomEvent(EVENT_TYPES.FOCUS, this);
                this.blurEvent = new CustomEvent(EVENT_TYPES.BLUR, this);
                this.destroyEvent = new CustomEvent(EVENT_TYPES.DESTROY, this);

                if(p_oConfig) {

                    oConfig.applyConfig(p_oConfig);

                }

                oConfig.fireQueue();

            }

        },

        // Private methods

        /**
        * @method _getFirstElement
        * @description Returns an HTML element's first HTML element node.
        * @private
        * @param {<a href="http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929/
        * level-one-html.html#ID-58190037">HTMLElement</a>} p_oElement Object
        * reference specifying the element to be evaluated.
        * @param {String} p_sTagName Optional. String specifying the tagname of
        * the element to be retrieved.
        * @return {<a href="http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929/
        * level-one-html.html#ID-58190037">HTMLElement</a>}
        */
        _getFirstElement: function(p_oElement, p_sTagName) {

            var oFirstChild = p_oElement.firstChild,
                oElement;

            if(oFirstChild) {

                if(oFirstChild.nodeType == 1) {

                    oElement = oFirstChild;

                }
                else {

                    var oNextSibling = oFirstChild.nextSibling;

                    if(oNextSibling && oNextSibling.nodeType == 1) {

                        oElement = oNextSibling;

                    }

                }

            }

            if(p_sTagName) {

                return (oElement && oElement.tagName.toUpperCase() == p_sTagName) ?
                    oElement : false;

            }

            return oElement;

        },

        /**
        * @method _checkDOMNode
        * @description Determines if an object is an HTML element.
        * @private
        * @param {Object} p_oObject Object to be evaluated.
        * @return {Boolean}
        */
        _checkDOMNode: function(p_oObject) {

            return (p_oObject && p_oObject.tagName);

        },

        /**
        * @method _createRootNodeStructure
        * @description Creates the core DOM structure for the menu item.
        * @private
        */
        _createRootNodeStructure: function () {

            var oTemplate = YAHOO.widget.MenuItem._MenuItemTemplate;

            if(!oTemplate) {

                oTemplate = document.createElement("li");
                oTemplate.innerHTML = "<a href=\"#\">s</a>";

                YAHOO.widget.MenuItem._MenuItemTemplate = oTemplate;

            }

            this.element = oTemplate.cloneNode(true);
            this._oAnchor = this.element.firstChild;
            this._oText = this._oAnchor.firstChild;

            this.element.appendChild(this._oAnchor);

        },

        /**
        * @method _initSubTree
        * @description Iterates the source element's childNodes collection and uses
        * the child nodes to instantiate other menus.
        * @private
        */
        _initSubTree: function() {

            var oSrcEl = this.srcElement,
                oConfig = this.cfg;

            if(oSrcEl.childNodes.length > 0) {

                if(
                    this.parent.lazyLoad &&
                    this.parent.srcElement &&
                    this.parent.srcElement.tagName.toUpperCase() == "SELECT"
                ) {

                    oConfig.setProperty(
                            "submenu",
                            { id: Dom.generateId(), itemdata: oSrcEl.childNodes }
                        );

                }
                else {

                    var oNode = oSrcEl.firstChild,
                        aOptions = [];

                    do {

                        if(oNode && oNode.tagName) {

                            switch(oNode.tagName.toUpperCase()) {

                                case "DIV":

                                    oConfig.setProperty("submenu", oNode);

                                break;

                                case "OPTION":

                                    aOptions[aOptions.length] = oNode;

                                break;

                            }

                        }

                    }
                    while((oNode = oNode.nextSibling));

                    var nOptions = aOptions.length;

                    if(nOptions > 0) {

                        var oMenu = new this.SUBMENU_TYPE(Dom.generateId());

                        oConfig.setProperty("submenu", oMenu);

                        for(var n=0; n<nOptions; n++) {

                            oMenu.addItem((new oMenu.ITEM_TYPE(aOptions[n])));

                        }

                    }

                }

            }

        },

        // Event handlers for configuration properties

        /**
        * @method configText
        * @description Event handler for when the "text" configuration property of
        * the menu item changes.
        * @param {String} p_sType String representing the name of the event that
        * was fired.
        * @param {Array} p_aArgs Array of arguments sent when the event was fired.
        * @param {YAHOO.widget.MenuItem} p_oItem Object representing the menu item
        * that fired the event.
        */
        configText: function(p_sType, p_aArgs, p_oItem) {

            var sText = p_aArgs[0];

            if(this._oText) {

                this._oText.nodeValue = sText;

            }

        },

        /**
        * @method configHelpText
        * @description Event handler for when the "helptext" configuration property
        * of the menu item changes.
        * @param {String} p_sType String representing the name of the event that
        * was fired.
        * @param {Array} p_aArgs Array of arguments sent when the event was fired.
        * @param {YAHOO.widget.MenuItem} p_oItem Object representing the menu item
        * that fired the event.
        */
        configHelpText: function(p_sType, p_aArgs, p_oItem) {

            var me = this,
                oHelpText = p_aArgs[0],
                oEl = this.element,
                oConfig = this.cfg,
                aNodes = [oEl, this._oAnchor],
                oSubmenuIndicator = this.submenuIndicator;

            function initHelpText() {

                Dom.addClass(aNodes, "hashelptext");

                if(oConfig.getProperty("disabled")) {

                    oConfig.refireEvent("disabled");

                }

                if(oConfig.getProperty("selected")) {

                    oConfig.refireEvent("selected");

                }

            }

            function removeHelpText() {

                Dom.removeClass(aNodes, "hashelptext");

                oEl.removeChild(me._oHelpTextEM);
                me._oHelpTextEM = null;

            }

            if(this._checkDOMNode(oHelpText)) {

                oHelpText.className = "helptext";

                if(this._oHelpTextEM) {

                    this._oHelpTextEM.parentNode.replaceChild(
                        oHelpText,
                        this._oHelpTextEM
                    );

                }
                else {

                    this._oHelpTextEM = oHelpText;

                    oEl.insertBefore(this._oHelpTextEM, oSubmenuIndicator);

                }

                initHelpText();

            }
            else if(Lang.isString(oHelpText)) {

                if(oHelpText.length === 0) {

                    removeHelpText();

                }
                else {

                    if(!this._oHelpTextEM) {

                        this._oHelpTextEM = document.createElement("em");
                        this._oHelpTextEM.className = "helptext";

                        oEl.insertBefore(this._oHelpTextEM, oSubmenuIndicator);

                    }

                    this._oHelpTextEM.innerHTML = oHelpText;

                    initHelpText();

                }

            }
            else if(!oHelpText && this._oHelpTextEM) {

                removeHelpText();

            }

        },

        /**
        * @method configURL
        * @description Event handler for when the "url" configuration property of
        * the menu item changes.
        * @param {String} p_sType String representing the name of the event that
        * was fired.
        * @param {Array} p_aArgs Array of arguments sent when the event was fired.
        * @param {YAHOO.widget.MenuItem} p_oItem Object representing the menu item
        * that fired the event.
        */
        configURL: function(p_sType, p_aArgs, p_oItem) {

            var sURL = p_aArgs[0];

            if(!sURL) {

                sURL = "#";

            }

            this._oAnchor.setAttribute("href", sURL);

        },

        /**
        * @method configTarget
        * @description Event handler for when the "target" configuration property
        * of the menu item changes.
        * @param {String} p_sType String representing the name of the event that
        * was fired.
        * @param {Array} p_aArgs Array of arguments sent when the event was fired.
        * @param {YAHOO.widget.MenuItem} p_oItem Object representing the menu item
        * that fired the event.
        */
        configTarget: function(p_sType, p_aArgs, p_oItem) {

            var sTarget = p_aArgs[0],
                oAnchor = this._oAnchor;

            if(sTarget && sTarget.length > 0) {

                oAnchor.setAttribute("target", sTarget);

            }
            else {

                oAnchor.removeAttribute("target");

            }

        },

        /**
        * @method configEmphasis
        * @description Event handler for when the "emphasis" configuration property
        * of the menu item changes.
        * @param {String} p_sType String representing the name of the event that
        * was fired.
        * @param {Array} p_aArgs Array of arguments sent when the event was fired.
        * @param {YAHOO.widget.MenuItem} p_oItem Object representing the menu item
        * that fired the event.
        */
        configEmphasis: function(p_sType, p_aArgs, p_oItem) {

            var bEmphasis = p_aArgs[0],
                oAnchor = this._oAnchor,
                oText = this._oText,
                oConfig = this.cfg,
                oEM;

            if(bEmphasis && oConfig.getProperty("strongemphasis")) {

                oConfig.setProperty("strongemphasis", false);

            }

            if(oAnchor) {

                if(bEmphasis) {

                    oEM = document.createElement("em");
                    oEM.appendChild(oText);

                    oAnchor.appendChild(oEM);

                }
                else {

                    oEM = this._getFirstElement(oAnchor, "EM");

                    if(oEM) {

                        oAnchor.removeChild(oEM);
                        oAnchor.appendChild(oText);

                    }

                }

            }

        },

        /**
        * @method configStrongEmphasis
        * @description Event handler for when the "strongemphasis" configuration
        * property of the menu item changes.
        * @param {String} p_sType String representing the name of the event that
        * was fired.
        * @param {Array} p_aArgs Array of arguments sent when the event was fired.
        * @param {YAHOO.widget.MenuItem} p_oItem Object representing the menu item
        * that fired the event.
        */
        configStrongEmphasis: function(p_sType, p_aArgs, p_oItem) {

            var bStrongEmphasis = p_aArgs[0],
                oAnchor = this._oAnchor,
                oText = this._oText,
                oConfig = this.cfg,
                oStrong;

            if(bStrongEmphasis && oConfig.getProperty("emphasis")) {

                oConfig.setProperty("emphasis", false);

            }

            if(oAnchor) {

                if(bStrongEmphasis) {

                    oStrong = document.createElement("strong");
                    oStrong.appendChild(oText);

                    oAnchor.appendChild(oStrong);

                }
                else {

                    oStrong = this._getFirstElement(oAnchor, "STRONG");

                    if(oStrong) {

                        oAnchor.removeChild(oStrong);
                        oAnchor.appendChild(oText);

                    }

                }

            }

        },

        /**
        * @method configChecked
        * @description Event handler for when the "checked" configuration property
        * of the menu item changes.
        * @param {String} p_sType String representing the name of the event that
        * was fired.
        * @param {Array} p_aArgs Array of arguments sent when the event was fired.
        * @param {YAHOO.widget.MenuItem} p_oItem Object representing the menu item
        * that fired the event.
        */
        configChecked: function(p_sType, p_aArgs, p_oItem) {

            var bChecked = p_aArgs[0],
                oEl = this.element,
                oConfig = this.cfg,
                oEM;

            if(bChecked) {

                var oTemplate = YAHOO.widget.MenuItem._CheckedIndicatorTemplate;

                if(!oTemplate) {

                    oTemplate = document.createElement("em");
                    oTemplate.innerHTML = this.CHECKED_TEXT;
                    oTemplate.className = "checkedindicator";

                    YAHOO.widget.MenuItem._CheckedIndicatorTemplate = oTemplate;

                }

                oEM = oTemplate.cloneNode(true);

                var oSubmenu = this.cfg.getProperty("submenu");

                if(oSubmenu && oSubmenu.element) {

                    oEl.insertBefore(oEM, oSubmenu.element);

                }
                else {

                    oEl.appendChild(oEM);

                }

                Dom.addClass(oEl, "checked");

                this._oCheckedIndicator = oEM;

                if(oConfig.getProperty("disabled")) {

                    oConfig.refireEvent("disabled");

                }

                if(oConfig.getProperty("selected")) {

                    oConfig.refireEvent("selected");

                }

            }
            else {

                oEM = this._oCheckedIndicator;

                Dom.removeClass(oEl, "checked");

                if(oEM) {

                    oEl.removeChild(oEM);

                }

                this._oCheckedIndicator = null;

            }

        },

        /**
        * @method configDisabled
        * @description Event handler for when the "disabled" configuration property
        * of the menu item changes.
        * @param {String} p_sType String representing the name of the event that
        * was fired.
        * @param {Array} p_aArgs Array of arguments sent when the event was fired.
        * @param {YAHOO.widget.MenuItem} p_oItem Object representing the menu item
        * that fired the event.
        */
        configDisabled: function(p_sType, p_aArgs, p_oItem) {

            var bDisabled = p_aArgs[0],
                oConfig = this.cfg,
                oAnchor = this._oAnchor,
                aNodes = [this.element, oAnchor],
                oHelpText = this._oHelpTextEM,
                oCheckedIndicator = this._oCheckedIndicator,
                oSubmenuIndicator = this.submenuIndicator,
                i = 1;

            if(oHelpText) {

                i++;
                aNodes[i] = oHelpText;

            }

            if(oCheckedIndicator) {

                oCheckedIndicator.firstChild.nodeValue = bDisabled ?
                    this.DISABLED_CHECKED_TEXT :
                    this.CHECKED_TEXT;

                i++;
                aNodes[i] = oCheckedIndicator;

            }

            if(oSubmenuIndicator) {

                oSubmenuIndicator.firstChild.nodeValue = bDisabled ?
                    this.DISABLED_SUBMENU_INDICATOR_TEXT :
                    this.COLLAPSED_SUBMENU_INDICATOR_TEXT;

                i++;
                aNodes[i] = oSubmenuIndicator;

            }

            if(bDisabled) {

                if(oConfig.getProperty("selected")) {

                    oConfig.setProperty("selected", false);

                }

                oAnchor.removeAttribute("href");

                Dom.addClass(aNodes, "disabled");

            }
            else {

                oAnchor.setAttribute("href", oConfig.getProperty("url"));

                Dom.removeClass(aNodes, "disabled");

            }

        },

        /**
        * @method configSelected
        * @description Event handler for when the "selected" configuration property
        * of the menu item changes.
        * @param {String} p_sType String representing the name of the event that
        * was fired.
        * @param {Array} p_aArgs Array of arguments sent when the event was fired.
        * @param {YAHOO.widget.MenuItem} p_oItem Object representing the menu item
        * that fired the event.
        */
        configSelected: function(p_sType, p_aArgs, p_oItem) {

            if(!this.cfg.getProperty("disabled")) {

                var bSelected = p_aArgs[0],
                    oHelpText = this._oHelpTextEM,
                    oSubmenuIndicator = this.submenuIndicator,
                    oCheckedIndicator = this._oCheckedIndicator,
                    aNodes = [this.element, this._oAnchor],
                    i = 1;

                if(oHelpText) {

                    i++;
                    aNodes[i] = oHelpText;

                }

                if(oSubmenuIndicator) {

                    i++;
                    aNodes[i] = oSubmenuIndicator;

                }

                if(oCheckedIndicator) {

                    i++;
                    aNodes[i] = oCheckedIndicator;

                }

                if(bSelected) {

                    Dom.addClass(aNodes, "selected");

                }
                else {

                    Dom.removeClass(aNodes, "selected");

                }

            }

        },

        /**
        * @method configSubmenu
        * @description Event handler for when the "submenu" configuration property
        * of the menu item changes.
        * @param {String} p_sType String representing the name of the event that
        * was fired.
        * @param {Array} p_aArgs Array of arguments sent when the event was fired.
        * @param {YAHOO.widget.MenuItem} p_oItem Object representing the menu item
        * that fired the event.
        */
        configSubmenu: function(p_sType, p_aArgs, p_oItem) {

            var oEl = this.element,
                oSubmenu = p_aArgs[0],
                oSubmenuIndicator = this.submenuIndicator,
                oConfig = this.cfg,
                aNodes = [this.element, this._oAnchor],
                bLazyLoad = this.parent && this.parent.lazyLoad,
                oMenu;

            if(oSubmenu) {

                if(oSubmenu instanceof Menu) {

                    oMenu = oSubmenu;
                    oMenu.parent = this;
                    oMenu.lazyLoad = bLazyLoad;

                }
                else if(
                    typeof oSubmenu == "object" &&
                    oSubmenu.id &&
                    !oSubmenu.nodeType
                ) {

                    var sSubmenuId = oSubmenu.id,
                        oSubmenuConfig = oSubmenu;

                    oSubmenuConfig.lazyload = bLazyLoad;
                    oSubmenuConfig.parent = this;

                    oMenu = new this.SUBMENU_TYPE(sSubmenuId, oSubmenuConfig);

                    // Set the value of the property to the Menu instance

                    this.cfg.setProperty("submenu", oMenu, true);

                }
                else {

                    oMenu = new this.SUBMENU_TYPE(
                                    oSubmenu,
                                    { lazyload: bLazyLoad, parent: this }
                                );

                    // Set the value of the property to the Menu instance

                    this.cfg.setProperty("submenu", oMenu, true);

                }

                if(oMenu) {

                    this._oSubmenu = oMenu;

                    if(!oSubmenuIndicator) {

                        var oTemplate =
                                YAHOO.widget.MenuItem._oSubmenuIndicatorTemplate;

                        if(!oTemplate) {

                            oTemplate = document.createElement("em");
                            oTemplate.innerHTML =
                                this.COLLAPSED_SUBMENU_INDICATOR_TEXT;
                            oTemplate.className = "submenuindicator";

                            YAHOO.widget.MenuItem._oSubmenuIndicatorTemplate =
                                oTemplate;

                        }

                        oSubmenuIndicator = oTemplate.cloneNode(true);

                        if(oMenu.element.parentNode == oEl) {

                            if(this.browser == "opera") {

                                oEl.appendChild(oSubmenuIndicator);

                                oMenu.renderEvent.subscribe(function() {

                                    oSubmenuIndicator.parentNode.insertBefore(
                                                                oSubmenuIndicator,
                                                                oMenu.element
                                                            );

                                });

                            }
                            else {

                                oEl.insertBefore(oSubmenuIndicator, oMenu.element);

                            }

                        }
                        else {

                            oEl.appendChild(oSubmenuIndicator);

                        }

                        this.submenuIndicator = oSubmenuIndicator;

                    }

                    Dom.addClass(aNodes, "hassubmenu");

                    if(oConfig.getProperty("disabled")) {

                        oConfig.refireEvent("disabled");

                    }

                    if(oConfig.getProperty("selected")) {

                        oConfig.refireEvent("selected");

                    }

                }

            }
            else {

                Dom.removeClass(aNodes, "hassubmenu");

                if(oSubmenuIndicator) {

                    oEl.removeChild(oSubmenuIndicator);

                }

                if(this._oSubmenu) {

                    this._oSubmenu.destroy();

                }

            }

        },

        /**
        * @method configOnClick
        * @description Event handler for when the "onclick" configuration property
        * of the menu item changes.
        * @param {String} p_sType String representing the name of the event that
        * was fired.
        * @param {Array} p_aArgs Array of arguments sent when the event was fired.
        * @param {YAHOO.widget.MenuItem} p_oItem Object representing the menu item
        * that fired the event.
        */
        configOnClick: function(p_sType, p_aArgs, p_oItem) {

            var oObject = p_aArgs[0];

            /*
                Remove any existing listeners if a "click" event handler has
                already been specified.
            */

            if(
                this._oOnclickAttributeValue &&
                (this._oOnclickAttributeValue != oObject)
            ) {

                this.clickEvent.unsubscribe(
                                    this._oOnclickAttributeValue.fn,
                                    this._oOnclickAttributeValue.obj
                                );

                this._oOnclickAttributeValue = null;

            }

            if(
                !this._oOnclickAttributeValue &&
                typeof oObject == "object" &&
                typeof oObject.fn == "function"
            ) {

                this.clickEvent.subscribe(
                        oObject.fn,
                        (oObject.obj || this),
                        oObject.scope
                    );

                this._oOnclickAttributeValue = oObject;

            }

        },

        /**
        * @method configClassName
        * @description Event handler for when the "classname" configuration
        * property of a menu item changes.
        * @param {String} p_sType String representing the name of the event that
        * was fired.
        * @param {Array} p_aArgs Array of arguments sent when the event was fired.
        * @param {YAHOO.widget.MenuItem} p_oItem Object representing the menu item
        * that fired the event.
        */
        configClassName: function(p_sType, p_aArgs, p_oItem) {

            var sClassName = p_aArgs[0];

            if(this._sClassName) {

                Dom.removeClass(this.element, this._sClassName);

            }

            Dom.addClass(this.element, sClassName);
            this._sClassName = sClassName;

        },

        // Public methods

    	/**
        * @method initDefaultConfig
    	* @description Initializes an item's configurable properties.
    	*/
    	initDefaultConfig : function() {

            var oConfig = this.cfg,
                DEFAULT_CONFIG = YAHOO.widget.MenuItem._DEFAULT_CONFIG;

            // Define the configuration attributes

            /**
            * @config text
            * @description String specifying the text label for the menu item.
            * When building a menu from existing HTML the value of this property
            * will be interpreted from the menu's markup.
            * @default ""
            * @type String
            */
            oConfig.addProperty(
                DEFAULT_CONFIG.TEXT.key,
                {
                    handler: this.configText,
                    value: DEFAULT_CONFIG.TEXT.value,
                    validator: DEFAULT_CONFIG.TEXT.validator,
                    suppressEvent: DEFAULT_CONFIG.TEXT.suppressEvent
                }
            );

            /**
            * @config helptext
            * @description String specifying additional instructional text to
            * accompany the text for the nenu item.
            * @default null
            * @type String|<a href="http://www.w3.org/TR/
            * 2000/WD-DOM-Level-1-20000929/level-one-html.html#ID-58190037">
            * HTMLElement</a>
            */
            oConfig.addProperty(
                DEFAULT_CONFIG.HELP_TEXT.key,
                { handler: this.configHelpText }
            );

            /**
            * @config url
            * @description String specifying the URL for the menu item's anchor's
            * "href" attribute.  When building a menu from existing HTML the value
            * of this property will be interpreted from the menu's markup.
            * @default "#"
            * @type String
            */
            oConfig.addProperty(
                DEFAULT_CONFIG.URL.key,
                {
                    handler: this.configURL,
                    value: DEFAULT_CONFIG.URL.value,
                    suppressEvent: DEFAULT_CONFIG.URL.suppressEvent
                }
            );

            /**
            * @config target
            * @description String specifying the value for the "target" attribute
            * of the menu item's anchor element. <strong>Specifying a target will
            * require the user to click directly on the menu item's anchor node in
            * order to cause the browser to navigate to the specified URL.</strong>
            * When building a menu from existing HTML the value of this property
            * will be interpreted from the menu's markup.
            * @default null
            * @type String
            */
            oConfig.addProperty(
                DEFAULT_CONFIG.TARGET.key,
                {
                    handler: this.configTarget,
                    suppressEvent: DEFAULT_CONFIG.TARGET.suppressEvent
                }
            );

            /**
            * @config emphasis
            * @description Boolean indicating if the text of the menu item will be
            * rendered with emphasis.  When building a menu from existing HTML the
            * value of this property will be interpreted from the menu's markup.
            * @default false
            * @type Boolean
            */
            oConfig.addProperty(
                DEFAULT_CONFIG.EMPHASIS.key,
                {
                    handler: this.configEmphasis,
                    value: DEFAULT_CONFIG.EMPHASIS.value,
                    validator: DEFAULT_CONFIG.EMPHASIS.validator,
                    suppressEvent: DEFAULT_CONFIG.EMPHASIS.suppressEvent
                }
            );

            /**
            * @config strongemphasis
            * @description Boolean indicating if the text of the menu item will be
            * rendered with strong emphasis.  When building a menu from existing
            * HTML the value of this property will be interpreted from the
            * menu's markup.
            * @default false
            * @type Boolean
            */
            oConfig.addProperty(
                DEFAULT_CONFIG.STRONG_EMPHASIS.key,
                {
                    handler: this.configStrongEmphasis,
                    value: DEFAULT_CONFIG.STRONG_EMPHASIS.value,
                    validator: DEFAULT_CONFIG.STRONG_EMPHASIS.validator,
                    suppressEvent: DEFAULT_CONFIG.STRONG_EMPHASIS.suppressEvent
                }
            );

            /**
            * @config checked
            * @description Boolean indicating if the menu item should be rendered
            * with a checkmark.
            * @default false
            * @type Boolean
            */
            oConfig.addProperty(
                DEFAULT_CONFIG.CHECKED.key,
                {
                    handler: this.configChecked,
                    value: DEFAULT_CONFIG.CHECKED.value,
                    validator: DEFAULT_CONFIG.CHECKED.validator,
                    suppressEvent: DEFAULT_CONFIG.CHECKED.suppressEvent,
                    supercedes: DEFAULT_CONFIG.CHECKED.supercedes
                }
            );

            /**
            * @config disabled
            * @description Boolean indicating if the menu item should be disabled.
            * (Disabled menu items are  dimmed and will not respond to user input
            * or fire events.)
            * @default false
            * @type Boolean
            */
            oConfig.addProperty(
                DEFAULT_CONFIG.DISABLED.key,
                {
                    handler: this.configDisabled,
                    value: DEFAULT_CONFIG.DISABLED.value,
                    validator: DEFAULT_CONFIG.DISABLED.validator,
                    suppressEvent: DEFAULT_CONFIG.DISABLED.suppressEvent
                }
            );

            /**
            * @config selected
            * @description Boolean indicating if the menu item should
            * be highlighted.
            * @default false
            * @type Boolean
            */
            oConfig.addProperty(
                DEFAULT_CONFIG.SELECTED.key,
                {
                    handler: this.configSelected,
                    value: DEFAULT_CONFIG.SELECTED.value,
                    validator: DEFAULT_CONFIG.SELECTED.validator,
                    suppressEvent: DEFAULT_CONFIG.SELECTED.suppressEvent
                }
            );

            /**
            * @config submenu
            * @description Object specifying the submenu to be appended to the
            * menu item.  The value can be one of the following: <ul><li>Object
            * specifying a Menu instance.</li><li>Object literal specifying the
            * menu to be created.  Format: <code>{ id: [menu id], itemdata:
            * [<a href="YAHOO.widget.Menu.html#itemData">array of values for
            * items</a>] }</code>.</li><li>String specifying the id attribute
            * of the <code>&#60;div&#62;</code> element of the menu.</li><li>
            * Object specifying the <code>&#60;div&#62;</code> element of the
            * menu.</li></ul>
            * @default null
            * @type Menu|String|Object|<a href="http://www.w3.org/TR/2000/
            * WD-DOM-Level-1-20000929/level-one-html.html#ID-58190037">
            * HTMLElement</a>
            */
            oConfig.addProperty(
                DEFAULT_CONFIG.SUBMENU.key,
                { handler: this.configSubmenu }
            );

            /**
            * @config onclick
            * @description Object literal representing the code to be executed when
            * the button is clicked.  Format:<br> <code> {<br>
            * <strong>fn:</strong> Function,   &#47;&#47; The handler to call when
            * the event fires.<br> <strong>obj:</strong> Object, &#47;&#47; An
            * object to  pass back to the handler.<br> <strong>scope:</strong>
            * Object &#47;&#47; The object to use for the scope of the handler.
            * <br> } </code>
            * @type Object
            * @default null
            */
            oConfig.addProperty(
                DEFAULT_CONFIG.ONCLICK.key,
                { handler: this.configOnClick }
            );

            /**
            * @config classname
            * @description CSS class to be applied to the menu item's root
            * <code>&#60;li&#62;</code> element.  The specified class(es) are
            * appended in addition to the default class as specified by the menu
            * item's CSS_CLASS_NAME constant.
            * @default null
            * @type String
            */
            oConfig.addProperty(
                DEFAULT_CONFIG.CLASS_NAME.key,
                {
                    handler: this.configClassName,
                    value: DEFAULT_CONFIG.CLASS_NAME.value,
                    validator: DEFAULT_CONFIG.CLASS_NAME.validator
                }
            );

    	},

        /**
        * @method getNextEnabledSibling
        * @description Finds the menu item's next enabled sibling.
        * @return YAHOO.widget.MenuItem
        */
        getNextEnabledSibling: function() {

            if(this.parent instanceof Menu) {

                var nGroupIndex = this.groupIndex;

                function getNextArrayItem(p_aArray, p_nStartIndex) {

                    return p_aArray[p_nStartIndex] ||
                        getNextArrayItem(p_aArray, (p_nStartIndex+1));

                }

                var aItemGroups = this.parent.getItemGroups(),
                    oNextItem;

                if(this.index < (aItemGroups[nGroupIndex].length - 1)) {

                    oNextItem = getNextArrayItem(
                            aItemGroups[nGroupIndex],
                            (this.index+1)
                        );

                }
                else {

                    var nNextGroupIndex;

                    if(nGroupIndex < (aItemGroups.length - 1)) {

                        nNextGroupIndex = nGroupIndex + 1;

                    }
                    else {

                        nNextGroupIndex = 0;

                    }

                    var aNextGroup = getNextArrayItem(aItemGroups, nNextGroupIndex);

                    // Retrieve the first menu item in the next group

                    oNextItem = getNextArrayItem(aNextGroup, 0);

                }

                return (
                    oNextItem.cfg.getProperty("disabled") ||
                    oNextItem.element.style.display == "none"
                ) ?
                oNextItem.getNextEnabledSibling() : oNextItem;

            }

        },

        /**
        * @method getPreviousEnabledSibling
        * @description Finds the menu item's previous enabled sibling.
        * @return {YAHOO.widget.MenuItem}
        */
        getPreviousEnabledSibling: function() {

           if(this.parent instanceof Menu) {

                var nGroupIndex = this.groupIndex;

                function getPreviousArrayItem(p_aArray, p_nStartIndex) {

                    return p_aArray[p_nStartIndex] ||
                        getPreviousArrayItem(p_aArray, (p_nStartIndex-1));

                }

                function getFirstItemIndex(p_aArray, p_nStartIndex) {

                    return p_aArray[p_nStartIndex] ?
                        p_nStartIndex :
                        getFirstItemIndex(p_aArray, (p_nStartIndex+1));

                }

                var aItemGroups = this.parent.getItemGroups(),
                    oPreviousItem;

                if(
                    this.index > getFirstItemIndex(aItemGroups[nGroupIndex], 0)
                ) {

                    oPreviousItem =
                        getPreviousArrayItem(
                            aItemGroups[nGroupIndex],
                            (this.index-1)
                        );

                }
                else {

                    var nPreviousGroupIndex;

                    if(nGroupIndex > getFirstItemIndex(aItemGroups, 0)) {

                        nPreviousGroupIndex = nGroupIndex - 1;

                    }
                    else {

                        nPreviousGroupIndex = aItemGroups.length - 1;

                    }

                    var aPreviousGroup =
                            getPreviousArrayItem(aItemGroups, nPreviousGroupIndex);

                    oPreviousItem =
                        getPreviousArrayItem(
                            aPreviousGroup,
                            (aPreviousGroup.length - 1)
                        );

                }

                return (
                    oPreviousItem.cfg.getProperty("disabled") ||
                    oPreviousItem.element.style.display == "none"
                ) ?
                oPreviousItem.getPreviousEnabledSibling() : oPreviousItem;

            }

        },

        /**
        * @method focus
        * @description Causes the menu item to receive the focus and fires the
        * focus event.
        */
        focus: function() {

            var oParent = this.parent,
                oAnchor = this._oAnchor,
                oActiveItem = oParent.activeItem,
                me = this;

            function setFocus() {

                try {

                    if (
                        (me.browser == "ie" || me.browser == "ie7") &&
                        !document.hasFocus()
                    ) {

                        return;

                    }

                    oAnchor.focus();

                }
                catch(e) {

                }

            }

            if(
                !this.cfg.getProperty("disabled") &&
                oParent &&
                oParent.cfg.getProperty("visible") &&
                this.element.style.display != "none"
            ) {

                if(oActiveItem) {

                    oActiveItem.blur();

                }

                /*
                    Setting focus via a timer fixes a race condition in Firefox, IE
                    and Opera where the browser viewport jumps as it trys to
                    position and focus the menu.
                */

                window.setTimeout(setFocus, 0);

                this.focusEvent.fire();

            }

        },

        /**
        * @method blur
        * @description Causes the menu item to lose focus and fires the
        * blur event.
        */
        blur: function() {

            var oParent = this.parent;

            if(
                !this.cfg.getProperty("disabled") &&
                oParent &&
                Dom.getStyle(oParent.element, "visibility") == "visible"
            ) {

                this._oAnchor.blur();

                this.blurEvent.fire();

            }

        },

        /**
        * @method hasFocus
        * @description Returns a boolean indicating whether or not the menu item
        * has focus.
        * @return {Boolean}
        */
        hasFocus: function() {

            return (YAHOO.widget.MenuManager.getFocusedMenuItem() == this);

        },

    	/**
        * @method destroy
    	* @description Removes the menu item's <code>&#60;li&#62;</code> element
    	* from its parent <code>&#60;ul&#62;</code> element.
    	*/
        destroy: function() {

            var oEl = this.element;

            if(oEl) {

                // If the item has a submenu, destroy it first

                var oSubmenu = this.cfg.getProperty("submenu");

                if(oSubmenu) {

                    oSubmenu.destroy();

                }

                // Remove CustomEvent listeners

                this.mouseOverEvent.unsubscribeAll();
                this.mouseOutEvent.unsubscribeAll();
                this.mouseDownEvent.unsubscribeAll();
                this.mouseUpEvent.unsubscribeAll();
                this.clickEvent.unsubscribeAll();
                this.keyPressEvent.unsubscribeAll();
                this.keyDownEvent.unsubscribeAll();
                this.keyUpEvent.unsubscribeAll();
                this.focusEvent.unsubscribeAll();
                this.blurEvent.unsubscribeAll();
                this.cfg.configChangedEvent.unsubscribeAll();

                // Remove the element from the parent node

                var oParentNode = oEl.parentNode;

                if(oParentNode) {

                    oParentNode.removeChild(oEl);

                    this.destroyEvent.fire();

                }

                this.destroyEvent.unsubscribeAll();

            }

        },

        /**
        * @method toString
        * @description Returns a string representing the menu item.
        * @return {String}
        */
        toString: function() {

            var sReturnVal = "MenuItem";

            if(this.cfg && this.cfg.getProperty("text")) {

                sReturnVal += (": " + this.cfg.getProperty("text"));

            }

            return sReturnVal;

        }

    };

    })();

Copyright © 2007 Yahoo! Inc. All rights reserved.