source: TI12-security/trunk/python/ndg.security.test/ndg/security/test/openidrelyingparty/public/yui/2.6.0/menu/README @ 4907

Subversion URL: http://proj.badc.rl.ac.uk/svn/ndg/TI12-security/trunk/python/ndg.security.test/ndg/security/test/openidrelyingparty/public/yui/2.6.0/menu/README@4907
Revision 4907, 39.8 KB checked in by pjkersha, 11 years ago (diff)
  • Single Sign On Service logout controller: fixed WSGI Session Manager client instantiation - added Session Manager environ key arg
  • Completed OpenIDRelyingPartyMiddleware - wraps Authkit OpenID RP code adding a custom signin template and logout capability.
Line 
1*** version 2.6.0 ***
2
3Fixed the following bugs:
4-------------------------
5
6+ Submenus no longer appear in the top-left corner of the viewport before moving into position when
7  initially made visible.
8
9+ Submenus are no longer re-shown when the mouse moves from a submenu back to its parent MenuItem.
10
11+ A Menu's shadow is now rendered at the correct dimensions consistently in Internet Explorer.
12
13+ Menus no longer trigger a JavaScript error if the "constraintoviewport" configuration property
14  is set to "true", but the "context" configuration property is not set.
15
16
17Added the following features:
18-----------------------------
19
20+ Added a "keepopen" configuration property to YAHOO.widget.Menu that, when set to "true", will
21  result in a Menu remaining open when clicked.
22
23+ Popup Menus now automatically focus themselves when made visible, and when hidden, restore focus
24  to the element in the DOM that had focus prior to them being made visible.
25
26+ Added a new "submenutoggleregion" configuration property to YAHOO.widget.MenuBar.  When set to
27  "true", only clicking a specific region of a MenuBarItem will toggle the display of a submenu. 
28  The width of the toggle region is defined
29  by YAHOO.widget.MenuBar.prototype.SUBMENU_TOGGLE_REGION_WIDTH.
30
31
32
33*** version 2.6.0 Preview 1 ***
34
35Fixed the following bugs:
36-------------------------
37
38+ Setting the "submenualignment" configuration property for a MenuBar instance will no longer
39  result in the value being automatically propagated across all submenus.
40
41+ Setting a MenuItem instance's "disabled" configuration property to "true" inside the scope of
42  a "click" event listener registered via the "onclick" configuration property will no longer
43  prevent the "click" event of its parent Menu instance from firing.
44 
45+ MenuItem instances of submenus that open to the left of their parent MenuItem will now
46  highlight in response to the "mouseover" event in Firefox 2.
47 
48+ The Menu library no longer logs errors when strict error reporting is enabled in FireFox.
49
50+ Submenus will no longer hide in IE 7 when moving the mouse from an item in a MenuBar to
51  its corresponding submenu.
52
53+ MenuItem instances placed in groups are now properly removed and destroyed when the
54  "clearContent" method of their parent Menu instance is called.
55
56+ The "monitorresize" configuration property now propagates to submenus.
57 
58+ Updated the "maxheight" configuration property so that it will only scroll the body of a Menu if
59  its content is composed of MenuItem instances.
60
61+ Updated the implementation of Menu's "constraintoviewport" configuration property so that
62  submenus will automatically scroll and reposition themselves to remain inside the boundaries of
63  the viewport regardless of the default value supplied to the "submenualignment"
64  configuration property.
65
66
67Added the following features:
68-----------------------------
69
70+ Added a new "preventcontextoverlap" configuration property that is used to manage whether or not
71  a submenu should overlap its parent MenuItem when the "constraintoviewport" configuration
72  property is set to "true".
73
74+ Added a new "shadow" configuration property.  The "shadow" configuration property should be
75  set via the constructor and cannot be changed.  Previously a Menu's shadow was created via the
76  public "onRender" method.  This method has been removed.
77
78
79Changes:
80--------
81
82+ The "url" configuration property for MenuItem instances with a submenu will now be set to
83  "#[submenu_id]" if the "url" property is not otherwise specified by the user.
84
85+ Dynamically positioned submenus now have a default z-index of 1, rather than one greater than
86  the z-index of their parent Menu.
87
88
89*** version 2.5.2 ***
90
91Fixed the following bugs:
92-------------------------
93
94+ Mousing over a Menu instance will no longer result in the JavaScript error "oItem has
95  no properties"
96
97+ When using a custom skin, a Menu instance's width will no longer continue to increase in IE each
98  time it is displayed.
99
100+ Menu no longer blocks the display of the browser's default context menu when right clicking on a
101  MenuItem instance in Firefox 2 for Windows or Firefox 3.
102
103+ Fixed the behavior of the "clicktohide" configuration property so that the property properly
104  cascades to all submenus when a Menu instance's "position" configuration property is set to
105  "dynamic".
106
107+ Rolled back a change introduced in 2.5.0 that modified the behavior of submenus so that they are
108  no longer hidden then re-shown when the mouse is moving from a visible submenu back to its parent
109  MenuItem instance.  This change in 2.5.0 introduced a problem where multiple submenus of a menu
110  could end up being displayed at once.  Currently targeting to restore the behavior introduced in
111  2.5.0 in 2.6.0.
112
113
114
115*** version 2.5.1 ***
116
117Fixed the following bugs:
118-------------------------
119
120+ The "url" configuration property of YAHOO.widget.MenuItem now returns the exact value of the
121  "href" attribute of its anchor element in Internet Explorer.
122
123+ Clicking on an item in a Menu will no longer cause Firefox to scroll to the top of the window.
124
125+ Improved Menu's viewport boundary awareness.
126
127
128
129*** version 2.5.0 ***
130
131Fixed the following bugs:
132-------------------------
133
134+ Corrected the paths to all images in the original Menu CSS file so that checked MenuItems now
135  render correctly.
136
137+ Clicking on a disabled MenuItem instance will no longer cause the browser to navigate to
138  the top of the current page.
139
140+ Removed the use of the "yui-skin-sam" class name from the Menu core CSS file.
141
142+ Scrolling Menus now render correctly in IE 6 and IE 7.
143
144+ Submenus are no longer hidden then re-shown when the mouse is moving from a visible submenu back
145  to its parent MenuItem instance.
146
147
148
149*** version 2.4.1 ***
150
151+ No changes
152
153
154
155*** version 2.4.0 ***
156
157
158Fixed the following bugs:
159-------------------------
160
161+ The "context" property of YAHOO.widget.Menu works better in IE 6.
162
163+ Immediate submenus of a YAHOO.widget.MenuBar instance will now re-align
164  themselves to their parent YAHOO.widget.MenuBarItem instance to remain inside
165  the boundaries of the browser viewport when the "constraintoviewport"
166  property is set to "true."
167
168+ A submenu will now appear in the correct position when its parent menu
169  is scrolled.
170
171+ YAHOO.widget.MenuItem instances will no longer increase in height when their
172  submenu is made visible.
173
174+ Removed superfluous white space between YAHOO.widget.MenuItem instances in
175  IE 6 (Strict Mode and Quirks Mode) and IE 7 (Quirks Mode).
176 
177+ Statically positioned YAHOO.widget.MenuBar instances will no longer be
178  rendered in the wrong position when the Container CSS file is included in
179  the page.
180
181+ Usage of the "maxheight" configuration property will no longer change the
182  position of a YAHOO.widget.Menu instance's shadow element
183  (<DIV class="yui-menu-shadow">).  The shadow element will alway be the last
184  child node of a menu's root element.
185
186+ YAHOO.widget.MenuBar instances with their "position" configuration property
187  set to "dynamic" are no longer rendered with scrollbars in Firefox for
188  Mac OS X.
189               
190
191
192Added the following features:
193-----------------------------
194
195+ Added a new "minscrollheight" configuration property to YAHOO.widget.Menu
196  that defines the minimum threshold for the "maxheight" configuration property.
197
198+ Added a new "scrollincrement" configuration property to YAHOO.widget.Menu
199  which can be used to increase or decrease the scroll speed of scolled menu.
200
201+ Hidden YAHOO.widget.Menu instances are now positioned off screen to
202  prevent them from introducing scrollbars on the browser viewport.  The
203  default off-screen position is -10000 for both the x and y coordinates and is
204  defined in a new constant: "YAHOO.widget.Menu.prototype.OFF_SCREEN_POSITION".
205  The method responsible for moving a menu off the screen is
206  "YAHOO.widget.Menu.prototype.positionOffScreen" which is called in response
207  to the firing of the "hide" event.
208   
209
210Changes:
211--------
212
213+ Setting "iframe" configuration property on a YAHOO.widget.MenuBar instance
214  will now result in the property cascading down to all submenus.
215
216+ The "position" configuration property no longer automatically enables the
217  iframe shim for YAHOO.widget.Menu instances.  Previously, setting the
218  "position" configuration property to "static" would automatically
219  set the "iframe" configuration property to "false," and setting "position" to
220  "dynamic" would set the "iframe" configuration property to "true" for IE 6.
221
222+ YAHOO.widget.Menu instances no longer have their widths set automatically
223  as they are rendered.
224
225+ Modified the DOM structure for a YAHOO.widget.MenuItem instance so that the
226  submenu indicator node (<EM class="submenuindicator" />) and checked
227  indicator node (<EM class="checkedindicator" />) that were previously direct
228  descendants of the <A/> node are no longer present.  The updated DOM
229  structure of a YAHOO.widget.MenuItem instance is now:
230
231    <LI class="yuimenuitem">
232   
233        <A class="yuimenuitemlabel">
234   
235            Text Label
236   
237            <EM class="helptext"> Help Text </EM>   (Optional)
238   
239        </A>
240   
241        <DIV class="yuimenu"> ... </DIV> (Optional submenu node)
242   
243    </LI>
244
245
246  With the removal of the submenu indicator and checked indicator nodes,
247  the following YAHOO.widget.MenuItem constants, used to define the inner
248  text of these nodes, have been removed:
249
250    - YAHOO.widget.MenuItem.prototype.COLLAPSED_SUBMENU_INDICATOR_TEXT
251    - YAHOO.widget.MenuItem.prototype.EXPANDED_SUBMENU_INDICATOR_TEXT
252    - YAHOO.widget.MenuItem.prototype.DISABLED_SUBMENU_INDICATOR_TEXT
253    - YAHOO.widget.MenuItem.prototype.CHECKED_TEXT
254    - YAHOO.widget.MenuItem.prototype.DISABLED_CHECKED_TEXT
255   
256  The "submenuIndicator" property of YAHOO.widget.MenuItem has also
257  been removed.
258
259
260+ Modified the CSS class names used to represent the state of
261  YAHOO.widget.MenuItem and YAHOO.widget.MenuBarItem instances.  Previous to
262  2.4.0 the following CSS class names were applied only to the <A> element
263  representing the text label for YAHOO.widget.MenuItem and
264  YAHOO.widget.MenuBarItem instances:
265
266    + hashelptext
267    + checked
268    + hassubmenu
269    + selected
270    + disabled
271
272
273  To provide more flexibility and facilitate easier styling of state, a set of
274  new CSS class names have been created that are applied to both the root
275  <LI> node and its child <A> node for YAHOO.widget.MenuItem and
276  YAHOO.widget.MenuBarItem instances:
277 
278
279    New YAHOO.widget.MenuItem CSS classes:
280    --------------------------------------
281   
282    The following are applied to the <LI> element:
283   
284    .yuimenuitem-hassubmenu
285    .yuimenuitem-checked
286    .yuimenuitem-selected
287    .yuimenuitem-disabled
288   
289    .yuimenuitem-checked-selected
290    .yuimenuitem-checked-disabled
291   
292    .yuimenuitem-hassubmenu-selected
293    .yuimenuitem-hassubmenu-disabled
294   
295
296    The following are applied to the <A> element:
297
298    .yuimenuitemlabel-hassubmenu
299    .yuimenuitemlabel-checked
300    .yuimenuitemlabel-selected
301    .yuimenuitemlabel-disabled
302   
303    .yuimenuitemlabel-checked-selected
304    .yuimenuitemlabel-checked-disabled
305   
306    .yuimenuitemlabel-hassubmenu-selected
307    .yuimenuitemlabel-hassubmenu-disabled
308
309
310    New YAHOO.widget.MenuBarItem CSS classes:
311    -----------------------------------------
312   
313    The following are applied to the <LI> element:
314   
315    .yuimenubaritem-hassubmenu
316    .yuimenubaritem-selected
317    .yuimenubaritem-disabled
318   
319    .yuimenubaritem-hassubmenu-selected
320    .yuimenubaritem-hassubmenu-disabled
321   
322
323    The following are applied to the <A> element:
324   
325    .yuimenubaritemlabel-hassubmenu
326    .yuimenubaritemlabel-selected
327    .yuimenubaritemlabel-disabled
328   
329    .yuimenubaritemlabel-hassubmenu-selected
330    .yuimenubaritemlabel-hassubmenu-disabled
331
332
333+ Deprecated the YAHOO.widget.ContextMenuItem class and replaced it
334  with YAHOO.widget.MenuItem.
335
336+ All submenus of a YAHOO.widget.ContextMenu instance are now of type
337  YAHOO.widget.Menu.
338
339+ Updated the behavior of the "clicktohide" configuration property of
340  YAHOO.widget.Menu so that it behaves as documented: controls whether or not
341  clicking outside a menu results in the menu hiding.
342
343
344
345*** version 2.3.1 ***
346
347Fixed the following bugs:
348-------------------------
349
350+ Including the Container CSS along with Menu CSS on a page will no longer
351  result in statically positioned Menu instances rendering as hidden.
352
353+ The focus outline for MenuItem instances no longer sticks in Opera.
354
355+ Clicking MenuItem instances without a value for the "url" configuration
356  property will no longer result in the MenuItem losing focus.
357 
358+ Improved compatibility with Menu CSS and YUI Base CSS.
359
360
361*** version 2.3 ***
362
363Fixed the following bugs:
364-------------------------
365
366+ Pressing the Esc key when an item in a MenuBar has focus will now result
367  in the item blurring in IE.
368
369+ Clicking a YAHOO.widget.MenuItem instance with a "url" configuration property
370  set will now result in the hiding of its parent YAHOO.widget.Menu instance.
371
372+ Creating an empty YAHOO.widget.Menu instance from existing markup will no
373  longer result in a JavaScript error.
374 
375+ The "constraintoviewport" configuration property now correctly keeps a
376  YAHOO.widget.Menu instance inside the boundaries of the browser viewport.
377
378+ Tuned scrolling behavior so that when the user has scrolled to the bottom of
379  a YAHOO.widget.Menu instance and starts pressing the up arrow key, the
380  contents begin scrolling only when the next item to be selected is out of
381  view of the scrollable area.
382
383+ Modified "removeMenu" method of YAHOO.widget.MenuManager so that it removes
384  the specified YAHOO.widget.Menu instance from the collection of visible menus.
385 
386+ Calling the "destroy" method of a visible YAHOO.widget.Menu instance now
387  purges it from the YAHOO.widget.Manager's collection of visible Menus.
388 
389+ YAHOO.widget.Menu instances now blur before hiding.
390
391+ The debug version of YAHOO.widget.Menu now correctly logs as "Menu" rather
392  than "Overlay" in IE.
393 
394+ Setting a YAHOO.widget.MenuItem instance's "checked" configuration property
395  to "true" two or more times followed by "false" will no longer result in some
396  of the DOM elements used to render the checkmark icon will no longer remain
397  in the item's DOM.
398
399+ It is now possible to click anywhere on a YAHOO.widget.MenuItem instance
400  and have it navigate to the URL specified by its "url" configuration property
401  - even if the MenuItem has a value specified for its "target"
402  configuation property.
403
404+ The "toString" method of YAHOO.widget.MenuItem now returns the instance's id.
405
406+ Setting the YAHOO.widget.MenuItem.prototype.COLLAPSED_SUBMENU_INDICATOR_TEXT
407  constant to empty string no longer results in JavaScript error.
408
409+ YAHOO.widget.MenuBar instances behave the same regardless of the value
410  of their "position" configuration property.
411
412+ It is now possible to ctr or shift-click on YAHOO.widget.MenuItem instances
413  without the browser automatically redirecting to the URL specified by the
414  MenuItem's "url" configuration property.
415
416
417Added the following features:
418-----------------------------
419
420+ Prototype of all classes (Menu, ContextMenu, MenuBar, MenuItem,
421  ContextMenuItem, MenuBarItem) are augmented with YAHOO.util.EventProvider.
422
423+ Added the following methods to YAHOO.widget.MenuManager:
424
425    - "getMenuItem"
426    - "getMenuItemGroup"
427
428+ Added the following methods to YAHOO.widget.Menu:
429
430    - "subscribe"
431    - "getSubmenus"
432    - "onRender"
433
434+ Added a "disabled" configuration property to YAHOO.widget.Menu.
435
436+ Added the constant "CSS_LABEL_CLASS_NAME" to YAHOO.widget.MenuItem that
437  represents the name of the CSS class applied to the <A/> node that is the
438  first child of its root <LI/> node.
439
440+ Added the constant "CSS_LABEL_CLASS_NAME" to YAHOO.widget.MenuBarItem that
441  represents the name of the CSS class applied to the <A/> node that is the
442  first child of its root <LI/> node.
443
444+ Added ability for YAHOO.widget.Menu instances to have shadow:
445
446    - The shadow for a Menu is implemented by appending a new element as the
447      last child of its root <DIV/> element:
448
449        <DIV class="yuimenu">
450            <DIV class="bd">
451                <UL>
452                    <LI class="yuimenuitem"/>
453                    <LI class="yuimenuitem"/>
454                    <LI class="yuimenuitem"/>
455                </UL>
456            </DIV>
457            <DIV class="yui-menu-shadow"/>
458        </DIV>
459
460    - The code that creates the shadow element resides inside the Menu's
461      public "onRender" prototype method.  To disable the creation of a Menu's
462      shadow override the prototype of the "onRender" method:
463     
464      YAHOO.widget.Menu.prototype.onRender = function () { };
465     
466    - The actual creation of the shadow element is deferred until the Menu is
467      made visible for the first time.
468     
469    - The shadow element is only created for Menu instances whose
470      "position" configuration property is set to "dynamic."
471
472    - A Menu's shadow element can be styled via two CSS classes:
473
474        + "yui-menu-shadow"  - Applied to the shadow element when it is created.
475        + "yui-menu-shadow-visible" - Applied to the shadow element when the
476        Menu is visible; it is removed when hidden.
477
478    - The shadow element is only styled when using the new "Sam" skin, for
479      the previous default skin its "display" property is set to "none."
480
481
482Changes:
483--------
484
485+ Deprecated "browser" property of YAHOO.widget.MenuItem in favor
486  of the YAHOO.env.ua.
487
488+ Modified the DOM structure for a YAHOO.widget.MenuItem instance so that its
489  root <LI/> node only has only two direct descendants:
490 
491    - The <A/> node for its text label
492    - The <DIV/> node for its submenu
493 
494  The submenu indicator node (<EM class="submenuindicator" />), checked
495  indicator node (<EM class="checkedindicator" />), and help text node
496  (<EM class="helptext" />) that were previously direct descendants of a
497  YAHOO.widget.MenuItem instance's root <LI/> are now direct descendants of
498  its <A/> node:
499
500    <LI class="yuimenuitem || yuimenubaritem">
501
502        <A class="yuimenuitemlabel || yuimenubaritemlabel">
503
504            Text Label
505
506            <EM class="helptext"> Help Text </EM>   (Optional)
507            <EM class="checkedindicator"> ... </EM> (Optional)
508            <EM class="submenuindicator"> ... </EM> (Optional)
509
510        </A>
511
512        <DIV class="yuimenu"> ... </DIV> (Optional submenu node)
513
514    </LI>
515
516+ As a result of the DOM structure changes for YAHOO.widget.MenuItem, the
517  following CSS class are now only applied to a YAHOO.widget.MenuItem
518  instance's <A/> node:
519
520    - "selected"
521    - "disabled"
522    - "checked"
523    - "hashelptext"
524    - "hassubmenu"
525
526+ The "text" configuration property of YAHOO.widget.MenuItem now accepts a
527  string of HTML (previously only accepted plain text).
528
529+ The "emphasis" and "strongemphasis" configuration properties of
530  YAHOO.widget.MenuItem are no longer interpreted when building from
531  existing markup.
532
533+ All YAHOO.widget.MenuItem instances built from markup must have an <A> node
534  as the first child of its root <LI> node.
535
536+ When building YAHOO.widget.MenuItem instances from existing markup, the value
537  of the "text" property is set to the innerHTML of the menu item's <A> node.
538
539+ Deprecated the following YAHOO.widget.MenuItem configuration properties:
540
541    - "strongemphasis"
542    - "emphasis"
543    - "helptext"
544
545
546Known Issues
547------------
548
549+ ContextMenu works differently in Opera
550  --------------------------------------
551  Opera doesn't support the "contextmenu" DOM event used to trigger the display
552  of YAHOO.widget.ContextMenu instances.  As a result, clicking the right mouse
553  button in Opera will not result in the display of a ContextMenu instance
554  as it would in IE, Gecko, and Safari.  To work around this shortcoming, users
555  will need to do the following to trigger the display of
556  YAHOO.widget.ContextMenu instances in Opera:
557
558    - Opera for Windows: Hold down the control key while clicking with the
559      left mouse button.
560
561    - Opera for Mac OS X: Hold down the command/Apple key while clicking with 
562      the left mouse button.
563
564+ Focus highlight sticks in Opera
565  -------------------------------
566  In Opera focus is designated via the application of a background color
567  to an element's text node.  When a Menu instance has focus in Opera, the
568  focus highlight can remain on a MenuItem instance even after it has blurred.
569
570+ ContextMenu instances cannot be invoked by clicking on Java Applets
571  -------------------------------------------------------------------
572  When a Java Applet is specified as the "trigger" element for a ContextMenu
573  instance it will not display when the Applet is clicked.  This is not a
574  bug in the ContextMenu class, but rather a result of DOM events not bubbling
575  up from inside Java Applets.  For more information on this issue see:
576  http://tech.groups.yahoo.com/group/ydn-javascript/message/12128
577
578+ Flash Movies appear on top of Menu instances
579  --------------------------------------------
580  Flash movies can appear on top of Menu instances in IE and Gecko-based
581  browsers.  To fix this problem, set the "wmode" of the Flash movie to either
582  "transparent" or "opaque" as indicated below:
583
584  Via the <object> tag:
585
586    <object>
587        <param name="wmode" value="opaque">
588    </object>
589
590    <object>
591        <param name="wmode" value="transparent">
592    </object>
593
594  Via the <embed> tag:
595   
596    <embed wmode="transparent"> ... </embed>
597    <embed wmode="opaque"> ... </embed>
598
599    ** For more information see
600       http://kb.adobe.com/selfservice/viewContent.do?externalId=tn_15523
601
602+ Menu instances not rendered at correct z-index in IE
603  -------------------------------------------------------
604  In IE, when a Menu instance is rendered inside a relatively positioned
605  element the z-index of the Menu instance is now relative to its
606  relatively positioned parent element.  This is not a bug in the
607  Menu class, but rather a bug in IE where relatively positioned elements
608  establish a new stacking context for their child nodes.  To avoid this
609  bug is recommend that all Menu instances that need to be able to float
610  above any other element in the document be made direct descendants of the
611  <body> element.
612 
613  ** For more information see
614   http://therealcrisp.xs4all.nl/meuk/IE-zindexbug.html
615
616+ Elements with scrollbars poke through Menu instances floating above them
617  ------------------------------------------------------------------------
618  There is a bug in Gecko-based browsers for Mac OS X where an element's
619  scrollbars will poke through absolutely positioned elements floating above
620  them.  To fix this problem the "overflow" property of a Menu instance's
621  shadow element is toggled between "hidden" and "auto" (through the application
622  and removal of the "hide-scrollbars" and "show-scrollbars" CSS classes) as its
623  "visibility" configuration property is toggled between "false" and "true."
624  Therefore, the shadow element acts like a shim, blocking scrollbars from
625  poking through the Menu.
626
627  PLEASE NOTE: 
628
629  1) The "hide-scrollbars" and "show-scrollbars" CSS classes classes are
630     applied only for Gecko on Mac OS X and are added/removed to/from the
631     Menu's root HTML element (DIV) via the "hideMacGeckoScrollbars" and
632     "showMacGeckoScrollbars" methods of YAHOO.widget.Overlay. 
633 
634  2) This fix is only applied when using the "Sam" skin; the CSS for the
635     original Menu skin does not contain any rules for rendering the
636     shadow element. 
637 
638  3) Once the fix is applied the bug will reappear if the window loses focus. 
639     This can be fixed via Javascript by hiding and showing the Menu instance
640     when the window receives focus:
641
642        YAHOO.util.Event.on(window, "focus", function () {
643       
644            oMyMenu.hide();
645            oMyMenu.show();
646       
647        });
648
649    ** For more information see
650       https://bugzilla.mozilla.org/show_bug.cgi?id=187435
651
652
653*** version 2.2.2 ***
654
655Fixed the following bugs:
656-------------------------
657
658+ "toString" method of MenuItem, MenuBarItem and ContextMenuItem classes will
659  no longer throw a JavaScript error when using the debug version
660  of the Event utility.
661
662+ "toString" method of Menu, MenuBar and ContextMenu classes will
663  no longer attempt to output the instance's id if it is not available.
664
665+ Logger statements output by debug version of MenuManager are now properly
666  categorized as "MenuManager"
667
668
669
670*** version 2.2.1 ***
671
672Added the following features:
673-----------------------------
674
675+ Added the following methods to YAHOO.widget.Menu:
676  - "focus"
677  - "blur"
678  - "hasFocus"
679
680+ Added the following Custom Events to YAHOO.widget.Menu:
681    + "focusEvent"
682    + "blurEvent"
683
684+ Added the following methods to YAHOO.widget.MenuManager:
685  - "getFocusedMenuItem"
686  - "getFocusedMenu"
687
688+ Added "hasFocus" method to YAHOO.widget.MenuItem
689
690
691Fixed the following bugs:
692-------------------------
693
694+ Menu instances no longer set focus to themselves by default when made
695  visible.  Menus only receive focus in response to the following events:
696    - The user mouses down on a MenuItem instance
697    - The user tabs into a MenuItem instance
698
699+ Application of the "maxheight" configuration property is now correctly
700  deferred until the "render" event fires when Menu instance is being
701  lazy loaded.
702
703+ The "maxheight" configuration property can now be set multiple times without
704  a Menu instance restoring itself to its original default height.
705
706+ The "maxheight" configuration property can now be set on hidden Menu
707  instances that use lazy loading.
708
709+ Menu instances with a "width" configuration property set will now render
710  at the specified width rather than shrink wrapping to their contents.
711
712+ Menu item help text no longer wraps to the next line in Opera 9.
713
714+ Immediate submenus of a Menubar instance will no longer shift their position
715  to try and remain inside the confines of the browser's viewport.
716
717+ Lazy loaded ContextMenu instances now appear in the correct position when
718  they are made visible for the first time.
719
720+ MenuBar instances no longer throw JavaScript errors when navigating items with
721  submenus containing no active items using the keyboard.
722
723+ Replaced use of native "hasOwnProperty" method
724  with YAHOO.lang.hasOwnProperty.
725
726+ Rendered Menu instances will now update their width when items are added
727  or removed.
728
729+ Mousing over a Menu instance in an IE window that does not have focus will
730  no longer cause the window to receive focus.
731
732
733Changes:
734--------
735
736+ "activeItem" property of YAHOO.widget.Menu now returns a reference to the
737  Menu's currently selected item.
738
739+ Added a "visible" CSS class that is applied to visible Menu instances.
740
741+ Refactored the Menu family to improve performance, especially when working
742  with a large number of instances in IE6.
743
744
745
746*** version 2.2.0 ***
747
748Added the following features:
749-----------------------------
750
751* Added two new methods to YAHOO.widget.Menu:
752
753    * "getItems" - Returns a flat array of the items in a menu.
754
755    * "clearContent" - Removes all of the content from the menu, including the
756      menu items, group titles, header and footer.
757
758
759* Added three new configuration attributes to YAHOO.widget.Menu:
760
761    * "submenuhidedelay" - Number indicating the time (in milliseconds) that
762      should expire before a submenu is hidden when the user mouses out of a
763      menu item heading in the direction of a submenu. The value must be
764      greater than or equal to the value specified for the "showdelay"
765      configuration property.
766
767    * "maxheight" - Defines the maximum height (in pixels) for a menu before
768      the contents of the body are scrolled.
769
770    * "classname" - CSS class to be applied to the menu's root <div> element.
771      The specified class(es) are appended in addition to the default class as
772      specified by the menu's CSS_CLASS_NAME constant.
773
774
775* Added new constants to YAHOO.widget.MenuItem:
776
777    * COLLAPSED_SUBMENU_INDICATOR_TEXT - String representing the text for the
778      <em> element used for the submenu arrow indicator.
779
780    * EXPANDED_SUBMENU_INDICATOR_TEXT - String representing the text for the
781      submenu arrow indicator element (<em>) when the submenu is visible.
782
783    * DISABLED_SUBMENU_INDICATOR_ALT_TEXT - String representing the text for
784      the submenu arrow indicator element (<em>) when the menu item is disabled.
785
786    * CHECKED_TEXT - String representing the text to be used for the checked
787      indicator element (<em>).
788
789    * DISABLED_CHECKED_TEXT - String representing the text to be used for the
790      checked indicator element (<em>) when the menu item is disabled.
791
792
793* Added two new configuration attributes to YAHOO.widget.MenuItem:
794
795    * "onclick" - Object literal representing the code to be executed when the
796      button is clicked. Format:
797
798        {
799            fn: Function, // The handler to call when the event fires.
800            obj: Object, // An object to pass back to the handler.
801            scope: Object // The object to use for the scope of the handler.
802        }
803   
804    * "classname" - CSS class to be applied to the menu item's root <li>
805      element. The specified class(es) are appended in addition to the default
806      class as specified by the menu item's CSS_CLASS_NAME constant.
807
808
809* Added an "id" property to YAHOO.widget.MenuItem that represents the id of
810  the menu item's root <li> node.  Although not a configuration attribute, this
811  property should be set via the object literal of configuration attributes
812  passed as the second argument to the constructor.  If no value is
813  specified, then one will be generated using the "generateId" method of the
814  Dom utility (YAHOO.widget.Dom).
815
816* Added a "trigger context menu event"
817  (YAHOO.widget.ContextMenu.triggerContextMenuEvent) that fires when the DOM
818  "contextmenu" event ("mousedown" for Opera) is fired by one of the elemeents
819  defined as a YAHOO.widget.ContextMenu instance's trigger.
820
821* Added a "cancel" method to YAHOO.widget.ContextMenu that can be used to
822  cancel the display of a YAHOO.widget.ContextMen instance.  This method
823  should be called within the scope of a "context menu" event handler for
824  one of the context menu's triggers
825  (YAHOO.widget.ContextMenu.triggerContextMenuEvent).
826
827
828Fixed the following bugs:
829-------------------------
830
831* Users can now move diagonally from a menu item to its corresponding submenu
832  without the submenu hiding immediately.
833
834* "destroy" method of YAHOO.widget.Menu now unsubscribes from the "text resize" 
835  event (YAHOO.widget.Module.textResizeEvent).
836
837* Browser progress bar no longer flashes when hovering over checked menu items
838  or menu items with submenus.
839
840* Menu item submenu indicator image no longer jumps to the next line in
841  quirks mode.
842
843* Mouse events no longer fire in Firefox if a YAHOO.widget.Menu instance is
844  moved by script into a stationary mouse pointer.
845
846* Modified "toString" method of YAHOO.widget.ContextMenuItem to return the
847  correct class name, as it was reporting as YAHOO.widget.MenuBarItem.
848
849
850Changes:
851--------
852
853* Default value for the "showdelay" configuration attribute is now 250
854
855* Modified code so that all Menu images are added via CSS background images. 
856  As a result, the following constants and properties have been deprecated:
857
858    * YAHOO.widget.MenuItem.SUBMENU_INDICATOR_IMAGE_PATH
859    * YAHOO.widget.MenuItem.SELECTED_SUBMENU_INDICATOR_IMAGE_PATH
860    * YAHOO.widget.MenuItem.DISABLED_SUBMENU_INDICATOR_IMAGE_PATH
861    * YAHOO.widget.MenuItem.COLLAPSED_SUBMENU_INDICATOR_ALT_TEXT
862    * YAHOO.widget.MenuItem.EXPANDED_SUBMENU_INDICATOR_ALT_TEXT
863    * YAHOO.widget.MenuItem.DISABLED_SUBMENU_INDICATOR_ALT_TEXT
864    * YAHOO.widget.MenuItem.CHECKED_IMAGE_PATH
865    * YAHOO.widget.MenuItem.SELECTED_CHECKED_IMAGE_PATH
866    * YAHOO.widget.MenuItem.DISABLED_CHECKED_IMAGE_PATH
867    * YAHOO.widget.MenuItem.CHECKED_IMAGE_ALT_TEXT
868    * YAHOO.widget.MenuItem.DISABLED_CHECKED_IMAGE_ALT_TEXT
869    * YAHOO.widget.MenuItem.IMG_ROOT
870    * YAHOO.widget.MenuItem.IMG_ROOT_SSL
871    * YAHOO.widget.MenuItem.imageRoot
872    * YAHOO.widget.MenuItem.isSecure
873
874
875
876*** version 0.12.2 ***
877
878* No changes
879
880
881
882*** version 0.12.1 ***
883
884Fixed the following bugs:
885-------------------------
886
887* Placed the call to the DOM "focus" method used by the MenuItem class inside
888  a zero-second timeout to resolve a race condition between menu positioning
889  and focusing of a menu item that resulted in the browser viewport
890  scrolling unnecessarily.
891
892* Switched to JSMin for JavaScript compression to resolve issues with the
893  minified version. 
894
895* Disabled menu item instances will no longer display a submenu if the item is
896  clicked or moused over.
897
898* Can no longer select more than one item in a menu if using the keyboard and
899  mouse simultaneously.
900
901* Calling the "destory" method on a menu will now unregister all of the menu's
902  submenus from the MenuManager. 
903
904
905
906*** version 0.12 ***
907
908Added the following features:
909-----------------------------
910
911* Added the YAHOO.widget.MenuManager singleton class.
912
913* Added two new methods to YAHOO.widget.Menu:
914
915    * "addItems" - Adds an array of items to a menu.
916
917    * "getRoot" - Returns the root menu in a menu hierarchy.
918
919* Added two new events to YAHOO.widget.Menu:
920
921    * "itemAddedEvent" - Fires when an item is added to a menu.
922
923    * "itemRemovedEvent" - Fires when an item is removed from a menu.
924
925* Added two new properties to YAHOO.widget.Menu:
926
927    * "itemData" - Array of items to be added to the menu.
928
929    * "lazyLoad" - Boolean indicating if the menu's "lazy load" feature
930      is enabled.
931
932* Added new configuration properties to YAHOO.widget.Menu:
933
934    * "hidedelay" - Hides the menu after the specified number of milliseconds. 
935
936    * "showdelay" - Shows the menu after the specified number of milliseconds. 
937
938    * "container" - The containing element the menu should be rendered into. 
939
940    * "clicktohide" - Boolean indicating if the menu will automatically be
941      hidden if the user clicks outside of it.
942
943    * "autosubmenudisplay" - Boolean indicating if submenus are automatically
944      made visible when the user mouses over the menu's items.
945
946* Added a "toString" method to YAHOO.widget.MenuItem, YAHOO.widget.MenuBarItem
947  and YAHOO.widget.ContextMenuItem that returns the class name followed by the
948  value of the item's "text" configuration property.
949
950
951Fixed the following bugs:
952-------------------------
953
954* Setting a YAHOO.widget.ContextMenu instance's "trigger" configuration
955  property will remove all previous triggers before setting up the new ones.
956
957* "destroy" method of YAHOO.widget.ContextMenu cleans up all DOM event handlers.
958
959* Clicking on a menu item with a submenu no longer hides/collapses the
960  entire menu.
961
962* Clicking an item's submenu indicator image no longer collapses the
963  entire menu.
964 
965 
966Changes:
967--------
968
969* Deprecated the YAHOO.widget.MenuModule and YAHOO.widget.MenuModuleItem
970  classes.  The Base classes are now YAHOO.widget.Menu and
971  YAHOO.widget.MenuItem.
972
973* "addItem" and "insertItem" methods of YAHOO.widget.Menu now accept an
974  object literal representing YAHOO.widget.MenuItem configuration properties.
975
976* "clearActiveItem" now takes an argument: flag indicating if the Menu
977  instance's active item should be blurred.
978
979* Switched the default value of the "visible" configuration property for
980  YAHOO.widget.Menu to "false."
981
982* Switched the default value of the "constraintoviewport" configuration
983  property for YAHOO.widget.Menu to "true."
984
985* Overloaded the "submenu" configuration property for YAHOO.widget.MenuItem
986  so that it now can accept any of the following:
987
988    * YAHOO.widget.Menu instance
989    * Object literal representation of a menu
990    * Element id
991    * Element reference
992
993* "hide" and "show" methods of statically positioned menus now toggle the their
994  element's "display" style property between "block" and "none."
995
996
997
998*** version 0.10.0 ***
999
1000* Initial release
1001
1002* Known issues:
1003
1004      * Some Firefox extensions disable the ability for JavaScript to prevent 
1005        the display of the browser's default context menu.  These extensions
1006        can cause the YUI ContextMenu to stop working.  If you encounter this
1007        problem, you can reset the context menu preference in Firefox back to
1008        the default by making sure the "Disable or replace context menus"
1009        preference is checked:
1010
1011            Mac Firefox 1.0:
1012            -------------------
1013            Preferences > Web Features >
1014                Advanced... > Disable or replace context menus
1015
1016            Mac Firefox 1.5
1017            -------------------
1018            Preferences > Context >
1019                Advanced... > Disable or replace context menus
1020
1021            Windows Firefox 1.0
1022            -------------------
1023            Tools > Options > Web Features >
1024                Advanced... > Disable or replace context menus
1025
1026            Windows Firefox 1.5
1027            -------------------
1028            Tools > Options > Context >
1029                Advanced... > Disable or replace context menus
1030
1031
1032
1033*** version 0.11.3 ***
1034
1035Added the following features:
1036-----------------------------
1037
1038* Added a "target" configuration property to the MenuModuleItem object that
1039  allows the user to specify the target of an item's anchor element.  Items
1040  that make use of the "target" configuration property will require the user
1041  to click exactly on the item's anchor element to navigate to the specified
1042  URL.
1043
1044* Items without a "url" property set will automatically hide their parent
1045  menu instance(s) when clicked.
1046
1047
1048Fixed the following bugs:
1049-------------------------
1050
1051* Items in a submenu should now navigate to their specified URL when clicked.
1052
1053* Removed MenuBar's use of "overflow:hidden."  This fixes an issue in Firefox
1054  1.5 in which submenus of a Menubar instance cannot overlay other absolutely
1055  positioned elements on the page.
1056
1057* Submenus of a Menubar instance will now automatically have their iframe shim
1058  enabled in IE<7.
1059
1060* Statically positioned Menubar and Menu instances will now render with the
1061  correct position and dimensions in Safari.
1062
1063* MenuModuleItem's "focus" method now checks to make sure that an item's
1064  "display" style property is not "none" before trying to set focus to its
1065  anchor element.
1066 
1067* A ContextMenu instance will now hide all other ContextMenu instances before
1068  displaying itself.
1069
1070* Removed the dead space in front of an item's submenu indicator image in IE. 
1071  This space was causing an item's submenu to flicker when the user hovered
1072  over it.
1073
1074
1075Changes:
1076--------
1077
1078* Moved the DOM event handlers for every menu from the root DIV node of each
1079  instance to the document object.  This change reduces the number of DOM event
1080  handlers used by Menu to eight, improving the cleanup time required by the
1081  Event utility.
1082
1083               
1084
1085*** version 0.11.0 ***
1086
1087Added the following features:
1088-----------------------------
1089* Overloaded the "addItem" and "insertItem" methods of MenuModule to accept a
1090  string or a MenuModuleItem instance
1091
1092* Added the ability to define a MenuItem instance as being "checked"
1093
1094
1095Fixed the following bugs:
1096-------------------------
1097* Changing the path for the submenu indicator image of one MenuModuleItem
1098  subclass will no longer affect other subclasses
1099
1100* MenuItem instances built from existing markup without anchor tags will no
1101  longer trigger a JavaScript error when clicked
1102
1103* Modified the implementation of the "imageRoot" property for the
1104  MenuModuleItem class so that it is set to a secure/non-secure path when the
1105  object is instantiated
1106
1107* Menu instances now resize in response to changes to the browser's font size
1108
1109* Modified the propagation of the MenuModule class's "submenualignment"
1110  configuration property so that it only applies to instances of the same type
1111
1112* Adjusted the specificity of the style rule that controls the position of a
1113  MenuItem instance's submenu indicator image to prevent it from wrapping in IE
1114
1115* Specified a width and height for submenu indicator images in the Menu
1116  stylesheet to ensure that Menu instances are always rendered at the correct
1117  width
1118
1119* Clicking a MenuItem instance will no longer trigger two HTTP GET requests
1120
1121* Users can now control or shift-click on MenuItem links
1122
1123
1124Changes:
1125--------
1126* In the Menu stylesheet (menu.css), switched from using "first" class to
1127  "first-of-type" class
1128
1129* Changed case of MenuModuleItem class's "subMenuIndicator" property
1130  to "submenuIndicator"
Note: See TracBrowser for help on using the repository browser.