Index: openacs-4/packages/ajaxhelper/www/resources/yui/menu/README =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/ajaxhelper/www/resources/yui/menu/README,v diff -u -r1.1 -r1.2 --- openacs-4/packages/ajaxhelper/www/resources/yui/menu/README 21 Oct 2006 06:14:59 -0000 1.1 +++ openacs-4/packages/ajaxhelper/www/resources/yui/menu/README 25 Dec 2006 16:40:03 -0000 1.2 @@ -1,11 +1,92 @@ Menu Release Notes -*** version 0.11.3 *** +*** version 0.10.0 *** +* Initial release +* Known issues: + + * Some Firefox extensions disable the ability for JavaScript to prevent + the display of the browser's default context menu. These extensions + can cause the YUI ContextMenu to stop working. If you encounter this + problem, you can reset the context menu preference in Firefox back to + the default by making sure the "Disable or replace context menus" + preference is checked: + + Mac Firefox 1.0: + ------------------- + Preferences > Web Features > + Advanced... > Disable or replace context menus + + Mac Firefox 1.5 + ------------------- + Preferences > Context > + Advanced... > Disable or replace context menus + + Windows Firefox 1.0 + ------------------- + Tools > Options > Web Features > + Advanced... > Disable or replace context menus + + Windows Firefox 1.5 + ------------------- + Tools > Options > Context > + Advanced... > Disable or replace context menus + + +*** version 0.11.0 *** + Added the following features: ----------------------------- +* Overloaded the "addItem" and "insertItem" methods of MenuModule to accept a + string or a MenuModuleItem instance +* Added the ability to define a MenuItem instance as being "checked" + + +Fixed the following bugs: +------------------------- +* Changing the path for the submenu indicator image of one MenuModuleItem + subclass will no longer affect other subclasses + +* MenuItem instances built from existing markup without anchor tags will no + longer trigger a JavaScript error when clicked + +* Modified the implementation of the "imageRoot" property for the + MenuModuleItem class so that it is set to a secure/non-secure path when the + object is instantiated + +* Menu instances now resize in response to changes to the browser's font size + +* Modified the propagation of the MenuModule class's "submenualignment" + configuration property so that it only applies to instances of the same type + +* Adjusted the specificity of the style rule that controls the position of a + MenuItem instance's submenu indicator image to prevent it from wrapping in IE + +* Specified a width and height for submenu indicator images in the Menu + stylesheet to ensure that Menu instances are always rendered at the correct + width + +* Clicking a MenuItem instance will no longer trigger two HTTP GET requests + +* Users can now control or shift-click on MenuItem links + + +Changes: +-------- +* In the Menu stylesheet (menu.css), switched from using "first" class to + "first-of-type" class + +* Changed case of MenuModuleItem class's "subMenuIndicator" property + to "submenuIndicator" + + +*** version 0.11.3 *** + +Added the following features: +----------------------------- + * Added a "target" configuration property to the MenuModuleItem object that allows the user to specify the target of an item's anchor element. Items that make use of the "target" configuration property will require the user @@ -43,91 +124,124 @@ over it. -Changes -------- +Changes: +-------- * Moved the DOM event handlers for every menu from the root DIV node of each instance to the document object. This change reduces the number of DOM event handlers used by Menu to eight, improving the cleanup time required by the Event utility. -*** version 0.11.0 *** + +*** version 0.12 *** - Added the following features: ----------------------------- -* Overloaded the "addItem" and "insertItem" methods of MenuModule to accept a - string or a MenuModuleItem instance -* Added the ability to define a MenuItem instance as being "checked" +* Added the YAHOO.widget.MenuManager singleton class. +* Added two new methods to YAHOO.widget.Menu: + * "addItems" - Adds an array of items to a menu. + + * "getRoot" - Returns the root menu in a menu hierarchy. + +* Added two new events to YAHOO.widget.Menu: + + * "itemAddedEvent" - Fires when an item is added to a menu. + + * "itemRemovedEvent" - Fires when an item is removed from a menu. + +* Added two new properties to YAHOO.widget.Menu: + + * "itemData" - Array of items to be added to the menu. + + * "lazyLoad" - Boolean indicating if the menu's "lazy load" feature + is enabled. + +* Added new configuration properties to YAHOO.widget.Menu: + + * "hidedelay" - Hides the menu after the specified number of milliseconds. + + * "showdelay" - Shows the menu after the specified number of milliseconds. + + * "container" - The containing element the menu should be rendered into. + + * "clicktohide" - Boolean indicating if the menu will automatically be + hidden if the user clicks outside of it. + + * "autosubmenudisplay" - Boolean indicating if submenus are automatically + made visible when the user mouses over the menu's items. + +* Added a "toString" method to YAHOO.widget.MenuItem, YAHOO.widget.MenuBarItem + and YAHOO.widget.ContextMenuItem that returns the class name followed by the + value of the item's "text" configuration property. + + Fixed the following bugs: ------------------------- -* Changing the path for the submenu indicator image of one MenuModuleItem - subclass will no longer affect other subclasses -* MenuItem instances built from existing markup without anchor tags will no - longer trigger a JavaScript error when clicked +* Setting a YAHOO.widget.ContextMenu instance's "trigger" configuration + property will remove all previous triggers before setting up the new ones. -* Modified the implementation of the "imageRoot" property for the - MenuModuleItem class so that it is set to a secure/non-secure path when the - object is instantiated +* "destroy" method of YAHOO.widget.ContextMenu cleans up all DOM event handlers. -* Menu instances now resize in response to changes to the browser's font size +* Clicking on a menu item with a submenu no longer hides/collapses the + entire menu. -* Modified the propagation of the MenuModule class's "submenualignment" - configuration property so that it only applies to instances of the same type +* Clicking an item's submenu indicator image no longer collapses the + entire menu. + + +Changes: +-------- -* Adjusted the specificity of the style rule that controls the position of a - MenuItem instance's submenu indicator image to prevent it from wrapping in IE +* Deprecated the YAHOO.widget.MenuModule and YAHOO.widget.MenuModuleItem + classes. The Base classes are now YAHOO.widget.Menu and + YAHOO.widget.MenuItem. -* Specified a width and height for submenu indicator images in the Menu - stylesheet to ensure that Menu instances are always rendered at the correct - width +* "addItem" and "insertItem" methods of YAHOO.widget.Menu now accept an + object literal representing YAHOO.widget.MenuItem configuration properties. -* Clicking a MenuItem instance will no longer trigger two HTTP GET requests +* "clearActiveItem" now takes an argument: flag indicating if the Menu + instance's active item should be blurred. -* Users can now control or shift-click on MenuItem links +* Switched the default value of the "visible" configuration property for + YAHOO.widget.Menu to "false." +* Switched the default value of the "constraintoviewport" configuration + property for YAHOO.widget.Menu to "true." -Changes -------- -* In the Menu stylesheet (menu.css), switched from using "first" class to - "first-of-type" class +* Overloaded the "submenu" configuration property for YAHOO.widget.MenuItem + so that it now can accept any of the following: -* Changed case of MenuModuleItem class's "subMenuIndicator" property - to "submenuIndicator" + * YAHOO.widget.Menu instance + * Object literal representation of a menu + * Element id + * Element reference -*** version 0.10.0 *** +* "hide" and "show" methods of statically positioned menus now toggle the their + element's "display" style property between "block" and "none." + + +*** version 0.12.1 *** -* Initial release +Fixed the following bugs: +------------------------- -* Known issues: +* Placed the call to the DOM "focus" method used by the MenuItem class inside + a zero-second timeout to resolve a race condition between menu positioning + and focusing of a menu item that resulted in the browser viewport + scrolling unnecessarily. - * Some Firefox extensions disable the ability for JavaScript to prevent - the display of the browser's default context menu. These extensions - can cause the YUI ContextMenu to stop working. If you encounter this - problem, you can reset the context menu preference in Firefox back to - the default by making sure the "Disable or replace context menus" - preference is checked: +* Switched to JSMin for JavaScript compression to resolve issues with the + minified version. - Mac Firefox 1.0: - ------------------- - Preferences > Web Features > - Advanced... > Disable or replace context menus +* Disabled menu item instances will no longer display a submenu if the item is + clicked or moused over. - Mac Firefox 1.5 - ------------------- - Preferences > Context > - Advanced... > Disable or replace context menus +* Can no longer select more than one item in a menu if using the keyboard and + mouse simultaneously. - Windows Firefox 1.0 - ------------------- - Tools > Options > Web Features > - Advanced... > Disable or replace context menus - - Windows Firefox 1.5 - ------------------- - Tools > Options > Context > - Advanced... > Disable or replace context menus \ No newline at end of file +* Calling the "destory" method on a menu will now unregister all of the menu's + submenus from the MenuManager. \ No newline at end of file