). + Multiple ContenxtMenu instances can now be attached to the same element without the first ContextMenu instance preventing the display of the others. Added the following features: ----------------------------- + Added a "keylistener" configuration property that accepts an Object literal representing the key(s) that can be used to trigger the MenuItem's "click" event. Possible attributes are shift (boolean), alt (boolean), ctrl (boolean) and keys (either an int or an array of ints representing keycodes). Changes: -------- + The "maxheight" configuration property now automatically propagates to all submenus. *** version 2.6.0 *** Fixed the following bugs: ------------------------- + Submenus no longer appear in the top-left corner of the viewport before moving into position when initially made visible. + Submenus are no longer re-shown when the mouse moves from a submenu back to its parent MenuItem. + A Menu's shadow is now rendered at the correct dimensions consistently in Internet Explorer. + Menus no longer trigger a JavaScript error if the "constraintoviewport" configuration property is set to "true", but the "context" configuration property is not set. Added the following features: ----------------------------- + Added a "keepopen" configuration property to YAHOO.widget.Menu that, when set to "true", will result in a Menu remaining open when clicked. + Popup Menus now automatically focus themselves when made visible, and when hidden, restore focus to the element in the DOM that had focus prior to them being made visible. + Added a new "submenutoggleregion" configuration property to YAHOO.widget.MenuBar. When set to "true", only clicking a specific region of a MenuBarItem will toggle the display of a submenu. The width of the toggle region is defined by YAHOO.widget.MenuBar.prototype.SUBMENU_TOGGLE_REGION_WIDTH. *** version 2.6.0 Preview 1 *** Fixed the following bugs: ------------------------- + Setting the "submenualignment" configuration property for a MenuBar instance will no longer result in the value being automatically propagated across all submenus. + Setting a MenuItem instance's "disabled" configuration property to "true" inside the scope of a "click" event listener registered via the "onclick" configuration property will no longer prevent the "click" event of its parent Menu instance from firing. + MenuItem instances of submenus that open to the left of their parent MenuItem will now highlight in response to the "mouseover" event in Firefox 2. + The Menu library no longer logs errors when strict error reporting is enabled in FireFox. + Submenus will no longer hide in IE 7 when moving the mouse from an item in a MenuBar to its corresponding submenu. + MenuItem instances placed in groups are now properly removed and destroyed when the "clearContent" method of their parent Menu instance is called. + The "monitorresize" configuration property now propagates to submenus. + Updated the "maxheight" configuration property so that it will only scroll the body of a Menu if its content is composed of MenuItem instances. + Updated the implementation of Menu's "constraintoviewport" configuration property so that submenus will automatically scroll and reposition themselves to remain inside the boundaries of the viewport regardless of the default value supplied to the "submenualignment" configuration property. Added the following features: ----------------------------- + Added a new "preventcontextoverlap" configuration property that is used to manage whether or not a submenu should overlap its parent MenuItem when the "constraintoviewport" configuration property is set to "true". + Added a new "shadow" configuration property. The "shadow" configuration property should be set via the constructor and cannot be changed. Previously a Menu's shadow was created via the public "onRender" method. This method has been removed. Changes: -------- + The "url" configuration property for MenuItem instances with a submenu will now be set to "#[submenu_id]" if the "url" property is not otherwise specified by the user. + Dynamically positioned submenus now have a default z-index of 1, rather than one greater than the z-index of their parent Menu. *** version 2.5.2 *** Fixed the following bugs: ------------------------- + Mousing over a Menu instance will no longer result in the JavaScript error "oItem has no properties" + When using a custom skin, a Menu instance's width will no longer continue to increase in IE each time it is displayed. + Menu no longer blocks the display of the browser's default context menu when right clicking on a MenuItem instance in Firefox 2 for Windows or Firefox 3. + Fixed the behavior of the "clicktohide" configuration property so that the property properly cascades to all submenus when a Menu instance's "position" configuration property is set to "dynamic". + Rolled back a change introduced in 2.5.0 that modified the behavior of submenus so that they are no longer hidden then re-shown when the mouse is moving from a visible submenu back to its parent MenuItem instance. This change in 2.5.0 introduced a problem where multiple submenus of a menu could end up being displayed at once. Currently targeting to restore the behavior introduced in 2.5.0 in 2.6.0. *** version 2.5.1 *** Fixed the following bugs: ------------------------- + The "url" configuration property of YAHOO.widget.MenuItem now returns the exact value of the "href" attribute of its anchor element in Internet Explorer. + Clicking on an item in a Menu will no longer cause Firefox to scroll to the top of the window. + Improved Menu's viewport boundary awareness. *** version 2.5.0 *** Fixed the following bugs: ------------------------- + Corrected the paths to all images in the original Menu CSS file so that checked MenuItems now render correctly. + Clicking on a disabled MenuItem instance will no longer cause the browser to navigate to the top of the current page. + Removed the use of the "yui-skin-sam" class name from the Menu core CSS file. + Scrolling Menus now render correctly in IE 6 and IE 7. + Submenus are no longer hidden then re-shown when the mouse is moving from a visible submenu back to its parent MenuItem instance. *** version 2.4.1 *** + No changes *** version 2.4.0 *** Fixed the following bugs: ------------------------- + The "context" property of YAHOO.widget.Menu works better in IE 6. + Immediate submenus of a YAHOO.widget.MenuBar instance will now re-align themselves to their parent YAHOO.widget.MenuBarItem instance to remain inside the boundaries of the browser viewport when the "constraintoviewport" property is set to "true." + A submenu will now appear in the correct position when its parent menu is scrolled. + YAHOO.widget.MenuItem instances will no longer increase in height when their submenu is made visible. + Removed superfluous white space between YAHOO.widget.MenuItem instances in IE 6 (Strict Mode and Quirks Mode) and IE 7 (Quirks Mode). + Statically positioned YAHOO.widget.MenuBar instances will no longer be rendered in the wrong position when the Container CSS file is included in the page. + Usage of the "maxheight" configuration property will no longer change the position of a YAHOO.widget.Menu instance's shadow element (

). The shadow element will alway be the last child node of a menu's root element. + YAHOO.widget.MenuBar instances with their "position" configuration property set to "dynamic" are no longer rendered with scrollbars in Firefox for Mac OS X. Added the following features: ----------------------------- + Added a new "minscrollheight" configuration property to YAHOO.widget.Menu that defines the minimum threshold for the "maxheight" configuration property. + Added a new "scrollincrement" configuration property to YAHOO.widget.Menu which can be used to increase or decrease the scroll speed of scolled menu. + Hidden YAHOO.widget.Menu instances are now positioned off screen to prevent them from introducing scrollbars on the browser viewport. The default off-screen position is -10000 for both the x and y coordinates and is defined in a new constant: "YAHOO.widget.Menu.prototype.OFF_SCREEN_POSITION". The method responsible for moving a menu off the screen is "YAHOO.widget.Menu.prototype.positionOffScreen" which is called in response to the firing of the "hide" event. Changes: -------- + Setting "iframe" configuration property on a YAHOO.widget.MenuBar instance will now result in the property cascading down to all submenus. + The "position" configuration property no longer automatically enables the iframe shim for YAHOO.widget.Menu instances. Previously, setting the "position" configuration property to "static" would automatically set the "iframe" configuration property to "false," and setting "position" to "dynamic" would set the "iframe" configuration property to "true" for IE 6. + YAHOO.widget.Menu instances no longer have their widths set automatically as they are rendered. + Modified the DOM structure for a YAHOO.widget.MenuItem instance so that the submenu indicator node () and checked indicator node () that were previously direct descendants of the node are no longer present. The updated DOM structure of a YAHOO.widget.MenuItem instance is now:
Text Label Help Text (Optional)
...
(Optional submenu node)
With the removal of the submenu indicator and checked indicator nodes, the following YAHOO.widget.MenuItem constants, used to define the inner text of these nodes, have been removed: - YAHOO.widget.MenuItem.prototype.COLLAPSED_SUBMENU_INDICATOR_TEXT - YAHOO.widget.MenuItem.prototype.EXPANDED_SUBMENU_INDICATOR_TEXT - YAHOO.widget.MenuItem.prototype.DISABLED_SUBMENU_INDICATOR_TEXT - YAHOO.widget.MenuItem.prototype.CHECKED_TEXT - YAHOO.widget.MenuItem.prototype.DISABLED_CHECKED_TEXT The "submenuIndicator" property of YAHOO.widget.MenuItem has also been removed. + Modified the CSS class names used to represent the state of YAHOO.widget.MenuItem and YAHOO.widget.MenuBarItem instances. Previous to 2.4.0 the following CSS class names were applied only to the element representing the text label for YAHOO.widget.MenuItem and YAHOO.widget.MenuBarItem instances: + hashelptext + checked + hassubmenu + selected + disabled To provide more flexibility and facilitate easier styling of state, a set of new CSS class names have been created that are applied to both the root
node and its child node for YAHOO.widget.MenuItem and YAHOO.widget.MenuBarItem instances: New YAHOO.widget.MenuItem CSS classes: -------------------------------------- The following are applied to the
element: .yuimenuitem-hassubmenu .yuimenuitem-checked .yuimenuitem-selected .yuimenuitem-disabled .yuimenuitem-checked-selected .yuimenuitem-checked-disabled .yuimenuitem-hassubmenu-selected .yuimenuitem-hassubmenu-disabled The following are applied to the element: .yuimenuitemlabel-hassubmenu .yuimenuitemlabel-checked .yuimenuitemlabel-selected .yuimenuitemlabel-disabled .yuimenuitemlabel-checked-selected .yuimenuitemlabel-checked-disabled .yuimenuitemlabel-hassubmenu-selected .yuimenuitemlabel-hassubmenu-disabled New YAHOO.widget.MenuBarItem CSS classes: ----------------------------------------- The following are applied to the
element: .yuimenubaritem-hassubmenu .yuimenubaritem-selected .yuimenubaritem-disabled .yuimenubaritem-hassubmenu-selected .yuimenubaritem-hassubmenu-disabled The following are applied to the element: .yuimenubaritemlabel-hassubmenu .yuimenubaritemlabel-selected .yuimenubaritemlabel-disabled .yuimenubaritemlabel-hassubmenu-selected .yuimenubaritemlabel-hassubmenu-disabled + Deprecated the YAHOO.widget.ContextMenuItem class and replaced it with YAHOO.widget.MenuItem. + All submenus of a YAHOO.widget.ContextMenu instance are now of type YAHOO.widget.Menu. + Updated the behavior of the "clicktohide" configuration property of YAHOO.widget.Menu so that it behaves as documented: controls whether or not clicking outside a menu results in the menu hiding. *** version 2.3.1 *** Fixed the following bugs: ------------------------- + Including the Container CSS along with Menu CSS on a page will no longer result in statically positioned Menu instances rendering as hidden. + The focus outline for MenuItem instances no longer sticks in Opera. + Clicking MenuItem instances without a value for the "url" configuration property will no longer result in the MenuItem losing focus. + Improved compatibility with Menu CSS and YUI Base CSS. *** version 2.3 *** Fixed the following bugs: ------------------------- + Pressing the Esc key when an item in a MenuBar has focus will now result in the item blurring in IE. + Clicking a YAHOO.widget.MenuItem instance with a "url" configuration property set will now result in the hiding of its parent YAHOO.widget.Menu instance. + Creating an empty YAHOO.widget.Menu instance from existing markup will no longer result in a JavaScript error. + The "constraintoviewport" configuration property now correctly keeps a YAHOO.widget.Menu instance inside the boundaries of the browser viewport. + Tuned scrolling behavior so that when the user has scrolled to the bottom of a YAHOO.widget.Menu instance and starts pressing the up arrow key, the contents begin scrolling only when the next item to be selected is out of view of the scrollable area. + Modified "removeMenu" method of YAHOO.widget.MenuManager so that it removes the specified YAHOO.widget.Menu instance from the collection of visible menus. + Calling the "destroy" method of a visible YAHOO.widget.Menu instance now purges it from the YAHOO.widget.Manager's collection of visible Menus. + YAHOO.widget.Menu instances now blur before hiding. + The debug version of YAHOO.widget.Menu now correctly logs as "Menu" rather than "Overlay" in IE. + Setting a YAHOO.widget.MenuItem instance's "checked" configuration property to "true" two or more times followed by "false" will no longer result in some of the DOM elements used to render the checkmark icon will no longer remain in the item's DOM. + It is now possible to click anywhere on a YAHOO.widget.MenuItem instance and have it navigate to the URL specified by its "url" configuration property - even if the MenuItem has a value specified for its "target" configuation property. + The "toString" method of YAHOO.widget.MenuItem now returns the instance's id. + Setting the YAHOO.widget.MenuItem.prototype.COLLAPSED_SUBMENU_INDICATOR_TEXT constant to empty string no longer results in JavaScript error. + YAHOO.widget.MenuBar instances behave the same regardless of the value of their "position" configuration property. + It is now possible to ctr or shift-click on YAHOO.widget.MenuItem instances without the browser automatically redirecting to the URL specified by the MenuItem's "url" configuration property. Added the following features: ----------------------------- + Prototype of all classes (Menu, ContextMenu, MenuBar, MenuItem, ContextMenuItem, MenuBarItem) are augmented with YAHOO.util.EventProvider. + Added the following methods to YAHOO.widget.MenuManager: - "getMenuItem" - "getMenuItemGroup" + Added the following methods to YAHOO.widget.Menu: - "subscribe" - "getSubmenus" - "onRender" + Added a "disabled" configuration property to YAHOO.widget.Menu. + Added the constant "CSS_LABEL_CLASS_NAME" to YAHOO.widget.MenuItem that represents the name of the CSS class applied to the node that is the first child of its root
node. + Added the constant "CSS_LABEL_CLASS_NAME" to YAHOO.widget.MenuBarItem that represents the name of the CSS class applied to the node that is the first child of its root
node. + Added ability for YAHOO.widget.Menu instances to have shadow: - The shadow for a Menu is implemented by appending a new element as the last child of its root
element:

- The code that creates the shadow element resides inside the Menu's public "onRender" prototype method. To disable the creation of a Menu's shadow override the prototype of the "onRender" method: YAHOO.widget.Menu.prototype.onRender = function () { }; - The actual creation of the shadow element is deferred until the Menu is made visible for the first time. - The shadow element is only created for Menu instances whose "position" configuration property is set to "dynamic." - A Menu's shadow element can be styled via two CSS classes: + "yui-menu-shadow" - Applied to the shadow element when it is created. + "yui-menu-shadow-visible" - Applied to the shadow element when the Menu is visible; it is removed when hidden. - The shadow element is only styled when using the new "Sam" skin, for the previous default skin its "display" property is set to "none." Changes: -------- + Deprecated "browser" property of YAHOO.widget.MenuItem in favor of the YAHOO.env.ua. + Modified the DOM structure for a YAHOO.widget.MenuItem instance so that its root
node only has only two direct descendants: - The node for its text label - The
node for its submenu The submenu indicator node (), checked indicator node (), and help text node () that were previously direct descendants of a YAHOO.widget.MenuItem instance's root
are now direct descendants of its node:
Text Label Help Text (Optional) ... (Optional) ... (Optional)
...
(Optional submenu node)
+ As a result of the DOM structure changes for YAHOO.widget.MenuItem, the following CSS class are now only applied to a YAHOO.widget.MenuItem instance's node: - "selected" - "disabled" - "checked" - "hashelptext" - "hassubmenu" + The "text" configuration property of YAHOO.widget.MenuItem now accepts a string of HTML (previously only accepted plain text). + The "emphasis" and "strongemphasis" configuration properties of YAHOO.widget.MenuItem are no longer interpreted when building from existing markup. + All YAHOO.widget.MenuItem instances built from markup must have an node as the first child of its root
node. + When building YAHOO.widget.MenuItem instances from existing markup, the value of the "text" property is set to the innerHTML of the menu item's node. + Deprecated the following YAHOO.widget.MenuItem configuration properties: - "strongemphasis" - "emphasis" - "helptext" Known Issues ------------ + ContextMenu works differently in Opera -------------------------------------- Opera doesn't support the "contextmenu" DOM event used to trigger the display of YAHOO.widget.ContextMenu instances. As a result, clicking the right mouse button in Opera will not result in the display of a ContextMenu instance as it would in IE, Gecko, and Safari. To work around this shortcoming, users will need to do the following to trigger the display of YAHOO.widget.ContextMenu instances in Opera: - Opera for Windows: Hold down the control key while clicking with the left mouse button. - Opera for Mac OS X: Hold down the command/Apple key while clicking with the left mouse button. + Focus highlight sticks in Opera ------------------------------- In Opera focus is designated via the application of a background color to an element's text node. When a Menu instance has focus in Opera, the focus highlight can remain on a MenuItem instance even after it has blurred. + ContextMenu instances cannot be invoked by clicking on Java Applets ------------------------------------------------------------------- When a Java Applet is specified as the "trigger" element for a ContextMenu instance it will not display when the Applet is clicked. This is not a bug in the ContextMenu class, but rather a result of DOM events not bubbling up from inside Java Applets. For more information on this issue see: http://tech.groups.yahoo.com/group/ydn-javascript/message/12128 + Flash Movies appear on top of Menu instances -------------------------------------------- Flash movies can appear on top of Menu instances in IE and Gecko-based browsers. To fix this problem, set the "wmode" of the Flash movie to either "transparent" or "opaque" as indicated below: Via the