- * var navConfig = { - * strings: { - * month:"Calendar Month", - * year:"Calendar Year", - * submit: "Submit", - * cancel: "Cancel", - * invalidYear: "Please enter a valid year" - * }, - * monthFormat: YAHOO.widget.Calendar.SHORT, - * initialFocus: "month" - * } - *

'; - - var renderLeft, renderRight = false; - - if (this.parent) { - if (this.index === 0) { - renderLeft = true; - } - if (this.index == (this.parent.cfg.getProperty("pages") -1)) { - renderRight = true; - } - } else { - renderLeft = true; - renderRight = true; - } - - if (renderLeft) { - var leftArrow = this.cfg.getProperty(defCfg.NAV_ARROW_LEFT.key); - // Check for deprecated customization - If someone set IMG_ROOT, but didn't set NAV_ARROW_LEFT, then set NAV_ARROW_LEFT to the old deprecated value - if (leftArrow === null && YAHOO.widget.Calendar.IMG_ROOT !== null) { - leftArrow = YAHOO.widget.Calendar.IMG_ROOT + DEPR_NAV_LEFT; - } - var leftStyle = (leftArrow === null) ? "" : ' style="background-image:url(' + leftArrow + ')"'; - html[html.length] = ' '; - } - - var lbl = this.buildMonthLabel(); - var cal = this.parent || this; - if (cal.cfg.getProperty("navigator")) { - lbl = "" + lbl + ""; - } - html[html.length] = lbl; - - if (renderRight) { - var rightArrow = this.cfg.getProperty(defCfg.NAV_ARROW_RIGHT.key); - if (rightArrow === null && YAHOO.widget.Calendar.IMG_ROOT !== null) { - rightArrow = YAHOO.widget.Calendar.IMG_ROOT + DEPR_NAV_RIGHT; - } - var rightStyle = (rightArrow === null) ? "" : ' style="background-image:url(' + rightArrow + ')"'; - html[html.length] = ' '; - } - - html[html.length] = '

element. - The specified class(es) are appended in addition to the default class as - specified by the menu's CSS_CLASS_NAME constant. - - -* Added new constants to YAHOO.widget.MenuItem: - - * COLLAPSED_SUBMENU_INDICATOR_TEXT - String representing the text for the - element used for the submenu arrow indicator. - - * EXPANDED_SUBMENU_INDICATOR_TEXT - String representing the text for the - submenu arrow indicator element () when the submenu is visible. - - * DISABLED_SUBMENU_INDICATOR_ALT_TEXT - String representing the text for - the submenu arrow indicator element () when the menu item is disabled. - - * CHECKED_TEXT - String representing the text to be used for the checked - indicator element (). - - * DISABLED_CHECKED_TEXT - String representing the text to be used for the - checked indicator element () when the menu item is disabled. - - -* Added two new configuration attributes to YAHOO.widget.MenuItem: - - * "onclick" - Object literal representing the code to be executed when the - button is clicked. Format: - - { - fn: Function, // The handler to call when the event fires. - obj: Object, // An object to pass back to the handler. - scope: Object // The object to use for the scope of the handler. - } - - * "classname" - CSS class to be applied to the menu item's root
- element. The specified class(es) are appended in addition to the default - class as specified by the menu item's CSS_CLASS_NAME constant. - - -* Added an "id" property to YAHOO.widget.MenuItem that represents the id of - the menu item's root
node. Although not a configuration attribute, this - property should be set via the object literal of configuration attributes - passed as the second argument to the constructor. If no value is - specified, then one will be generated using the "generateId" method of the - Dom utility (YAHOO.widget.Dom). - -* Added a "trigger context menu event" - (YAHOO.widget.ContextMenu.triggerContextMenuEvent) that fires when the DOM - "contextmenu" event ("mousedown" for Opera) is fired by one of the elemeents - defined as a YAHOO.widget.ContextMenu instance's trigger. - -* Added a "cancel" method to YAHOO.widget.ContextMenu that can be used to - cancel the display of a YAHOO.widget.ContextMen instance. This method - should be called within the scope of a "context menu" event handler for - one of the context menu's triggers - (YAHOO.widget.ContextMenu.triggerContextMenuEvent). - - -Fixed the following bugs: -------------------------- - -* Users can now move diagonally from a menu item to its corresponding submenu - without the submenu hiding immediately. - -* "destroy" method of YAHOO.widget.Menu now unsubscribes from the "text resize" - event (YAHOO.widget.Module.textResizeEvent). - -* Browser progress bar no longer flashes when hovering over checked menu items - or menu items with submenus. - -* Menu item submenu indicator image no longer jumps to the next line in - quirks mode. - -* Mouse events no longer fire in Firefox if a YAHOO.widget.Menu instance is - moved by script into a stationary mouse pointer. - -* Modified "toString" method of YAHOO.widget.ContextMenuItem to return the - correct class name, as it was reporting as YAHOO.widget.MenuBarItem. - - -Changes: --------- - -* Default value for the "showdelay" configuration attribute is now 250 - -* Modified code so that all Menu images are added via CSS background images. - As a result, the following constants and properties have been deprecated: - - * YAHOO.widget.MenuItem.SUBMENU_INDICATOR_IMAGE_PATH - * YAHOO.widget.MenuItem.SELECTED_SUBMENU_INDICATOR_IMAGE_PATH - * YAHOO.widget.MenuItem.DISABLED_SUBMENU_INDICATOR_IMAGE_PATH - * YAHOO.widget.MenuItem.COLLAPSED_SUBMENU_INDICATOR_ALT_TEXT - * YAHOO.widget.MenuItem.EXPANDED_SUBMENU_INDICATOR_ALT_TEXT - * YAHOO.widget.MenuItem.DISABLED_SUBMENU_INDICATOR_ALT_TEXT - * YAHOO.widget.MenuItem.CHECKED_IMAGE_PATH - * YAHOO.widget.MenuItem.SELECTED_CHECKED_IMAGE_PATH - * YAHOO.widget.MenuItem.DISABLED_CHECKED_IMAGE_PATH - * YAHOO.widget.MenuItem.CHECKED_IMAGE_ALT_TEXT - * YAHOO.widget.MenuItem.DISABLED_CHECKED_IMAGE_ALT_TEXT - * YAHOO.widget.MenuItem.IMG_ROOT - * YAHOO.widget.MenuItem.IMG_ROOT_SSL - * YAHOO.widget.MenuItem.imageRoot - * YAHOO.widget.MenuItem.isSecure - - - -*** version 0.12.2 *** - -* No changes - - - -*** version 0.12.1 *** - -Fixed the following bugs: -------------------------- - -* 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. - -* Switched to JSMin for JavaScript compression to resolve issues with the - minified version. - -* Disabled menu item instances will no longer display a submenu if the item is - clicked or moused over. - -* Can no longer select more than one item in a menu if using the keyboard and - mouse simultaneously. - -* Calling the "destory" method on a menu will now unregister all of the menu's - submenus from the MenuManager. - - - -*** version 0.12 *** - -Added the following features: ------------------------------ - -* 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: -------------------------- - -* Setting a YAHOO.widget.ContextMenu instance's "trigger" configuration - property will remove all previous triggers before setting up the new ones. - -* "destroy" method of YAHOO.widget.ContextMenu cleans up all DOM event handlers. - -* Clicking on a menu item with a submenu no longer hides/collapses the - entire menu. - -* Clicking an item's submenu indicator image no longer collapses the - entire menu. - - -Changes: --------- - -* Deprecated the YAHOO.widget.MenuModule and YAHOO.widget.MenuModuleItem - classes. The Base classes are now YAHOO.widget.Menu and - YAHOO.widget.MenuItem. - -* "addItem" and "insertItem" methods of YAHOO.widget.Menu now accept an - object literal representing YAHOO.widget.MenuItem configuration properties. - -* "clearActiveItem" now takes an argument: flag indicating if the Menu - instance's active item should be blurred. - -* 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." - -* Overloaded the "submenu" configuration property for YAHOO.widget.MenuItem - so that it now can accept any of the following: - - * YAHOO.widget.Menu instance - * Object literal representation of a menu - * Element id - * Element reference - -* "hide" and "show" methods of statically positioned menus now toggle the their - element's "display" style property between "block" and "none." - - - -*** 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.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 - to click exactly on the item's anchor element to navigate to the specified - URL. - -* Items without a "url" property set will automatically hide their parent - menu instance(s) when clicked. - - -Fixed the following bugs: -------------------------- - -* Items in a submenu should now navigate to their specified URL when clicked. - -* Removed MenuBar's use of "overflow:hidden." This fixes an issue in Firefox - 1.5 in which submenus of a Menubar instance cannot overlay other absolutely - positioned elements on the page. - -* Submenus of a Menubar instance will now automatically have their iframe shim - enabled in IE<7. - -* Statically positioned Menubar and Menu instances will now render with the - correct position and dimensions in Safari. - -* MenuModuleItem's "focus" method now checks to make sure that an item's - "display" style property is not "none" before trying to set focus to its - anchor element. - -* A ContextMenu instance will now hide all other ContextMenu instances before - displaying itself. - -* Removed the dead space in front of an item's submenu indicator image in IE. - This space was causing an item's submenu to flicker when the user hovered - over it. - - -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 *** - -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" \ No newline at end of file diff --git a/lib/yui/menu/assets/menu-core.css b/lib/yui/menu/assets/menu-core.css deleted file mode 100755 index cde3be79b9..0000000000 --- a/lib/yui/menu/assets/menu-core.css +++ /dev/null @@ -1,235 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -/* Menu & MenuBar styles */ - -.yuimenubar { - - visibility: visible; - position: static; - -} - -.yuimenu .yuimenu, -.yuimenubar .yuimenu { - - visibility: hidden; - position: absolute; - top: -10000px; - left: -10000px; - -} - -.yuimenubar li, -.yuimenu li { - - list-style-type: none; - -} - -.yuimenubar ul, -.yuimenu ul, -.yuimenubar li, -.yuimenu li, -.yuimenu h6, -.yuimenubar h6 { - - margin: 0; - padding: 0; - -} - -.yuimenuitemlabel, -.yuimenubaritemlabel { - - text-align: left; - white-space: nowrap; - -} - - -/* - The following style rule trigger the "hasLayout" property in - IE (http://msdn2.microsoft.com/en-us/library/ms533776.aspx) for a - MenuBar instance's
element, allowing both to clear their floated - child
elements. -*/ - -.yuimenubar ul { - - *zoom: 1; - -} - - -/* - Remove the "hasLayout" trigger for submenus of MenuBar instances as it - is unnecessary. -*/ - -.yuimenubar .yuimenu ul { - - *zoom: normal; - -} - -/* - The following style rule allows a MenuBar instance's
element to clear - its floated
elements in Firefox, Safari and and Opera. -*/ - -.yuimenubar>.bd>ul:after { - - content: "."; - display: block; - clear: both; - visibility: hidden; - height: 0; - line-height: 0; - -} - -.yuimenubaritem { - - float: left; - -} - -.yuimenubaritemlabel, -.yuimenuitemlabel { - - display: block; - -} - -.yuimenuitemlabel .helptext { - - font-style: normal; - display: block; - - /* - The value for the left margin controls how much the help text is - offset from the text of the menu item. This value will need to - be customized depending on the longest text label of a menu item. - */ - - margin: -1em 0 0 10em; - -} - -/* - PLEASE NOTE: The
element used for a menu's shadow is appended - to its root element via JavaScript once it has been rendered. The - code that creates the shadow lives in the menu's public "onRender" - event handler that is a prototype method of YAHOO.widget.Menu. - Implementers wishing to remove a menu's shadow or add any other markup - required for a given skin for menu should override the "onRender" method. -*/ - -.yui-menu-shadow { - - position: absolute; - visibility: hidden; - z-index: -1; - -} - -.yui-menu-shadow-visible { - - top: 2px; - right: -3px; - left: -3px; - bottom: -3px; - visibility: visible; - -} - - -/* - -There are two known issues with YAHOO.widget.Overlay (the superclass class of -Menu) that manifest in Gecko-based browsers on Mac OS X: - - 1) Elements with scrollbars will poke through Overlay instances floating - above them. - - 2) An Overlay's scrollbars and the scrollbars of its child nodes remain - visible when the Overlay is hidden. - -To fix these bugs in Menu (a subclass of YAHOO.widget.Overlay): - - 1) The "overflow" property of a Menu instance's shadow element and child - nodes is toggled between "hidden" and "auto" (through the application - and removal of the "hide-scrollbars" and "show-scrollbars" CSS classes) - as its "visibility" configuration property is toggled between - "false" and "true." - - 2) The "display" property of elements that are child nodes of the - Menu instance's root element is set to "none" when it is hidden. - -PLEASE NOTE: - - 1) The "hide-scrollbars" and "show-scrollbars" CSS classes classes are - applied only for Gecko on Mac OS X and are added/removed to/from the - Overlay's root HTML element (DIV) via the "hideMacGeckoScrollbars" and - "showMacGeckoScrollbars" methods of YAHOO.widget.Overlay. - - 2) There may be instances where the CSS for a web page or application - contains style rules whose specificity override the rules implemented by - the Menu CSS files to fix this bug. In such cases, is necessary to - leverage the provided "hide-scrollbars" and "show-scrollbars" classes to - write custom style rules to guard against this bug. - -** For more information on this issue, see: - - + https://bugzilla.mozilla.org/show_bug.cgi?id=187435 - + SourceForge bug #1723530 - -*/ - -.hide-scrollbars * { - - overflow: hidden; - -} - -.hide-scrollbars select { - - display: none; - -} - - -/* - -The following style rule (".yuimenu.show-scrollbars") overrides the -".show-scrollbars" rule defined in container-core.css which sets the -"overflow" property of a YAHOO.widget.Overlay instance's root HTML element to -"auto" when it is visible. Without this override, a Menu would have scrollbars -when one of its submenus is visible. - -*/ - -.yuimenu.show-scrollbars, -.yuimenubar.show-scrollbars { - - overflow: visible; - -} - -.yuimenu.hide-scrollbars .yui-menu-shadow, -.yuimenubar.hide-scrollbars .yui-menu-shadow { - - overflow: hidden; - -} - -.yuimenu.show-scrollbars .yui-menu-shadow, -.yuimenubar.show-scrollbars .yui-menu-shadow { - - overflow: auto; - -} - - -/* MenuBar style rules */ - -.yuimenubar { - - background-color: #f6f7ee; - -} - - - -/* Menu style rules */ - -.yuimenu { - - background-color: #f6f7ee; - border: solid 1px #c4c4be; - padding: 1px; - -} - -.yui-menu-shadow { - - display: none; - -} - -.yuimenu ul { - - border: solid 1px #c4c4be; - border-width: 1px 0 0 0; - padding: 10px 0; - -} - -.yuimenu .yui-menu-body-scrolled { - - overflow: hidden; - -} - - -/* Group titles */ - -.yuimenu h6, -.yuimenubar h6 { - - font-size: 100%; - font-weight: normal; - border: solid 1px #c4c4be; - color: #b9b9b9; - -} - -.yuimenubar h6 { - - float: left; - padding: 4px 12px; - border-width: 0 1px 0 0; - -} - -.yuimenubar .yuimenu h6 { - - float: none; - -} - -.yuimenu h6 { - - border-width: 1px 0 0 0; - padding: 5px 10px 0 10px; - -} - -.yuimenu ul.first-of-type, -.yuimenu ul.hastitle, -.yuimenu h6.first-of-type { - - border-width: 0; - -} - - - -/* Top and bottom scroll controls */ - -.yuimenu .topscrollbar, -.yuimenu .bottomscrollbar { - - height: 16px; - background-position: center center; - background-repeat: no-repeat; - -} - -.yuimenu .topscrollbar { - - background-image: url(menu_up_arrow.png); - -} - -.yuimenu .topscrollbar_disabled { - - background-image: url(menu_up_arrow_disabled.png); - -} - -.yuimenu .bottomscrollbar { - - background-image: url(menu_down_arrow.png); - -} - -.yuimenu .bottomscrollbar_disabled { - - background-image: url(menu_down_arrow_disabled.png); - -} - - -/* MenuItem and MenuBarItem styles */ - -.yuimenuitem { - - /* - For IE: Used to collapse superfluous white space between
elements - that is triggered by the "display" property of the elements being - set to "block." - */ - - *border-bottom: solid 1px #f6f7ee; - -} - -.yuimenuitemlabel, -.yuimenubaritemlabel { - - font-size: 85%; - color: #000; - text-decoration: none; - -} - -.yuimenuitemlabel { - - padding: 2px 24px; - -} - -.yuimenubaritemlabel { - - border-width: 0 0 0 1px; - border-style: solid; - border-color: #c4c4be; - padding: 4px 24px; - -} - -.yuimenubar li.first-of-type .yuimenubaritemlabel { - - border-width: 0; - -} - -.yuimenubaritem-hassubmenu { - - background: url(menubaritem_submenuindicator.png) right center no-repeat; - -} - -.yuimenuitem-hassubmenu { - - background: url(menuitem_submenuindicator.png) right center no-repeat; - -} - -.yuimenuitem-checked { - - background: url(menuitem_checkbox.png) left center no-repeat; - -} - -.yuimenuitemlabel .helptext { - - margin-top: -1.1em; - *margin-top: -1.2em; /* For IE*/ - -} - - - -/* MenuItem states */ - - -/* Selected MenuItem */ - -.yuimenubaritem-selected, -.yuimenuitem-selected { - - background-color: #8c8ad0; - -} - -.yuimenubaritemlabel-selected, -.yuimenuitemlabel-selected { - - text-decoration: underline; - color: #fff; - -} - -.yuimenubaritem-hassubmenu-selected { - - background-image: url(menubaritem_submenuindicator_selected.png); - -} - -.yuimenuitem-hassubmenu-selected { - - background-image: url(menuitem_submenuindicator_selected.png); - -} - -.yuimenuitem-checked-selected { - - background-image: url(menuitem_checkbox_selected.png); - -} - - -/* Disabled MenuItem */ - -.yuimenubaritemlabel-disabled, -.yuimenuitemlabel-disabled { - - cursor: default; - color: #b9b9b9; - -} - -.yuimenubaritem-hassubmenu-disabled { - - background-image: url(menubaritem_submenuindicator_disabled.png); - -} - -.yuimenuitem-hassubmenu-disabled { - - background-image: url(menuitem_submenuindicator_disabled.png); - -} - -.yuimenuitem-checked-disabled { - - background-image: url(menuitem_checkbox_disabled.png); - -} \ No newline at end of file diff --git a/lib/yui/menu/assets/menu_down_arrow.png b/lib/yui/menu/assets/menu_down_arrow.png deleted file mode 100644 index 86d885db17..0000000000 Binary files a/lib/yui/menu/assets/menu_down_arrow.png and /dev/null differ diff --git a/lib/yui/menu/assets/menu_down_arrow_disabled.png b/lib/yui/menu/assets/menu_down_arrow_disabled.png deleted file mode 100644 index 98b39885ab..0000000000 Binary files a/lib/yui/menu/assets/menu_down_arrow_disabled.png and /dev/null differ diff --git a/lib/yui/menu/assets/menu_up_arrow.png b/lib/yui/menu/assets/menu_up_arrow.png deleted file mode 100644 index d83a6be8c5..0000000000 Binary files a/lib/yui/menu/assets/menu_up_arrow.png and /dev/null differ diff --git a/lib/yui/menu/assets/menu_up_arrow_disabled.png b/lib/yui/menu/assets/menu_up_arrow_disabled.png deleted file mode 100644 index 63b56382a9..0000000000 Binary files a/lib/yui/menu/assets/menu_up_arrow_disabled.png and /dev/null differ diff --git a/lib/yui/menu/assets/menubaritem_submenuindicator.png b/lib/yui/menu/assets/menubaritem_submenuindicator.png deleted file mode 100644 index 921b267c24..0000000000 Binary files a/lib/yui/menu/assets/menubaritem_submenuindicator.png and /dev/null differ diff --git a/lib/yui/menu/assets/menubaritem_submenuindicator_disabled.png b/lib/yui/menu/assets/menubaritem_submenuindicator_disabled.png deleted file mode 100644 index 63e0c3c193..0000000000 Binary files a/lib/yui/menu/assets/menubaritem_submenuindicator_disabled.png and /dev/null differ diff --git a/lib/yui/menu/assets/menubaritem_submenuindicator_selected.png b/lib/yui/menu/assets/menubaritem_submenuindicator_selected.png deleted file mode 100644 index 51078d70e2..0000000000 Binary files a/lib/yui/menu/assets/menubaritem_submenuindicator_selected.png and /dev/null differ diff --git a/lib/yui/menu/assets/menuitem_checkbox.png b/lib/yui/menu/assets/menuitem_checkbox.png deleted file mode 100644 index 12e74ddf09..0000000000 Binary files a/lib/yui/menu/assets/menuitem_checkbox.png and /dev/null differ diff --git a/lib/yui/menu/assets/menuitem_checkbox_disabled.png b/lib/yui/menu/assets/menuitem_checkbox_disabled.png deleted file mode 100644 index 0063391d1d..0000000000 Binary files a/lib/yui/menu/assets/menuitem_checkbox_disabled.png and /dev/null differ diff --git a/lib/yui/menu/assets/menuitem_checkbox_selected.png b/lib/yui/menu/assets/menuitem_checkbox_selected.png deleted file mode 100644 index 6f26c818db..0000000000 Binary files a/lib/yui/menu/assets/menuitem_checkbox_selected.png and /dev/null differ diff --git a/lib/yui/menu/assets/menuitem_submenuindicator.png b/lib/yui/menu/assets/menuitem_submenuindicator.png deleted file mode 100644 index ee69fe4bf7..0000000000 Binary files a/lib/yui/menu/assets/menuitem_submenuindicator.png and /dev/null differ diff --git a/lib/yui/menu/assets/menuitem_submenuindicator_disabled.png b/lib/yui/menu/assets/menuitem_submenuindicator_disabled.png deleted file mode 100644 index a0ee7936e2..0000000000 Binary files a/lib/yui/menu/assets/menuitem_submenuindicator_disabled.png and /dev/null differ diff --git a/lib/yui/menu/assets/menuitem_submenuindicator_selected.png b/lib/yui/menu/assets/menuitem_submenuindicator_selected.png deleted file mode 100644 index a96c7b5ac4..0000000000 Binary files a/lib/yui/menu/assets/menuitem_submenuindicator_selected.png and /dev/null differ diff --git a/lib/yui/menu/menu-debug.js b/lib/yui/menu/menu-debug.js deleted file mode 100755 index f0818e08be..0000000000 --- a/lib/yui/menu/menu-debug.js +++ /dev/null @@ -1,9088 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ - - -/** -* @module menu -* @description
The Menu family of components features a collection of -* controls that make it easy to add menus to your website or web application. -* With the Menu Controls you can create website fly-out menus, customized -* context menus, or application-style menu bars with just a small amount of -* scripting.
The Menu family of controls features:
-*
-*
Keyboard and mouse navigation.
-*
A rich event model that provides access to all of a menu's -* interesting moments.
-*
Support for -* Progressive -* Enhancement; Menus can be created from simple, -* semantic markup on the page or purely through JavaScript.
-*
-* @title Menu -* @namespace YAHOO.widget -* @requires Event, Dom, Container -*/ -(function () { - - var Dom = YAHOO.util.Dom, - Event = YAHOO.util.Event; - - - /** - * Singleton that manages a collection of all menus and menu items. Listens - * for DOM events at the document level and dispatches the events to the - * corresponding menu or menu item. - * - * @namespace YAHOO.widget - * @class MenuManager - * @static - */ - YAHOO.widget.MenuManager = function () { - - // Private member variables - - - // Flag indicating if the DOM event handlers have been attached - - var m_bInitializedEventHandlers = false, - - - // Collection of menus - - m_oMenus = {}, - - - // Collection of visible menus - - m_oVisibleMenus = {}, - - - // Collection of menu items - - m_oItems = {}, - - - // Map of DOM event types to their equivalent CustomEvent types - - m_oEventTypes = { - "click": "clickEvent", - "mousedown": "mouseDownEvent", - "mouseup": "mouseUpEvent", - "mouseover": "mouseOverEvent", - "mouseout": "mouseOutEvent", - "keydown": "keyDownEvent", - "keyup": "keyUpEvent", - "keypress": "keyPressEvent" - }, - - - m_oFocusedMenuItem = null; - - - var m_oLogger = new YAHOO.widget.LogWriter("MenuManager"); - - - - // Private methods - - - /** - * @method getMenuRootElement - * @description Finds the root DIV node of a menu or the root LI node of - * a menu item. - * @private - * @param {HTMLElement} p_oElement Object - * specifying an HTML element. - */ - function getMenuRootElement(p_oElement) { - - var oParentNode; - - if (p_oElement && p_oElement.tagName) { - - switch (p_oElement.tagName.toUpperCase()) { - - case "DIV": - - oParentNode = p_oElement.parentNode; - - // Check if the DIV is the inner "body" node of a menu - - if ( - ( - Dom.hasClass(p_oElement, "hd") || - Dom.hasClass(p_oElement, "bd") || - Dom.hasClass(p_oElement, "ft") - ) && - oParentNode && - oParentNode.tagName && - oParentNode.tagName.toUpperCase() == "DIV") - { - - return oParentNode; - - } - else { - - return p_oElement; - - } - - break; - - case "LI": - - return p_oElement; - - default: - - oParentNode = p_oElement.parentNode; - - if (oParentNode) { - - return getMenuRootElement(oParentNode); - - } - - break; - - } - - } - - } - - - - // Private event handlers - - - /** - * @method onDOMEvent - * @description Generic, global event handler for all of a menu's - * DOM-based events. This listens for events against the document - * object. If the target of a given event is a member of a menu or - * menu item's DOM, the instance's corresponding Custom Event is fired. - * @private - * @param {Event} p_oEvent Object representing the DOM event object - * passed back by the event utility (YAHOO.util.Event). - */ - function onDOMEvent(p_oEvent) { - - // Get the target node of the DOM event - - var oTarget = Event.getTarget(p_oEvent), - - // See if the target of the event was a menu, or a menu item - - oElement = getMenuRootElement(oTarget), - sCustomEventType, - sTagName, - sId, - oMenuItem, - oMenu; - - - if (oElement) { - - sTagName = oElement.tagName.toUpperCase(); - - if (sTagName == "LI") { - - sId = oElement.id; - - if (sId && m_oItems[sId]) { - - oMenuItem = m_oItems[sId]; - oMenu = oMenuItem.parent; - - } - - } - else if (sTagName == "DIV") { - - if (oElement.id) { - - oMenu = m_oMenus[oElement.id]; - - } - - } - - } - - - if (oMenu) { - - sCustomEventType = m_oEventTypes[p_oEvent.type]; - - - // Fire the Custom Event that corresponds the current DOM event - - if (oMenuItem && !oMenuItem.cfg.getProperty("disabled")) { - - oMenuItem[sCustomEventType].fire(p_oEvent); - - - if ( - p_oEvent.type == "keyup" || - p_oEvent.type == "mousedown") - { - - if (m_oFocusedMenuItem != oMenuItem) { - - if (m_oFocusedMenuItem) { - - m_oFocusedMenuItem.blurEvent.fire(); - - } - - oMenuItem.focusEvent.fire(); - - } - - } - - } - - oMenu[sCustomEventType].fire(p_oEvent, oMenuItem); - - } - else if (p_oEvent.type == "mousedown") { - - if (m_oFocusedMenuItem) { - - m_oFocusedMenuItem.blurEvent.fire(); - - m_oFocusedMenuItem = null; - - } - - - /* - If the target of the event wasn't a menu, hide all - dynamically positioned menus - */ - - for (var i in m_oVisibleMenus) { - - if (YAHOO.lang.hasOwnProperty(m_oVisibleMenus, i)) { - - oMenu = m_oVisibleMenus[i]; - - if (oMenu.cfg.getProperty("clicktohide") && - !(oMenu instanceof YAHOO.widget.MenuBar) && - oMenu.cfg.getProperty("position") == "dynamic") { - - oMenu.hide(); - - } - else { - - oMenu.clearActiveItem(true); - - } - - } - - } - - } - else if (p_oEvent.type == "keyup") { - - if (m_oFocusedMenuItem) { - - m_oFocusedMenuItem.blurEvent.fire(); - - m_oFocusedMenuItem = null; - - } - - } - - } - - - /** - * @method onMenuDestroy - * @description "destroy" event handler for a menu. - * @private - * @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.Menu} p_oMenu The menu that fired the event. - */ - function onMenuDestroy(p_sType, p_aArgs, p_oMenu) { - - if (m_oMenus[p_oMenu.id]) { - - this.removeMenu(p_oMenu); - - } - - } - - - /** - * @method onMenuFocus - * @description "focus" event handler for a MenuItem instance. - * @private - * @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. - */ - function onMenuFocus(p_sType, p_aArgs) { - - var oItem = p_aArgs[0]; - - if (oItem) { - - m_oFocusedMenuItem = oItem; - - } - - } - - - /** - * @method onMenuBlur - * @description "blur" event handler for a MenuItem instance. - * @private - * @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. - */ - function onMenuBlur(p_sType, p_aArgs) { - - m_oFocusedMenuItem = null; - - } - - - - /** - * @method onMenuVisibleConfigChange - * @description Event handler for when the "visible" configuration - * property of a Menu instance changes. - * @private - * @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. - */ - function onMenuVisibleConfigChange(p_sType, p_aArgs) { - - var bVisible = p_aArgs[0], - sId = this.id; - - if (bVisible) { - - m_oVisibleMenus[sId] = this; - - m_oLogger.log( - this + - " added to the collection of visible menus."); - - } - else if (m_oVisibleMenus[sId]) { - - delete m_oVisibleMenus[sId]; - - m_oLogger.log( - this + - " removed from the collection of visible menus."); - - } - - } - - - /** - * @method onItemDestroy - * @description "destroy" event handler for a MenuItem instance. - * @private - * @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. - */ - function onItemDestroy(p_sType, p_aArgs) { - - removeItem(this); - - } - - - function removeItem(p_oMenuItem) { - - var sId = p_oMenuItem.id; - - if (sId && m_oItems[sId]) { - - if (m_oFocusedMenuItem == p_oMenuItem) { - - m_oFocusedMenuItem = null; - - } - - delete m_oItems[sId]; - - p_oMenuItem.destroyEvent.unsubscribe(onItemDestroy); - - m_oLogger.log(p_oMenuItem + " successfully unregistered."); - - } - - } - - - /** - * @method onItemAdded - * @description "itemadded" event handler for a Menu instance. - * @private - * @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. - */ - function onItemAdded(p_sType, p_aArgs) { - - var oItem = p_aArgs[0], - sId; - - if (oItem instanceof YAHOO.widget.MenuItem) { - - sId = oItem.id; - - if (!m_oItems[sId]) { - - m_oItems[sId] = oItem; - - oItem.destroyEvent.subscribe(onItemDestroy); - - m_oLogger.log(oItem + " successfully registered."); - - } - - } - - } - - - return { - - // Privileged methods - - - /** - * @method addMenu - * @description Adds a menu to the collection of known menus. - * @param {YAHOO.widget.Menu} p_oMenu Object specifying the Menu - * instance to be added. - */ - addMenu: function (p_oMenu) { - - var oDoc; - - if (p_oMenu instanceof YAHOO.widget.Menu && p_oMenu.id && - !m_oMenus[p_oMenu.id]) { - - m_oMenus[p_oMenu.id] = p_oMenu; - - - if (!m_bInitializedEventHandlers) { - - oDoc = document; - - Event.on(oDoc, "mouseover", onDOMEvent, this, true); - Event.on(oDoc, "mouseout", onDOMEvent, this, true); - Event.on(oDoc, "mousedown", onDOMEvent, this, true); - Event.on(oDoc, "mouseup", onDOMEvent, this, true); - Event.on(oDoc, "click", onDOMEvent, this, true); - Event.on(oDoc, "keydown", onDOMEvent, this, true); - Event.on(oDoc, "keyup", onDOMEvent, this, true); - Event.on(oDoc, "keypress", onDOMEvent, this, true); - - - m_bInitializedEventHandlers = true; - - m_oLogger.log("DOM event handlers initialized."); - - } - - p_oMenu.cfg.subscribeToConfigEvent("visible", - onMenuVisibleConfigChange); - - p_oMenu.destroyEvent.subscribe(onMenuDestroy, p_oMenu, - this); - - p_oMenu.itemAddedEvent.subscribe(onItemAdded); - p_oMenu.focusEvent.subscribe(onMenuFocus); - p_oMenu.blurEvent.subscribe(onMenuBlur); - - m_oLogger.log(p_oMenu + " successfully registered."); - - } - - }, - - - /** - * @method removeMenu - * @description Removes a menu from the collection of known menus. - * @param {YAHOO.widget.Menu} p_oMenu Object specifying the Menu - * instance to be removed. - */ - removeMenu: function (p_oMenu) { - - var sId, - aItems, - i; - - if (p_oMenu) { - - sId = p_oMenu.id; - - if (m_oMenus[sId] == p_oMenu) { - - // Unregister each menu item - - aItems = p_oMenu.getItems(); - - if (aItems && aItems.length > 0) { - - i = aItems.length - 1; - - do { - - removeItem(aItems[i]); - - } - while (i--); - - } - - - // Unregister the menu - - delete m_oMenus[sId]; - - m_oLogger.log(p_oMenu + " successfully unregistered."); - - - /* - Unregister the menu from the collection of - visible menus - */ - - if (m_oVisibleMenus[sId] == p_oMenu) { - - delete m_oVisibleMenus[sId]; - - m_oLogger.log(p_oMenu + " unregistered from the" + - " collection of visible menus."); - - } - - - // Unsubscribe event listeners - - if (p_oMenu.cfg) { - - p_oMenu.cfg.unsubscribeFromConfigEvent("visible", - onMenuVisibleConfigChange); - - } - - p_oMenu.destroyEvent.unsubscribe(onMenuDestroy, - p_oMenu); - - p_oMenu.itemAddedEvent.unsubscribe(onItemAdded); - p_oMenu.focusEvent.unsubscribe(onMenuFocus); - p_oMenu.blurEvent.unsubscribe(onMenuBlur); - - } - - } - - }, - - - /** - * @method hideVisible - * @description Hides all visible, dynamically positioned menus - * (excluding instances of YAHOO.widget.MenuBar). - */ - hideVisible: function () { - - var oMenu; - - for (var i in m_oVisibleMenus) { - - if (YAHOO.lang.hasOwnProperty(m_oVisibleMenus, i)) { - - oMenu = m_oVisibleMenus[i]; - - if (!(oMenu instanceof YAHOO.widget.MenuBar) && - oMenu.cfg.getProperty("position") == "dynamic") { - - oMenu.hide(); - - } - - } - - } - - }, - - - /** - * @method getVisible - * @description Returns a collection of all visible menus registered - * with the menu manger. - * @return {Array} - */ - getVisible: function () { - - return m_oVisibleMenus; - - }, - - - /** - * @method getMenus - * @description Returns a collection of all menus registered with the - * menu manger. - * @return {Array} - */ - getMenus: function () { - - return m_oMenus; - - }, - - - /** - * @method getMenu - * @description Returns a menu with the specified id. - * @param {String} p_sId String specifying the id of the - * <div> element representing the menu to - * be retrieved. - * @return {YAHOO.widget.Menu} - */ - getMenu: function (p_sId) { - - var oMenu = m_oMenus[p_sId]; - - if (oMenu) { - - return oMenu; - - } - - }, - - - /** - * @method getMenuItem - * @description Returns a menu item with the specified id. - * @param {String} p_sId String specifying the id of the - * <li> element representing the menu item to - * be retrieved. - * @return {YAHOO.widget.MenuItem} - */ - getMenuItem: function (p_sId) { - - var oItem = m_oItems[p_sId]; - - if (oItem) { - - return oItem; - - } - - }, - - - /** - * @method getMenuItemGroup - * @description Returns an array of menu item instances whose - * corresponding <li> elements are child - * nodes of the <ul> element with the - * specified id. - * @param {String} p_sId String specifying the id of the - * <ul> element representing the group of - * menu items to be retrieved. - * @return {Array} - */ - getMenuItemGroup: function (p_sId) { - - var oUL = Dom.get(p_sId), - aItems, - oNode, - oItem, - sId; - - - if (oUL && oUL.tagName && - oUL.tagName.toUpperCase() == "UL") { - - oNode = oUL.firstChild; - - if (oNode) { - - aItems = []; - - do { - - sId = oNode.id; - - if (sId) { - - oItem = this.getMenuItem(sId); - - if (oItem) { - - aItems[aItems.length] = oItem; - - } - - } - - } - while ((oNode = oNode.nextSibling)); - - - if (aItems.length > 0) { - - return aItems; - - } - - } - - } - - }, - - - /** - * @method getFocusedMenuItem - * @description Returns a reference to the menu item that currently - * has focus. - * @return {YAHOO.widget.MenuItem} - */ - getFocusedMenuItem: function () { - - return m_oFocusedMenuItem; - - }, - - - /** - * @method getFocusedMenu - * @description Returns a reference to the menu that currently - * has focus. - * @return {YAHOO.widget.Menu} - */ - getFocusedMenu: function () { - - if (m_oFocusedMenuItem) { - - return (m_oFocusedMenuItem.parent.getRoot()); - - } - - }, - - - /** - * @method toString - * @description Returns a string representing the menu manager. - * @return {String} - */ - toString: function () { - - return "MenuManager"; - - } - - }; - - }(); - -})(); - - - -(function () { - - -/** -* The Menu class creates a container that holds a vertical list representing -* a set of options or commands. Menu is the base class for all -* menu containers. -* @param {String} p_oElement String specifying the id attribute of the -* <div> element of the menu. -* @param {String} p_oElement String specifying the id attribute of the -* <select> element to be used as the data source -* for the menu. -* @param {HTMLDivElement} p_oElement Object -* specifying the <div> element of the menu. -* @param {HTMLSelectElement} p_oElement -* Object specifying the <select> element to be used as -* the data source for the menu. -* @param {Object} p_oConfig Optional. Object literal specifying the -* configuration for the menu. See configuration class documentation for -* more details. -* @namespace YAHOO.widget -* @class Menu -* @constructor -* @extends YAHOO.widget.Overlay -*/ -YAHOO.widget.Menu = function (p_oElement, p_oConfig) { - - if (p_oConfig) { - - this.parent = p_oConfig.parent; - this.lazyLoad = p_oConfig.lazyLoad || p_oConfig.lazyload; - this.itemData = p_oConfig.itemData || p_oConfig.itemdata; - - } - - - YAHOO.widget.Menu.superclass.constructor.call(this, p_oElement, p_oConfig); - -}; - - - -/** -* @method checkPosition -* @description Checks to make sure that the value of the "position" property -* is one of the supported strings. Returns true if the position is supported. -* @private -* @param {Object} p_sPosition String specifying the position of the menu. -* @return {Boolean} -*/ -function checkPosition(p_sPosition) { - - if (typeof p_sPosition == "string") { - - return ("dynamic,static".indexOf((p_sPosition.toLowerCase())) != -1); - - } - -} - - -var Dom = YAHOO.util.Dom, - Event = YAHOO.util.Event, - Module = YAHOO.widget.Module, - Overlay = YAHOO.widget.Overlay, - Menu = YAHOO.widget.Menu, - MenuManager = YAHOO.widget.MenuManager, - CustomEvent = YAHOO.util.CustomEvent, - Lang = YAHOO.lang, - UA = YAHOO.env.ua, - - m_oShadowTemplate, - - /** - * Constant representing the name of the Menu's events - * @property EVENT_TYPES - * @private - * @final - * @type Object - */ - 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", - "FOCUS": "focus", - "BLUR": "blur", - "ITEM_ADDED": "itemAdded", - "ITEM_REMOVED": "itemRemoved" - - }, - - - /** - * Constant representing the Menu's configuration properties - * @property DEFAULT_CONFIG - * @private - * @final - * @type Object - */ - DEFAULT_CONFIG = { - - "VISIBLE": { - key: "visible", - value: false, - validator: Lang.isBoolean - }, - - "CONSTRAIN_TO_VIEWPORT": { - key: "constraintoviewport", - value: true, - validator: Lang.isBoolean, - supercedes: ["iframe","x","y","xy"] - }, - - "POSITION": { - key: "position", - value: "dynamic", - validator: checkPosition, - supercedes: ["visible", "iframe"] - }, - - "SUBMENU_ALIGNMENT": { - key: "submenualignment", - value: ["tl","tr"], - suppressEvent: true - }, - - "AUTO_SUBMENU_DISPLAY": { - key: "autosubmenudisplay", - value: true, - validator: Lang.isBoolean, - suppressEvent: true - }, - - "SHOW_DELAY": { - key: "showdelay", - value: 250, - validator: Lang.isNumber, - suppressEvent: true - }, - - "HIDE_DELAY": { - key: "hidedelay", - value: 0, - validator: Lang.isNumber, - suppressEvent: true - }, - - "SUBMENU_HIDE_DELAY": { - key: "submenuhidedelay", - value: 250, - validator: Lang.isNumber, - suppressEvent: true - }, - - "CLICK_TO_HIDE": { - key: "clicktohide", - value: true, - validator: Lang.isBoolean, - suppressEvent: true - }, - - "CONTAINER": { - key: "container", - suppressEvent: true - }, - - "SCROLL_INCREMENT": { - key: "scrollincrement", - value: 1, - validator: Lang.isNumber, - supercedes: ["maxheight"], - suppressEvent: true - }, - - "MIN_SCROLL_HEIGHT": { - key: "minscrollheight", - value: 90, - validator: Lang.isNumber, - supercedes: ["maxheight"], - suppressEvent: true - }, - - "MAX_HEIGHT": { - key: "maxheight", - value: 0, - validator: Lang.isNumber, - supercedes: ["iframe"], - suppressEvent: true - }, - - "CLASS_NAME": { - key: "classname", - value: null, - validator: Lang.isString, - suppressEvent: true - }, - - "DISABLED": { - key: "disabled", - value: false, - validator: Lang.isBoolean, - suppressEvent: true - } - - }; - - - -YAHOO.lang.extend(Menu, Overlay, { - - -// Constants - - -/** -* @property CSS_CLASS_NAME -* @description String representing the CSS class(es) to be applied to the -* menu's <div> element. -* @default "yuimenu" -* @final -* @type String -*/ -CSS_CLASS_NAME: "yuimenu", - - -/** -* @property ITEM_TYPE -* @description Object representing the type of menu item to instantiate and -* add when parsing the child nodes (either <li> element, -* <optgroup> element or <option>) -* of the menu's source HTML element. -* @default YAHOO.widget.MenuItem -* @final -* @type YAHOO.widget.MenuItem -*/ -ITEM_TYPE: null, - - -/** -* @property GROUP_TITLE_TAG_NAME -* @description String representing the tagname of the HTML element used to -* title the menu's item groups. -* @default H6 -* @final -* @type String -*/ -GROUP_TITLE_TAG_NAME: "h6", - - -/** -* @property OFF_SCREEN_POSITION -* @description Array representing the default x and y position that a menu -* should have when it is positioned outside the viewport by the -* "poistionOffScreen" method. -* @default [-10000, -10000] -* @final -* @type Array -*/ -OFF_SCREEN_POSITION: [-10000, -10000], - - -// Private properties - - -/** -* @property _nHideDelayId -* @description Number representing the time-out setting used to cancel the -* hiding of a menu. -* @default null -* @private -* @type Number -*/ -_nHideDelayId: null, - - -/** -* @property _nShowDelayId -* @description Number representing the time-out setting used to cancel the -* showing of a menu. -* @default null -* @private -* @type Number -*/ -_nShowDelayId: null, - - -/** -* @property _nSubmenuHideDelayId -* @description Number representing the time-out setting used to cancel the -* hiding of a submenu. -* @default null -* @private -* @type Number -*/ -_nSubmenuHideDelayId: null, - - -/** -* @property _nBodyScrollId -* @description Number representing the time-out setting used to cancel the -* scrolling of the menu's body element. -* @default null -* @private -* @type Number -*/ -_nBodyScrollId: null, - - -/** -* @property _bHideDelayEventHandlersAssigned -* @description Boolean indicating if the "mouseover" and "mouseout" event -* handlers used for hiding the menu via a call to "window.setTimeout" have -* already been assigned. -* @default false -* @private -* @type Boolean -*/ -_bHideDelayEventHandlersAssigned: false, - - -/** -* @property _bHandledMouseOverEvent -* @description Boolean indicating the current state of the menu's -* "mouseover" event. -* @default false -* @private -* @type Boolean -*/ -_bHandledMouseOverEvent: false, - - -/** -* @property _bHandledMouseOutEvent -* @description Boolean indicating the current state of the menu's -* "mouseout" event. -* @default false -* @private -* @type Boolean -*/ -_bHandledMouseOutEvent: false, - - -/** -* @property _aGroupTitleElements -* @description Array of HTML element used to title groups of menu items. -* @default [] -* @private -* @type Array -*/ -_aGroupTitleElements: null, - - -/** -* @property _aItemGroups -* @description Multi-dimensional Array representing the menu items as they -* are grouped in the menu. -* @default [] -* @private -* @type Array -*/ -_aItemGroups: null, - - -/** -* @property _aListElements -* @description Array of <ul> elements, each of which is -* the parent node for each item's <li> element. -* @default [] -* @private -* @type Array -*/ -_aListElements: null, - - -/** -* @property _nCurrentMouseX -* @description The current x coordinate of the mouse inside the area of -* the menu. -* @default 0 -* @private -* @type Number -*/ -_nCurrentMouseX: 0, - - -/** -* @property _bStopMouseEventHandlers -* @description Stops "mouseover," "mouseout," and "mousemove" event handlers -* from executing. -* @default false -* @private -* @type Boolean -*/ -_bStopMouseEventHandlers: false, - - -/** -* @property _sClassName -* @description The current value of the "classname" configuration attribute. -* @default null -* @private -* @type String -*/ -_sClassName: null, - - - -// Public properties - - -/** -* @property lazyLoad -* @description Boolean indicating if the menu's "lazy load" feature is -* enabled. If set to "true," initialization and rendering of the menu's -* items will be deferred until the first time it is made visible. This -* property should be set via the constructor using the configuration -* object literal. -* @default false -* @type Boolean -*/ -lazyLoad: false, - - -/** -* @property itemData -* @description Array of items to be added to the menu. The array can contain -* strings representing the text for each item to be created, object literals -* representing the menu item configuration properties, or MenuItem instances. -* This property should be set via the constructor using the configuration -* object literal. -* @default null -* @type Array -*/ -itemData: null, - - -/** -* @property activeItem -* @description Object reference to the item in the menu that has is selected. -* @default null -* @type YAHOO.widget.MenuItem -*/ -activeItem: null, - - -/** -* @property parent -* @description Object reference to the menu's parent menu or menu item. -* This property can be set via the constructor using the configuration -* object literal. -* @default null -* @type YAHOO.widget.MenuItem -*/ -parent: null, - - -/** -* @property srcElement -* @description Object reference to the HTML element (either -* <select> or <div>) used to -* create the menu. -* @default null -* @type HTMLSelectElement|HTMLDivElement -*/ -srcElement: null, - - - -// Events - - -/** -* @event mouseOverEvent -* @description Fires when the mouse has entered the menu. Passes back -* the DOM Event object as an argument. -*/ -mouseOverEvent: null, - - -/** -* @event mouseOutEvent -* @description Fires when the mouse has left the menu. 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. 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. 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. 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 one of the -* menu's items 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 one of the menu's items -* 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 one of the menu's items -* has focus. Passes back the DOM Event object as an argument. -* @type YAHOO.util.CustomEvent -*/ -keyUpEvent: null, - - -/** -* @event itemAddedEvent -* @description Fires when an item is added to the menu. -* @type YAHOO.util.CustomEvent -*/ -itemAddedEvent: null, - - -/** -* @event itemRemovedEvent -* @description Fires when an item is removed to the menu. -* @type YAHOO.util.CustomEvent -*/ -itemRemovedEvent: null, - - -/** -* @method init -* @description The Menu 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_oElement String specifying the id attribute of the -* <div> element of the menu. -* @param {String} p_oElement String specifying the id attribute of the -* <select> element to be used as the data source -* for the menu. -* @param {HTMLDivElement} p_oElement Object -* specifying the <div> element of the menu. -* @param {HTMLSelectElement} p_oElement -* Object specifying the <select> element to be used as -* the data source for the menu. -* @param {Object} p_oConfig Optional. Object literal specifying the -* configuration for the menu. See configuration class documentation for -* more details. -*/ -init: function (p_oElement, p_oConfig) { - - this._aItemGroups = []; - this._aListElements = []; - this._aGroupTitleElements = []; - - if (!this.ITEM_TYPE) { - - this.ITEM_TYPE = YAHOO.widget.MenuItem; - - } - - - var oElement; - - if (typeof p_oElement == "string") { - - oElement = document.getElementById(p_oElement); - - } - else if (p_oElement.tagName) { - - oElement = p_oElement; - - } - - - if (oElement && oElement.tagName) { - - switch(oElement.tagName.toUpperCase()) { - - case "DIV": - - this.srcElement = oElement; - - if (!oElement.id) { - - oElement.setAttribute("id", Dom.generateId()); - - } - - - /* - Note: we don't pass the user config in here yet - because we only want it executed once, at the lowest - subclass level. - */ - - Menu.superclass.init.call(this, oElement); - - this.beforeInitEvent.fire(Menu); - - this.logger = new YAHOO.widget.LogWriter(this.toString()); - - this.logger.log("Source element: " + this.srcElement.tagName); - - break; - - case "SELECT": - - this.srcElement = oElement; - - - /* - The source element is not something that we can use - outright, so we need to create a new Overlay - - Note: we don't pass the user config in here yet - because we only want it executed once, at the lowest - subclass level. - */ - - Menu.superclass.init.call(this, Dom.generateId()); - - this.beforeInitEvent.fire(Menu); - - this.logger = new YAHOO.widget.LogWriter(this.toString()); - - this.logger.log("Source element: " + this.srcElement.tagName); - - break; - - } - - } - else { - - /* - Note: we don't pass the user config in here yet - because we only want it executed once, at the lowest - subclass level. - */ - - Menu.superclass.init.call(this, p_oElement); - - this.beforeInitEvent.fire(Menu); - - this.logger = new YAHOO.widget.LogWriter(this.toString()); - - this.logger.log("No source element found. " + - "Created element with id: " + this.id); - - } - - - if (this.element) { - - Dom.addClass(this.element, this.CSS_CLASS_NAME); - - - // Subscribe to Custom Events - - this.initEvent.subscribe(this._onInit); - this.beforeRenderEvent.subscribe(this._onBeforeRender); - this.renderEvent.subscribe(this._onRender); - this.renderEvent.subscribe(this.onRender); - this.beforeShowEvent.subscribe(this._onBeforeShow); - this.hideEvent.subscribe(this.positionOffScreen); - this.showEvent.subscribe(this._onShow); - this.beforeHideEvent.subscribe(this._onBeforeHide); - this.mouseOverEvent.subscribe(this._onMouseOver); - this.mouseOutEvent.subscribe(this._onMouseOut); - this.clickEvent.subscribe(this._onClick); - this.keyDownEvent.subscribe(this._onKeyDown); - this.keyPressEvent.subscribe(this._onKeyPress); - - - if (UA.gecko || UA.webkit) { - - this.cfg.subscribeToConfigEvent("y", this._onYChange); - - } - - - if (p_oConfig) { - - this.cfg.applyConfig(p_oConfig, true); - - } - - - // Register the Menu instance with the MenuManager - - MenuManager.addMenu(this); - - - this.initEvent.fire(Menu); - - } - -}, - - - -// Private methods - - -/** -* @method _initSubTree -* @description Iterates the childNodes of the source element to find nodes -* used to instantiate menu and menu items. -* @private -*/ -_initSubTree: function () { - - var oSrcElement = this.srcElement, - sSrcElementTagName, - nGroup, - sGroupTitleTagName, - oNode, - aListElements, - nListElements, - i; - - - if (oSrcElement) { - - sSrcElementTagName = - (oSrcElement.tagName && oSrcElement.tagName.toUpperCase()); - - - if (sSrcElementTagName == "DIV") { - - // Populate the collection of item groups and item group titles - - oNode = this.body.firstChild; - - - if (oNode) { - - nGroup = 0; - sGroupTitleTagName = this.GROUP_TITLE_TAG_NAME.toUpperCase(); - - do { - - - if (oNode && oNode.tagName) { - - switch (oNode.tagName.toUpperCase()) { - - case sGroupTitleTagName: - - this._aGroupTitleElements[nGroup] = oNode; - - break; - - case "UL": - - this._aListElements[nGroup] = oNode; - this._aItemGroups[nGroup] = []; - nGroup++; - - break; - - } - - } - - } - while ((oNode = oNode.nextSibling)); - - - /* - Apply the "first-of-type" class to the first UL to mimic - the "first-of-type" CSS3 psuedo class. - */ - - if (this._aListElements[0]) { - - Dom.addClass(this._aListElements[0], "first-of-type"); - - } - - } - - } - - - oNode = null; - - this.logger.log("Searching DOM for items to initialize."); - - - if (sSrcElementTagName) { - - switch (sSrcElementTagName) { - - case "DIV": - - aListElements = this._aListElements; - nListElements = aListElements.length; - - if (nListElements > 0) { - - this.logger.log("Found " + nListElements + - " item groups to initialize."); - - i = nListElements - 1; - - do { - - oNode = aListElements[i].firstChild; - - if (oNode) { - - this.logger.log("Scanning " + - aListElements[i].childNodes.length + - " child nodes for items to initialize."); - - do { - - if (oNode && oNode.tagName && - oNode.tagName.toUpperCase() == "LI") { - - this.logger.log("Initializing " + - oNode.tagName + " node."); - - this.addItem(new this.ITEM_TYPE(oNode, - { parent: this }), i); - - } - - } - while ((oNode = oNode.nextSibling)); - - } - - } - while (i--); - - } - - break; - - case "SELECT": - - this.logger.log("Scanning " + - oSrcElement.childNodes.length + - " child nodes for items to initialize."); - - oNode = oSrcElement.firstChild; - - do { - - if (oNode && oNode.tagName) { - - switch (oNode.tagName.toUpperCase()) { - - case "OPTGROUP": - case "OPTION": - - this.logger.log("Initializing " + - oNode.tagName + " node."); - - this.addItem( - new this.ITEM_TYPE( - oNode, - { parent: this } - ) - ); - - break; - - } - - } - - } - while ((oNode = oNode.nextSibling)); - - break; - - } - - } - - } - -}, - - -/** -* @method _getFirstEnabledItem -* @description Returns the first enabled item in the menu. -* @return {YAHOO.widget.MenuItem} -* @private -*/ -_getFirstEnabledItem: function () { - - var aItems = this.getItems(), - nItems = aItems.length, - oItem; - - for(var i=0; i= aGroup.length); - - - if (aGroup[p_nItemIndex]) { - - aGroup.splice(p_nItemIndex, 0, oItem); - - } - else { - - aGroup[p_nItemIndex] = oItem; - - } - - - oGroupItem = aGroup[p_nItemIndex]; - - if (oGroupItem) { - - if (bAppend && (!oGroupItem.element.parentNode || - oGroupItem.element.parentNode.nodeType == 11)) { - - this._aListElements[nGroupIndex].appendChild( - oGroupItem.element); - - } - else { - - oNextItemSibling = getNextItemSibling(aGroup, - (p_nItemIndex+1)); - - if (oNextItemSibling && (!oGroupItem.element.parentNode || - oGroupItem.element.parentNode.nodeType == 11)) { - - this._aListElements[nGroupIndex].insertBefore( - oGroupItem.element, - oNextItemSibling.element); - - } - - } - - - oGroupItem.parent = this; - - this._subscribeToItemEvents(oGroupItem); - - this._configureSubmenu(oGroupItem); - - this._updateItemProperties(nGroupIndex); - - this.logger.log("Item inserted." + - " Text: " + oGroupItem.cfg.getProperty("text") + ", " + - " Index: " + oGroupItem.index + ", " + - " Group Index: " + oGroupItem.groupIndex); - - this.itemAddedEvent.fire(oGroupItem); - this.changeContentEvent.fire(); - - return oGroupItem; - - } - - } - else { - - nItemIndex = aGroup.length; - - aGroup[nItemIndex] = oItem; - - oGroupItem = aGroup[nItemIndex]; - - - if (oGroupItem) { - - if (!Dom.isAncestor(this._aListElements[nGroupIndex], - oGroupItem.element)) { - - this._aListElements[nGroupIndex].appendChild( - oGroupItem.element); - - } - - oGroupItem.element.setAttribute("groupindex", nGroupIndex); - oGroupItem.element.setAttribute("index", nItemIndex); - - oGroupItem.parent = this; - - oGroupItem.index = nItemIndex; - oGroupItem.groupIndex = nGroupIndex; - - this._subscribeToItemEvents(oGroupItem); - - this._configureSubmenu(oGroupItem); - - if (nItemIndex === 0) { - - Dom.addClass(oGroupItem.element, "first-of-type"); - - } - - this.logger.log("Item added." + - " Text: " + oGroupItem.cfg.getProperty("text") + ", " + - " Index: " + oGroupItem.index + ", " + - " Group Index: " + oGroupItem.groupIndex); - - - this.itemAddedEvent.fire(oGroupItem); - this.changeContentEvent.fire(); - - return oGroupItem; - - } - - } - - } - -}, - - -/** -* @method _removeItemFromGroupByIndex -* @description Removes a menu item from a group by index. Returns the menu -* item that was removed. -* @private -* @param {Number} p_nGroupIndex Number indicating the group to which the menu -* item belongs. -* @param {Number} p_nItemIndex Number indicating the index of the menu item -* to be removed. -* @return {YAHOO.widget.MenuItem} -*/ -_removeItemFromGroupByIndex: function (p_nGroupIndex, p_nItemIndex) { - - var nGroupIndex = typeof p_nGroupIndex == "number" ? p_nGroupIndex : 0, - aGroup = this._getItemGroup(nGroupIndex), - aArray, - oItem, - oUL; - - if (aGroup) { - - aArray = aGroup.splice(p_nItemIndex, 1); - oItem = aArray[0]; - - if (oItem) { - - // Update the index and className properties of each member - - this._updateItemProperties(nGroupIndex); - - if (aGroup.length === 0) { - - // Remove the UL - - oUL = this._aListElements[nGroupIndex]; - - if (this.body && oUL) { - - this.body.removeChild(oUL); - - } - - // Remove the group from the array of items - - this._aItemGroups.splice(nGroupIndex, 1); - - - // Remove the UL from the array of ULs - - this._aListElements.splice(nGroupIndex, 1); - - - /* - Assign the "first-of-type" class to the new first UL - in the collection - */ - - oUL = this._aListElements[0]; - - if (oUL) { - - Dom.addClass(oUL, "first-of-type"); - - } - - } - - - this.itemRemovedEvent.fire(oItem); - this.changeContentEvent.fire(); - - - // Return a reference to the item that was removed - - return oItem; - - } - - } - -}, - - -/** -* @method _removeItemFromGroupByValue -* @description Removes a menu item from a group by reference. Returns the -* menu item that was removed. -* @private -* @param {Number} p_nGroupIndex Number indicating the group to which the -* menu item belongs. -* @param {YAHOO.widget.MenuItem} p_oItem Object reference for the MenuItem -* instance to be removed. -* @return {YAHOO.widget.MenuItem} -*/ -_removeItemFromGroupByValue: function (p_nGroupIndex, p_oItem) { - - var aGroup = this._getItemGroup(p_nGroupIndex), - nItems, - nItemIndex, - i; - - if (aGroup) { - - nItems = aGroup.length; - nItemIndex = -1; - - if (nItems > 0) { - - i = nItems-1; - - do { - - if (aGroup[i] == p_oItem) { - - nItemIndex = i; - break; - - } - - } - while(i--); - - if (nItemIndex > -1) { - - return (this._removeItemFromGroupByIndex(p_nGroupIndex, - nItemIndex)); - - } - - } - - } - -}, - - -/** -* @method _updateItemProperties -* @description Updates the "index," "groupindex," and "className" properties -* of the menu items in the specified group. -* @private -* @param {Number} p_nGroupIndex Number indicating the group of items to update. -*/ -_updateItemProperties: function (p_nGroupIndex) { - - var aGroup = this._getItemGroup(p_nGroupIndex), - nItems = aGroup.length, - oItem, - oLI, - i; - - - if (nItems > 0) { - - i = nItems - 1; - - // Update the index and className properties of each member - - do { - - oItem = aGroup[i]; - - if (oItem) { - - oLI = oItem.element; - - oItem.index = i; - oItem.groupIndex = p_nGroupIndex; - - oLI.setAttribute("groupindex", p_nGroupIndex); - oLI.setAttribute("index", i); - - Dom.removeClass(oLI, "first-of-type"); - - } - - } - while(i--); - - - if (oLI) { - - Dom.addClass(oLI, "first-of-type"); - - } - - } - -}, - - -/** -* @method _createItemGroup -* @description Creates a new menu item group (array) and its associated -* <ul> element. Returns an aray of menu item groups. -* @private -* @param {Number} p_nIndex Number indicating the group to create. -* @return {Array} -*/ -_createItemGroup: function (p_nIndex) { - - var oUL; - - if (!this._aItemGroups[p_nIndex]) { - - this._aItemGroups[p_nIndex] = []; - - oUL = document.createElement("ul"); - - this._aListElements[p_nIndex] = oUL; - - return this._aItemGroups[p_nIndex]; - - } - -}, - - -/** -* @method _getItemGroup -* @description Returns the menu item group at the specified index. -* @private -* @param {Number} p_nIndex Number indicating the index of the menu item group -* to be retrieved. -* @return {Array} -*/ -_getItemGroup: function (p_nIndex) { - - var nIndex = ((typeof p_nIndex == "number") ? p_nIndex : 0); - - return this._aItemGroups[nIndex]; - -}, - - -/** -* @method _configureSubmenu -* @description Subscribes the menu item's submenu to its parent menu's events. -* @private -* @param {YAHOO.widget.MenuItem} p_oItem Object reference for the MenuItem -* instance with the submenu to be configured. -*/ -_configureSubmenu: function (p_oItem) { - - var oSubmenu = p_oItem.cfg.getProperty("submenu"); - - if (oSubmenu) { - - /* - Listen for configuration changes to the parent menu - so they they can be applied to the submenu. - */ - - this.cfg.configChangedEvent.subscribe(this._onParentMenuConfigChange, - oSubmenu, true); - - this.renderEvent.subscribe(this._onParentMenuRender, oSubmenu, true); - - oSubmenu.beforeShowEvent.subscribe(this._onSubmenuBeforeShow); - - } - -}, - - - - -/** -* @method _subscribeToItemEvents -* @description Subscribes a menu to a menu item's event. -* @private -* @param {YAHOO.widget.MenuItem} p_oItem Object reference for the MenuItem -* instance whose events should be subscribed to. -*/ -_subscribeToItemEvents: function (p_oItem) { - - p_oItem.focusEvent.subscribe(this._onMenuItemFocus); - - p_oItem.blurEvent.subscribe(this._onMenuItemBlur); - - p_oItem.destroyEvent.subscribe(this._onMenuItemDestroy, p_oItem, this); - - p_oItem.cfg.configChangedEvent.subscribe(this._onMenuItemConfigChange, - p_oItem, this); - -}, - - -/** -* @method _onVisibleChange -* @description Change event handler for the the menu's "visible" configuration -* property. -* @private -* @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. -*/ -_onVisibleChange: function (p_sType, p_aArgs) { - - var bVisible = p_aArgs[0]; - - if (bVisible) { - - Dom.addClass(this.element, "visible"); - - } - else { - - Dom.removeClass(this.element, "visible"); - - } - -}, - - -/** -* @method _cancelHideDelay -* @description Cancels the call to "hideMenu." -* @private -*/ -_cancelHideDelay: function () { - - var oRoot = this.getRoot(); - - if (oRoot._nHideDelayId) { - - window.clearTimeout(oRoot._nHideDelayId); - - } - -}, - - -/** -* @method _execHideDelay -* @description Hides the menu after the number of milliseconds specified by -* the "hidedelay" configuration property. -* @private -*/ -_execHideDelay: function () { - - this._cancelHideDelay(); - - var oRoot = this.getRoot(), - me = this; - - function hideMenu() { - - if (oRoot.activeItem) { - - oRoot.clearActiveItem(); - - } - - if (oRoot == me && !(me instanceof YAHOO.widget.MenuBar) && - me.cfg.getProperty("position") == "dynamic") { - - me.hide(); - - } - - } - - - oRoot._nHideDelayId = - window.setTimeout(hideMenu, oRoot.cfg.getProperty("hidedelay")); - -}, - - -/** -* @method _cancelShowDelay -* @description Cancels the call to the "showMenu." -* @private -*/ -_cancelShowDelay: function () { - - var oRoot = this.getRoot(); - - if (oRoot._nShowDelayId) { - - window.clearTimeout(oRoot._nShowDelayId); - - } - -}, - - -/** -* @method _execShowDelay -* @description Shows the menu after the number of milliseconds specified by -* the "showdelay" configuration property have ellapsed. -* @private -* @param {YAHOO.widget.Menu} p_oMenu Object specifying the menu that should -* be made visible. -*/ -_execShowDelay: function (p_oMenu) { - - var oRoot = this.getRoot(); - - function showMenu() { - - if (p_oMenu.parent.cfg.getProperty("selected")) { - - p_oMenu.show(); - - } - - } - - - oRoot._nShowDelayId = - window.setTimeout(showMenu, oRoot.cfg.getProperty("showdelay")); - -}, - - -/** -* @method _execSubmenuHideDelay -* @description Hides a submenu after the number of milliseconds specified by -* the "submenuhidedelay" configuration property have ellapsed. -* @private -* @param {YAHOO.widget.Menu} p_oSubmenu Object specifying the submenu that -* should be hidden. -* @param {Number} p_nMouseX The x coordinate of the mouse when it left -* the specified submenu's parent menu item. -* @param {Number} p_nHideDelay The number of milliseconds that should ellapse -* before the submenu is hidden. -*/ -_execSubmenuHideDelay: function (p_oSubmenu, p_nMouseX, p_nHideDelay) { - - var me = this; - - p_oSubmenu._nSubmenuHideDelayId = window.setTimeout(function () { - - if (me._nCurrentMouseX > (p_nMouseX + 10)) { - - p_oSubmenu._nSubmenuHideDelayId = window.setTimeout(function () { - - p_oSubmenu.hide(); - - }, p_nHideDelay); - - } - else { - - p_oSubmenu.hide(); - - } - - }, 50); - -}, - - - -// Protected methods - - -/** -* @method _disableScrollHeader -* @description Disables the header used for scrolling the body of the menu. -* @protected -*/ -_disableScrollHeader: function () { - - if (!this._bHeaderDisabled) { - - Dom.addClass(this.header, "topscrollbar_disabled"); - this._bHeaderDisabled = true; - - } - -}, - - -/** -* @method _disableScrollFooter -* @description Disables the footer used for scrolling the body of the menu. -* @protected -*/ -_disableScrollFooter: function () { - - if (!this._bFooterDisabled) { - - Dom.addClass(this.footer, "bottomscrollbar_disabled"); - this._bFooterDisabled = true; - - } - -}, - - -/** -* @method _enableScrollHeader -* @description Enables the header used for scrolling the body of the menu. -* @protected -*/ -_enableScrollHeader: function () { - - if (this._bHeaderDisabled) { - - Dom.removeClass(this.header, "topscrollbar_disabled"); - this._bHeaderDisabled = false; - - } - -}, - - -/** -* @method _enableScrollFooter -* @description Enables the footer used for scrolling the body of the menu. -* @protected -*/ -_enableScrollFooter: function () { - - if (this._bFooterDisabled) { - - Dom.removeClass(this.footer, "bottomscrollbar_disabled"); - this._bFooterDisabled = false; - - } - -}, - - -/** -* @method _onMouseOver -* @description "mouseover" event handler for the menu. -* @protected -* @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. -*/ -_onMouseOver: function (p_sType, p_aArgs) { - - if (this._bStopMouseEventHandlers) { - - return false; - - } - - - var oEvent = p_aArgs[0], - oItem = p_aArgs[1], - oTarget = Event.getTarget(oEvent), - oParentMenu, - nShowDelay, - bShowDelay, - oActiveItem, - oItemCfg, - oSubmenu; - - - if (!this._bHandledMouseOverEvent && (oTarget == this.element || - Dom.isAncestor(this.element, oTarget))) { - - // Menu mouseover logic - - this._nCurrentMouseX = 0; - - Event.on(this.element, "mousemove", this._onMouseMove, this, true); - - - if (!Dom.isAncestor(oItem.element, Event.getRelatedTarget(oEvent))) { - - this.clearActiveItem(); - - } - - - if (this.parent && this._nSubmenuHideDelayId) { - - window.clearTimeout(this._nSubmenuHideDelayId); - - this.parent.cfg.setProperty("selected", true); - - oParentMenu = this.parent.parent; - - oParentMenu._bHandledMouseOutEvent = true; - oParentMenu._bHandledMouseOverEvent = false; - - } - - - this._bHandledMouseOverEvent = true; - this._bHandledMouseOutEvent = false; - - } - - - if (oItem && !oItem.handledMouseOverEvent && - !oItem.cfg.getProperty("disabled") && - (oTarget == oItem.element || Dom.isAncestor(oItem.element, oTarget))) { - - // Menu Item mouseover logic - - nShowDelay = this.cfg.getProperty("showdelay"); - bShowDelay = (nShowDelay > 0); - - - if (bShowDelay) { - - this._cancelShowDelay(); - - } - - - oActiveItem = this.activeItem; - - if (oActiveItem) { - - oActiveItem.cfg.setProperty("selected", false); - - } - - - oItemCfg = oItem.cfg; - - // Select and focus the current menu item - - oItemCfg.setProperty("selected", true); - - - if (this.hasFocus()) { - - oItem.focus(); - - } - - - if (this.cfg.getProperty("autosubmenudisplay")) { - - // Show the submenu this menu item - - oSubmenu = oItemCfg.getProperty("submenu"); - - if (oSubmenu) { - - if (bShowDelay) { - - this._execShowDelay(oSubmenu); - - } - else { - - oSubmenu.show(); - - } - - } - - } - - oItem.handledMouseOverEvent = true; - oItem.handledMouseOutEvent = false; - - } - -}, - - -/** -* @method _onMouseOut -* @description "mouseout" event handler for the menu. -* @protected -* @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. -*/ -_onMouseOut: function (p_sType, p_aArgs) { - - if (this._bStopMouseEventHandlers) { - - return false; - - } - - - var oEvent = p_aArgs[0], - oItem = p_aArgs[1], - oRelatedTarget = Event.getRelatedTarget(oEvent), - bMovingToSubmenu = false, - oItemCfg, - oSubmenu, - nSubmenuHideDelay, - nShowDelay; - - - if (oItem && !oItem.cfg.getProperty("disabled")) { - - oItemCfg = oItem.cfg; - oSubmenu = oItemCfg.getProperty("submenu"); - - - if (oSubmenu && (oRelatedTarget == oSubmenu.element || - Dom.isAncestor(oSubmenu.element, oRelatedTarget))) { - - bMovingToSubmenu = true; - - } - - - if (!oItem.handledMouseOutEvent && ((oRelatedTarget != oItem.element && - !Dom.isAncestor(oItem.element, oRelatedTarget)) || - bMovingToSubmenu)) { - - // Menu Item mouseout logic - - if (!bMovingToSubmenu) { - - oItem.cfg.setProperty("selected", false); - - - if (oSubmenu) { - - nSubmenuHideDelay = - this.cfg.getProperty("submenuhidedelay"); - - nShowDelay = this.cfg.getProperty("showdelay"); - - if (!(this instanceof YAHOO.widget.MenuBar) && - nSubmenuHideDelay > 0 && - nShowDelay >= nSubmenuHideDelay) { - - this._execSubmenuHideDelay(oSubmenu, - Event.getPageX(oEvent), - nSubmenuHideDelay); - - } - else { - - oSubmenu.hide(); - - } - - } - - } - - - oItem.handledMouseOutEvent = true; - oItem.handledMouseOverEvent = false; - - } - - } - - - if (!this._bHandledMouseOutEvent && ((oRelatedTarget != this.element && - !Dom.isAncestor(this.element, oRelatedTarget)) || bMovingToSubmenu)) { - - // Menu mouseout logic - - Event.removeListener(this.element, "mousemove", this._onMouseMove); - - this._nCurrentMouseX = Event.getPageX(oEvent); - - this._bHandledMouseOutEvent = true; - this._bHandledMouseOverEvent = false; - - } - -}, - - -/** -* @method _onMouseMove -* @description "click" event handler for the menu. -* @protected -* @param {Event} p_oEvent Object representing the DOM event object passed -* back by the event utility (YAHOO.util.Event). -* @param {YAHOO.widget.Menu} p_oMenu Object representing the menu that -* fired the event. -*/ -_onMouseMove: function (p_oEvent, p_oMenu) { - - if (this._bStopMouseEventHandlers) { - - return false; - - } - - this._nCurrentMouseX = Event.getPageX(p_oEvent); - -}, - - -/** -* @method _onClick -* @description "click" event handler for the menu. -* @protected -* @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. -*/ -_onClick: function (p_sType, p_aArgs) { - - var Event = YAHOO.util.Event, - Dom = YAHOO.util.Dom, - oEvent = p_aArgs[0], - oItem = p_aArgs[1], - oSubmenu, - bInMenuAnchor = false, - oRoot, - sId, - sURL, - nHashPos, - nLen; - - - if (oItem) { - - if (oItem.cfg.getProperty("disabled")) { - - Event.preventDefault(oEvent); - - } - else { - - oSubmenu = oItem.cfg.getProperty("submenu"); - - - /* - Check if the URL of the anchor is pointing to an element that is - a child of the menu. - */ - - sURL = oItem.cfg.getProperty("url"); - - - if (sURL) { - - nHashPos = sURL.indexOf("#"); - - nLen = sURL.length; - - - if (nHashPos != -1) { - - sURL = sURL.substr(nHashPos, nLen); - - nLen = sURL.length; - - - if (nLen > 1) { - - sId = sURL.substr(1, nLen); - - bInMenuAnchor = Dom.isAncestor(this.element, sId); - - } - else if (nLen === 1) { - - bInMenuAnchor = true; - - } - - } - - } - - - - if (bInMenuAnchor && !oItem.cfg.getProperty("target")) { - - Event.preventDefault(oEvent); - - oItem.focus(); - - } - - - if (!oSubmenu) { - - oRoot = this.getRoot(); - - if (oRoot instanceof YAHOO.widget.MenuBar || - oRoot.cfg.getProperty("position") == "static") { - - oRoot.clearActiveItem(); - - } - else { - - oRoot.hide(); - - } - - } - - } - - } - -}, - - -/** -* @method _onKeyDown -* @description "keydown" event handler for the menu. -* @protected -* @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. -*/ -_onKeyDown: function (p_sType, p_aArgs) { - - var oEvent = p_aArgs[0], - oItem = p_aArgs[1], - me = this, - oSubmenu, - oItemCfg, - oParentItem, - oRoot, - oNextItem, - oBody, - nBodyScrollTop, - nBodyOffsetHeight, - aItems, - nItems, - nNextItemOffsetTop, - nScrollTarget, - oParentMenu; - - - /* - This function is called to prevent a bug in Firefox. In Firefox, - moving a DOM element into a stationary mouse pointer will cause the - browser to fire mouse events. This can result in the menu mouse - event handlers being called uncessarily, especially when menus are - moved into a stationary mouse pointer as a result of a - key event handler. - */ - function stopMouseEventHandlers() { - - me._bStopMouseEventHandlers = true; - - window.setTimeout(function () { - - me._bStopMouseEventHandlers = false; - - }, 10); - - } - - - if (oItem && !oItem.cfg.getProperty("disabled")) { - - oItemCfg = oItem.cfg; - oParentItem = this.parent; - - switch(oEvent.keyCode) { - - case 38: // Up arrow - case 40: // Down arrow - - oNextItem = (oEvent.keyCode == 38) ? - oItem.getPreviousEnabledSibling() : - oItem.getNextEnabledSibling(); - - if (oNextItem) { - - this.clearActiveItem(); - - oNextItem.cfg.setProperty("selected", true); - oNextItem.focus(); - - - if (this.cfg.getProperty("maxheight") > 0) { - - oBody = this.body; - nBodyScrollTop = oBody.scrollTop; - nBodyOffsetHeight = oBody.offsetHeight; - aItems = this.getItems(); - nItems = aItems.length - 1; - nNextItemOffsetTop = oNextItem.element.offsetTop; - - - if (oEvent.keyCode == 40 ) { // Down - - if (nNextItemOffsetTop >= (nBodyOffsetHeight + nBodyScrollTop)) { - - oBody.scrollTop = nNextItemOffsetTop - nBodyOffsetHeight; - - } - else if (nNextItemOffsetTop <= nBodyScrollTop) { - - oBody.scrollTop = 0; - - } - - - if (oNextItem == aItems[nItems]) { - - oBody.scrollTop = oNextItem.element.offsetTop; - - } - - } - else { // Up - - if (nNextItemOffsetTop <= nBodyScrollTop) { - - oBody.scrollTop = nNextItemOffsetTop - oNextItem.element.offsetHeight; - - } - else if (nNextItemOffsetTop >= (nBodyScrollTop + nBodyOffsetHeight)) { - - oBody.scrollTop = nNextItemOffsetTop; - - } - - - if (oNextItem == aItems[0]) { - - oBody.scrollTop = 0; - - } - - } - - - nBodyScrollTop = oBody.scrollTop; - nScrollTarget = oBody.scrollHeight - oBody.offsetHeight; - - if (nBodyScrollTop === 0) { - - this._disableScrollHeader(); - this._enableScrollFooter(); - - } - else if (nBodyScrollTop == nScrollTarget) { - - this._enableScrollHeader(); - this._disableScrollFooter(); - - } - else { - - this._enableScrollHeader(); - this._enableScrollFooter(); - - } - - } - - } - - - Event.preventDefault(oEvent); - - stopMouseEventHandlers(); - - break; - - - case 39: // Right arrow - - oSubmenu = oItemCfg.getProperty("submenu"); - - if (oSubmenu) { - - if (!oItemCfg.getProperty("selected")) { - - oItemCfg.setProperty("selected", true); - - } - - oSubmenu.show(); - oSubmenu.setInitialFocus(); - oSubmenu.setInitialSelection(); - - } - else { - - oRoot = this.getRoot(); - - if (oRoot instanceof YAHOO.widget.MenuBar) { - - oNextItem = oRoot.activeItem.getNextEnabledSibling(); - - if (oNextItem) { - - oRoot.clearActiveItem(); - - oNextItem.cfg.setProperty("selected", true); - - oSubmenu = oNextItem.cfg.getProperty("submenu"); - - if (oSubmenu) { - - oSubmenu.show(); - - } - - oNextItem.focus(); - - } - - } - - } - - - Event.preventDefault(oEvent); - - stopMouseEventHandlers(); - - break; - - - case 37: // Left arrow - - if (oParentItem) { - - oParentMenu = oParentItem.parent; - - if (oParentMenu instanceof YAHOO.widget.MenuBar) { - - oNextItem = - oParentMenu.activeItem.getPreviousEnabledSibling(); - - if (oNextItem) { - - oParentMenu.clearActiveItem(); - - oNextItem.cfg.setProperty("selected", true); - - oSubmenu = oNextItem.cfg.getProperty("submenu"); - - if (oSubmenu) { - - oSubmenu.show(); - - } - - oNextItem.focus(); - - } - - } - else { - - this.hide(); - - oParentItem.focus(); - - } - - } - - Event.preventDefault(oEvent); - - stopMouseEventHandlers(); - - break; - - } - - - } - - - if (oEvent.keyCode == 27) { // Esc key - - if (this.cfg.getProperty("position") == "dynamic") { - - this.hide(); - - if (this.parent) { - - this.parent.focus(); - - } - - } - else if (this.activeItem) { - - oSubmenu = this.activeItem.cfg.getProperty("submenu"); - - if (oSubmenu && oSubmenu.cfg.getProperty("visible")) { - - oSubmenu.hide(); - this.activeItem.focus(); - - } - else { - - this.activeItem.blur(); - this.activeItem.cfg.setProperty("selected", false); - - } - - } - - - Event.preventDefault(oEvent); - - } - -}, - - -/** -* @method _onKeyPress -* @description "keypress" event handler for a Menu instance. -* @protected -* @param {String} p_sType The name of the event that was fired. -* @param {Array} p_aArgs Collection of arguments sent when the event -* was fired. -*/ -_onKeyPress: function (p_sType, p_aArgs) { - - var oEvent = p_aArgs[0]; - - - if (oEvent.keyCode == 40 || oEvent.keyCode == 38) { - - Event.preventDefault(oEvent); - - } - -}, - - -/** -* @method _onYChange -* @description "y" event handler for a Menu instance. -* @protected -* @param {String} p_sType The name of the event that was fired. -* @param {Array} p_aArgs Collection of arguments sent when the event -* was fired. -*/ -_onYChange: function (p_sType, p_aArgs) { - - var oParent = this.parent, - nScrollTop, - oIFrame, - nY; - - - if (oParent) { - - nScrollTop = oParent.parent.body.scrollTop; - - - if (nScrollTop > 0) { - - nY = (this.cfg.getProperty("y") - nScrollTop); - - Dom.setY(this.element, nY); - - oIFrame = this.iframe; - - - if (oIFrame) { - - Dom.setY(oIFrame, nY); - - } - - this.cfg.setProperty("y", nY, true); - - } - - } - -}, - - -/** -* @method _onScrollTargetMouseOver -* @description "mouseover" event handler for the menu's "header" and "footer" -* elements. Used to scroll the body of the menu up and down when the -* menu's "maxheight" configuration property is set to a value greater than 0. -* @protected -* @param {Event} p_oEvent Object representing the DOM event object passed -* back by the event utility (YAHOO.util.Event). -* @param {YAHOO.widget.Menu} p_oMenu Object representing the menu that -* fired the event. -*/ -_onScrollTargetMouseOver: function (p_oEvent, p_oMenu) { - - this._cancelHideDelay(); - - var oTarget = Event.getTarget(p_oEvent), - oBody = this.body, - me = this, - nScrollIncrement = this.cfg.getProperty("scrollincrement"), - nScrollTarget, - fnScrollFunction; - - - function scrollBodyDown() { - - var nScrollTop = oBody.scrollTop; - - - if (nScrollTop < nScrollTarget) { - - oBody.scrollTop = (nScrollTop + nScrollIncrement); - - me._enableScrollHeader(); - - } - else { - - oBody.scrollTop = nScrollTarget; - - window.clearInterval(me._nBodyScrollId); - - me._disableScrollFooter(); - - } - - } - - - function scrollBodyUp() { - - var nScrollTop = oBody.scrollTop; - - - if (nScrollTop > 0) { - - oBody.scrollTop = (nScrollTop - nScrollIncrement); - - me._enableScrollFooter(); - - } - else { - - oBody.scrollTop = 0; - - window.clearInterval(me._nBodyScrollId); - - me._disableScrollHeader(); - - } - - } - - - if (Dom.hasClass(oTarget, "hd")) { - - fnScrollFunction = scrollBodyUp; - - } - else { - - nScrollTarget = oBody.scrollHeight - oBody.offsetHeight; - - fnScrollFunction = scrollBodyDown; - - } - - - this._nBodyScrollId = window.setInterval(fnScrollFunction, 10); - -}, - - -/** -* @method _onScrollTargetMouseOut -* @description "mouseout" event handler for the menu's "header" and "footer" -* elements. Used to stop scrolling the body of the menu up and down when the -* menu's "maxheight" configuration property is set to a value greater than 0. -* @protected -* @param {Event} p_oEvent Object representing the DOM event object passed -* back by the event utility (YAHOO.util.Event). -* @param {YAHOO.widget.Menu} p_oMenu Object representing the menu that -* fired the event. -*/ -_onScrollTargetMouseOut: function (p_oEvent, p_oMenu) { - - window.clearInterval(this._nBodyScrollId); - - this._cancelHideDelay(); - -}, - - - -// Private methods - - -/** -* @method _onInit -* @description "init" event handler for the menu. -* @private -* @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. -*/ -_onInit: function (p_sType, p_aArgs) { - - this.cfg.subscribeToConfigEvent("visible", this._onVisibleChange); - - var bRootMenu = !this.parent, - bLazyLoad = this.lazyLoad; - - - /* - Automatically initialize a menu's subtree if: - - 1) This is the root menu and lazyload is off - - 2) This is the root menu, lazyload is on, but the menu is - already visible - - 3) This menu is a submenu and lazyload is off - */ - - - - if (((bRootMenu && !bLazyLoad) || - (bRootMenu && (this.cfg.getProperty("visible") || - this.cfg.getProperty("position") == "static")) || - (!bRootMenu && !bLazyLoad)) && this.getItemGroups().length === 0) { - - if (this.srcElement) { - - this._initSubTree(); - - } - - - if (this.itemData) { - - this.addItems(this.itemData); - - } - - } - else if (bLazyLoad) { - - this.cfg.fireQueue(); - - } - -}, - - -/** -* @method _onBeforeRender -* @description "beforerender" event handler for the menu. Appends all of the -* <ul>, <li> and their accompanying -* title elements to the body element of the menu. -* @private -* @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. -*/ -_onBeforeRender: function (p_sType, p_aArgs) { - - var oEl = this.element, - nListElements = this._aListElements.length, - bFirstList = true, - i = 0, - oUL, - oGroupTitle; - - if (nListElements > 0) { - - do { - - oUL = this._aListElements[i]; - - if (oUL) { - - if (bFirstList) { - - Dom.addClass(oUL, "first-of-type"); - bFirstList = false; - - } - - - if (!Dom.isAncestor(oEl, oUL)) { - - this.appendToBody(oUL); - - } - - - oGroupTitle = this._aGroupTitleElements[i]; - - if (oGroupTitle) { - - if (!Dom.isAncestor(oEl, oGroupTitle)) { - - oUL.parentNode.insertBefore(oGroupTitle, oUL); - - } - - - Dom.addClass(oUL, "hastitle"); - - } - - } - - i++; - - } - while(i < nListElements); - - } - -}, - - -/** -* @method _onRender -* @description "render" event handler for the menu. -* @private -* @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. -*/ -_onRender: function (p_sType, p_aArgs) { - - if (this.cfg.getProperty("position") == "dynamic") { - - if (!this.cfg.getProperty("visible")) { - - this.positionOffScreen(); - - } - - } - -}, - - - - - -/** -* @method _onBeforeShow -* @description "beforeshow" event handler for the menu. -* @private -* @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. -*/ -_onBeforeShow: function (p_sType, p_aArgs) { - - var nOptions, - n, - nViewportHeight, - oRegion, - oSrcElement; - - - if (this.lazyLoad && this.getItemGroups().length === 0) { - - if (this.srcElement) { - - this._initSubTree(); - - } - - - if (this.itemData) { - - if (this.parent && this.parent.parent && - this.parent.parent.srcElement && - this.parent.parent.srcElement.tagName.toUpperCase() == - "SELECT") { - - nOptions = this.itemData.length; - - for(n=0; n= nViewportHeight) { - - nMaxHeight = (nViewportHeight - (Overlay.VIEWPORT_OFFSET * 2)); - - if (nMaxHeight < nMinScrollHeight) { - - nMaxHeight = nMinScrollHeight; - - } - - this.cfg.setProperty("maxheight", nMaxHeight); - - this.hideEvent.subscribe(clearMaxHeight); - - } - - } - - } - -}, - - -/** -* @method _onShow -* @description "show" event handler for the menu. -* @private -* @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. -*/ -_onShow: function (p_sType, p_aArgs) { - - var oParent = this.parent, - oParentMenu, - aParentAlignment, - aAlignment; - - - function disableAutoSubmenuDisplay(p_oEvent) { - - var oTarget; - - if (p_oEvent.type == "mousedown" || (p_oEvent.type == "keydown" && - p_oEvent.keyCode == 27)) { - - /* - Set the "autosubmenudisplay" to "false" if the user - clicks outside the menu bar. - */ - - oTarget = Event.getTarget(p_oEvent); - - if (oTarget != oParentMenu.element || - !Dom.isAncestor(oParentMenu.element, oTarget)) { - - oParentMenu.cfg.setProperty("autosubmenudisplay", false); - - Event.removeListener(document, "mousedown", - disableAutoSubmenuDisplay); - - Event.removeListener(document, "keydown", - disableAutoSubmenuDisplay); - - } - - } - - } - - - if (oParent) { - - oParentMenu = oParent.parent; - aParentAlignment = oParentMenu.cfg.getProperty("submenualignment"); - aAlignment = this.cfg.getProperty("submenualignment"); - - - if ((aParentAlignment[0] != aAlignment[0]) && - (aParentAlignment[1] != aAlignment[1])) { - - this.cfg.setProperty("submenualignment", - [aParentAlignment[0], aParentAlignment[1]]); - - } - - - if (!oParentMenu.cfg.getProperty("autosubmenudisplay") && - (oParentMenu instanceof YAHOO.widget.MenuBar || - oParentMenu.cfg.getProperty("position") == "static")) { - - oParentMenu.cfg.setProperty("autosubmenudisplay", true); - - Event.on(document, "mousedown", disableAutoSubmenuDisplay); - Event.on(document, "keydown", disableAutoSubmenuDisplay); - - } - - } - -}, - - -/** -* @method _onBeforeHide -* @description "beforehide" event handler for the menu. -* @private -* @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. -*/ -_onBeforeHide: function (p_sType, p_aArgs) { - - var oActiveItem = this.activeItem, - oConfig, - oSubmenu; - - if (oActiveItem) { - - oConfig = oActiveItem.cfg; - - oConfig.setProperty("selected", false); - - oSubmenu = oConfig.getProperty("submenu"); - - if (oSubmenu) { - - oSubmenu.hide(); - - } - - } - - if (this.getRoot() == this) { - - this.blur(); - - } - -}, - - -/** -* @method _onParentMenuConfigChange -* @description "configchange" event handler for a submenu. -* @private -* @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.Menu} p_oSubmenu Object representing the submenu that -* subscribed to the event. -*/ -_onParentMenuConfigChange: function (p_sType, p_aArgs, p_oSubmenu) { - - var sPropertyName = p_aArgs[0][0], - oPropertyValue = p_aArgs[0][1]; - - switch(sPropertyName) { - - case "iframe": - case "constraintoviewport": - case "hidedelay": - case "showdelay": - case "submenuhidedelay": - case "clicktohide": - case "effect": - case "classname": - case "scrollincrement": - case "minscrollheight": - - p_oSubmenu.cfg.setProperty(sPropertyName, oPropertyValue); - - break; - - } - -}, - - -/** -* @method _onParentMenuRender -* @description "render" event handler for a submenu. Renders a -* submenu in response to the firing of its parent's "render" event. -* @private -* @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.Menu} p_oSubmenu Object representing the submenu that -* subscribed to the event. -*/ -_onParentMenuRender: function (p_sType, p_aArgs, p_oSubmenu) { - - var oParentCfg = p_oSubmenu.parent.parent.cfg, - - oConfig = { - - constraintoviewport: oParentCfg.getProperty("constraintoviewport"), - - xy: [0,0], - - clicktohide: oParentCfg.getProperty("clicktohide"), - - effect: oParentCfg.getProperty("effect"), - - showdelay: oParentCfg.getProperty("showdelay"), - - hidedelay: oParentCfg.getProperty("hidedelay"), - - submenuhidedelay: oParentCfg.getProperty("submenuhidedelay"), - - classname: oParentCfg.getProperty("classname"), - - scrollincrement: oParentCfg.getProperty("scrollincrement"), - - minscrollheight: oParentCfg.getProperty("minscrollheight"), - - iframe: oParentCfg.getProperty("iframe") - - }, - - oLI; - - - p_oSubmenu.cfg.applyConfig(oConfig); - - - if (!this.lazyLoad) { - - oLI = this.parent.element; - - if (this.element.parentNode == oLI) { - - this.render(); - - } - else { - - this.render(oLI); - - } - - } - -}, - - -/** -* @method _onSubmenuBeforeShow -* @description "beforeshow" event handler for a submenu. -* @private -* @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. -*/ -_onSubmenuBeforeShow: function (p_sType, p_aArgs) { - - var oParent = this.parent, - aAlignment = oParent.parent.cfg.getProperty("submenualignment"); - - - if (!this.cfg.getProperty("context")) { - - this.cfg.setProperty("context", - [oParent.element, aAlignment[0], aAlignment[1]]); - - } - else { - - this.align(); - - } - -}, - - -/** -* @method _onMenuItemFocus -* @description "focus" event handler for the menu's items. -* @private -* @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. -*/ -_onMenuItemFocus: function (p_sType, p_aArgs) { - - this.parent.focusEvent.fire(this); - -}, - - -/** -* @method _onMenuItemBlur -* @description "blur" event handler for the menu's items. -* @private -* @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. -*/ -_onMenuItemBlur: function (p_sType, p_aArgs) { - - this.parent.blurEvent.fire(this); - -}, - - -/** -* @method _onMenuItemDestroy -* @description "destroy" event handler for the menu's items. -* @private -* @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. -*/ -_onMenuItemDestroy: function (p_sType, p_aArgs, p_oItem) { - - this._removeItemFromGroupByValue(p_oItem.groupIndex, p_oItem); - -}, - - -/** -* @method _onMenuItemConfigChange -* @description "configchange" event handler for the menu's items. -* @private -* @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. -*/ -_onMenuItemConfigChange: function (p_sType, p_aArgs, p_oItem) { - - var sPropertyName = p_aArgs[0][0], - oPropertyValue = p_aArgs[0][1], - oSubmenu; - - - switch(sPropertyName) { - - case "selected": - - if (oPropertyValue === true) { - - this.activeItem = p_oItem; - - } - - break; - - case "submenu": - - oSubmenu = p_aArgs[0][1]; - - if (oSubmenu) { - - this._configureSubmenu(p_oItem); - - } - - break; - - } - -}, - - - -// Public event handlers for configuration properties - - -/** -* @method enforceConstraints -* @description The default event handler executed when the moveEvent is fired, -* if the "constraintoviewport" configuration property is set to true. -* @param {String} type The name of the event that was fired. -* @param {Array} args Collection of arguments sent when the -* event was fired. -* @param {Array} obj Array containing the current Menu instance -* and the item that fired the event. -*/ -enforceConstraints: function (type, args, obj) { - - var oParentMenuItem = this.parent, - nViewportOffset = Overlay.VIEWPORT_OFFSET, - oElement = this.element, - oConfig = this.cfg, - pos = args[0], - offsetHeight = oElement.offsetHeight, - offsetWidth = oElement.offsetWidth, - viewPortWidth = Dom.getViewportWidth(), - viewPortHeight = Dom.getViewportHeight(), - nPadding = (oParentMenuItem && - oParentMenuItem.parent instanceof YAHOO.widget.MenuBar) ? - 0 : nViewportOffset, - aContext = oConfig.getProperty("context"), - oContextElement = aContext ? aContext[0] : null, - topConstraint, - leftConstraint, - bottomConstraint, - rightConstraint, - scrollX, - scrollY, - x, - y; - - - if (offsetWidth < viewPortWidth) { - - x = pos[0]; - scrollX = Dom.getDocumentScrollLeft(); - leftConstraint = scrollX + nPadding; - rightConstraint = scrollX + viewPortWidth - offsetWidth - nPadding; - - if (x < nViewportOffset) { - - x = leftConstraint; - - } else if ((x + offsetWidth) > viewPortWidth) { - - if(oContextElement && - ((x - oContextElement.offsetWidth) > offsetWidth)) { - - if (oParentMenuItem && - oParentMenuItem.parent instanceof YAHOO.widget.MenuBar) { - - x = (x - (offsetWidth - oContextElement.offsetWidth)); - - } - else { - - x = (x - (oContextElement.offsetWidth + offsetWidth)); - - } - - } - else { - - x = rightConstraint; - - } - - } - - } - - - if (offsetHeight < viewPortHeight) { - - y = pos[1]; - scrollY = Dom.getDocumentScrollTop(); - topConstraint = scrollY + nPadding; - bottomConstraint = scrollY + viewPortHeight - offsetHeight - nPadding; - - - - if (y < nViewportOffset) { - - y = topConstraint; - - } else if (y > bottomConstraint) { - - if (oContextElement && (y > offsetHeight)) { - - y = ((y + oContextElement.offsetHeight) - offsetHeight); - - } - else { - - y = bottomConstraint; - - - - } - - } - - } - - - oConfig.setProperty("x", x, true); - oConfig.setProperty("y", y, true); - oConfig.setProperty("xy", [x,y], true); - -}, - - -/** -* @method configVisible -* @description Event handler for when the "visible" configuration property -* the menu 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.Menu} p_oMenu Object representing the menu that -* fired the event. -*/ -configVisible: function (p_sType, p_aArgs, p_oMenu) { - - var bVisible, - sDisplay; - - if (this.cfg.getProperty("position") == "dynamic") { - - Menu.superclass.configVisible.call(this, p_sType, p_aArgs, p_oMenu); - - } - else { - - bVisible = p_aArgs[0]; - sDisplay = Dom.getStyle(this.element, "display"); - - Dom.setStyle(this.element, "visibility", "visible"); - - if (bVisible) { - - if (sDisplay != "block") { - this.beforeShowEvent.fire(); - Dom.setStyle(this.element, "display", "block"); - this.showEvent.fire(); - } - - } - else { - - if (sDisplay == "block") { - this.beforeHideEvent.fire(); - Dom.setStyle(this.element, "display", "none"); - this.hideEvent.fire(); - } - - } - - } - -}, - - -/** -* @method configPosition -* @description Event handler for when the "position" configuration property -* of the menu 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.Menu} p_oMenu Object representing the menu that -* fired the event. -*/ -configPosition: function (p_sType, p_aArgs, p_oMenu) { - - var oElement = this.element, - sCSSPosition = p_aArgs[0] == "static" ? "static" : "absolute", - oCfg = this.cfg, - nZIndex; - - - Dom.setStyle(oElement, "position", sCSSPosition); - - - if (sCSSPosition == "static") { - - // Statically positioned menus are visible by default - - Dom.setStyle(oElement, "display", "block"); - - oCfg.setProperty("visible", true); - - } - else { - - /* - Even though the "visible" property is queued to - "false" by default, we need to set the "visibility" property to - "hidden" since Overlay's "configVisible" implementation checks the - element's "visibility" style property before deciding whether - or not to show an Overlay instance. - */ - - Dom.setStyle(oElement, "visibility", "hidden"); - - } - - - if (sCSSPosition == "absolute") { - - nZIndex = oCfg.getProperty("zindex"); - - if (!nZIndex || nZIndex === 0) { - - nZIndex = this.parent ? - (this.parent.parent.cfg.getProperty("zindex") + 1) : 1; - - oCfg.setProperty("zindex", nZIndex); - - } - - } - -}, - - -/** -* @method configIframe -* @description Event handler for when the "iframe" configuration property of -* the menu 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.Menu} p_oMenu Object representing the menu that -* fired the event. -*/ -configIframe: function (p_sType, p_aArgs, p_oMenu) { - - if (this.cfg.getProperty("position") == "dynamic") { - - Menu.superclass.configIframe.call(this, p_sType, p_aArgs, p_oMenu); - - } - -}, - - -/** -* @method configHideDelay -* @description Event handler for when the "hidedelay" configuration property -* of the menu 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.Menu} p_oMenu Object representing the menu that -* fired the event. -*/ -configHideDelay: function (p_sType, p_aArgs, p_oMenu) { - - var nHideDelay = p_aArgs[0], - oMouseOutEvent = this.mouseOutEvent, - oMouseOverEvent = this.mouseOverEvent, - oKeyDownEvent = this.keyDownEvent; - - if (nHideDelay > 0) { - - /* - Only assign event handlers once. This way the user change - the value for the hidedelay as many times as they want. - */ - - if (!this._bHideDelayEventHandlersAssigned) { - - oMouseOutEvent.subscribe(this._execHideDelay); - oMouseOverEvent.subscribe(this._cancelHideDelay); - oKeyDownEvent.subscribe(this._cancelHideDelay); - - this._bHideDelayEventHandlersAssigned = true; - - } - - } - else { - - oMouseOutEvent.unsubscribe(this._execHideDelay); - oMouseOverEvent.unsubscribe(this._cancelHideDelay); - oKeyDownEvent.unsubscribe(this._cancelHideDelay); - - this._bHideDelayEventHandlersAssigned = false; - - } - -}, - - -/** -* @method configContainer -* @description Event handler for when the "container" configuration property -* of the menu 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.Menu} p_oMenu Object representing the menu that -* fired the event. -*/ -configContainer: function (p_sType, p_aArgs, p_oMenu) { - - var oElement = p_aArgs[0]; - - if (typeof oElement == 'string') { - - this.cfg.setProperty("container", document.getElementById(oElement), - true); - - } - -}, - - -/** -* @method _setMaxHeight -* @description "renderEvent" handler used to defer the setting of the -* "maxheight" configuration property until the menu is rendered in lazy -* load scenarios. -* @param {String} p_sType The name of the event that was fired. -* @param {Array} p_aArgs Collection of arguments sent when the event -* was fired. -* @param {Number} p_nMaxHeight Number representing the value to set for the -* "maxheight" configuration property. -* @private -*/ -_setMaxHeight: function (p_sType, p_aArgs, p_nMaxHeight) { - - this.cfg.setProperty("maxheight", p_nMaxHeight); - this.renderEvent.unsubscribe(this._setMaxHeight); - -}, - - -/** -* @method configMaxHeight -* @description Event handler for when the "maxheight" configuration property of -* a Menu changes. -* @param {String} p_sType The name of the event that was fired. -* @param {Array} p_aArgs Collection of arguments sent when the event -* was fired. -* @param {YAHOO.widget.Menu} p_oMenu The Menu instance fired -* the event. -*/ -configMaxHeight: function (p_sType, p_aArgs, p_oMenu) { - - var nMaxHeight = p_aArgs[0], - oElement = this.element, - oBody = this.body, - oHeader = this.header, - oFooter = this.footer, - fnMouseOver = this._onScrollTargetMouseOver, - fnMouseOut = this._onScrollTargetMouseOut, - nMinScrollHeight = this.cfg.getProperty("minscrollheight"), - nHeight, - nOffsetWidth, - sWidth; - - - if (nMaxHeight !== 0 && nMaxHeight < nMinScrollHeight) { - - nMaxHeight = nMinScrollHeight; - - } - - - if (this.lazyLoad && !oBody) { - - this.renderEvent.unsubscribe(this._setMaxHeight); - - if (nMaxHeight > 0) { - - this.renderEvent.subscribe(this._setMaxHeight, nMaxHeight, this); - - } - - return; - - } - - - Dom.setStyle(oBody, "height", ""); - Dom.removeClass(oBody, "yui-menu-body-scrolled"); - - - /* - There is a bug in gecko-based browsers where an element whose - "position" property is set to "absolute" and "overflow" property is set - to "hidden" will not render at the correct width when its - offsetParent's "position" property is also set to "absolute." It is - possible to work around this bug by specifying a value for the width - property in addition to overflow. - - In IE it is also necessary to give the Menu a width when the scrollbars are - rendered to prevent the Menu from rendering with a width that is 100% of - the browser viewport. - */ - - var bSetWidth = ((UA.gecko && this.parent && this.parent.parent && - this.parent.parent.cfg.getProperty("position") == "dynamic") || UA.ie); - - - if (bSetWidth) { - - if (!this.cfg.getProperty("width")) { - - nOffsetWidth = oElement.offsetWidth; - - /* - Measuring the difference of the offsetWidth before and after - setting the "width" style attribute allows us to compute the - about of padding and borders applied to the element, which in - turn allows us to set the "width" property correctly. - */ - - oElement.style.width = nOffsetWidth + "px"; - - sWidth = (nOffsetWidth - (oElement.offsetWidth - nOffsetWidth)) + "px"; - - this.cfg.setProperty("width", sWidth); - - } - - } - - - if (!oHeader && !oFooter) { - - this.setHeader(" "); - this.setFooter(" "); - - oHeader = this.header; - oFooter = this.footer; - - Dom.addClass(oHeader, "topscrollbar"); - Dom.addClass(oFooter, "bottomscrollbar"); - - oElement.insertBefore(oHeader, oBody); - oElement.appendChild(oFooter); - - } - - - nHeight = (nMaxHeight - (oHeader.offsetHeight + oHeader.offsetHeight)); - - - if (nHeight > 0 && (oBody.offsetHeight > nMaxHeight)) { - - Dom.addClass(oBody, "yui-menu-body-scrolled"); - Dom.setStyle(oBody, "height", (nHeight + "px")); - - Event.on(oHeader, "mouseover", fnMouseOver, this, true); - Event.on(oHeader, "mouseout", fnMouseOut, this, true); - Event.on(oFooter, "mouseover", fnMouseOver, this, true); - Event.on(oFooter, "mouseout", fnMouseOut, this, true); - - this._disableScrollHeader(); - this._enableScrollFooter(); - - } - else if (oHeader && oFooter) { - - if (bSetWidth) { - - this.cfg.setProperty("width", ""); - - } - - - this._enableScrollHeader(); - this._enableScrollFooter(); - - Event.removeListener(oHeader, "mouseover", fnMouseOver); - Event.removeListener(oHeader, "mouseout", fnMouseOut); - Event.removeListener(oFooter, "mouseover", fnMouseOver); - Event.removeListener(oFooter, "mouseout", fnMouseOut); - - oElement.removeChild(oHeader); - oElement.removeChild(oFooter); - - this.header = null; - this.footer = null; - - } - - this.cfg.refireEvent("iframe"); - -}, - - -/** -* @method configClassName -* @description Event handler for when the "classname" configuration property of -* a menu changes. -* @param {String} p_sType The name of the event that was fired. -* @param {Array} p_aArgs Collection of arguments sent when the event was fired. -* @param {YAHOO.widget.Menu} p_oMenu The Menu instance fired the event. -*/ -configClassName: function (p_sType, p_aArgs, p_oMenu) { - - var sClassName = p_aArgs[0]; - - if (this._sClassName) { - - Dom.removeClass(this.element, this._sClassName); - - } - - Dom.addClass(this.element, sClassName); - this._sClassName = sClassName; - -}, - - -/** -* @method _onItemAdded -* @description "itemadded" event handler for a Menu instance. -* @private -* @param {String} p_sType The name of the event that was fired. -* @param {Array} p_aArgs Collection of arguments sent when the event -* was fired. -*/ -_onItemAdded: function (p_sType, p_aArgs) { - - var oItem = p_aArgs[0]; - - if (oItem) { - - oItem.cfg.setProperty("disabled", true); - - } - -}, - - -/** -* @method configDisabled -* @description Event handler for when the "disabled" configuration property of -* a menu changes. -* @param {String} p_sType The name of the event that was fired. -* @param {Array} p_aArgs Collection of arguments sent when the event was fired. -* @param {YAHOO.widget.Menu} p_oMenu The Menu instance fired the event. -*/ -configDisabled: function (p_sType, p_aArgs, p_oMenu) { - - var bDisabled = p_aArgs[0], - aItems = this.getItems(), - nItems, - i; - - if (Lang.isArray(aItems)) { - - nItems = aItems.length; - - if (nItems > 0) { - - i = nItems - 1; - - do { - - aItems[i].cfg.setProperty("disabled", bDisabled); - - } - while (i--); - - } - - - if (bDisabled) { - - this.clearActiveItem(true); - - Dom.addClass(this.element, "disabled"); - - this.itemAddedEvent.subscribe(this._onItemAdded); - - } - else { - - Dom.removeClass(this.element, "disabled"); - - this.itemAddedEvent.unsubscribe(this._onItemAdded); - - } - - } - -}, - - -/** -* @method onRender -* @description "render" event handler for the menu. -* @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. -*/ -onRender: function (p_sType, p_aArgs) { - - function sizeShadow() { - - var oElement = this.element, - oShadow = this._shadow; - - if (oShadow && oElement) { - - oShadow.style.width = (oElement.offsetWidth + 6) + "px"; - oShadow.style.height = (oElement.offsetHeight + 1) + "px"; - - } - - } - - - function replaceShadow() { - - this.element.appendChild(this._shadow); - - } - - - function addShadowVisibleClass() { - - Dom.addClass(this._shadow, "yui-menu-shadow-visible"); - - } - - - function removeShadowVisibleClass() { - - Dom.removeClass(this._shadow, "yui-menu-shadow-visible"); - - } - - - function createShadow() { - - var oShadow = this._shadow, - oElement, - me; - - if (!oShadow) { - - oElement = this.element; - me = this; - - if (!m_oShadowTemplate) { - - m_oShadowTemplate = document.createElement("div"); - m_oShadowTemplate.className = - "yui-menu-shadow yui-menu-shadow-visible"; - - } - - oShadow = m_oShadowTemplate.cloneNode(false); - - oElement.appendChild(oShadow); - - this._shadow = oShadow; - - this.beforeShowEvent.subscribe(addShadowVisibleClass); - this.beforeHideEvent.subscribe(removeShadowVisibleClass); - - if (UA.ie) { - - /* - Need to call sizeShadow & syncIframe via setTimeout for - IE 7 Quirks Mode and IE 6 Standards Mode and Quirks Mode - or the shadow and iframe shim will not be sized and - positioned properly. - */ - - window.setTimeout(function () { - - sizeShadow.call(me); - me.syncIframe(); - - }, 0); - - this.cfg.subscribeToConfigEvent("width", sizeShadow); - this.cfg.subscribeToConfigEvent("height", sizeShadow); - this.cfg.subscribeToConfigEvent("maxheight", sizeShadow); - this.changeContentEvent.subscribe(sizeShadow); - - Module.textResizeEvent.subscribe(sizeShadow, me, true); - - this.destroyEvent.subscribe(function () { - - Module.textResizeEvent.unsubscribe(sizeShadow, me); - - }); - - } - - this.cfg.subscribeToConfigEvent("maxheight", replaceShadow); - - } - - } - - - function onBeforeShow() { - - createShadow.call(this); - - this.beforeShowEvent.unsubscribe(onBeforeShow); - - } - - - if (this.cfg.getProperty("position") == "dynamic") { - - if (this.cfg.getProperty("visible")) { - - createShadow.call(this); - - } - else { - - this.beforeShowEvent.subscribe(onBeforeShow); - - } - - } - -}, - - -// Public methods - - -/** -* @method initEvents -* @description Initializes the custom events for the menu. -*/ -initEvents: function () { - - Menu.superclass.initEvents.call(this); - - // Create custom events - - var SIGNATURE = CustomEvent.LIST; - - this.mouseOverEvent = this.createEvent(EVENT_TYPES.MOUSE_OVER); - this.mouseOverEvent.signature = SIGNATURE; - - this.mouseOutEvent = this.createEvent(EVENT_TYPES.MOUSE_OUT); - this.mouseOutEvent.signature = SIGNATURE; - - this.mouseDownEvent = this.createEvent(EVENT_TYPES.MOUSE_DOWN); - this.mouseDownEvent.signature = SIGNATURE; - - this.mouseUpEvent = this.createEvent(EVENT_TYPES.MOUSE_UP); - this.mouseUpEvent.signature = SIGNATURE; - - this.clickEvent = this.createEvent(EVENT_TYPES.CLICK); - this.clickEvent.signature = SIGNATURE; - - this.keyPressEvent = this.createEvent(EVENT_TYPES.KEY_PRESS); - this.keyPressEvent.signature = SIGNATURE; - - this.keyDownEvent = this.createEvent(EVENT_TYPES.KEY_DOWN); - this.keyDownEvent.signature = SIGNATURE; - - this.keyUpEvent = this.createEvent(EVENT_TYPES.KEY_UP); - this.keyUpEvent.signature = SIGNATURE; - - this.focusEvent = this.createEvent(EVENT_TYPES.FOCUS); - this.focusEvent.signature = SIGNATURE; - - this.blurEvent = this.createEvent(EVENT_TYPES.BLUR); - this.blurEvent.signature = SIGNATURE; - - this.itemAddedEvent = this.createEvent(EVENT_TYPES.ITEM_ADDED); - this.itemAddedEvent.signature = SIGNATURE; - - this.itemRemovedEvent = this.createEvent(EVENT_TYPES.ITEM_REMOVED); - this.itemRemovedEvent.signature = SIGNATURE; - -}, - - -/** -* @method positionOffScreen -* @description Positions the menu outside of the boundaries of the browser's -* viewport. Called automatically when a menu is hidden to ensure that -* it doesn't force the browser to render uncessary scrollbars. -*/ -positionOffScreen: function () { - - var oIFrame = this.iframe, - aPos = this.OFF_SCREEN_POSITION; - - Dom.setXY(this.element, aPos); - - if (oIFrame) { - - Dom.setXY(oIFrame, aPos); - - } - -}, - - -/** -* @method getRoot -* @description Finds the menu's root menu. -*/ -getRoot: function () { - - var oItem = this.parent, - oParentMenu; - - if (oItem) { - - oParentMenu = oItem.parent; - - return oParentMenu ? oParentMenu.getRoot() : this; - - } - else { - - return this; - - } - -}, - - -/** -* @method toString -* @description Returns a string representing the menu. -* @return {String} -*/ -toString: function () { - - var sReturnVal = "Menu", - sId = this.id; - - if (sId) { - - sReturnVal += (" " + sId); - - } - - return sReturnVal; - -}, - - -/** -* @method setItemGroupTitle -* @description Sets the title of a group of menu items. -* @param {String} p_sGroupTitle String specifying the title of the group. -* @param {Number} p_nGroupIndex Optional. Number specifying the group to which -* the title belongs. -*/ -setItemGroupTitle: function (p_sGroupTitle, p_nGroupIndex) { - - var nGroupIndex, - oTitle, - i, - nFirstIndex; - - if (typeof p_sGroupTitle == "string" && p_sGroupTitle.length > 0) { - - nGroupIndex = typeof p_nGroupIndex == "number" ? p_nGroupIndex : 0; - oTitle = this._aGroupTitleElements[nGroupIndex]; - - - if (oTitle) { - - oTitle.innerHTML = p_sGroupTitle; - - } - else { - - oTitle = document.createElement(this.GROUP_TITLE_TAG_NAME); - - oTitle.innerHTML = p_sGroupTitle; - - this._aGroupTitleElements[nGroupIndex] = oTitle; - - } - - - i = this._aGroupTitleElements.length - 1; - - do { - - if (this._aGroupTitleElements[i]) { - - Dom.removeClass(this._aGroupTitleElements[i], "first-of-type"); - - nFirstIndex = i; - - } - - } - while(i--); - - - if (nFirstIndex !== null) { - - Dom.addClass(this._aGroupTitleElements[nFirstIndex], - "first-of-type"); - - } - - this.changeContentEvent.fire(); - - } - -}, - - - -/** -* @method addItem -* @description Appends an item to the menu. -* @param {YAHOO.widget.MenuItem} p_oItem Object reference for the MenuItem -* instance to be added to the menu. -* @param {String} p_oItem String specifying the text of the item to be added -* to the menu. -* @param {Object} p_oItem Object literal containing a set of menu item -* configuration properties. -* @param {Number} p_nGroupIndex Optional. Number indicating the group to -* which the item belongs. -* @return {YAHOO.widget.MenuItem} -*/ -addItem: function (p_oItem, p_nGroupIndex) { - - if (p_oItem) { - - return this._addItemToGroup(p_nGroupIndex, p_oItem); - - } - -}, - - -/** -* @method addItems -* @description Adds an array of items to the menu. -* @param {Array} p_aItems Array of items to be added to the menu. The array -* can contain strings specifying the text for each item to be created, object -* literals specifying each of the menu item configuration properties, -* or MenuItem instances. -* @param {Number} p_nGroupIndex Optional. Number specifying the group to -* which the items belongs. -* @return {Array} -*/ -addItems: function (p_aItems, p_nGroupIndex) { - - var nItems, - aItems, - oItem, - i; - - if (Lang.isArray(p_aItems)) { - - nItems = p_aItems.length; - aItems = []; - - for(i=0; i 0) { - - aSubmenus = []; - - for(i=0; i 0) { - - i = nItems - 1; - - do { - - oItem = aItems[i]; - - if (oItem) { - - oSubmenu = oItem.cfg.getProperty("submenu"); - - if (oSubmenu) { - - this.cfg.configChangedEvent.unsubscribe( - this._onParentMenuConfigChange, oSubmenu); - - this.renderEvent.unsubscribe(this._onParentMenuRender, - oSubmenu); - - } - - this.removeItem(oItem); - - } - - } - while(i--); - - } - - - if (oHeader) { - - Event.purgeElement(oHeader); - oElement.removeChild(oHeader); - - } - - - if (oFooter) { - - Event.purgeElement(oFooter); - oElement.removeChild(oFooter); - } - - - if (oBody) { - - Event.purgeElement(oBody); - - oBody.innerHTML = ""; - - } - - this.activeItem = null; - - this._aItemGroups = []; - this._aListElements = []; - this._aGroupTitleElements = []; - - this.cfg.setProperty("width", null); - -}, - - -/** -* @method destroy -* @description Removes the menu's <div> element -* (and accompanying child nodes) from the document. -*/ -destroy: function () { - - // Remove all items - - this.clearContent(); - - this._aItemGroups = null; - this._aListElements = null; - this._aGroupTitleElements = null; - - - // Continue with the superclass implementation of this method - - Menu.superclass.destroy.call(this); - - this.logger.log("Destroyed."); - -}, - - -/** -* @method setInitialFocus -* @description Sets focus to the menu's first enabled item. -*/ -setInitialFocus: function () { - - var oItem = this._getFirstEnabledItem(); - - if (oItem) { - - oItem.focus(); - - } - -}, - - -/** -* @method setInitialSelection -* @description Sets the "selected" configuration property of the menu's first -* enabled item to "true." -*/ -setInitialSelection: function () { - - var oItem = this._getFirstEnabledItem(); - - if (oItem) { - - oItem.cfg.setProperty("selected", true); - } - -}, - - -/** -* @method clearActiveItem -* @description Sets the "selected" configuration property of the menu's active -* item to "false" and hides the item's submenu. -* @param {Boolean} p_bBlur Boolean indicating if the menu's active item -* should be blurred. -*/ -clearActiveItem: function (p_bBlur) { - - if (this.cfg.getProperty("showdelay") > 0) { - - this._cancelShowDelay(); - - } - - - var oActiveItem = this.activeItem, - oConfig, - oSubmenu; - - if (oActiveItem) { - - oConfig = oActiveItem.cfg; - - if (p_bBlur) { - - oActiveItem.blur(); - - } - - oConfig.setProperty("selected", false); - - oSubmenu = oConfig.getProperty("submenu"); - - if (oSubmenu) { - - oSubmenu.hide(); - - } - - this.activeItem = null; - - } - -}, - - -/** -* @method focus -* @description Causes the menu to receive focus and fires the "focus" event. -*/ -focus: function () { - - if (!this.hasFocus()) { - - this.setInitialFocus(); - - } - -}, - - -/** -* @method blur -* @description Causes the menu to lose focus and fires the "blur" event. -*/ -blur: function () { - - var oItem; - - if (this.hasFocus()) { - - oItem = MenuManager.getFocusedMenuItem(); - - if (oItem) { - - oItem.blur(); - - } - - } - -}, - - -/** -* @method hasFocus -* @description Returns a boolean indicating whether or not the menu has focus. -* @return {Boolean} -*/ -hasFocus: function () { - - return (MenuManager.getFocusedMenu() == this.getRoot()); - -}, - - -/** -* Adds the specified CustomEvent subscriber to the menu and each of -* its submenus. -* @method subscribe -* @param p_type {string} the type, or name of the event -* @param p_fn {function} the function to exectute when the event fires -* @param p_obj {Object} An object to be passed along when the event -* fires -* @param p_override {boolean} If true, the obj passed in becomes the -* execution scope of the listener -*/ -subscribe: function () { - - function onItemAdded(p_sType, p_aArgs, p_oObject) { - - var oItem = p_aArgs[0], - oSubmenu = oItem.cfg.getProperty("submenu"); - - if (oSubmenu) { - - oSubmenu.subscribe.apply(oSubmenu, p_oObject); - - } - - } - - - function onSubmenuAdded(p_sType, p_aArgs, p_oObject) { - - var oSubmenu = this.cfg.getProperty("submenu"); - - if (oSubmenu) { - - oSubmenu.subscribe.apply(oSubmenu, p_oObject); - - } - - } - - - Menu.superclass.subscribe.apply(this, arguments); - Menu.superclass.subscribe.call(this, "itemAdded", onItemAdded, arguments); - - - var aItems = this.getItems(), - nItems, - oItem, - oSubmenu, - i; - - - if (aItems) { - - nItems = aItems.length; - - if (nItems > 0) { - - i = nItems - 1; - - do { - - oItem = aItems[i]; - - oSubmenu = oItem.cfg.getProperty("submenu"); - - if (oSubmenu) { - - oSubmenu.subscribe.apply(oSubmenu, arguments); - - } - else { - - oItem.cfg.subscribeToConfigEvent("submenu", onSubmenuAdded, arguments); - - } - - } - while (i--); - - } - - } - -}, - - -/** -* @description Initializes the class's configurable properties which can be -* changed using the menu's Config object ("cfg"). -* @method initDefaultConfig -*/ -initDefaultConfig: function () { - - Menu.superclass.initDefaultConfig.call(this); - - var oConfig = this.cfg; - - - // Module documentation overrides - - /** - * @config effect - * @description Object or array of objects representing the ContainerEffect - * classes that are active for animating the container. When set this - * property is automatically applied to all submenus. - * @type Object - * @default null - */ - - // Overlay documentation overrides - - - /** - * @config x - * @description Number representing the absolute x-coordinate position of - * the Menu. This property is only applied when the "position" - * configuration property is set to dynamic. - * @type Number - * @default null - */ - - - /** - * @config y - * @description Number representing the absolute y-coordinate position of - * the Menu. This property is only applied when the "position" - * configuration property is set to dynamic. - * @type Number - * @default null - */ - - - /** - * @description Array of the absolute x and y positions of the Menu. This - * property is only applied when the "position" configuration property is - * set to dynamic. - * @config xy - * @type Number[] - * @default null - */ - - - /** - * @config context - * @description Array of context arguments for context-sensitive positioning. - * The format is: [id or element, element corner, context corner]. - * For example, setting this property to ["img1", "tl", "bl"] would - * align the Mnu's top left corner to the context element's - * bottom left corner. This property is only applied when the "position" - * configuration property is set to dynamic. - * @type Array - * @default null - */ - - - /** - * @config fixedcenter - * @description Boolean indicating if the Menu should be anchored to the - * center of the viewport. This property is only applied when the - * "position" configuration property is set to dynamic. - * @type Boolean - * @default false - */ - - - /** - * @config zindex - * @description Number representing the CSS z-index of the Menu. This - * property is only applied when the "position" configuration property is - * set to dynamic. - * @type Number - * @default null - */ - - - /** - * @config iframe - * @description Boolean indicating whether or not the Menu should - * have an IFRAME shim; used to prevent SELECT elements from - * poking through an Overlay instance in IE6. When set to "true", - * the iframe shim is created when the Menu instance is intially - * made visible. This property is only applied when the "position" - * configuration property is set to dynamic and is automatically applied - * to all submenus. - * @type Boolean - * @default true for IE6 and below, false for all other browsers. - */ - - - // Add configuration attributes - - /* - Change the default value for the "visible" configuration - property to "false" by re-adding the property. - */ - - /** - * @config visible - * @description Boolean indicating whether or not the menu is visible. If - * the menu's "position" configuration property is set to "dynamic" (the - * default), this property toggles the menu's <div> - * element's "visibility" style property between "visible" (true) or - * "hidden" (false). If the menu's "position" configuration property is - * set to "static" this property toggles the menu's - * <div> element's "display" style property - * between "block" (true) or "none" (false). - * @default false - * @type Boolean - */ - oConfig.addProperty( - DEFAULT_CONFIG.VISIBLE.key, - { - handler: this.configVisible, - value: DEFAULT_CONFIG.VISIBLE.value, - validator: DEFAULT_CONFIG.VISIBLE.validator - } - ); - - - /* - Change the default value for the "constraintoviewport" configuration - property to "true" by re-adding the property. - */ - - /** - * @config constraintoviewport - * @description Boolean indicating if the menu will try to remain inside - * the boundaries of the size of viewport. This property is only applied - * when the "position" configuration property is set to dynamic and is - * automatically applied to all submenus. - * @default true - * @type Boolean - */ - oConfig.addProperty( - DEFAULT_CONFIG.CONSTRAIN_TO_VIEWPORT.key, - { - handler: this.configConstrainToViewport, - value: DEFAULT_CONFIG.CONSTRAIN_TO_VIEWPORT.value, - validator: DEFAULT_CONFIG.CONSTRAIN_TO_VIEWPORT.validator, - supercedes: DEFAULT_CONFIG.CONSTRAIN_TO_VIEWPORT.supercedes - } - ); - - - /** - * @config position - * @description String indicating how a menu should be positioned on the - * screen. Possible values are "static" and "dynamic." Static menus are - * visible by default and reside in the normal flow of the document - * (CSS position: static). Dynamic menus are hidden by default, reside - * out of the normal flow of the document (CSS position: absolute), and - * can overlay other elements on the screen. - * @default dynamic - * @type String - */ - oConfig.addProperty( - DEFAULT_CONFIG.POSITION.key, - { - handler: this.configPosition, - value: DEFAULT_CONFIG.POSITION.value, - validator: DEFAULT_CONFIG.POSITION.validator, - supercedes: DEFAULT_CONFIG.POSITION.supercedes - } - ); - - - /** - * @config submenualignment - * @description Array defining how submenus should be aligned to their - * parent menu item. The format is: [itemCorner, submenuCorner]. By default - * a submenu's top left corner is aligned to its parent menu item's top - * right corner. - * @default ["tl","tr"] - * @type Array - */ - oConfig.addProperty( - DEFAULT_CONFIG.SUBMENU_ALIGNMENT.key, - { - value: DEFAULT_CONFIG.SUBMENU_ALIGNMENT.value, - suppressEvent: DEFAULT_CONFIG.SUBMENU_ALIGNMENT.suppressEvent - } - ); - - - /** - * @config autosubmenudisplay - * @description Boolean indicating if submenus are automatically made - * visible when the user mouses over the menu's items. - * @default true - * @type Boolean - */ - oConfig.addProperty( - DEFAULT_CONFIG.AUTO_SUBMENU_DISPLAY.key, - { - value: DEFAULT_CONFIG.AUTO_SUBMENU_DISPLAY.value, - validator: DEFAULT_CONFIG.AUTO_SUBMENU_DISPLAY.validator, - suppressEvent: DEFAULT_CONFIG.AUTO_SUBMENU_DISPLAY.suppressEvent - } - ); - - - /** - * @config showdelay - * @description Number indicating the time (in milliseconds) that should - * expire before a submenu is made visible when the user mouses over - * the menu's items. This property is only applied when the "position" - * configuration property is set to dynamic and is automatically applied - * to all submenus. - * @default 250 - * @type Number - */ - oConfig.addProperty( - DEFAULT_CONFIG.SHOW_DELAY.key, - { - value: DEFAULT_CONFIG.SHOW_DELAY.value, - validator: DEFAULT_CONFIG.SHOW_DELAY.validator, - suppressEvent: DEFAULT_CONFIG.SHOW_DELAY.suppressEvent - } - ); - - - /** - * @config hidedelay - * @description Number indicating the time (in milliseconds) that should - * expire before the menu is hidden. This property is only applied when - * the "position" configuration property is set to dynamic and is - * automatically applied to all submenus. - * @default 0 - * @type Number - */ - oConfig.addProperty( - DEFAULT_CONFIG.HIDE_DELAY.key, - { - handler: this.configHideDelay, - value: DEFAULT_CONFIG.HIDE_DELAY.value, - validator: DEFAULT_CONFIG.HIDE_DELAY.validator, - suppressEvent: DEFAULT_CONFIG.HIDE_DELAY.suppressEvent - } - ); - - - /** - * @config submenuhidedelay - * @description Number indicating the time (in milliseconds) that should - * expire before a submenu is hidden when the user mouses out of a menu item - * heading in the direction of a submenu. The value must be greater than or - * equal to the value specified for the "showdelay" configuration property. - * This property is only applied when the "position" configuration property - * is set to dynamic and is automatically applied to all submenus. - * @default 250 - * @type Number - */ - oConfig.addProperty( - DEFAULT_CONFIG.SUBMENU_HIDE_DELAY.key, - { - value: DEFAULT_CONFIG.SUBMENU_HIDE_DELAY.value, - validator: DEFAULT_CONFIG.SUBMENU_HIDE_DELAY.validator, - suppressEvent: DEFAULT_CONFIG.SUBMENU_HIDE_DELAY.suppressEvent - } - ); - - - /** - * @config clicktohide - * @description Boolean indicating if the menu will automatically be - * hidden if the user clicks outside of it. This property is only - * applied when the "position" configuration property is set to dynamic - * and is automatically applied to all submenus. - * @default true - * @type Boolean - */ - oConfig.addProperty( - DEFAULT_CONFIG.CLICK_TO_HIDE.key, - { - value: DEFAULT_CONFIG.CLICK_TO_HIDE.value, - validator: DEFAULT_CONFIG.CLICK_TO_HIDE.validator, - suppressEvent: DEFAULT_CONFIG.CLICK_TO_HIDE.suppressEvent - } - ); - - - /** - * @config container - * @description HTML element reference or string specifying the id - * attribute of the HTML element that the menu's markup should be - * rendered into. - * @type HTMLElement|String - * @default document.body - */ - oConfig.addProperty( - DEFAULT_CONFIG.CONTAINER.key, - { - handler: this.configContainer, - value: document.body, - suppressEvent: DEFAULT_CONFIG.CONTAINER.suppressEvent - } - ); - - - /** - * @config scrollincrement - * @description Number used to control the scroll speed of a menu. Used to - * increment the "scrollTop" property of the menu's body by when a menu's - * content is scrolling. When set this property is automatically applied - * to all submenus. - * @default 1 - * @type Number - */ - oConfig.addProperty( - DEFAULT_CONFIG.SCROLL_INCREMENT.key, - { - value: DEFAULT_CONFIG.SCROLL_INCREMENT.value, - validator: DEFAULT_CONFIG.SCROLL_INCREMENT.validator, - supercedes: DEFAULT_CONFIG.SCROLL_INCREMENT.supercedes, - suppressEvent: DEFAULT_CONFIG.SCROLL_INCREMENT.suppressEvent - } - ); - - - /** - * @config minscrollheight - * @description Number defining the minimum threshold for the "maxheight" - * configuration property. When set this property is automatically applied - * to all submenus. - * @default 90 - * @type Number - */ - oConfig.addProperty( - DEFAULT_CONFIG.MIN_SCROLL_HEIGHT.key, - { - value: DEFAULT_CONFIG.MIN_SCROLL_HEIGHT.value, - validator: DEFAULT_CONFIG.MIN_SCROLL_HEIGHT.validator, - supercedes: DEFAULT_CONFIG.MIN_SCROLL_HEIGHT.supercedes, - suppressEvent: DEFAULT_CONFIG.MIN_SCROLL_HEIGHT.suppressEvent - } - ); - - - /** - * @config maxheight - * @description Number defining the maximum height (in pixels) for a menu's - * body element (<div class="bd"<). Once a menu's body - * exceeds this height, the contents of the body are scrolled to maintain - * this value. This value cannot be set lower than the value of the - * "minscrollheight" configuration property. - * @default 0 - * @type Number - */ - oConfig.addProperty( - DEFAULT_CONFIG.MAX_HEIGHT.key, - { - handler: this.configMaxHeight, - value: DEFAULT_CONFIG.MAX_HEIGHT.value, - validator: DEFAULT_CONFIG.MAX_HEIGHT.validator, - suppressEvent: DEFAULT_CONFIG.MAX_HEIGHT.suppressEvent, - supercedes: DEFAULT_CONFIG.MAX_HEIGHT.supercedes - } - ); - - - /** - * @config classname - * @description String representing the CSS class to be applied to the - * menu's root <div> element. The specified class(es) - * are appended in addition to the default class as specified by the menu's - * CSS_CLASS_NAME constant. When set this property is automatically - * applied to all submenus. - * @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, - supercedes: DEFAULT_CONFIG.CLASS_NAME.supercedes - } - ); - - - /** - * @config disabled - * @description Boolean indicating if the menu should be disabled. - * Disabling a menu disables each of its items. (Disabled menu items are - * dimmed and will not respond to user input or fire events.) Disabled - * menus have a corresponding "disabled" CSS class applied to their root - * <div> element. - * @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 - } - ); - -} - -}); // END YAHOO.lang.extend - -})(); - - - -(function () { - - -/** -* Creates an item for a menu. -* -* @param {String} p_oObject String specifying the text of the menu item. -* @param {HTMLLIElement} p_oObject Object specifying -* the <li> element of the menu item. -* @param {HTMLOptGroupElement} p_oObject Object -* specifying the <optgroup> element of the menu item. -* @param {HTMLOptionElement} p_oObject Object -* specifying the <option> 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); - - } - -}; - - -var Dom = YAHOO.util.Dom, - Module = YAHOO.widget.Module, - Menu = YAHOO.widget.Menu, - MenuItem = YAHOO.widget.MenuItem, - CustomEvent = YAHOO.util.CustomEvent, - Lang = YAHOO.lang, - - m_oMenuItemTemplate, - - /** - * Constant representing the name of the MenuItem's events - * @property EVENT_TYPES - * @private - * @final - * @type Object - */ - 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 DEFAULT_CONFIG - * @private - * @final - * @type Object - */ - DEFAULT_CONFIG = { - - "TEXT": { - key: "text", - value: "", - validator: Lang.isString, - suppressEvent: true - }, - - "HELP_TEXT": { - key: "helptext", - supercedes: ["text"], - suppressEvent: true - }, - - "URL": { - key: "url", - value: "#", - suppressEvent: true - }, - - "TARGET": { - key: "target", - suppressEvent: true - }, - - "EMPHASIS": { - key: "emphasis", - value: false, - validator: Lang.isBoolean, - suppressEvent: true, - supercedes: ["text"] - }, - - "STRONG_EMPHASIS": { - key: "strongemphasis", - value: false, - validator: Lang.isBoolean, - suppressEvent: true, - supercedes: ["text"] - }, - - "CHECKED": { - key: "checked", - value: false, - validator: Lang.isBoolean, - suppressEvent: true, - supercedes: ["disabled", "selected"] - }, - - "SUBMENU": { - key: "submenu", - suppressEvent: true, - supercedes: ["disabled", "selected"] - }, - - "DISABLED": { - key: "disabled", - value: false, - validator: Lang.isBoolean, - suppressEvent: true, - supercedes: ["text", "selected"] - }, - - "SELECTED": { - key: "selected", - value: false, - validator: Lang.isBoolean, - suppressEvent: true - }, - - "ONCLICK": { - key: "onclick", - suppressEvent: true - }, - - "CLASS_NAME": { - key: "classname", - value: null, - validator: Lang.isString, - suppressEvent: true - } - - }; - - -MenuItem.prototype = { - - /** - * @property CSS_CLASS_NAME - * @description String representing the CSS class(es) to be applied to the - * <li> element of the menu item. - * @default "yuimenuitem" - * @final - * @type String - */ - CSS_CLASS_NAME: "yuimenuitem", - - - /** - * @property CSS_LABEL_CLASS_NAME - * @description String representing the CSS class(es) to be applied to the - * menu item's <a> element. - * @default "yuimenuitemlabel" - * @final - * @type String - */ - CSS_LABEL_CLASS_NAME: "yuimenuitemlabel", - - - /** - * @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 - * <a> element. - * @default null - * @private - * @type HTMLAnchorElement - */ - _oAnchor: null, - - - /** - * @property _oHelpTextEM - * @description Object reference to the menu item's help text - * <em> element. - * @default null - * @private - * @type HTMLElement - */ - _oHelpTextEM: null, - - - /** - * @property _oSubmenu - * @description Object reference to the menu item's submenu. - * @default null - * @private - * @type YAHOO.widget.Menu - */ - _oSubmenu: 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: 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 - * <li> element. - * @default HTMLLIElement - * @type HTMLLIElement - */ - element: null, - - - /** - * @property srcElement - * @description Object reference to the HTML element (either - * <li>, <optgroup> or - * <option>) used create the menu item. - * @default HTMLLIElement|HTMLOptGroupElement|HTMLOptionElement - * @type HTMLLIElement| - * HTMLOptGroupElement|HTMLOptionElement - */ - srcElement: null, - - - /** - * @property value - * @description Object reference to the menu item's value. - * @default null - * @type Object - */ - value: null, - - - /** - * @property browser - * @deprecated Use YAHOO.env.ua - * @description String representing the browser. - * @type String - */ - browser: Module.prototype.browser, - - - /** - * @property id - * @description Id of the menu item's root <li> - * 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 <li> - * element is removed from its parent <ul> 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 {HTMLLIElement} p_oObject Object specifying - * the <li> element of the menu item. - * @param {HTMLOptGroupElement} p_oObject Object - * specifying the <optgroup> element of the menu item. - * @param {HTMLOptionElement} p_oObject Object - * specifying the <option> 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 SIGNATURE = CustomEvent.LIST, - oConfig = this.cfg, - sURL = "#", - oAnchor, - sTarget, - sText, - sId; - - - if (Lang.isString(p_oObject)) { - - this._createRootNodeStructure(); - - oConfig.queueProperty("text", p_oObject); - - } - else if (p_oObject && p_oObject.tagName) { - - switch(p_oObject.tagName.toUpperCase()) { - - case "OPTION": - - this._createRootNodeStructure(); - - oConfig.queueProperty("text", p_oObject.text); - oConfig.queueProperty("disabled", p_oObject.disabled); - - this.value = p_oObject.value; - - this.srcElement = p_oObject; - - break; - - case "OPTGROUP": - - this._createRootNodeStructure(); - - oConfig.queueProperty("text", p_oObject.label); - oConfig.queueProperty("disabled", p_oObject.disabled); - - this.srcElement = p_oObject; - - this._initSubTree(); - - break; - - case "LI": - - // Get the anchor node (if it exists) - - oAnchor = Dom.getFirstChild(p_oObject); - - - // Capture the "text" and/or the "URL" - - if (oAnchor) { - - sURL = oAnchor.getAttribute("href"); - sTarget = oAnchor.getAttribute("target"); - - sText = oAnchor.innerHTML; - - } - - this.srcElement = p_oObject; - this.element = p_oObject; - this._oAnchor = oAnchor; - - /* - 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); - - this._initSubTree(); - - break; - - } - - } - - - if (this.element) { - - sId = (this.srcElement || 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); - Dom.addClass(this._oAnchor, this.CSS_LABEL_CLASS_NAME); - - - // Create custom events - - this.mouseOverEvent = this.createEvent(EVENT_TYPES.MOUSE_OVER); - this.mouseOverEvent.signature = SIGNATURE; - - this.mouseOutEvent = this.createEvent(EVENT_TYPES.MOUSE_OUT); - this.mouseOutEvent.signature = SIGNATURE; - - this.mouseDownEvent = this.createEvent(EVENT_TYPES.MOUSE_DOWN); - this.mouseDownEvent.signature = SIGNATURE; - - this.mouseUpEvent = this.createEvent(EVENT_TYPES.MOUSE_UP); - this.mouseUpEvent.signature = SIGNATURE; - - this.clickEvent = this.createEvent(EVENT_TYPES.CLICK); - this.clickEvent.signature = SIGNATURE; - - this.keyPressEvent = this.createEvent(EVENT_TYPES.KEY_PRESS); - this.keyPressEvent.signature = SIGNATURE; - - this.keyDownEvent = this.createEvent(EVENT_TYPES.KEY_DOWN); - this.keyDownEvent.signature = SIGNATURE; - - this.keyUpEvent = this.createEvent(EVENT_TYPES.KEY_UP); - this.keyUpEvent.signature = SIGNATURE; - - this.focusEvent = this.createEvent(EVENT_TYPES.FOCUS); - this.focusEvent.signature = SIGNATURE; - - this.blurEvent = this.createEvent(EVENT_TYPES.BLUR); - this.blurEvent.signature = SIGNATURE; - - this.destroyEvent = this.createEvent(EVENT_TYPES.DESTROY); - this.destroyEvent.signature = SIGNATURE; - - if (p_oConfig) { - - oConfig.applyConfig(p_oConfig); - - } - - oConfig.fireQueue(); - - } - - }, - - - - // Private methods - - - /** - * @method _createRootNodeStructure - * @description Creates the core DOM structure for the menu item. - * @private - */ - _createRootNodeStructure: function () { - - var oElement, - oAnchor; - - if (!m_oMenuItemTemplate) { - - m_oMenuItemTemplate = document.createElement("li"); - m_oMenuItemTemplate.innerHTML = ""; - - } - - oElement = m_oMenuItemTemplate.cloneNode(true); - oElement.className = this.CSS_CLASS_NAME; - - oAnchor = oElement.firstChild; - oAnchor.className = this.CSS_LABEL_CLASS_NAME; - - this.element = oElement; - this._oAnchor = 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, - oNode, - aOptions, - nOptions, - oMenu, - n; - - - 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 { - - 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)); - - - nOptions = aOptions.length; - - if (nOptions > 0) { - - oMenu = new this.SUBMENU_TYPE(Dom.generateId()); - - oConfig.setProperty("submenu", oMenu); - - for(n=0; n" + sHelpText + ""; - - } - - - if (oConfig.getProperty("emphasis")) { - - sEmphasisStartTag = ""; - sEmphasisEndTag = ""; - - } - - - if (oConfig.getProperty("strongemphasis")) { - - sEmphasisStartTag = ""; - sEmphasisEndTag = ""; - - } - - - oAnchor.innerHTML = (sEmphasisStartTag + sText + - sEmphasisEndTag + sHelpTextHTML); - - } - - }, - - - /** - * @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) { - - this.cfg.refireEvent("text"); - - }, - - - /** - * @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 = "#"; - - } - - var oAnchor = this._oAnchor; - - if (YAHOO.env.ua.opera) { - - oAnchor.removeAttribute("href"); - - } - - 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], - oConfig = this.cfg; - - - if (bEmphasis && oConfig.getProperty("strongemphasis")) { - - oConfig.setProperty("strongemphasis", false); - - } - - - oConfig.refireEvent("text"); - - }, - - - /** - * @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], - oConfig = this.cfg; - - - if (bStrongEmphasis && oConfig.getProperty("emphasis")) { - - oConfig.setProperty("emphasis", false); - - } - - oConfig.refireEvent("text"); - - }, - - - /** - * @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], - oElement = this.element, - oAnchor = this._oAnchor, - oConfig = this.cfg, - sState = "-checked", - sClassName = this.CSS_CLASS_NAME + sState, - sLabelClassName = this.CSS_LABEL_CLASS_NAME + sState; - - - if (bChecked) { - - Dom.addClass(oElement, sClassName); - Dom.addClass(oAnchor, sLabelClassName); - - } - else { - - Dom.removeClass(oElement, sClassName); - Dom.removeClass(oAnchor, sLabelClassName); - - } - - - oConfig.refireEvent("text"); - - - if (oConfig.getProperty("disabled")) { - - oConfig.refireEvent("disabled"); - - } - - - if (oConfig.getProperty("selected")) { - - oConfig.refireEvent("selected"); - - } - - }, - - - - /** - * @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, - oSubmenu = oConfig.getProperty("submenu"), - bChecked = oConfig.getProperty("checked"), - oElement = this.element, - oAnchor = this._oAnchor, - sState = "-disabled", - sCheckedState = "-checked" + sState, - sSubmenuState = "-hassubmenu" + sState, - sClassName = this.CSS_CLASS_NAME + sState, - sLabelClassName = this.CSS_LABEL_CLASS_NAME + sState, - sCheckedClassName = this.CSS_CLASS_NAME + sCheckedState, - sLabelCheckedClassName = this.CSS_LABEL_CLASS_NAME + sCheckedState, - sSubmenuClassName = this.CSS_CLASS_NAME + sSubmenuState, - sLabelSubmenuClassName = this.CSS_LABEL_CLASS_NAME + sSubmenuState; - - - if (bDisabled) { - - if (oConfig.getProperty("selected")) { - - oConfig.setProperty("selected", false); - - } - - Dom.addClass(oElement, sClassName); - Dom.addClass(oAnchor, sLabelClassName); - - - if (oSubmenu) { - - Dom.addClass(oElement, sSubmenuClassName); - Dom.addClass(oAnchor, sLabelSubmenuClassName); - - } - - - if (bChecked) { - - Dom.addClass(oElement, sCheckedClassName); - Dom.addClass(oAnchor, sLabelCheckedClassName); - - } - - } - else { - - Dom.removeClass(oElement, sClassName); - Dom.removeClass(oAnchor, sLabelClassName); - - - if (oSubmenu) { - - Dom.removeClass(oElement, sSubmenuClassName); - Dom.removeClass(oAnchor, sLabelSubmenuClassName); - - } - - - if (bChecked) { - - Dom.removeClass(oElement, sCheckedClassName); - Dom.removeClass(oAnchor, sLabelCheckedClassName); - - } - - } - - }, - - - /** - * @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) { - - var oConfig = this.cfg, - bSelected = p_aArgs[0], - oElement = this.element, - oAnchor = this._oAnchor, - bChecked = oConfig.getProperty("checked"), - oSubmenu = oConfig.getProperty("submenu"), - sState = "-selected", - sCheckedState = "-checked" + sState, - sSubmenuState = "-hassubmenu" + sState, - sClassName = this.CSS_CLASS_NAME + sState, - sLabelClassName = this.CSS_LABEL_CLASS_NAME + sState, - sCheckedClassName = this.CSS_CLASS_NAME + sCheckedState, - sLabelCheckedClassName = this.CSS_LABEL_CLASS_NAME + sCheckedState, - sSubmenuClassName = this.CSS_CLASS_NAME + sSubmenuState, - sLabelSubmenuClassName = this.CSS_LABEL_CLASS_NAME + sSubmenuState; - - - if (YAHOO.env.ua.opera) { - - oAnchor.blur(); - - } - - - if (bSelected && !oConfig.getProperty("disabled")) { - - Dom.addClass(oElement, sClassName); - Dom.addClass(oAnchor, sLabelClassName); - - - if (oSubmenu) { - - Dom.addClass(oElement, sSubmenuClassName); - Dom.addClass(oAnchor, sLabelSubmenuClassName); - - } - - - if (bChecked) { - - Dom.addClass(oElement, sCheckedClassName); - Dom.addClass(oAnchor, sLabelCheckedClassName); - - } - - } - else { - - Dom.removeClass(oElement, sClassName); - Dom.removeClass(oAnchor, sLabelClassName); - - - if (oSubmenu) { - - Dom.removeClass(oElement, sSubmenuClassName); - Dom.removeClass(oAnchor, sLabelSubmenuClassName); - - } - - - if (bChecked) { - - Dom.removeClass(oElement, sCheckedClassName); - Dom.removeClass(oAnchor, sLabelCheckedClassName); - - } - - } - - - if (this.hasFocus() && YAHOO.env.ua.opera) { - - oAnchor.focus(); - - } - - }, - - - /** - * @method _onSubmenuBeforeHide - * @description "beforehide" Custom Event handler for a submenu. - * @private - * @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. - */ - _onSubmenuBeforeHide: function (p_sType, p_aArgs) { - - var oItem = this.parent, - oMenu; - - function onHide() { - - oItem._oAnchor.blur(); - oMenu.beforeHideEvent.unsubscribe(onHide); - - } - - - if (oItem.hasFocus()) { - - oMenu = oItem.parent; - - oMenu.beforeHideEvent.subscribe(onHide); - - } - - }, - - - /** - * @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 oSubmenu = p_aArgs[0], - oConfig = this.cfg, - oElement = this.element, - oAnchor = this._oAnchor, - bLazyLoad = this.parent && this.parent.lazyLoad, - sState = "-hassubmenu", - sClassName = this.CSS_CLASS_NAME + sState, - sLabelClassName = this.CSS_LABEL_CLASS_NAME + sState, - oMenu, - sSubmenuId, - oSubmenuConfig; - - - if (oSubmenu) { - - if (oSubmenu instanceof Menu) { - - oMenu = oSubmenu; - oMenu.parent = this; - oMenu.lazyLoad = bLazyLoad; - - } - else if (typeof oSubmenu == "object" && oSubmenu.id && - !oSubmenu.nodeType) { - - 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 - - oConfig.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 - - oConfig.setProperty("submenu", oMenu, true); - - } - - - if (oMenu) { - - Dom.addClass(oElement, sClassName); - Dom.addClass(oAnchor, sLabelClassName); - - this._oSubmenu = oMenu; - - if (YAHOO.env.ua.opera) { - - oMenu.beforeHideEvent.subscribe(this._onSubmenuBeforeHide); - - } - - } - - } - else { - - Dom.removeClass(oElement, sClassName); - Dom.removeClass(oAnchor, sLabelClassName); - - if (this._oSubmenu) { - - this._oSubmenu.destroy(); - - } - - } - - - if (oConfig.getProperty("disabled")) { - - oConfig.refireEvent("disabled"); - - } - - - if (oConfig.getProperty("selected")) { - - oConfig.refireEvent("selected"); - - } - - }, - - - /** - * @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, - ((!YAHOO.lang.isUndefined(oObject.obj)) ? 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; - - - // 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 menu item. - * @deprecated Use "text" configuration property to add help text markup. - * For example: oMenuItem.cfg.setProperty("text", "Copy <em - * class=\"helptext\">Ctrl + C</em>"); - * @default null - * @type String| - * HTMLElement - */ - oConfig.addProperty( - DEFAULT_CONFIG.HELP_TEXT.key, - { - handler: this.configHelpText, - supercedes: DEFAULT_CONFIG.HELP_TEXT.supercedes, - suppressEvent: DEFAULT_CONFIG.HELP_TEXT.suppressEvent - } - ); - - - /** - * @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. 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. - * 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. - * @deprecated Use "text" configuration property to add emphasis. - * For example: oMenuItem.cfg.setProperty("text", "<em>Some - * Text</em>"); - * @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, - supercedes: DEFAULT_CONFIG.EMPHASIS.supercedes - } - ); - - - /** - * @config strongemphasis - * @description Boolean indicating if the text of the menu item will be - * rendered with strong emphasis. - * @deprecated Use "text" configuration property to add strong emphasis. - * For example: oMenuItem.cfg.setProperty("text", "<strong> - * Some Text</strong>"); - * @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, - supercedes: DEFAULT_CONFIG.STRONG_EMPHASIS.supercedes - } - ); - - - /** - * @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:
Object - * specifying a Menu instance.
Object literal specifying the - * menu to be created. Format: { id: [menu id], itemdata: - * [array of values for - * items] }.
String specifying the id attribute - * of the <div> element of the menu.
- * Object specifying the <div> element of the - * menu.
- * @default null - * @type Menu|String|Object| - * HTMLElement - */ - oConfig.addProperty( - DEFAULT_CONFIG.SUBMENU.key, - { - handler: this.configSubmenu, - supercedes: DEFAULT_CONFIG.SUBMENU.supercedes, - suppressEvent: DEFAULT_CONFIG.SUBMENU.suppressEvent - } - ); - - - /** - * @config onclick - * @description Object literal representing the code to be executed when - * the item is clicked. Format:
{ - * fn: Function, // The handler to call when - * the event fires. obj: Object, // An - * object to pass back to the handler. scope: - * Object // The object to use for the scope of the handler. - * } - * @type Object - * @default null - */ - oConfig.addProperty( - DEFAULT_CONFIG.ONCLICK.key, - { - handler: this.configOnClick, - suppressEvent: DEFAULT_CONFIG.ONCLICK.suppressEvent - } - ); - - - /** - * @config classname - * @description CSS class to be applied to the menu item's root - * <li> 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, - suppressEvent: DEFAULT_CONFIG.CLASS_NAME.suppressEvent - } - ); - - }, - - - /** - * @method getNextEnabledSibling - * @description Finds the menu item's next enabled sibling. - * @return YAHOO.widget.MenuItem - */ - getNextEnabledSibling: function () { - - var nGroupIndex, - aItemGroups, - oNextItem, - nNextGroupIndex, - aNextGroup; - - function getNextArrayItem(p_aArray, p_nStartIndex) { - - return p_aArray[p_nStartIndex] || - getNextArrayItem(p_aArray, (p_nStartIndex+1)); - - } - - if (this.parent instanceof Menu) { - - nGroupIndex = this.groupIndex; - - aItemGroups = this.parent.getItemGroups(); - - if (this.index < (aItemGroups[nGroupIndex].length - 1)) { - - oNextItem = getNextArrayItem(aItemGroups[nGroupIndex], - (this.index+1)); - - } - else { - - if (nGroupIndex < (aItemGroups.length - 1)) { - - nNextGroupIndex = nGroupIndex + 1; - - } - else { - - nNextGroupIndex = 0; - - } - - 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 () { - - var nGroupIndex, - aItemGroups, - oPreviousItem, - nPreviousGroupIndex, - aPreviousGroup; - - 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)); - - } - - if (this.parent instanceof Menu) { - - nGroupIndex = this.groupIndex; - aItemGroups = this.parent.getItemGroups(); - - - if (this.index > getFirstItemIndex(aItemGroups[nGroupIndex], 0)) { - - oPreviousItem = getPreviousArrayItem(aItemGroups[nGroupIndex], - (this.index-1)); - - } - else { - - if (nGroupIndex > getFirstItemIndex(aItemGroups, 0)) { - - nPreviousGroupIndex = nGroupIndex - 1; - - } - else { - - nPreviousGroupIndex = aItemGroups.length - 1; - - } - - 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 (YAHOO.env.ua.ie && !document.hasFocus()) { - - return; - - } - - if (oActiveItem) { - - oActiveItem.blurEvent.fire(); - - } - - oAnchor.focus(); - - me.focusEvent.fire(); - - } - catch(e) { - - } - - } - - - if (!this.cfg.getProperty("disabled") && oParent && - oParent.cfg.getProperty("visible") && - this.element.style.display != "none") { - - - /* - 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); - - } - - }, - - - /** - * @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 && - oParent.cfg.getProperty("visible")) { - - - var me = this; - - window.setTimeout(function () { - - try { - - me._oAnchor.blur(); - me.blurEvent.fire(); - - } - catch (e) { - - } - - }, 0); - - } - - }, - - - /** - * @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 <li> element - * from its parent <ul> element. - */ - destroy: function () { - - var oEl = this.element, - oSubmenu, - oParentNode; - - if (oEl) { - - - // If the item has a submenu, destroy it first - - 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 - - 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", - sId = this.id; - - if (sId) { - - sReturnVal += (" " + sId); - - } - - return sReturnVal; - - } - -}; - -Lang.augmentProto(MenuItem, YAHOO.util.EventProvider); - -})(); -(function () { - - -/** -* Creates a list of options or commands which are made visible in response to -* an HTML element's "contextmenu" event ("mousedown" for Opera). -* -* @param {String} p_oElement String specifying the id attribute of the -* <div> element of the context menu. -* @param {String} p_oElement String specifying the id attribute of the -* <select> element to be used as the data source for the -* context menu. -* @param {HTMLDivElement} p_oElement Object specifying the -* <div> element of the context menu. -* @param {HTMLSelectElement} p_oElement Object specifying -* the <select> element to be used as the data source for -* the context menu. -* @param {Object} p_oConfig Optional. Object literal specifying the -* configuration for the context menu. See configuration class documentation -* for more details. -* @class ContextMenu -* @constructor -* @extends YAHOO.widget.Menu -* @namespace YAHOO.widget -*/ -YAHOO.widget.ContextMenu = function(p_oElement, p_oConfig) { - - YAHOO.widget.ContextMenu.superclass.constructor.call(this, - p_oElement, p_oConfig); - -}; - - -var Event = YAHOO.util.Event, - ContextMenu = YAHOO.widget.ContextMenu, - - - - /** - * Constant representing the name of the ContextMenu's events - * @property EVENT_TYPES - * @private - * @final - * @type Object - */ - EVENT_TYPES = { - - "TRIGGER_CONTEXT_MENU": "triggerContextMenu", - "CONTEXT_MENU": (YAHOO.env.ua.opera ? "mousedown" : "contextmenu"), - "CLICK": "click" - - }, - - - /** - * Constant representing the ContextMenu's configuration properties - * @property DEFAULT_CONFIG - * @private - * @final - * @type Object - */ - DEFAULT_CONFIG = { - - "TRIGGER": { - key: "trigger", - suppressEvent: true - } - - }; - - -/** -* @method position -* @description "beforeShow" event handler used to position the contextmenu. -* @private -* @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 {Array} p_aPos Array representing the xy position for the context menu. -*/ -function position(p_sType, p_aArgs, p_aPos) { - - this.cfg.setProperty("xy", p_aPos); - - this.beforeShowEvent.unsubscribe(position, p_aPos); - -} - - -YAHOO.lang.extend(ContextMenu, YAHOO.widget.Menu, { - - - -// Private properties - - -/** -* @property _oTrigger -* @description Object reference to the current value of the "trigger" -* configuration property. -* @default null -* @private -* @type String|HTMLElement|Array -*/ -_oTrigger: null, - - -/** -* @property _bCancelled -* @description Boolean indicating if the display of the context menu should -* be cancelled. -* @default false -* @private -* @type Boolean -*/ -_bCancelled: false, - - - -// Public properties - - -/** -* @property contextEventTarget -* @description Object reference for the HTML element that was the target of the -* "contextmenu" DOM event ("mousedown" for Opera) that triggered the display of -* the context menu. -* @default null -* @type HTMLElement -*/ -contextEventTarget: null, - - - -// Events - - -/** -* @event triggerContextMenuEvent -* @description Custom Event wrapper for the "contextmenu" DOM event -* ("mousedown" for Opera) fired by the element(s) that trigger the display of -* the context menu. -*/ -triggerContextMenuEvent: null, - - - -/** -* @method init -* @description The ContextMenu 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_oElement String specifying the id attribute of the -* <div> element of the context menu. -* @param {String} p_oElement String specifying the id attribute of the -* <select> element to be used as the data source for -* the context menu. -* @param {HTMLDivElement} p_oElement Object specifying the -* <div> element of the context menu. -* @param {HTMLSelectElement} p_oElement Object specifying -* the <select> element to be used as the data source for -* the context menu. -* @param {Object} p_oConfig Optional. Object literal specifying the -* configuration for the context menu. See configuration class documentation -* for more details. -*/ -init: function(p_oElement, p_oConfig) { - - - // Call the init of the superclass (YAHOO.widget.Menu) - - ContextMenu.superclass.init.call(this, p_oElement); - - - this.beforeInitEvent.fire(ContextMenu); - - - if(p_oConfig) { - - this.cfg.applyConfig(p_oConfig, true); - - } - - - this.initEvent.fire(ContextMenu); - -}, - - -/** -* @method initEvents -* @description Initializes the custom events for the context menu. -*/ -initEvents: function() { - - ContextMenu.superclass.initEvents.call(this); - - // Create custom events - - this.triggerContextMenuEvent = - this.createEvent(EVENT_TYPES.TRIGGER_CONTEXT_MENU); - - this.triggerContextMenuEvent.signature = YAHOO.util.CustomEvent.LIST; - -}, - - -/** -* @method cancel -* @description Cancels the display of the context menu. -*/ -cancel: function() { - - this._bCancelled = true; - -}, - - - -// Private methods - - -/** -* @method _removeEventHandlers -* @description Removes all of the DOM event handlers from the HTML element(s) -* whose "context menu" event ("click" for Opera) trigger the display of -* the context menu. -* @private -*/ -_removeEventHandlers: function() { - - var oTrigger = this._oTrigger; - - - // Remove the event handlers from the trigger(s) - - if (oTrigger) { - - Event.removeListener(oTrigger, EVENT_TYPES.CONTEXT_MENU, - this._onTriggerContextMenu); - - if(YAHOO.env.ua.opera) { - - Event.removeListener(oTrigger, EVENT_TYPES.CLICK, - this._onTriggerClick); - - } - - } - -}, - - - -// Private event handlers - - - -/** -* @method _onTriggerClick -* @description "click" event handler for the HTML element(s) identified as the -* "trigger" for the context menu. Used to cancel default behaviors in Opera. -* @private -* @param {Event} p_oEvent Object representing the DOM event object passed back -* by the event utility (YAHOO.util.Event). -* @param {YAHOO.widget.ContextMenu} p_oMenu Object representing the context -* menu that is handling the event. -*/ -_onTriggerClick: function(p_oEvent, p_oMenu) { - - if(p_oEvent.ctrlKey) { - - Event.stopEvent(p_oEvent); - - } - -}, - - -/** -* @method _onTriggerContextMenu -* @description "contextmenu" event handler ("mousedown" for Opera) for the HTML -* element(s) that trigger the display of the context menu. -* @private -* @param {Event} p_oEvent Object representing the DOM event object passed back -* by the event utility (YAHOO.util.Event). -* @param {YAHOO.widget.ContextMenu} p_oMenu Object representing the context -* menu that is handling the event. -*/ -_onTriggerContextMenu: function(p_oEvent, p_oMenu) { - - if (p_oEvent.type == "mousedown" && !p_oEvent.ctrlKey) { - - return; - - } - - - var aXY; - - - /* - Prevent the browser's default context menu from appearing and - stop the propagation of the "contextmenu" event so that - other ContextMenu instances are not displayed. - */ - - Event.stopEvent(p_oEvent); - - - this.contextEventTarget = Event.getTarget(p_oEvent); - - this.triggerContextMenuEvent.fire(p_oEvent); - - - // Hide any other Menu instances that might be visible - - YAHOO.widget.MenuManager.hideVisible(); - - - - if(!this._bCancelled) { - - // Position and display the context menu - - aXY = Event.getXY(p_oEvent); - - - if (!YAHOO.util.Dom.inDocument(this.element)) { - - this.beforeShowEvent.subscribe(position, aXY); - - } - else { - - this.cfg.setProperty("xy", aXY); - - } - - - this.show(); - - } - - this._bCancelled = false; - -}, - - - -// Public methods - - -/** -* @method toString -* @description Returns a string representing the context menu. -* @return {String} -*/ -toString: function() { - - var sReturnVal = "ContextMenu", - sId = this.id; - - if(sId) { - - sReturnVal += (" " + sId); - - } - - return sReturnVal; - -}, - - -/** -* @method initDefaultConfig -* @description Initializes the class's configurable properties which can be -* changed using the context menu's Config object ("cfg"). -*/ -initDefaultConfig: function() { - - ContextMenu.superclass.initDefaultConfig.call(this); - - /** - * @config trigger - * @description The HTML element(s) whose "contextmenu" event ("mousedown" - * for Opera) trigger the display of the context menu. Can be a string - * representing the id attribute of the HTML element, an object reference - * for the HTML element, or an array of strings or HTML element references. - * @default null - * @type String|HTMLElement|Array - */ - this.cfg.addProperty(DEFAULT_CONFIG.TRIGGER.key, - { - handler: this.configTrigger, - suppressEvent: DEFAULT_CONFIG.TRIGGER.suppressEvent - } - ); - -}, - - -/** -* @method destroy -* @description Removes the context menu's <div> element -* (and accompanying child nodes) from the document. -*/ -destroy: function() { - - // Remove the DOM event handlers from the current trigger(s) - - this._removeEventHandlers(); - - - // Continue with the superclass implementation of this method - - ContextMenu.superclass.destroy.call(this); - -}, - - - -// Public event handlers for configuration properties - - -/** -* @method configTrigger -* @description Event handler for when the value of the "trigger" configuration -* property 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.ContextMenu} p_oMenu Object representing the context -* menu that fired the event. -*/ -configTrigger: function(p_sType, p_aArgs, p_oMenu) { - - var oTrigger = p_aArgs[0]; - - if(oTrigger) { - - /* - If there is a current "trigger" - remove the event handlers - from that element(s) before assigning new ones - */ - - if(this._oTrigger) { - - this._removeEventHandlers(); - - } - - this._oTrigger = oTrigger; - - - /* - Listen for the "mousedown" event in Opera b/c it does not - support the "contextmenu" event - */ - - Event.on(oTrigger, EVENT_TYPES.CONTEXT_MENU, - this._onTriggerContextMenu, this, true); - - - /* - Assign a "click" event handler to the trigger element(s) for - Opera to prevent default browser behaviors. - */ - - if(YAHOO.env.ua.opera) { - - Event.on(oTrigger, EVENT_TYPES.CLICK, this._onTriggerClick, - this, true); - - } - - } - else { - - this._removeEventHandlers(); - - } - -} - -}); // END YAHOO.lang.extend - -}()); - - - -/** -* Creates an item for a context menu. -* -* @param {String} p_oObject String specifying the text of the context menu item. -* @param {HTMLLIElement} p_oObject Object specifying the -* <li> element of the context menu item. -* @param {HTMLOptGroupElement} p_oObject Object -* specifying the <optgroup> element of the context -* menu item. -* @param {HTMLOptionElement} p_oObject Object specifying -* the <option> element of the context menu item. -* @param {Object} p_oConfig Optional. Object literal specifying the -* configuration for the context menu item. See configuration class -* documentation for more details. -* @class ContextMenuItem -* @constructor -* @extends YAHOO.widget.MenuItem -* @deprecated As of version 2.4.0 items for YAHOO.widget.ContextMenu instances -* are of type YAHOO.widget.MenuItem. -*/ -YAHOO.widget.ContextMenuItem = YAHOO.widget.MenuItem; -(function () { - - -/** -* Horizontal collection of items, each of which can contain a submenu. -* -* @param {String} p_oElement String specifying the id attribute of the -* <div> element of the menu bar. -* @param {String} p_oElement String specifying the id attribute of the -* <select> element to be used as the data source for the -* menu bar. -* @param {HTMLDivElement} p_oElement Object specifying -* the <div> element of the menu bar. -* @param {HTMLSelectElement} p_oElement Object -* specifying the <select> element to be used as the data -* source for the menu bar. -* @param {Object} p_oConfig Optional. Object literal specifying the -* configuration for the menu bar. See configuration class documentation for -* more details. -* @class MenuBar -* @constructor -* @extends YAHOO.widget.Menu -* @namespace YAHOO.widget -*/ -YAHOO.widget.MenuBar = function(p_oElement, p_oConfig) { - - YAHOO.widget.MenuBar.superclass.constructor.call(this, - p_oElement, p_oConfig); - -}; - - -/** -* @method checkPosition -* @description Checks to make sure that the value of the "position" property -* is one of the supported strings. Returns true if the position is supported. -* @private -* @param {Object} p_sPosition String specifying the position of the menu. -* @return {Boolean} -*/ -function checkPosition(p_sPosition) { - - if (typeof p_sPosition == "string") { - - return ("dynamic,static".indexOf((p_sPosition.toLowerCase())) != -1); - - } - -} - - -var Event = YAHOO.util.Event, - MenuBar = YAHOO.widget.MenuBar, - - /** - * Constant representing the MenuBar's configuration properties - * @property DEFAULT_CONFIG - * @private - * @final - * @type Object - */ - DEFAULT_CONFIG = { - - "POSITION": { - key: "position", - value: "static", - validator: checkPosition, - supercedes: ["visible"] - }, - - "SUBMENU_ALIGNMENT": { - key: "submenualignment", - value: ["tl","bl"], - suppressEvent: true - }, - - "AUTO_SUBMENU_DISPLAY": { - key: "autosubmenudisplay", - value: false, - validator: YAHOO.lang.isBoolean, - suppressEvent: true - } - - }; - - - -YAHOO.lang.extend(MenuBar, YAHOO.widget.Menu, { - -/** -* @method init -* @description The MenuBar 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_oElement String specifying the id attribute of the -* <div> element of the menu bar. -* @param {String} p_oElement String specifying the id attribute of the -* <select> element to be used as the data source for the -* menu bar. -* @param {HTMLDivElement} p_oElement Object specifying -* the <div> element of the menu bar. -* @param {HTMLSelectElement} p_oElement Object -* specifying the <select> element to be used as the data -* source for the menu bar. -* @param {Object} p_oConfig Optional. Object literal specifying the -* configuration for the menu bar. See configuration class documentation for -* more details. -*/ -init: function(p_oElement, p_oConfig) { - - if(!this.ITEM_TYPE) { - - this.ITEM_TYPE = YAHOO.widget.MenuBarItem; - - } - - - // Call the init of the superclass (YAHOO.widget.Menu) - - MenuBar.superclass.init.call(this, p_oElement); - - - this.beforeInitEvent.fire(MenuBar); - - - if(p_oConfig) { - - this.cfg.applyConfig(p_oConfig, true); - - } - - this.initEvent.fire(MenuBar); - -}, - - - -// Constants - - -/** -* @property CSS_CLASS_NAME -* @description String representing the CSS class(es) to be applied to the menu -* bar's <div> element. -* @default "yuimenubar" -* @final -* @type String -*/ -CSS_CLASS_NAME: "yuimenubar", - - - -// Protected event handlers - - -/** -* @method _onKeyDown -* @description "keydown" Custom Event handler for the menu bar. -* @private -* @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.MenuBar} p_oMenuBar Object representing the menu bar -* that fired the event. -*/ -_onKeyDown: function(p_sType, p_aArgs, p_oMenuBar) { - - var oEvent = p_aArgs[0], - oItem = p_aArgs[1], - oSubmenu, - oItemCfg, - oNextItem; - - - if(oItem && !oItem.cfg.getProperty("disabled")) { - - oItemCfg = oItem.cfg; - - switch(oEvent.keyCode) { - - case 37: // Left arrow - case 39: // Right arrow - - if(oItem == this.activeItem && - !oItemCfg.getProperty("selected")) { - - oItemCfg.setProperty("selected", true); - - } - else { - - oNextItem = (oEvent.keyCode == 37) ? - oItem.getPreviousEnabledSibling() : - oItem.getNextEnabledSibling(); - - if(oNextItem) { - - this.clearActiveItem(); - - oNextItem.cfg.setProperty("selected", true); - - - if(this.cfg.getProperty("autosubmenudisplay")) { - - oSubmenu = oNextItem.cfg.getProperty("submenu"); - - if(oSubmenu) { - - oSubmenu.show(); - - } - - } - - oNextItem.focus(); - - } - - } - - Event.preventDefault(oEvent); - - break; - - case 40: // Down arrow - - if(this.activeItem != oItem) { - - this.clearActiveItem(); - - oItemCfg.setProperty("selected", true); - oItem.focus(); - - } - - oSubmenu = oItemCfg.getProperty("submenu"); - - if(oSubmenu) { - - if(oSubmenu.cfg.getProperty("visible")) { - - oSubmenu.setInitialSelection(); - oSubmenu.setInitialFocus(); - - } - else { - - oSubmenu.show(); - - } - - } - - Event.preventDefault(oEvent); - - break; - - } - - } - - - if(oEvent.keyCode == 27 && this.activeItem) { // Esc key - - oSubmenu = this.activeItem.cfg.getProperty("submenu"); - - if(oSubmenu && oSubmenu.cfg.getProperty("visible")) { - - oSubmenu.hide(); - this.activeItem.focus(); - - } - else { - - this.activeItem.cfg.setProperty("selected", false); - this.activeItem.blur(); - - } - - Event.preventDefault(oEvent); - - } - -}, - - -/** -* @method _onClick -* @description "click" event handler for the menu bar. -* @protected -* @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.MenuBar} p_oMenuBar Object representing the menu bar -* that fired the event. -*/ -_onClick: function(p_sType, p_aArgs, p_oMenuBar) { - - MenuBar.superclass._onClick.call(this, p_sType, p_aArgs, p_oMenuBar); - - var oItem = p_aArgs[1], - oEvent, - oTarget, - oActiveItem, - oConfig, - oSubmenu; - - - if(oItem && !oItem.cfg.getProperty("disabled")) { - - oEvent = p_aArgs[0]; - oTarget = Event.getTarget(oEvent); - oActiveItem = this.activeItem; - oConfig = this.cfg; - - - // Hide any other submenus that might be visible - - if(oActiveItem && oActiveItem != oItem) { - - this.clearActiveItem(); - - } - - - oItem.cfg.setProperty("selected", true); - - - // Show the submenu for the item - - oSubmenu = oItem.cfg.getProperty("submenu"); - - - if(oSubmenu) { - - if(oSubmenu.cfg.getProperty("visible")) { - - oSubmenu.hide(); - - } - else { - - oSubmenu.show(); - - } - - } - - } - -}, - - - -// Public methods - - -/** -* @method toString -* @description Returns a string representing the menu bar. -* @return {String} -*/ -toString: function() { - - var sReturnVal = "MenuBar", - sId = this.id; - - if(sId) { - - sReturnVal += (" " + sId); - - } - - return sReturnVal; - -}, - - -/** -* @description Initializes the class's configurable properties which can be -* changed using the menu bar's Config object ("cfg"). -* @method initDefaultConfig -*/ -initDefaultConfig: function() { - - MenuBar.superclass.initDefaultConfig.call(this); - - var oConfig = this.cfg; - - // Add configuration properties - - - /* - Set the default value for the "position" configuration property - to "static" by re-adding the property. - */ - - - /** - * @config position - * @description String indicating how a menu bar should be positioned on the - * screen. Possible values are "static" and "dynamic." Static menu bars - * are visible by default and reside in the normal flow of the document - * (CSS position: static). Dynamic menu bars are hidden by default, reside - * out of the normal flow of the document (CSS position: absolute), and can - * overlay other elements on the screen. - * @default static - * @type String - */ - oConfig.addProperty( - DEFAULT_CONFIG.POSITION.key, - { - handler: this.configPosition, - value: DEFAULT_CONFIG.POSITION.value, - validator: DEFAULT_CONFIG.POSITION.validator, - supercedes: DEFAULT_CONFIG.POSITION.supercedes - } - ); - - - /* - Set the default value for the "submenualignment" configuration property - to ["tl","bl"] by re-adding the property. - */ - - /** - * @config submenualignment - * @description Array defining how submenus should be aligned to their - * parent menu bar item. The format is: [itemCorner, submenuCorner]. - * @default ["tl","bl"] - * @type Array - */ - oConfig.addProperty( - DEFAULT_CONFIG.SUBMENU_ALIGNMENT.key, - { - value: DEFAULT_CONFIG.SUBMENU_ALIGNMENT.value, - suppressEvent: DEFAULT_CONFIG.SUBMENU_ALIGNMENT.suppressEvent - } - ); - - - /* - Change the default value for the "autosubmenudisplay" configuration - property to "false" by re-adding the property. - */ - - /** - * @config autosubmenudisplay - * @description Boolean indicating if submenus are automatically made - * visible when the user mouses over the menu bar's items. - * @default false - * @type Boolean - */ - oConfig.addProperty( - DEFAULT_CONFIG.AUTO_SUBMENU_DISPLAY.key, - { - value: DEFAULT_CONFIG.AUTO_SUBMENU_DISPLAY.value, - validator: DEFAULT_CONFIG.AUTO_SUBMENU_DISPLAY.validator, - suppressEvent: DEFAULT_CONFIG.AUTO_SUBMENU_DISPLAY.suppressEvent - } - ); - -} - -}); // END YAHOO.lang.extend - -}()); - - - -/** -* Creates an item for a menu bar. -* -* @param {String} p_oObject String specifying the text of the menu bar item. -* @param {HTMLLIElement} p_oObject Object specifying the -* <li> element of the menu bar item. -* @param {HTMLOptGroupElement} p_oObject Object -* specifying the <optgroup> element of the menu bar item. -* @param {HTMLOptionElement} p_oObject Object specifying -* the <option> element of the menu bar item. -* @param {Object} p_oConfig Optional. Object literal specifying the -* configuration for the menu bar item. See configuration class documentation -* for more details. -* @class MenuBarItem -* @constructor -* @extends YAHOO.widget.MenuItem -*/ -YAHOO.widget.MenuBarItem = function(p_oObject, p_oConfig) { - - YAHOO.widget.MenuBarItem.superclass.constructor.call(this, - p_oObject, p_oConfig); - -}; - -YAHOO.lang.extend(YAHOO.widget.MenuBarItem, YAHOO.widget.MenuItem, { - - - -/** -* @method init -* @description The MenuBarItem 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 bar item. -* @param {HTMLLIElement} p_oObject Object specifying the -* <li> element of the menu bar item. -* @param {HTMLOptGroupElement} p_oObject Object -* specifying the <optgroup> element of the menu bar item. -* @param {HTMLOptionElement} p_oObject Object specifying -* the <option> element of the menu bar item. -* @param {Object} p_oConfig Optional. Object literal specifying the -* configuration for the menu bar item. See configuration class documentation -* for more details. -*/ -init: function(p_oObject, p_oConfig) { - - if(!this.SUBMENU_TYPE) { - - this.SUBMENU_TYPE = YAHOO.widget.Menu; - - } - - - /* - Call the init of the superclass (YAHOO.widget.MenuItem) - Note: We don't pass the user config in here yet - because we only want it executed once, at the lowest - subclass level. - */ - - YAHOO.widget.MenuBarItem.superclass.init.call(this, p_oObject); - - - var oConfig = this.cfg; - - if(p_oConfig) { - - oConfig.applyConfig(p_oConfig, true); - - } - - oConfig.fireQueue(); - -}, - - - -// Constants - - -/** -* @property CSS_CLASS_NAME -* @description String representing the CSS class(es) to be applied to the -* <li> element of the menu bar item. -* @default "yuimenubaritem" -* @final -* @type String -*/ -CSS_CLASS_NAME: "yuimenubaritem", - - -/** -* @property CSS_LABEL_CLASS_NAME -* @description String representing the CSS class(es) to be applied to the -* menu bar item's <a> element. -* @default "yuimenubaritemlabel" -* @final -* @type String -*/ -CSS_LABEL_CLASS_NAME: "yuimenubaritemlabel", - - - -// Public methods - - -/** -* @method toString -* @description Returns a string representing the menu bar item. -* @return {String} -*/ -toString: function() { - - var sReturnVal = "MenuBarItem"; - - if(this.cfg && this.cfg.getProperty("text")) { - - sReturnVal += (": " + this.cfg.getProperty("text")); - - } - - return sReturnVal; - -} - -}); // END YAHOO.lang.extend -YAHOO.register("menu", YAHOO.widget.Menu, {version: "2.5.0", build: "895"}); diff --git a/lib/yui/menu/menu-min.js b/lib/yui/menu/menu-min.js deleted file mode 100755 index d91d760cd5..0000000000 --- a/lib/yui/menu/menu-min.js +++ /dev/null @@ -1,16 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -(function(){var B=YAHOO.util.Dom,A=YAHOO.util.Event;YAHOO.widget.MenuManager=function(){var N=false,F={},Q={},J={},E={"click":"clickEvent","mousedown":"mouseDownEvent","mouseup":"mouseUpEvent","mouseover":"mouseOverEvent","mouseout":"mouseOutEvent","keydown":"keyDownEvent","keyup":"keyUpEvent","keypress":"keyPressEvent"},K=null;function D(S){var R;if(S&&S.tagName){switch(S.tagName.toUpperCase()){case"DIV":R=S.parentNode;if((B.hasClass(S,"hd")||B.hasClass(S,"bd")||B.hasClass(S,"ft"))&&R&&R.tagName&&R.tagName.toUpperCase()=="DIV"){return R;}else{return S;}break;case"LI":return S;default:R=S.parentNode;if(R){return D(R);}break;}}}function G(V){var R=A.getTarget(V),S=D(R),X,T,U,Z,Y;if(S){T=S.tagName.toUpperCase();if(T=="LI"){U=S.id;if(U&&J[U]){Z=J[U];Y=Z.parent;}}else{if(T=="DIV"){if(S.id){Y=F[S.id];}}}}if(Y){X=E[V.type];if(Z&&!Z.cfg.getProperty("disabled")){Z[X].fire(V);if(V.type=="keyup"||V.type=="mousedown"){if(K!=Z){if(K){K.blurEvent.fire();}Z.focusEvent.fire();}}}Y[X].fire(V,Z);}else{if(V.type=="mousedown"){if(K){K.blurEvent.fire();K=null;}for(var W in Q){if(YAHOO.lang.hasOwnProperty(Q,W)){Y=Q[W];if(Y.cfg.getProperty("clicktohide")&&!(Y instanceof YAHOO.widget.MenuBar)&&Y.cfg.getProperty("position")=="dynamic"){Y.hide();}else{Y.clearActiveItem(true);}}}}else{if(V.type=="keyup"){if(K){K.blurEvent.fire();K=null;}}}}}function P(S,R,T){if(F[T.id]){this.removeMenu(T);}}function M(S,R){var T=R[0];if(T){K=T;}}function H(S,R){K=null;}function C(T,S){var R=S[0],U=this.id;if(R){Q[U]=this;}else{if(Q[U]){delete Q[U];}}}function L(S,R){O(this);}function O(S){var R=S.id;if(R&&J[R]){if(K==S){K=null;}delete J[R];S.destroyEvent.unsubscribe(L);}}function I(S,R){var U=R[0],T;if(U instanceof YAHOO.widget.MenuItem){T=U.id;if(!J[T]){J[T]=U;U.destroyEvent.subscribe(L);}}}return{addMenu:function(S){var R;if(S instanceof YAHOO.widget.Menu&&S.id&&!F[S.id]){F[S.id]=S;if(!N){R=document;A.on(R,"mouseover",G,this,true);A.on(R,"mouseout",G,this,true);A.on(R,"mousedown",G,this,true);A.on(R,"mouseup",G,this,true);A.on(R,"click",G,this,true);A.on(R,"keydown",G,this,true);A.on(R,"keyup",G,this,true);A.on(R,"keypress",G,this,true);N=true;}S.cfg.subscribeToConfigEvent("visible",C);S.destroyEvent.subscribe(P,S,this);S.itemAddedEvent.subscribe(I);S.focusEvent.subscribe(M);S.blurEvent.subscribe(H);}},removeMenu:function(U){var S,R,T;if(U){S=U.id;if(F[S]==U){R=U.getItems();if(R&&R.length>0){T=R.length-1;do{O(R[T]);}while(T--);}delete F[S];if(Q[S]==U){delete Q[S];}if(U.cfg){U.cfg.unsubscribeFromConfigEvent("visible",C);}U.destroyEvent.unsubscribe(P,U);U.itemAddedEvent.unsubscribe(I);U.focusEvent.unsubscribe(M);U.blurEvent.unsubscribe(H);}}},hideVisible:function(){var R;for(var S in Q){if(YAHOO.lang.hasOwnProperty(Q,S)){R=Q[S];if(!(R instanceof YAHOO.widget.MenuBar)&&R.cfg.getProperty("position")=="dynamic"){R.hide();}}}},getVisible:function(){return Q;},getMenus:function(){return F;},getMenu:function(S){var R=F[S];if(R){return R;}},getMenuItem:function(R){var S=J[R];if(S){return S;}},getMenuItemGroup:function(U){var S=B.get(U),R,W,V,T;if(S&&S.tagName&&S.tagName.toUpperCase()=="UL"){W=S.firstChild;if(W){R=[];do{T=W.id;if(T){V=this.getMenuItem(T);if(V){R[R.length]=V;}}}while((W=W.nextSibling));if(R.length>0){return R;}}}},getFocusedMenuItem:function(){return K;},getFocusedMenu:function(){if(K){return(K.parent.getRoot());}},toString:function(){return"MenuManager";}};}();})();(function(){YAHOO.widget.Menu=function(O,N){if(N){this.parent=N.parent;this.lazyLoad=N.lazyLoad||N.lazyload;this.itemData=N.itemData||N.itemdata;}YAHOO.widget.Menu.superclass.constructor.call(this,O,N);};function I(N){if(typeof N=="string"){return("dynamic,static".indexOf((N.toLowerCase()))!=-1);}}var C=YAHOO.util.Dom,M=YAHOO.util.Event,D=YAHOO.widget.Module,B=YAHOO.widget.Overlay,F=YAHOO.widget.Menu,K=YAHOO.widget.MenuManager,L=YAHOO.util.CustomEvent,E=YAHOO.lang,H=YAHOO.env.ua,G,A={"MOUSE_OVER":"mouseover","MOUSE_OUT":"mouseout","MOUSE_DOWN":"mousedown","MOUSE_UP":"mouseup","CLICK":"click","KEY_PRESS":"keypress","KEY_DOWN":"keydown","KEY_UP":"keyup","FOCUS":"focus","BLUR":"blur","ITEM_ADDED":"itemAdded","ITEM_REMOVED":"itemRemoved"},J={"VISIBLE":{key:"visible",value:false,validator:E.isBoolean},"CONSTRAIN_TO_VIEWPORT":{key:"constraintoviewport",value:true,validator:E.isBoolean,supercedes:["iframe","x","y","xy"]},"POSITION":{key:"position",value:"dynamic",validator:I,supercedes:["visible","iframe"]},"SUBMENU_ALIGNMENT":{key:"submenualignment",value:["tl","tr"],suppressEvent:true},"AUTO_SUBMENU_DISPLAY":{key:"autosubmenudisplay",value:true,validator:E.isBoolean,suppressEvent:true},"SHOW_DELAY":{key:"showdelay",value:250,validator:E.isNumber,suppressEvent:true},"HIDE_DELAY":{key:"hidedelay",value:0,validator:E.isNumber,suppressEvent:true},"SUBMENU_HIDE_DELAY":{key:"submenuhidedelay",value:250,validator:E.isNumber,suppressEvent:true},"CLICK_TO_HIDE":{key:"clicktohide",value:true,validator:E.isBoolean,suppressEvent:true},"CONTAINER":{key:"container",suppressEvent:true},"SCROLL_INCREMENT":{key:"scrollincrement",value:1,validator:E.isNumber,supercedes:["maxheight"],suppressEvent:true},"MIN_SCROLL_HEIGHT":{key:"minscrollheight",value:90,validator:E.isNumber,supercedes:["maxheight"],suppressEvent:true},"MAX_HEIGHT":{key:"maxheight",value:0,validator:E.isNumber,supercedes:["iframe"],suppressEvent:true},"CLASS_NAME":{key:"classname",value:null,validator:E.isString,suppressEvent:true},"DISABLED":{key:"disabled",value:false,validator:E.isBoolean,suppressEvent:true}};YAHOO.lang.extend(F,B,{CSS_CLASS_NAME:"yuimenu",ITEM_TYPE:null,GROUP_TITLE_TAG_NAME:"h6",OFF_SCREEN_POSITION:[-10000,-10000],_nHideDelayId:null,_nShowDelayId:null,_nSubmenuHideDelayId:null,_nBodyScrollId:null,_bHideDelayEventHandlersAssigned:false,_bHandledMouseOverEvent:false,_bHandledMouseOutEvent:false,_aGroupTitleElements:null,_aItemGroups:null,_aListElements:null,_nCurrentMouseX:0,_bStopMouseEventHandlers:false,_sClassName:null,lazyLoad:false,itemData:null,activeItem:null,parent:null,srcElement:null,mouseOverEvent:null,mouseOutEvent:null,mouseDownEvent:null,mouseUpEvent:null,clickEvent:null,keyPressEvent:null,keyDownEvent:null,keyUpEvent:null,itemAddedEvent:null,itemRemovedEvent:null,init:function(P,O){this._aItemGroups=[]; -this._aListElements=[];this._aGroupTitleElements=[];if(!this.ITEM_TYPE){this.ITEM_TYPE=YAHOO.widget.MenuItem;}var N;if(typeof P=="string"){N=document.getElementById(P);}else{if(P.tagName){N=P;}}if(N&&N.tagName){switch(N.tagName.toUpperCase()){case"DIV":this.srcElement=N;if(!N.id){N.setAttribute("id",C.generateId());}F.superclass.init.call(this,N);this.beforeInitEvent.fire(F);break;case"SELECT":this.srcElement=N;F.superclass.init.call(this,C.generateId());this.beforeInitEvent.fire(F);break;}}else{F.superclass.init.call(this,P);this.beforeInitEvent.fire(F);}if(this.element){C.addClass(this.element,this.CSS_CLASS_NAME);this.initEvent.subscribe(this._onInit);this.beforeRenderEvent.subscribe(this._onBeforeRender);this.renderEvent.subscribe(this._onRender);this.renderEvent.subscribe(this.onRender);this.beforeShowEvent.subscribe(this._onBeforeShow);this.hideEvent.subscribe(this.positionOffScreen);this.showEvent.subscribe(this._onShow);this.beforeHideEvent.subscribe(this._onBeforeHide);this.mouseOverEvent.subscribe(this._onMouseOver);this.mouseOutEvent.subscribe(this._onMouseOut);this.clickEvent.subscribe(this._onClick);this.keyDownEvent.subscribe(this._onKeyDown);this.keyPressEvent.subscribe(this._onKeyPress);if(H.gecko||H.webkit){this.cfg.subscribeToConfigEvent("y",this._onYChange);}if(O){this.cfg.applyConfig(O,true);}K.addMenu(this);this.initEvent.fire(F);}},_initSubTree:function(){var O=this.srcElement,N,Q,T,U,S,R,P;if(O){N=(O.tagName&&O.tagName.toUpperCase());if(N=="DIV"){U=this.body.firstChild;if(U){Q=0;T=this.GROUP_TITLE_TAG_NAME.toUpperCase();do{if(U&&U.tagName){switch(U.tagName.toUpperCase()){case T:this._aGroupTitleElements[Q]=U;break;case"UL":this._aListElements[Q]=U;this._aItemGroups[Q]=[];Q++;break;}}}while((U=U.nextSibling));if(this._aListElements[0]){C.addClass(this._aListElements[0],"first-of-type");}}}U=null;if(N){switch(N){case"DIV":S=this._aListElements;R=S.length;if(R>0){P=R-1;do{U=S[P].firstChild;if(U){do{if(U&&U.tagName&&U.tagName.toUpperCase()=="LI"){this.addItem(new this.ITEM_TYPE(U,{parent:this}),P);}}while((U=U.nextSibling));}}while(P--);}break;case"SELECT":U=O.firstChild;do{if(U&&U.tagName){switch(U.tagName.toUpperCase()){case"OPTGROUP":case"OPTION":this.addItem(new this.ITEM_TYPE(U,{parent:this}));break;}}}while((U=U.nextSibling));break;}}}},_getFirstEnabledItem:function(){var N=this.getItems(),Q=N.length,P;for(var O=0;O=Q.length);if(Q[W]){Q.splice(W,0,U);}else{Q[W]=U;}V=Q[W];if(V){if(R&&(!V.element.parentNode||V.element.parentNode.nodeType==11)){this._aListElements[X].appendChild(V.element);}else{O=N(Q,(W+1));if(O&&(!V.element.parentNode||V.element.parentNode.nodeType==11)){this._aListElements[X].insertBefore(V.element,O.element);}}V.parent=this;this._subscribeToItemEvents(V);this._configureSubmenu(V);this._updateItemProperties(X);this.itemAddedEvent.fire(V);this.changeContentEvent.fire();return V;}}else{P=Q.length;Q[P]=U;V=Q[P];if(V){if(!C.isAncestor(this._aListElements[X],V.element)){this._aListElements[X].appendChild(V.element);}V.element.setAttribute("groupindex",X);V.element.setAttribute("index",P);V.parent=this;V.index=P;V.groupIndex=X;this._subscribeToItemEvents(V);this._configureSubmenu(V);if(P===0){C.addClass(V.element,"first-of-type");}this.itemAddedEvent.fire(V);this.changeContentEvent.fire();return V;}}}},_removeItemFromGroupByIndex:function(Q,O){var P=typeof Q=="number"?Q:0,R=this._getItemGroup(P),T,S,N;if(R){T=R.splice(O,1);S=T[0];if(S){this._updateItemProperties(P);if(R.length===0){N=this._aListElements[P];if(this.body&&N){this.body.removeChild(N);}this._aItemGroups.splice(P,1);this._aListElements.splice(P,1);N=this._aListElements[0];if(N){C.addClass(N,"first-of-type");}}this.itemRemovedEvent.fire(S);this.changeContentEvent.fire();return S;}}},_removeItemFromGroupByValue:function(P,N){var R=this._getItemGroup(P),S,Q,O;if(R){S=R.length;Q=-1;if(S>0){O=S-1;do{if(R[O]==N){Q=O;break;}}while(O--);if(Q>-1){return(this._removeItemFromGroupByIndex(P,Q));}}}},_updateItemProperties:function(O){var P=this._getItemGroup(O),S=P.length,R,Q,N;if(S>0){N=S-1;do{R=P[N];if(R){Q=R.element;R.index=N;R.groupIndex=O;Q.setAttribute("groupindex",O);Q.setAttribute("index",N);C.removeClass(Q,"first-of-type");}}while(N--);if(Q){C.addClass(Q,"first-of-type");}}},_createItemGroup:function(O){var N;if(!this._aItemGroups[O]){this._aItemGroups[O]=[];N=document.createElement("ul");this._aListElements[O]=N;return this._aItemGroups[O];}},_getItemGroup:function(O){var N=((typeof O=="number")?O:0);return this._aItemGroups[N];},_configureSubmenu:function(N){var O=N.cfg.getProperty("submenu");if(O){this.cfg.configChangedEvent.subscribe(this._onParentMenuConfigChange,O,true);this.renderEvent.subscribe(this._onParentMenuRender,O,true);O.beforeShowEvent.subscribe(this._onSubmenuBeforeShow);}},_subscribeToItemEvents:function(N){N.focusEvent.subscribe(this._onMenuItemFocus);N.blurEvent.subscribe(this._onMenuItemBlur);N.destroyEvent.subscribe(this._onMenuItemDestroy,N,this);N.cfg.configChangedEvent.subscribe(this._onMenuItemConfigChange,N,this);},_onVisibleChange:function(P,O){var N=O[0];if(N){C.addClass(this.element,"visible");}else{C.removeClass(this.element,"visible");}},_cancelHideDelay:function(){var N=this.getRoot();if(N._nHideDelayId){window.clearTimeout(N._nHideDelayId);}},_execHideDelay:function(){this._cancelHideDelay();var O=this.getRoot(),P=this;function N(){if(O.activeItem){O.clearActiveItem();}if(O==P&&!(P instanceof YAHOO.widget.MenuBar)&&P.cfg.getProperty("position")=="dynamic"){P.hide(); -}}O._nHideDelayId=window.setTimeout(N,O.cfg.getProperty("hidedelay"));},_cancelShowDelay:function(){var N=this.getRoot();if(N._nShowDelayId){window.clearTimeout(N._nShowDelayId);}},_execShowDelay:function(P){var O=this.getRoot();function N(){if(P.parent.cfg.getProperty("selected")){P.show();}}O._nShowDelayId=window.setTimeout(N,O.cfg.getProperty("showdelay"));},_execSubmenuHideDelay:function(Q,O,N){var P=this;Q._nSubmenuHideDelayId=window.setTimeout(function(){if(P._nCurrentMouseX>(O+10)){Q._nSubmenuHideDelayId=window.setTimeout(function(){Q.hide();},N);}else{Q.hide();}},50);},_disableScrollHeader:function(){if(!this._bHeaderDisabled){C.addClass(this.header,"topscrollbar_disabled");this._bHeaderDisabled=true;}},_disableScrollFooter:function(){if(!this._bFooterDisabled){C.addClass(this.footer,"bottomscrollbar_disabled");this._bFooterDisabled=true;}},_enableScrollHeader:function(){if(this._bHeaderDisabled){C.removeClass(this.header,"topscrollbar_disabled");this._bHeaderDisabled=false;}},_enableScrollFooter:function(){if(this._bFooterDisabled){C.removeClass(this.footer,"bottomscrollbar_disabled");this._bFooterDisabled=false;}},_onMouseOver:function(W,R){if(this._bStopMouseEventHandlers){return false;}var X=R[0],V=R[1],N=M.getTarget(X),O,Q,U,P,T,S;if(!this._bHandledMouseOverEvent&&(N==this.element||C.isAncestor(this.element,N))){this._nCurrentMouseX=0;M.on(this.element,"mousemove",this._onMouseMove,this,true);if(!C.isAncestor(V.element,M.getRelatedTarget(X))){this.clearActiveItem();}if(this.parent&&this._nSubmenuHideDelayId){window.clearTimeout(this._nSubmenuHideDelayId);this.parent.cfg.setProperty("selected",true);O=this.parent.parent;O._bHandledMouseOutEvent=true;O._bHandledMouseOverEvent=false;}this._bHandledMouseOverEvent=true;this._bHandledMouseOutEvent=false;}if(V&&!V.handledMouseOverEvent&&!V.cfg.getProperty("disabled")&&(N==V.element||C.isAncestor(V.element,N))){Q=this.cfg.getProperty("showdelay");U=(Q>0);if(U){this._cancelShowDelay();}P=this.activeItem;if(P){P.cfg.setProperty("selected",false);}T=V.cfg;T.setProperty("selected",true);if(this.hasFocus()){V.focus();}if(this.cfg.getProperty("autosubmenudisplay")){S=T.getProperty("submenu");if(S){if(U){this._execShowDelay(S);}else{S.show();}}}V.handledMouseOverEvent=true;V.handledMouseOutEvent=false;}},_onMouseOut:function(V,P){if(this._bStopMouseEventHandlers){return false;}var W=P[0],T=P[1],Q=M.getRelatedTarget(W),U=false,S,R,N,O;if(T&&!T.cfg.getProperty("disabled")){S=T.cfg;R=S.getProperty("submenu");if(R&&(Q==R.element||C.isAncestor(R.element,Q))){U=true;}if(!T.handledMouseOutEvent&&((Q!=T.element&&!C.isAncestor(T.element,Q))||U)){if(!U){T.cfg.setProperty("selected",false);if(R){N=this.cfg.getProperty("submenuhidedelay");O=this.cfg.getProperty("showdelay");if(!(this instanceof YAHOO.widget.MenuBar)&&N>0&&O>=N){this._execSubmenuHideDelay(R,M.getPageX(W),N);}else{R.hide();}}}T.handledMouseOutEvent=true;T.handledMouseOverEvent=false;}}if(!this._bHandledMouseOutEvent&&((Q!=this.element&&!C.isAncestor(this.element,Q))||U)){M.removeListener(this.element,"mousemove",this._onMouseMove);this._nCurrentMouseX=M.getPageX(W);this._bHandledMouseOutEvent=true;this._bHandledMouseOverEvent=false;}},_onMouseMove:function(O,N){if(this._bStopMouseEventHandlers){return false;}this._nCurrentMouseX=M.getPageX(O);},_onClick:function(Y,Q){var W=YAHOO.util.Event,P=YAHOO.util.Dom,Z=Q[0],T=Q[1],R,V=false,O,N,S,U,X;if(T){if(T.cfg.getProperty("disabled")){W.preventDefault(Z);}else{R=T.cfg.getProperty("submenu");S=T.cfg.getProperty("url");if(S){U=S.indexOf("#");X=S.length;if(U!=-1){S=S.substr(U,X);X=S.length;if(X>1){N=S.substr(1,X);V=P.isAncestor(this.element,N);}else{if(X===1){V=true;}}}}if(V&&!T.cfg.getProperty("target")){W.preventDefault(Z);T.focus();}if(!R){O=this.getRoot();if(O instanceof YAHOO.widget.MenuBar||O.cfg.getProperty("position")=="static"){O.clearActiveItem();}else{O.hide();}}}}},_onKeyDown:function(b,V){var Y=V[0],X=V[1],f=this,U,Z,O,S,c,N,e,R,a,Q,W,d,T;function P(){f._bStopMouseEventHandlers=true;window.setTimeout(function(){f._bStopMouseEventHandlers=false;},10);}if(X&&!X.cfg.getProperty("disabled")){Z=X.cfg;O=this.parent;switch(Y.keyCode){case 38:case 40:c=(Y.keyCode==38)?X.getPreviousEnabledSibling():X.getNextEnabledSibling();if(c){this.clearActiveItem();c.cfg.setProperty("selected",true);c.focus();if(this.cfg.getProperty("maxheight")>0){N=this.body;e=N.scrollTop;R=N.offsetHeight;a=this.getItems();Q=a.length-1;W=c.element.offsetTop;if(Y.keyCode==40){if(W>=(R+e)){N.scrollTop=W-R;}else{if(W<=e){N.scrollTop=0;}}if(c==a[Q]){N.scrollTop=c.element.offsetTop;}}else{if(W<=e){N.scrollTop=W-c.element.offsetHeight;}else{if(W>=(e+R)){N.scrollTop=W;}}if(c==a[0]){N.scrollTop=0;}}e=N.scrollTop;d=N.scrollHeight-N.offsetHeight;if(e===0){this._disableScrollHeader();this._enableScrollFooter();}else{if(e==d){this._enableScrollHeader();this._disableScrollFooter();}else{this._enableScrollHeader();this._enableScrollFooter();}}}}M.preventDefault(Y);P();break;case 39:U=Z.getProperty("submenu");if(U){if(!Z.getProperty("selected")){Z.setProperty("selected",true);}U.show();U.setInitialFocus();U.setInitialSelection();}else{S=this.getRoot();if(S instanceof YAHOO.widget.MenuBar){c=S.activeItem.getNextEnabledSibling();if(c){S.clearActiveItem();c.cfg.setProperty("selected",true);U=c.cfg.getProperty("submenu");if(U){U.show();}c.focus();}}}M.preventDefault(Y);P();break;case 37:if(O){T=O.parent;if(T instanceof YAHOO.widget.MenuBar){c=T.activeItem.getPreviousEnabledSibling();if(c){T.clearActiveItem();c.cfg.setProperty("selected",true);U=c.cfg.getProperty("submenu");if(U){U.show();}c.focus();}}else{this.hide();O.focus();}}M.preventDefault(Y);P();break;}}if(Y.keyCode==27){if(this.cfg.getProperty("position")=="dynamic"){this.hide();if(this.parent){this.parent.focus();}}else{if(this.activeItem){U=this.activeItem.cfg.getProperty("submenu");if(U&&U.cfg.getProperty("visible")){U.hide();this.activeItem.focus();}else{this.activeItem.blur();this.activeItem.cfg.setProperty("selected",false); -}}}M.preventDefault(Y);}},_onKeyPress:function(P,O){var N=O[0];if(N.keyCode==40||N.keyCode==38){M.preventDefault(N);}},_onYChange:function(O,N){var Q=this.parent,S,P,R;if(Q){S=Q.parent.body.scrollTop;if(S>0){R=(this.cfg.getProperty("y")-S);C.setY(this.element,R);P=this.iframe;if(P){C.setY(P,R);}this.cfg.setProperty("y",R,true);}}},_onScrollTargetMouseOver:function(T,W){this._cancelHideDelay();var P=M.getTarget(T),R=this.body,V=this,Q=this.cfg.getProperty("scrollincrement"),N,O;function U(){var X=R.scrollTop;if(X0){R.scrollTop=(X-Q);V._enableScrollFooter();}else{R.scrollTop=0;window.clearInterval(V._nBodyScrollId);V._disableScrollHeader();}}if(C.hasClass(P,"hd")){O=S;}else{N=R.scrollHeight-R.offsetHeight;O=U;}this._nBodyScrollId=window.setInterval(O,10);},_onScrollTargetMouseOut:function(O,N){window.clearInterval(this._nBodyScrollId);this._cancelHideDelay();},_onInit:function(O,N){this.cfg.subscribeToConfigEvent("visible",this._onVisibleChange);var P=!this.parent,Q=this.lazyLoad;if(((P&&!Q)||(P&&(this.cfg.getProperty("visible")||this.cfg.getProperty("position")=="static"))||(!P&&!Q))&&this.getItemGroups().length===0){if(this.srcElement){this._initSubTree();}if(this.itemData){this.addItems(this.itemData);}}else{if(Q){this.cfg.fireQueue();}}},_onBeforeRender:function(Q,P){var R=this.element,U=this._aListElements.length,O=true,T=0,N,S;if(U>0){do{N=this._aListElements[T];if(N){if(O){C.addClass(N,"first-of-type");O=false;}if(!C.isAncestor(R,N)){this.appendToBody(N);}S=this._aGroupTitleElements[T];if(S){if(!C.isAncestor(R,S)){N.parentNode.insertBefore(S,N);}C.addClass(N,"hastitle");}}T++;}while(T=S){P=(S-(B.VIEWPORT_OFFSET*2));if(Pi){if(X&&((V-X.offsetWidth)>c)){if(j&&j.parent instanceof YAHOO.widget.MenuBar){V=(V-(c-X.offsetWidth));}else{V=(V-(X.offsetWidth+c));}}else{V=N;}}}}if(RO){if(X&&(U>R)){U=((U+X.offsetHeight)-R);}else{U=O;}}}}S.setProperty("x",V,true);S.setProperty("y",U,true);S.setProperty("xy",[V,U],true);},configVisible:function(P,O,Q){var N,R;if(this.cfg.getProperty("position")=="dynamic"){F.superclass.configVisible.call(this,P,O,Q);}else{N=O[0];R=C.getStyle(this.element,"display");C.setStyle(this.element,"visibility","visible");if(N){if(R!="block"){this.beforeShowEvent.fire();C.setStyle(this.element,"display","block");this.showEvent.fire();}}else{if(R=="block"){this.beforeHideEvent.fire();C.setStyle(this.element,"display","none");this.hideEvent.fire();}}}},configPosition:function(P,O,S){var R=this.element,Q=O[0]=="static"?"static":"absolute",T=this.cfg,N;C.setStyle(R,"position",Q);if(Q=="static"){C.setStyle(R,"display","block");T.setProperty("visible",true);}else{C.setStyle(R,"visibility","hidden");}if(Q=="absolute"){N=T.getProperty("zindex");if(!N||N===0){N=this.parent?(this.parent.parent.cfg.getProperty("zindex")+1):1;T.setProperty("zindex",N);}}},configIframe:function(O,N,P){if(this.cfg.getProperty("position")=="dynamic"){F.superclass.configIframe.call(this,O,N,P);}},configHideDelay:function(O,N,R){var T=N[0],S=this.mouseOutEvent,P=this.mouseOverEvent,Q=this.keyDownEvent;if(T>0){if(!this._bHideDelayEventHandlersAssigned){S.subscribe(this._execHideDelay);P.subscribe(this._cancelHideDelay);Q.subscribe(this._cancelHideDelay);this._bHideDelayEventHandlersAssigned=true;}}else{S.unsubscribe(this._execHideDelay);P.unsubscribe(this._cancelHideDelay);Q.unsubscribe(this._cancelHideDelay);this._bHideDelayEventHandlersAssigned=false;}},configContainer:function(O,N,Q){var P=N[0];if(typeof P=="string"){this.cfg.setProperty("container",document.getElementById(P),true);}},_setMaxHeight:function(O,N,P){this.cfg.setProperty("maxheight",P);this.renderEvent.unsubscribe(this._setMaxHeight);},configMaxHeight:function(a,U,X){var T=U[0],Q=this.element,R=this.body,Y=this.header,O=this.footer,W=this._onScrollTargetMouseOver,b=this._onScrollTargetMouseOut,N=this.cfg.getProperty("minscrollheight"),V,S,P;if(T!==0&&T0){this.renderEvent.subscribe(this._setMaxHeight,T,this);}return ;}C.setStyle(R,"height","");C.removeClass(R,"yui-menu-body-scrolled");var Z=((H.gecko&&this.parent&&this.parent.parent&&this.parent.parent.cfg.getProperty("position")=="dynamic")||H.ie);if(Z){if(!this.cfg.getProperty("width")){S=Q.offsetWidth;Q.style.width=S+"px";P=(S-(Q.offsetWidth-S))+"px";this.cfg.setProperty("width",P);}}if(!Y&&!O){this.setHeader(" ");this.setFooter(" ");Y=this.header;O=this.footer;C.addClass(Y,"topscrollbar");C.addClass(O,"bottomscrollbar");Q.insertBefore(Y,R);Q.appendChild(O);}V=(T-(Y.offsetHeight+Y.offsetHeight));if(V>0&&(R.offsetHeight>T)){C.addClass(R,"yui-menu-body-scrolled");C.setStyle(R,"height",(V+"px"));M.on(Y,"mouseover",W,this,true);M.on(Y,"mouseout",b,this,true);M.on(O,"mouseover",W,this,true);M.on(O,"mouseout",b,this,true);this._disableScrollHeader();this._enableScrollFooter();}else{if(Y&&O){if(Z){this.cfg.setProperty("width","");}this._enableScrollHeader();this._enableScrollFooter();M.removeListener(Y,"mouseover",W);M.removeListener(Y,"mouseout",b);M.removeListener(O,"mouseover",W);M.removeListener(O,"mouseout",b);Q.removeChild(Y);Q.removeChild(O);this.header=null;this.footer=null;}}this.cfg.refireEvent("iframe");},configClassName:function(P,O,Q){var N=O[0];if(this._sClassName){C.removeClass(this.element,this._sClassName);}C.addClass(this.element,N);this._sClassName=N;},_onItemAdded:function(O,N){var P=N[0];if(P){P.cfg.setProperty("disabled",true);}},configDisabled:function(P,O,S){var R=O[0],N=this.getItems(),T,Q;if(E.isArray(N)){T=N.length;if(T>0){Q=T-1;do{N[Q].cfg.setProperty("disabled",R);}while(Q--);}if(R){this.clearActiveItem(true);C.addClass(this.element,"disabled");this.itemAddedEvent.subscribe(this._onItemAdded);}else{C.removeClass(this.element,"disabled");this.itemAddedEvent.unsubscribe(this._onItemAdded);}}},onRender:function(R,Q){function S(){var W=this.element,V=this._shadow;if(V&&W){V.style.width=(W.offsetWidth+6)+"px";V.style.height=(W.offsetHeight+1)+"px";}}function U(){this.element.appendChild(this._shadow);}function O(){C.addClass(this._shadow,"yui-menu-shadow-visible");}function N(){C.removeClass(this._shadow,"yui-menu-shadow-visible");}function T(){var W=this._shadow,V,X;if(!W){V=this.element;X=this;if(!G){G=document.createElement("div");G.className="yui-menu-shadow yui-menu-shadow-visible";}W=G.cloneNode(false);V.appendChild(W);this._shadow=W;this.beforeShowEvent.subscribe(O);this.beforeHideEvent.subscribe(N);if(H.ie){window.setTimeout(function(){S.call(X);X.syncIframe();},0);this.cfg.subscribeToConfigEvent("width",S);this.cfg.subscribeToConfigEvent("height",S);this.cfg.subscribeToConfigEvent("maxheight",S);this.changeContentEvent.subscribe(S);D.textResizeEvent.subscribe(S,X,true);this.destroyEvent.subscribe(function(){D.textResizeEvent.unsubscribe(S,X);});}this.cfg.subscribeToConfigEvent("maxheight",U);}}function P(){T.call(this);this.beforeShowEvent.unsubscribe(P);}if(this.cfg.getProperty("position")=="dynamic"){if(this.cfg.getProperty("visible")){T.call(this);}else{this.beforeShowEvent.subscribe(P);}}},initEvents:function(){F.superclass.initEvents.call(this);var N=L.LIST;this.mouseOverEvent=this.createEvent(A.MOUSE_OVER);this.mouseOverEvent.signature=N;this.mouseOutEvent=this.createEvent(A.MOUSE_OUT);this.mouseOutEvent.signature=N;this.mouseDownEvent=this.createEvent(A.MOUSE_DOWN);this.mouseDownEvent.signature=N;this.mouseUpEvent=this.createEvent(A.MOUSE_UP);this.mouseUpEvent.signature=N;this.clickEvent=this.createEvent(A.CLICK);this.clickEvent.signature=N; -this.keyPressEvent=this.createEvent(A.KEY_PRESS);this.keyPressEvent.signature=N;this.keyDownEvent=this.createEvent(A.KEY_DOWN);this.keyDownEvent.signature=N;this.keyUpEvent=this.createEvent(A.KEY_UP);this.keyUpEvent.signature=N;this.focusEvent=this.createEvent(A.FOCUS);this.focusEvent.signature=N;this.blurEvent=this.createEvent(A.BLUR);this.blurEvent.signature=N;this.itemAddedEvent=this.createEvent(A.ITEM_ADDED);this.itemAddedEvent.signature=N;this.itemRemovedEvent=this.createEvent(A.ITEM_REMOVED);this.itemRemovedEvent.signature=N;},positionOffScreen:function(){var O=this.iframe,N=this.OFF_SCREEN_POSITION;C.setXY(this.element,N);if(O){C.setXY(O,N);}},getRoot:function(){var O=this.parent,N;if(O){N=O.parent;return N?N.getRoot():this;}else{return this;}},toString:function(){var O="Menu",N=this.id;if(N){O+=(" "+N);}return O;},setItemGroupTitle:function(S,R){var Q,P,O,N;if(typeof S=="string"&&S.length>0){Q=typeof R=="number"?R:0;P=this._aGroupTitleElements[Q];if(P){P.innerHTML=S;}else{P=document.createElement(this.GROUP_TITLE_TAG_NAME);P.innerHTML=S;this._aGroupTitleElements[Q]=P;}O=this._aGroupTitleElements.length-1;do{if(this._aGroupTitleElements[O]){C.removeClass(this._aGroupTitleElements[O],"first-of-type");N=O;}}while(O--);if(N!==null){C.addClass(this._aGroupTitleElements[N],"first-of-type");}this.changeContentEvent.fire();}},addItem:function(N,O){if(N){return this._addItemToGroup(O,N);}},addItems:function(Q,P){var S,N,R,O;if(E.isArray(Q)){S=Q.length;N=[];for(O=0;O0){N=[];for(Q=0;Q0){S=O-1;do{U=R[S];if(U){T=U.cfg.getProperty("submenu");if(T){this.cfg.configChangedEvent.unsubscribe(this._onParentMenuConfigChange,T);this.renderEvent.unsubscribe(this._onParentMenuRender,T);}this.removeItem(U);}}while(S--);}if(V){M.purgeElement(V);P.removeChild(V);}if(N){M.purgeElement(N);P.removeChild(N);}if(Q){M.purgeElement(Q);Q.innerHTML="";}this.activeItem=null;this._aItemGroups=[];this._aListElements=[];this._aGroupTitleElements=[];this.cfg.setProperty("width",null);},destroy:function(){this.clearContent();this._aItemGroups=null;this._aListElements=null;this._aGroupTitleElements=null;F.superclass.destroy.call(this);},setInitialFocus:function(){var N=this._getFirstEnabledItem();if(N){N.focus();}},setInitialSelection:function(){var N=this._getFirstEnabledItem();if(N){N.cfg.setProperty("selected",true);}},clearActiveItem:function(P){if(this.cfg.getProperty("showdelay")>0){this._cancelShowDelay();}var N=this.activeItem,Q,O;if(N){Q=N.cfg;if(P){N.blur();}Q.setProperty("selected",false);O=Q.getProperty("submenu");if(O){O.hide();}this.activeItem=null;}},focus:function(){if(!this.hasFocus()){this.setInitialFocus();}},blur:function(){var N;if(this.hasFocus()){N=K.getFocusedMenuItem();if(N){N.blur();}}},hasFocus:function(){return(K.getFocusedMenu()==this.getRoot());},subscribe:function(){function Q(V,U,X){var Y=U[0],W=Y.cfg.getProperty("submenu");if(W){W.subscribe.apply(W,X);}}function T(V,U,X){var W=this.cfg.getProperty("submenu");if(W){W.subscribe.apply(W,X);}}F.superclass.subscribe.apply(this,arguments);F.superclass.subscribe.call(this,"itemAdded",Q,arguments);var N=this.getItems(),S,R,O,P;if(N){S=N.length;if(S>0){P=S-1;do{R=N[P];O=R.cfg.getProperty("submenu");if(O){O.subscribe.apply(O,arguments);}else{R.cfg.subscribeToConfigEvent("submenu",T,arguments);}}while(P--);}}},initDefaultConfig:function(){F.superclass.initDefaultConfig.call(this);var N=this.cfg;N.addProperty(J.VISIBLE.key,{handler:this.configVisible,value:J.VISIBLE.value,validator:J.VISIBLE.validator});N.addProperty(J.CONSTRAIN_TO_VIEWPORT.key,{handler:this.configConstrainToViewport,value:J.CONSTRAIN_TO_VIEWPORT.value,validator:J.CONSTRAIN_TO_VIEWPORT.validator,supercedes:J.CONSTRAIN_TO_VIEWPORT.supercedes});N.addProperty(J.POSITION.key,{handler:this.configPosition,value:J.POSITION.value,validator:J.POSITION.validator,supercedes:J.POSITION.supercedes});N.addProperty(J.SUBMENU_ALIGNMENT.key,{value:J.SUBMENU_ALIGNMENT.value,suppressEvent:J.SUBMENU_ALIGNMENT.suppressEvent});N.addProperty(J.AUTO_SUBMENU_DISPLAY.key,{value:J.AUTO_SUBMENU_DISPLAY.value,validator:J.AUTO_SUBMENU_DISPLAY.validator,suppressEvent:J.AUTO_SUBMENU_DISPLAY.suppressEvent});N.addProperty(J.SHOW_DELAY.key,{value:J.SHOW_DELAY.value,validator:J.SHOW_DELAY.validator,suppressEvent:J.SHOW_DELAY.suppressEvent});N.addProperty(J.HIDE_DELAY.key,{handler:this.configHideDelay,value:J.HIDE_DELAY.value,validator:J.HIDE_DELAY.validator,suppressEvent:J.HIDE_DELAY.suppressEvent});N.addProperty(J.SUBMENU_HIDE_DELAY.key,{value:J.SUBMENU_HIDE_DELAY.value,validator:J.SUBMENU_HIDE_DELAY.validator,suppressEvent:J.SUBMENU_HIDE_DELAY.suppressEvent});N.addProperty(J.CLICK_TO_HIDE.key,{value:J.CLICK_TO_HIDE.value,validator:J.CLICK_TO_HIDE.validator,suppressEvent:J.CLICK_TO_HIDE.suppressEvent});N.addProperty(J.CONTAINER.key,{handler:this.configContainer,value:document.body,suppressEvent:J.CONTAINER.suppressEvent});N.addProperty(J.SCROLL_INCREMENT.key,{value:J.SCROLL_INCREMENT.value,validator:J.SCROLL_INCREMENT.validator,supercedes:J.SCROLL_INCREMENT.supercedes,suppressEvent:J.SCROLL_INCREMENT.suppressEvent}); -N.addProperty(J.MIN_SCROLL_HEIGHT.key,{value:J.MIN_SCROLL_HEIGHT.value,validator:J.MIN_SCROLL_HEIGHT.validator,supercedes:J.MIN_SCROLL_HEIGHT.supercedes,suppressEvent:J.MIN_SCROLL_HEIGHT.suppressEvent});N.addProperty(J.MAX_HEIGHT.key,{handler:this.configMaxHeight,value:J.MAX_HEIGHT.value,validator:J.MAX_HEIGHT.validator,suppressEvent:J.MAX_HEIGHT.suppressEvent,supercedes:J.MAX_HEIGHT.supercedes});N.addProperty(J.CLASS_NAME.key,{handler:this.configClassName,value:J.CLASS_NAME.value,validator:J.CLASS_NAME.validator,supercedes:J.CLASS_NAME.supercedes});N.addProperty(J.DISABLED.key,{handler:this.configDisabled,value:J.DISABLED.value,validator:J.DISABLED.validator,suppressEvent:J.DISABLED.suppressEvent});}});})();(function(){YAHOO.widget.MenuItem=function(K,J){if(K){if(J){this.parent=J.parent;this.value=J.value;this.id=J.id;}this.init(K,J);}};var B=YAHOO.util.Dom,C=YAHOO.widget.Module,E=YAHOO.widget.Menu,H=YAHOO.widget.MenuItem,I=YAHOO.util.CustomEvent,F=YAHOO.lang,D,A={"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"},G={"TEXT":{key:"text",value:"",validator:F.isString,suppressEvent:true},"HELP_TEXT":{key:"helptext",supercedes:["text"],suppressEvent:true},"URL":{key:"url",value:"#",suppressEvent:true},"TARGET":{key:"target",suppressEvent:true},"EMPHASIS":{key:"emphasis",value:false,validator:F.isBoolean,suppressEvent:true,supercedes:["text"]},"STRONG_EMPHASIS":{key:"strongemphasis",value:false,validator:F.isBoolean,suppressEvent:true,supercedes:["text"]},"CHECKED":{key:"checked",value:false,validator:F.isBoolean,suppressEvent:true,supercedes:["disabled","selected"]},"SUBMENU":{key:"submenu",suppressEvent:true,supercedes:["disabled","selected"]},"DISABLED":{key:"disabled",value:false,validator:F.isBoolean,suppressEvent:true,supercedes:["text","selected"]},"SELECTED":{key:"selected",value:false,validator:F.isBoolean,suppressEvent:true},"ONCLICK":{key:"onclick",suppressEvent:true},"CLASS_NAME":{key:"classname",value:null,validator:F.isString,suppressEvent:true}};H.prototype={CSS_CLASS_NAME:"yuimenuitem",CSS_LABEL_CLASS_NAME:"yuimenuitemlabel",SUBMENU_TYPE:null,_oAnchor:null,_oHelpTextEM:null,_oSubmenu:null,_oOnclickAttributeValue:null,_sClassName:null,constructor:H,index:null,groupIndex:null,parent:null,element:null,srcElement:null,value:null,browser:C.prototype.browser,id:null,destroyEvent:null,mouseOverEvent:null,mouseOutEvent:null,mouseDownEvent:null,mouseUpEvent:null,clickEvent:null,keyPressEvent:null,keyDownEvent:null,keyUpEvent:null,focusEvent:null,blurEvent:null,init:function(J,R){if(!this.SUBMENU_TYPE){this.SUBMENU_TYPE=E;}this.cfg=new YAHOO.util.Config(this);this.initDefaultConfig();var O=I.LIST,N=this.cfg,P="#",Q,K,M,L;if(F.isString(J)){this._createRootNodeStructure();N.queueProperty("text",J);}else{if(J&&J.tagName){switch(J.tagName.toUpperCase()){case"OPTION":this._createRootNodeStructure();N.queueProperty("text",J.text);N.queueProperty("disabled",J.disabled);this.value=J.value;this.srcElement=J;break;case"OPTGROUP":this._createRootNodeStructure();N.queueProperty("text",J.label);N.queueProperty("disabled",J.disabled);this.srcElement=J;this._initSubTree();break;case"LI":Q=B.getFirstChild(J);if(Q){P=Q.getAttribute("href");K=Q.getAttribute("target");M=Q.innerHTML;}this.srcElement=J;this.element=J;this._oAnchor=Q;N.setProperty("text",M,true);N.setProperty("url",P,true);N.setProperty("target",K,true);this._initSubTree();break;}}}if(this.element){L=(this.srcElement||this.element).id;if(!L){L=this.id||B.generateId();this.element.id=L;}this.id=L;B.addClass(this.element,this.CSS_CLASS_NAME);B.addClass(this._oAnchor,this.CSS_LABEL_CLASS_NAME);this.mouseOverEvent=this.createEvent(A.MOUSE_OVER);this.mouseOverEvent.signature=O;this.mouseOutEvent=this.createEvent(A.MOUSE_OUT);this.mouseOutEvent.signature=O;this.mouseDownEvent=this.createEvent(A.MOUSE_DOWN);this.mouseDownEvent.signature=O;this.mouseUpEvent=this.createEvent(A.MOUSE_UP);this.mouseUpEvent.signature=O;this.clickEvent=this.createEvent(A.CLICK);this.clickEvent.signature=O;this.keyPressEvent=this.createEvent(A.KEY_PRESS);this.keyPressEvent.signature=O;this.keyDownEvent=this.createEvent(A.KEY_DOWN);this.keyDownEvent.signature=O;this.keyUpEvent=this.createEvent(A.KEY_UP);this.keyUpEvent.signature=O;this.focusEvent=this.createEvent(A.FOCUS);this.focusEvent.signature=O;this.blurEvent=this.createEvent(A.BLUR);this.blurEvent.signature=O;this.destroyEvent=this.createEvent(A.DESTROY);this.destroyEvent.signature=O;if(R){N.applyConfig(R);}N.fireQueue();}},_createRootNodeStructure:function(){var J,K;if(!D){D=document.createElement("li");D.innerHTML="";}J=D.cloneNode(true);J.className=this.CSS_CLASS_NAME;K=J.firstChild;K.className=this.CSS_LABEL_CLASS_NAME;this.element=J;this._oAnchor=K;},_initSubTree:function(){var P=this.srcElement,L=this.cfg,N,M,K,J,O;if(P.childNodes.length>0){if(this.parent.lazyLoad&&this.parent.srcElement&&this.parent.srcElement.tagName.toUpperCase()=="SELECT"){L.setProperty("submenu",{id:B.generateId(),itemdata:P.childNodes});}else{N=P.firstChild;M=[];do{if(N&&N.tagName){switch(N.tagName.toUpperCase()){case"DIV":L.setProperty("submenu",N);break;case"OPTION":M[M.length]=N;break;}}}while((N=N.nextSibling));K=M.length;if(K>0){J=new this.SUBMENU_TYPE(B.generateId());L.setProperty("submenu",J);for(O=0;O"+J+"";}if(M.getProperty("emphasis")){O="";P="";}if(M.getProperty("strongemphasis")){O="";P="";}Q.innerHTML=(O+K+P+R);}},configHelpText:function(L,K,J){this.cfg.refireEvent("text");},configURL:function(L,K,J){var N=K[0];if(!N){N="#";}var M=this._oAnchor;if(YAHOO.env.ua.opera){M.removeAttribute("href"); -}M.setAttribute("href",N);},configTarget:function(M,L,K){var J=L[0],N=this._oAnchor;if(J&&J.length>0){N.setAttribute("target",J);}else{N.removeAttribute("target");}},configEmphasis:function(L,K,J){var N=K[0],M=this.cfg;if(N&&M.getProperty("strongemphasis")){M.setProperty("strongemphasis",false);}M.refireEvent("text");},configStrongEmphasis:function(M,L,K){var J=L[0],N=this.cfg;if(J&&N.getProperty("emphasis")){N.setProperty("emphasis",false);}N.refireEvent("text");},configChecked:function(S,M,O){var R=M[0],K=this.element,Q=this._oAnchor,N=this.cfg,J="-checked",L=this.CSS_CLASS_NAME+J,P=this.CSS_LABEL_CLASS_NAME+J;if(R){B.addClass(K,L);B.addClass(Q,P);}else{B.removeClass(K,L);B.removeClass(Q,P);}N.refireEvent("text");if(N.getProperty("disabled")){N.refireEvent("disabled");}if(N.getProperty("selected")){N.refireEvent("selected");}},configDisabled:function(X,R,a){var Z=R[0],L=this.cfg,P=L.getProperty("submenu"),O=L.getProperty("checked"),S=this.element,V=this._oAnchor,U="-disabled",W="-checked"+U,Y="-hassubmenu"+U,M=this.CSS_CLASS_NAME+U,N=this.CSS_LABEL_CLASS_NAME+U,T=this.CSS_CLASS_NAME+W,Q=this.CSS_LABEL_CLASS_NAME+W,K=this.CSS_CLASS_NAME+Y,J=this.CSS_LABEL_CLASS_NAME+Y;if(Z){if(L.getProperty("selected")){L.setProperty("selected",false);}B.addClass(S,M);B.addClass(V,N);if(P){B.addClass(S,K);B.addClass(V,J);}if(O){B.addClass(S,T);B.addClass(V,Q);}}else{B.removeClass(S,M);B.removeClass(V,N);if(P){B.removeClass(S,K);B.removeClass(V,J);}if(O){B.removeClass(S,T);B.removeClass(V,Q);}}},configSelected:function(X,R,a){var L=this.cfg,Y=R[0],S=this.element,V=this._oAnchor,O=L.getProperty("checked"),P=L.getProperty("submenu"),U="-selected",W="-checked"+U,Z="-hassubmenu"+U,M=this.CSS_CLASS_NAME+U,N=this.CSS_LABEL_CLASS_NAME+U,T=this.CSS_CLASS_NAME+W,Q=this.CSS_LABEL_CLASS_NAME+W,K=this.CSS_CLASS_NAME+Z,J=this.CSS_LABEL_CLASS_NAME+Z;if(YAHOO.env.ua.opera){V.blur();}if(Y&&!L.getProperty("disabled")){B.addClass(S,M);B.addClass(V,N);if(P){B.addClass(S,K);B.addClass(V,J);}if(O){B.addClass(S,T);B.addClass(V,Q);}}else{B.removeClass(S,M);B.removeClass(V,N);if(P){B.removeClass(S,K);B.removeClass(V,J);}if(O){B.removeClass(S,T);B.removeClass(V,Q);}}if(this.hasFocus()&&YAHOO.env.ua.opera){V.focus();}},_onSubmenuBeforeHide:function(M,L){var N=this.parent,J;function K(){N._oAnchor.blur();J.beforeHideEvent.unsubscribe(K);}if(N.hasFocus()){J=N.parent;J.beforeHideEvent.subscribe(K);}},configSubmenu:function(V,O,R){var Q=O[0],P=this.cfg,K=this.element,T=this._oAnchor,N=this.parent&&this.parent.lazyLoad,J="-hassubmenu",L=this.CSS_CLASS_NAME+J,S=this.CSS_LABEL_CLASS_NAME+J,U,W,M;if(Q){if(Q instanceof E){U=Q;U.parent=this;U.lazyLoad=N;}else{if(typeof Q=="object"&&Q.id&&!Q.nodeType){W=Q.id;M=Q;M.lazyload=N;M.parent=this;U=new this.SUBMENU_TYPE(W,M);P.setProperty("submenu",U,true);}else{U=new this.SUBMENU_TYPE(Q,{lazyload:N,parent:this});P.setProperty("submenu",U,true);}}if(U){B.addClass(K,L);B.addClass(T,S);this._oSubmenu=U;if(YAHOO.env.ua.opera){U.beforeHideEvent.subscribe(this._onSubmenuBeforeHide);}}}else{B.removeClass(K,L);B.removeClass(T,S);if(this._oSubmenu){this._oSubmenu.destroy();}}if(P.getProperty("disabled")){P.refireEvent("disabled");}if(P.getProperty("selected")){P.refireEvent("selected");}},configOnClick:function(L,K,J){var M=K[0];if(this._oOnclickAttributeValue&&(this._oOnclickAttributeValue!=M)){this.clickEvent.unsubscribe(this._oOnclickAttributeValue.fn,this._oOnclickAttributeValue.obj);this._oOnclickAttributeValue=null;}if(!this._oOnclickAttributeValue&&typeof M=="object"&&typeof M.fn=="function"){this.clickEvent.subscribe(M.fn,((!YAHOO.lang.isUndefined(M.obj))?M.obj:this),M.scope);this._oOnclickAttributeValue=M;}},configClassName:function(M,L,K){var J=L[0];if(this._sClassName){B.removeClass(this.element,this._sClassName);}B.addClass(this.element,J);this._sClassName=J;},initDefaultConfig:function(){var J=this.cfg;J.addProperty(G.TEXT.key,{handler:this.configText,value:G.TEXT.value,validator:G.TEXT.validator,suppressEvent:G.TEXT.suppressEvent});J.addProperty(G.HELP_TEXT.key,{handler:this.configHelpText,supercedes:G.HELP_TEXT.supercedes,suppressEvent:G.HELP_TEXT.suppressEvent});J.addProperty(G.URL.key,{handler:this.configURL,value:G.URL.value,suppressEvent:G.URL.suppressEvent});J.addProperty(G.TARGET.key,{handler:this.configTarget,suppressEvent:G.TARGET.suppressEvent});J.addProperty(G.EMPHASIS.key,{handler:this.configEmphasis,value:G.EMPHASIS.value,validator:G.EMPHASIS.validator,suppressEvent:G.EMPHASIS.suppressEvent,supercedes:G.EMPHASIS.supercedes});J.addProperty(G.STRONG_EMPHASIS.key,{handler:this.configStrongEmphasis,value:G.STRONG_EMPHASIS.value,validator:G.STRONG_EMPHASIS.validator,suppressEvent:G.STRONG_EMPHASIS.suppressEvent,supercedes:G.STRONG_EMPHASIS.supercedes});J.addProperty(G.CHECKED.key,{handler:this.configChecked,value:G.CHECKED.value,validator:G.CHECKED.validator,suppressEvent:G.CHECKED.suppressEvent,supercedes:G.CHECKED.supercedes});J.addProperty(G.DISABLED.key,{handler:this.configDisabled,value:G.DISABLED.value,validator:G.DISABLED.validator,suppressEvent:G.DISABLED.suppressEvent});J.addProperty(G.SELECTED.key,{handler:this.configSelected,value:G.SELECTED.value,validator:G.SELECTED.validator,suppressEvent:G.SELECTED.suppressEvent});J.addProperty(G.SUBMENU.key,{handler:this.configSubmenu,supercedes:G.SUBMENU.supercedes,suppressEvent:G.SUBMENU.suppressEvent});J.addProperty(G.ONCLICK.key,{handler:this.configOnClick,suppressEvent:G.ONCLICK.suppressEvent});J.addProperty(G.CLASS_NAME.key,{handler:this.configClassName,value:G.CLASS_NAME.value,validator:G.CLASS_NAME.validator,suppressEvent:G.CLASS_NAME.suppressEvent});},getNextEnabledSibling:function(){var L,O,J,N,M;function K(P,Q){return P[Q]||K(P,(Q+1));}if(this.parent instanceof E){L=this.groupIndex;O=this.parent.getItemGroups();if(this.index<(O[L].length-1)){J=K(O[L],(this.index+1));}else{if(L<(O.length-1)){N=L+1;}else{N=0;}M=K(O,N);J=K(M,0);}return(J.cfg.getProperty("disabled")||J.element.style.display=="none")?J.getNextEnabledSibling():J;}},getPreviousEnabledSibling:function(){var N,P,K,J,M; -function O(Q,R){return Q[R]||O(Q,(R-1));}function L(Q,R){return Q[R]?R:L(Q,(R+1));}if(this.parent instanceof E){N=this.groupIndex;P=this.parent.getItemGroups();if(this.index>L(P[N],0)){K=O(P[N],(this.index-1));}else{if(N>L(P,0)){J=N-1;}else{J=P.length-1;}M=O(P,J);K=O(M,(M.length-1));}return(K.cfg.getProperty("disabled")||K.element.style.display=="none")?K.getPreviousEnabledSibling():K;}},focus:function(){var N=this.parent,M=this._oAnchor,J=N.activeItem,L=this;function K(){try{if(YAHOO.env.ua.ie&&!document.hasFocus()){return ;}if(J){J.blurEvent.fire();}M.focus();L.focusEvent.fire();}catch(O){}}if(!this.cfg.getProperty("disabled")&&N&&N.cfg.getProperty("visible")&&this.element.style.display!="none"){window.setTimeout(K,0);}},blur:function(){var K=this.parent;if(!this.cfg.getProperty("disabled")&&K&&K.cfg.getProperty("visible")){var J=this;window.setTimeout(function(){try{J._oAnchor.blur();J.blurEvent.fire();}catch(L){}},0);}},hasFocus:function(){return(YAHOO.widget.MenuManager.getFocusedMenuItem()==this);},destroy:function(){var L=this.element,K,J;if(L){K=this.cfg.getProperty("submenu");if(K){K.destroy();}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();J=L.parentNode;if(J){J.removeChild(L);this.destroyEvent.fire();}this.destroyEvent.unsubscribeAll();}},toString:function(){var K="MenuItem",J=this.id;if(J){K+=(" "+J);}return K;}};F.augmentProto(H,YAHOO.util.EventProvider);})();(function(){YAHOO.widget.ContextMenu=function(G,F){YAHOO.widget.ContextMenu.superclass.constructor.call(this,G,F);};var B=YAHOO.util.Event,E=YAHOO.widget.ContextMenu,D={"TRIGGER_CONTEXT_MENU":"triggerContextMenu","CONTEXT_MENU":(YAHOO.env.ua.opera?"mousedown":"contextmenu"),"CLICK":"click"},C={"TRIGGER":{key:"trigger",suppressEvent:true}};function A(G,F,H){this.cfg.setProperty("xy",H);this.beforeShowEvent.unsubscribe(A,H);}YAHOO.lang.extend(E,YAHOO.widget.Menu,{_oTrigger:null,_bCancelled:false,contextEventTarget:null,triggerContextMenuEvent:null,init:function(G,F){E.superclass.init.call(this,G);this.beforeInitEvent.fire(E);if(F){this.cfg.applyConfig(F,true);}this.initEvent.fire(E);},initEvents:function(){E.superclass.initEvents.call(this);this.triggerContextMenuEvent=this.createEvent(D.TRIGGER_CONTEXT_MENU);this.triggerContextMenuEvent.signature=YAHOO.util.CustomEvent.LIST;},cancel:function(){this._bCancelled=true;},_removeEventHandlers:function(){var F=this._oTrigger;if(F){B.removeListener(F,D.CONTEXT_MENU,this._onTriggerContextMenu);if(YAHOO.env.ua.opera){B.removeListener(F,D.CLICK,this._onTriggerClick);}}},_onTriggerClick:function(G,F){if(G.ctrlKey){B.stopEvent(G);}},_onTriggerContextMenu:function(H,F){if(H.type=="mousedown"&&!H.ctrlKey){return ;}var G;B.stopEvent(H);this.contextEventTarget=B.getTarget(H);this.triggerContextMenuEvent.fire(H);YAHOO.widget.MenuManager.hideVisible();if(!this._bCancelled){G=B.getXY(H);if(!YAHOO.util.Dom.inDocument(this.element)){this.beforeShowEvent.subscribe(A,G);}else{this.cfg.setProperty("xy",G);}this.show();}this._bCancelled=false;},toString:function(){var G="ContextMenu",F=this.id;if(F){G+=(" "+F);}return G;},initDefaultConfig:function(){E.superclass.initDefaultConfig.call(this);this.cfg.addProperty(C.TRIGGER.key,{handler:this.configTrigger,suppressEvent:C.TRIGGER.suppressEvent});},destroy:function(){this._removeEventHandlers();E.superclass.destroy.call(this);},configTrigger:function(G,F,I){var H=F[0];if(H){if(this._oTrigger){this._removeEventHandlers();}this._oTrigger=H;B.on(H,D.CONTEXT_MENU,this._onTriggerContextMenu,this,true);if(YAHOO.env.ua.opera){B.on(H,D.CLICK,this._onTriggerClick,this,true);}}else{this._removeEventHandlers();}}});}());YAHOO.widget.ContextMenuItem=YAHOO.widget.MenuItem;(function(){YAHOO.widget.MenuBar=function(F,E){YAHOO.widget.MenuBar.superclass.constructor.call(this,F,E);};function D(E){if(typeof E=="string"){return("dynamic,static".indexOf((E.toLowerCase()))!=-1);}}var B=YAHOO.util.Event,A=YAHOO.widget.MenuBar,C={"POSITION":{key:"position",value:"static",validator:D,supercedes:["visible"]},"SUBMENU_ALIGNMENT":{key:"submenualignment",value:["tl","bl"],suppressEvent:true},"AUTO_SUBMENU_DISPLAY":{key:"autosubmenudisplay",value:false,validator:YAHOO.lang.isBoolean,suppressEvent:true}};YAHOO.lang.extend(A,YAHOO.widget.Menu,{init:function(F,E){if(!this.ITEM_TYPE){this.ITEM_TYPE=YAHOO.widget.MenuBarItem;}A.superclass.init.call(this,F);this.beforeInitEvent.fire(A);if(E){this.cfg.applyConfig(E,true);}this.initEvent.fire(A);},CSS_CLASS_NAME:"yuimenubar",_onKeyDown:function(G,F,K){var E=F[0],L=F[1],I,J,H;if(L&&!L.cfg.getProperty("disabled")){J=L.cfg;switch(E.keyCode){case 37:case 39:if(L==this.activeItem&&!J.getProperty("selected")){J.setProperty("selected",true);}else{H=(E.keyCode==37)?L.getPreviousEnabledSibling():L.getNextEnabledSibling();if(H){this.clearActiveItem();H.cfg.setProperty("selected",true);if(this.cfg.getProperty("autosubmenudisplay")){I=H.cfg.getProperty("submenu");if(I){I.show();}}H.focus();}}B.preventDefault(E);break;case 40:if(this.activeItem!=L){this.clearActiveItem();J.setProperty("selected",true);L.focus();}I=J.getProperty("submenu");if(I){if(I.cfg.getProperty("visible")){I.setInitialSelection();I.setInitialFocus();}else{I.show();}}B.preventDefault(E);break;}}if(E.keyCode==27&&this.activeItem){I=this.activeItem.cfg.getProperty("submenu");if(I&&I.cfg.getProperty("visible")){I.hide();this.activeItem.focus();}else{this.activeItem.cfg.setProperty("selected",false);this.activeItem.blur();}B.preventDefault(E);}},_onClick:function(L,G,J){A.superclass._onClick.call(this,L,G,J);var K=G[1],M,E,F,H,I;if(K&&!K.cfg.getProperty("disabled")){M=G[0];E=B.getTarget(M);F=this.activeItem;H=this.cfg;if(F&&F!=K){this.clearActiveItem(); -}K.cfg.setProperty("selected",true);I=K.cfg.getProperty("submenu");if(I){if(I.cfg.getProperty("visible")){I.hide();}else{I.show();}}}},toString:function(){var F="MenuBar",E=this.id;if(E){F+=(" "+E);}return F;},initDefaultConfig:function(){A.superclass.initDefaultConfig.call(this);var E=this.cfg;E.addProperty(C.POSITION.key,{handler:this.configPosition,value:C.POSITION.value,validator:C.POSITION.validator,supercedes:C.POSITION.supercedes});E.addProperty(C.SUBMENU_ALIGNMENT.key,{value:C.SUBMENU_ALIGNMENT.value,suppressEvent:C.SUBMENU_ALIGNMENT.suppressEvent});E.addProperty(C.AUTO_SUBMENU_DISPLAY.key,{value:C.AUTO_SUBMENU_DISPLAY.value,validator:C.AUTO_SUBMENU_DISPLAY.validator,suppressEvent:C.AUTO_SUBMENU_DISPLAY.suppressEvent});}});}());YAHOO.widget.MenuBarItem=function(B,A){YAHOO.widget.MenuBarItem.superclass.constructor.call(this,B,A);};YAHOO.lang.extend(YAHOO.widget.MenuBarItem,YAHOO.widget.MenuItem,{init:function(B,A){if(!this.SUBMENU_TYPE){this.SUBMENU_TYPE=YAHOO.widget.Menu;}YAHOO.widget.MenuBarItem.superclass.init.call(this,B);var C=this.cfg;if(A){C.applyConfig(A,true);}C.fireQueue();},CSS_CLASS_NAME:"yuimenubaritem",CSS_LABEL_CLASS_NAME:"yuimenubaritemlabel",toString:function(){var A="MenuBarItem";if(this.cfg&&this.cfg.getProperty("text")){A+=(": "+this.cfg.getProperty("text"));}return A;}});YAHOO.register("menu",YAHOO.widget.Menu,{version:"2.5.0",build:"895"}); \ No newline at end of file diff --git a/lib/yui/menu/menu.js b/lib/yui/menu/menu.js deleted file mode 100755 index 2b6dfda6e8..0000000000 --- a/lib/yui/menu/menu.js +++ /dev/null @@ -1,9041 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ - - -/** -* @module menu -* @description
The Menu family of components features a collection of -* controls that make it easy to add menus to your website or web application. -* With the Menu Controls you can create website fly-out menus, customized -* context menus, or application-style menu bars with just a small amount of -* scripting.
The Menu family of controls features:
-*
-*
Keyboard and mouse navigation.
-*
A rich event model that provides access to all of a menu's -* interesting moments.
-*
Support for -* Progressive -* Enhancement; Menus can be created from simple, -* semantic markup on the page or purely through JavaScript.
-*
-* @title Menu -* @namespace YAHOO.widget -* @requires Event, Dom, Container -*/ -(function () { - - var Dom = YAHOO.util.Dom, - Event = YAHOO.util.Event; - - - /** - * Singleton that manages a collection of all menus and menu items. Listens - * for DOM events at the document level and dispatches the events to the - * corresponding menu or menu item. - * - * @namespace YAHOO.widget - * @class MenuManager - * @static - */ - YAHOO.widget.MenuManager = function () { - - // Private member variables - - - // Flag indicating if the DOM event handlers have been attached - - var m_bInitializedEventHandlers = false, - - - // Collection of menus - - m_oMenus = {}, - - - // Collection of visible menus - - m_oVisibleMenus = {}, - - - // Collection of menu items - - m_oItems = {}, - - - // Map of DOM event types to their equivalent CustomEvent types - - m_oEventTypes = { - "click": "clickEvent", - "mousedown": "mouseDownEvent", - "mouseup": "mouseUpEvent", - "mouseover": "mouseOverEvent", - "mouseout": "mouseOutEvent", - "keydown": "keyDownEvent", - "keyup": "keyUpEvent", - "keypress": "keyPressEvent" - }, - - - m_oFocusedMenuItem = null; - - - - - - // Private methods - - - /** - * @method getMenuRootElement - * @description Finds the root DIV node of a menu or the root LI node of - * a menu item. - * @private - * @param {HTMLElement} p_oElement Object - * specifying an HTML element. - */ - function getMenuRootElement(p_oElement) { - - var oParentNode; - - if (p_oElement && p_oElement.tagName) { - - switch (p_oElement.tagName.toUpperCase()) { - - case "DIV": - - oParentNode = p_oElement.parentNode; - - // Check if the DIV is the inner "body" node of a menu - - if ( - ( - Dom.hasClass(p_oElement, "hd") || - Dom.hasClass(p_oElement, "bd") || - Dom.hasClass(p_oElement, "ft") - ) && - oParentNode && - oParentNode.tagName && - oParentNode.tagName.toUpperCase() == "DIV") - { - - return oParentNode; - - } - else { - - return p_oElement; - - } - - break; - - case "LI": - - return p_oElement; - - default: - - oParentNode = p_oElement.parentNode; - - if (oParentNode) { - - return getMenuRootElement(oParentNode); - - } - - break; - - } - - } - - } - - - - // Private event handlers - - - /** - * @method onDOMEvent - * @description Generic, global event handler for all of a menu's - * DOM-based events. This listens for events against the document - * object. If the target of a given event is a member of a menu or - * menu item's DOM, the instance's corresponding Custom Event is fired. - * @private - * @param {Event} p_oEvent Object representing the DOM event object - * passed back by the event utility (YAHOO.util.Event). - */ - function onDOMEvent(p_oEvent) { - - // Get the target node of the DOM event - - var oTarget = Event.getTarget(p_oEvent), - - // See if the target of the event was a menu, or a menu item - - oElement = getMenuRootElement(oTarget), - sCustomEventType, - sTagName, - sId, - oMenuItem, - oMenu; - - - if (oElement) { - - sTagName = oElement.tagName.toUpperCase(); - - if (sTagName == "LI") { - - sId = oElement.id; - - if (sId && m_oItems[sId]) { - - oMenuItem = m_oItems[sId]; - oMenu = oMenuItem.parent; - - } - - } - else if (sTagName == "DIV") { - - if (oElement.id) { - - oMenu = m_oMenus[oElement.id]; - - } - - } - - } - - - if (oMenu) { - - sCustomEventType = m_oEventTypes[p_oEvent.type]; - - - // Fire the Custom Event that corresponds the current DOM event - - if (oMenuItem && !oMenuItem.cfg.getProperty("disabled")) { - - oMenuItem[sCustomEventType].fire(p_oEvent); - - - if ( - p_oEvent.type == "keyup" || - p_oEvent.type == "mousedown") - { - - if (m_oFocusedMenuItem != oMenuItem) { - - if (m_oFocusedMenuItem) { - - m_oFocusedMenuItem.blurEvent.fire(); - - } - - oMenuItem.focusEvent.fire(); - - } - - } - - } - - oMenu[sCustomEventType].fire(p_oEvent, oMenuItem); - - } - else if (p_oEvent.type == "mousedown") { - - if (m_oFocusedMenuItem) { - - m_oFocusedMenuItem.blurEvent.fire(); - - m_oFocusedMenuItem = null; - - } - - - /* - If the target of the event wasn't a menu, hide all - dynamically positioned menus - */ - - for (var i in m_oVisibleMenus) { - - if (YAHOO.lang.hasOwnProperty(m_oVisibleMenus, i)) { - - oMenu = m_oVisibleMenus[i]; - - if (oMenu.cfg.getProperty("clicktohide") && - !(oMenu instanceof YAHOO.widget.MenuBar) && - oMenu.cfg.getProperty("position") == "dynamic") { - - oMenu.hide(); - - } - else { - - oMenu.clearActiveItem(true); - - } - - } - - } - - } - else if (p_oEvent.type == "keyup") { - - if (m_oFocusedMenuItem) { - - m_oFocusedMenuItem.blurEvent.fire(); - - m_oFocusedMenuItem = null; - - } - - } - - } - - - /** - * @method onMenuDestroy - * @description "destroy" event handler for a menu. - * @private - * @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.Menu} p_oMenu The menu that fired the event. - */ - function onMenuDestroy(p_sType, p_aArgs, p_oMenu) { - - if (m_oMenus[p_oMenu.id]) { - - this.removeMenu(p_oMenu); - - } - - } - - - /** - * @method onMenuFocus - * @description "focus" event handler for a MenuItem instance. - * @private - * @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. - */ - function onMenuFocus(p_sType, p_aArgs) { - - var oItem = p_aArgs[0]; - - if (oItem) { - - m_oFocusedMenuItem = oItem; - - } - - } - - - /** - * @method onMenuBlur - * @description "blur" event handler for a MenuItem instance. - * @private - * @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. - */ - function onMenuBlur(p_sType, p_aArgs) { - - m_oFocusedMenuItem = null; - - } - - - - /** - * @method onMenuVisibleConfigChange - * @description Event handler for when the "visible" configuration - * property of a Menu instance changes. - * @private - * @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. - */ - function onMenuVisibleConfigChange(p_sType, p_aArgs) { - - var bVisible = p_aArgs[0], - sId = this.id; - - if (bVisible) { - - m_oVisibleMenus[sId] = this; - - - } - else if (m_oVisibleMenus[sId]) { - - delete m_oVisibleMenus[sId]; - - - } - - } - - - /** - * @method onItemDestroy - * @description "destroy" event handler for a MenuItem instance. - * @private - * @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. - */ - function onItemDestroy(p_sType, p_aArgs) { - - removeItem(this); - - } - - - function removeItem(p_oMenuItem) { - - var sId = p_oMenuItem.id; - - if (sId && m_oItems[sId]) { - - if (m_oFocusedMenuItem == p_oMenuItem) { - - m_oFocusedMenuItem = null; - - } - - delete m_oItems[sId]; - - p_oMenuItem.destroyEvent.unsubscribe(onItemDestroy); - - - } - - } - - - /** - * @method onItemAdded - * @description "itemadded" event handler for a Menu instance. - * @private - * @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. - */ - function onItemAdded(p_sType, p_aArgs) { - - var oItem = p_aArgs[0], - sId; - - if (oItem instanceof YAHOO.widget.MenuItem) { - - sId = oItem.id; - - if (!m_oItems[sId]) { - - m_oItems[sId] = oItem; - - oItem.destroyEvent.subscribe(onItemDestroy); - - - } - - } - - } - - - return { - - // Privileged methods - - - /** - * @method addMenu - * @description Adds a menu to the collection of known menus. - * @param {YAHOO.widget.Menu} p_oMenu Object specifying the Menu - * instance to be added. - */ - addMenu: function (p_oMenu) { - - var oDoc; - - if (p_oMenu instanceof YAHOO.widget.Menu && p_oMenu.id && - !m_oMenus[p_oMenu.id]) { - - m_oMenus[p_oMenu.id] = p_oMenu; - - - if (!m_bInitializedEventHandlers) { - - oDoc = document; - - Event.on(oDoc, "mouseover", onDOMEvent, this, true); - Event.on(oDoc, "mouseout", onDOMEvent, this, true); - Event.on(oDoc, "mousedown", onDOMEvent, this, true); - Event.on(oDoc, "mouseup", onDOMEvent, this, true); - Event.on(oDoc, "click", onDOMEvent, this, true); - Event.on(oDoc, "keydown", onDOMEvent, this, true); - Event.on(oDoc, "keyup", onDOMEvent, this, true); - Event.on(oDoc, "keypress", onDOMEvent, this, true); - - - m_bInitializedEventHandlers = true; - - - } - - p_oMenu.cfg.subscribeToConfigEvent("visible", - onMenuVisibleConfigChange); - - p_oMenu.destroyEvent.subscribe(onMenuDestroy, p_oMenu, - this); - - p_oMenu.itemAddedEvent.subscribe(onItemAdded); - p_oMenu.focusEvent.subscribe(onMenuFocus); - p_oMenu.blurEvent.subscribe(onMenuBlur); - - - } - - }, - - - /** - * @method removeMenu - * @description Removes a menu from the collection of known menus. - * @param {YAHOO.widget.Menu} p_oMenu Object specifying the Menu - * instance to be removed. - */ - removeMenu: function (p_oMenu) { - - var sId, - aItems, - i; - - if (p_oMenu) { - - sId = p_oMenu.id; - - if (m_oMenus[sId] == p_oMenu) { - - // Unregister each menu item - - aItems = p_oMenu.getItems(); - - if (aItems && aItems.length > 0) { - - i = aItems.length - 1; - - do { - - removeItem(aItems[i]); - - } - while (i--); - - } - - - // Unregister the menu - - delete m_oMenus[sId]; - - - - /* - Unregister the menu from the collection of - visible menus - */ - - if (m_oVisibleMenus[sId] == p_oMenu) { - - delete m_oVisibleMenus[sId]; - - - } - - - // Unsubscribe event listeners - - if (p_oMenu.cfg) { - - p_oMenu.cfg.unsubscribeFromConfigEvent("visible", - onMenuVisibleConfigChange); - - } - - p_oMenu.destroyEvent.unsubscribe(onMenuDestroy, - p_oMenu); - - p_oMenu.itemAddedEvent.unsubscribe(onItemAdded); - p_oMenu.focusEvent.unsubscribe(onMenuFocus); - p_oMenu.blurEvent.unsubscribe(onMenuBlur); - - } - - } - - }, - - - /** - * @method hideVisible - * @description Hides all visible, dynamically positioned menus - * (excluding instances of YAHOO.widget.MenuBar). - */ - hideVisible: function () { - - var oMenu; - - for (var i in m_oVisibleMenus) { - - if (YAHOO.lang.hasOwnProperty(m_oVisibleMenus, i)) { - - oMenu = m_oVisibleMenus[i]; - - if (!(oMenu instanceof YAHOO.widget.MenuBar) && - oMenu.cfg.getProperty("position") == "dynamic") { - - oMenu.hide(); - - } - - } - - } - - }, - - - /** - * @method getVisible - * @description Returns a collection of all visible menus registered - * with the menu manger. - * @return {Array} - */ - getVisible: function () { - - return m_oVisibleMenus; - - }, - - - /** - * @method getMenus - * @description Returns a collection of all menus registered with the - * menu manger. - * @return {Array} - */ - getMenus: function () { - - return m_oMenus; - - }, - - - /** - * @method getMenu - * @description Returns a menu with the specified id. - * @param {String} p_sId String specifying the id of the - * <div> element representing the menu to - * be retrieved. - * @return {YAHOO.widget.Menu} - */ - getMenu: function (p_sId) { - - var oMenu = m_oMenus[p_sId]; - - if (oMenu) { - - return oMenu; - - } - - }, - - - /** - * @method getMenuItem - * @description Returns a menu item with the specified id. - * @param {String} p_sId String specifying the id of the - * <li> element representing the menu item to - * be retrieved. - * @return {YAHOO.widget.MenuItem} - */ - getMenuItem: function (p_sId) { - - var oItem = m_oItems[p_sId]; - - if (oItem) { - - return oItem; - - } - - }, - - - /** - * @method getMenuItemGroup - * @description Returns an array of menu item instances whose - * corresponding <li> elements are child - * nodes of the <ul> element with the - * specified id. - * @param {String} p_sId String specifying the id of the - * <ul> element representing the group of - * menu items to be retrieved. - * @return {Array} - */ - getMenuItemGroup: function (p_sId) { - - var oUL = Dom.get(p_sId), - aItems, - oNode, - oItem, - sId; - - - if (oUL && oUL.tagName && - oUL.tagName.toUpperCase() == "UL") { - - oNode = oUL.firstChild; - - if (oNode) { - - aItems = []; - - do { - - sId = oNode.id; - - if (sId) { - - oItem = this.getMenuItem(sId); - - if (oItem) { - - aItems[aItems.length] = oItem; - - } - - } - - } - while ((oNode = oNode.nextSibling)); - - - if (aItems.length > 0) { - - return aItems; - - } - - } - - } - - }, - - - /** - * @method getFocusedMenuItem - * @description Returns a reference to the menu item that currently - * has focus. - * @return {YAHOO.widget.MenuItem} - */ - getFocusedMenuItem: function () { - - return m_oFocusedMenuItem; - - }, - - - /** - * @method getFocusedMenu - * @description Returns a reference to the menu that currently - * has focus. - * @return {YAHOO.widget.Menu} - */ - getFocusedMenu: function () { - - if (m_oFocusedMenuItem) { - - return (m_oFocusedMenuItem.parent.getRoot()); - - } - - }, - - - /** - * @method toString - * @description Returns a string representing the menu manager. - * @return {String} - */ - toString: function () { - - return "MenuManager"; - - } - - }; - - }(); - -})(); - - - -(function () { - - -/** -* The Menu class creates a container that holds a vertical list representing -* a set of options or commands. Menu is the base class for all -* menu containers. -* @param {String} p_oElement String specifying the id attribute of the -* <div> element of the menu. -* @param {String} p_oElement String specifying the id attribute of the -* <select> element to be used as the data source -* for the menu. -* @param {HTMLDivElement} p_oElement Object -* specifying the <div> element of the menu. -* @param {HTMLSelectElement} p_oElement -* Object specifying the <select> element to be used as -* the data source for the menu. -* @param {Object} p_oConfig Optional. Object literal specifying the -* configuration for the menu. See configuration class documentation for -* more details. -* @namespace YAHOO.widget -* @class Menu -* @constructor -* @extends YAHOO.widget.Overlay -*/ -YAHOO.widget.Menu = function (p_oElement, p_oConfig) { - - if (p_oConfig) { - - this.parent = p_oConfig.parent; - this.lazyLoad = p_oConfig.lazyLoad || p_oConfig.lazyload; - this.itemData = p_oConfig.itemData || p_oConfig.itemdata; - - } - - - YAHOO.widget.Menu.superclass.constructor.call(this, p_oElement, p_oConfig); - -}; - - - -/** -* @method checkPosition -* @description Checks to make sure that the value of the "position" property -* is one of the supported strings. Returns true if the position is supported. -* @private -* @param {Object} p_sPosition String specifying the position of the menu. -* @return {Boolean} -*/ -function checkPosition(p_sPosition) { - - if (typeof p_sPosition == "string") { - - return ("dynamic,static".indexOf((p_sPosition.toLowerCase())) != -1); - - } - -} - - -var Dom = YAHOO.util.Dom, - Event = YAHOO.util.Event, - Module = YAHOO.widget.Module, - Overlay = YAHOO.widget.Overlay, - Menu = YAHOO.widget.Menu, - MenuManager = YAHOO.widget.MenuManager, - CustomEvent = YAHOO.util.CustomEvent, - Lang = YAHOO.lang, - UA = YAHOO.env.ua, - - m_oShadowTemplate, - - /** - * Constant representing the name of the Menu's events - * @property EVENT_TYPES - * @private - * @final - * @type Object - */ - 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", - "FOCUS": "focus", - "BLUR": "blur", - "ITEM_ADDED": "itemAdded", - "ITEM_REMOVED": "itemRemoved" - - }, - - - /** - * Constant representing the Menu's configuration properties - * @property DEFAULT_CONFIG - * @private - * @final - * @type Object - */ - DEFAULT_CONFIG = { - - "VISIBLE": { - key: "visible", - value: false, - validator: Lang.isBoolean - }, - - "CONSTRAIN_TO_VIEWPORT": { - key: "constraintoviewport", - value: true, - validator: Lang.isBoolean, - supercedes: ["iframe","x","y","xy"] - }, - - "POSITION": { - key: "position", - value: "dynamic", - validator: checkPosition, - supercedes: ["visible", "iframe"] - }, - - "SUBMENU_ALIGNMENT": { - key: "submenualignment", - value: ["tl","tr"], - suppressEvent: true - }, - - "AUTO_SUBMENU_DISPLAY": { - key: "autosubmenudisplay", - value: true, - validator: Lang.isBoolean, - suppressEvent: true - }, - - "SHOW_DELAY": { - key: "showdelay", - value: 250, - validator: Lang.isNumber, - suppressEvent: true - }, - - "HIDE_DELAY": { - key: "hidedelay", - value: 0, - validator: Lang.isNumber, - suppressEvent: true - }, - - "SUBMENU_HIDE_DELAY": { - key: "submenuhidedelay", - value: 250, - validator: Lang.isNumber, - suppressEvent: true - }, - - "CLICK_TO_HIDE": { - key: "clicktohide", - value: true, - validator: Lang.isBoolean, - suppressEvent: true - }, - - "CONTAINER": { - key: "container", - suppressEvent: true - }, - - "SCROLL_INCREMENT": { - key: "scrollincrement", - value: 1, - validator: Lang.isNumber, - supercedes: ["maxheight"], - suppressEvent: true - }, - - "MIN_SCROLL_HEIGHT": { - key: "minscrollheight", - value: 90, - validator: Lang.isNumber, - supercedes: ["maxheight"], - suppressEvent: true - }, - - "MAX_HEIGHT": { - key: "maxheight", - value: 0, - validator: Lang.isNumber, - supercedes: ["iframe"], - suppressEvent: true - }, - - "CLASS_NAME": { - key: "classname", - value: null, - validator: Lang.isString, - suppressEvent: true - }, - - "DISABLED": { - key: "disabled", - value: false, - validator: Lang.isBoolean, - suppressEvent: true - } - - }; - - - -YAHOO.lang.extend(Menu, Overlay, { - - -// Constants - - -/** -* @property CSS_CLASS_NAME -* @description String representing the CSS class(es) to be applied to the -* menu's <div> element. -* @default "yuimenu" -* @final -* @type String -*/ -CSS_CLASS_NAME: "yuimenu", - - -/** -* @property ITEM_TYPE -* @description Object representing the type of menu item to instantiate and -* add when parsing the child nodes (either <li> element, -* <optgroup> element or <option>) -* of the menu's source HTML element. -* @default YAHOO.widget.MenuItem -* @final -* @type YAHOO.widget.MenuItem -*/ -ITEM_TYPE: null, - - -/** -* @property GROUP_TITLE_TAG_NAME -* @description String representing the tagname of the HTML element used to -* title the menu's item groups. -* @default H6 -* @final -* @type String -*/ -GROUP_TITLE_TAG_NAME: "h6", - - -/** -* @property OFF_SCREEN_POSITION -* @description Array representing the default x and y position that a menu -* should have when it is positioned outside the viewport by the -* "poistionOffScreen" method. -* @default [-10000, -10000] -* @final -* @type Array -*/ -OFF_SCREEN_POSITION: [-10000, -10000], - - -// Private properties - - -/** -* @property _nHideDelayId -* @description Number representing the time-out setting used to cancel the -* hiding of a menu. -* @default null -* @private -* @type Number -*/ -_nHideDelayId: null, - - -/** -* @property _nShowDelayId -* @description Number representing the time-out setting used to cancel the -* showing of a menu. -* @default null -* @private -* @type Number -*/ -_nShowDelayId: null, - - -/** -* @property _nSubmenuHideDelayId -* @description Number representing the time-out setting used to cancel the -* hiding of a submenu. -* @default null -* @private -* @type Number -*/ -_nSubmenuHideDelayId: null, - - -/** -* @property _nBodyScrollId -* @description Number representing the time-out setting used to cancel the -* scrolling of the menu's body element. -* @default null -* @private -* @type Number -*/ -_nBodyScrollId: null, - - -/** -* @property _bHideDelayEventHandlersAssigned -* @description Boolean indicating if the "mouseover" and "mouseout" event -* handlers used for hiding the menu via a call to "window.setTimeout" have -* already been assigned. -* @default false -* @private -* @type Boolean -*/ -_bHideDelayEventHandlersAssigned: false, - - -/** -* @property _bHandledMouseOverEvent -* @description Boolean indicating the current state of the menu's -* "mouseover" event. -* @default false -* @private -* @type Boolean -*/ -_bHandledMouseOverEvent: false, - - -/** -* @property _bHandledMouseOutEvent -* @description Boolean indicating the current state of the menu's -* "mouseout" event. -* @default false -* @private -* @type Boolean -*/ -_bHandledMouseOutEvent: false, - - -/** -* @property _aGroupTitleElements -* @description Array of HTML element used to title groups of menu items. -* @default [] -* @private -* @type Array -*/ -_aGroupTitleElements: null, - - -/** -* @property _aItemGroups -* @description Multi-dimensional Array representing the menu items as they -* are grouped in the menu. -* @default [] -* @private -* @type Array -*/ -_aItemGroups: null, - - -/** -* @property _aListElements -* @description Array of <ul> elements, each of which is -* the parent node for each item's <li> element. -* @default [] -* @private -* @type Array -*/ -_aListElements: null, - - -/** -* @property _nCurrentMouseX -* @description The current x coordinate of the mouse inside the area of -* the menu. -* @default 0 -* @private -* @type Number -*/ -_nCurrentMouseX: 0, - - -/** -* @property _bStopMouseEventHandlers -* @description Stops "mouseover," "mouseout," and "mousemove" event handlers -* from executing. -* @default false -* @private -* @type Boolean -*/ -_bStopMouseEventHandlers: false, - - -/** -* @property _sClassName -* @description The current value of the "classname" configuration attribute. -* @default null -* @private -* @type String -*/ -_sClassName: null, - - - -// Public properties - - -/** -* @property lazyLoad -* @description Boolean indicating if the menu's "lazy load" feature is -* enabled. If set to "true," initialization and rendering of the menu's -* items will be deferred until the first time it is made visible. This -* property should be set via the constructor using the configuration -* object literal. -* @default false -* @type Boolean -*/ -lazyLoad: false, - - -/** -* @property itemData -* @description Array of items to be added to the menu. The array can contain -* strings representing the text for each item to be created, object literals -* representing the menu item configuration properties, or MenuItem instances. -* This property should be set via the constructor using the configuration -* object literal. -* @default null -* @type Array -*/ -itemData: null, - - -/** -* @property activeItem -* @description Object reference to the item in the menu that has is selected. -* @default null -* @type YAHOO.widget.MenuItem -*/ -activeItem: null, - - -/** -* @property parent -* @description Object reference to the menu's parent menu or menu item. -* This property can be set via the constructor using the configuration -* object literal. -* @default null -* @type YAHOO.widget.MenuItem -*/ -parent: null, - - -/** -* @property srcElement -* @description Object reference to the HTML element (either -* <select> or <div>) used to -* create the menu. -* @default null -* @type HTMLSelectElement|HTMLDivElement -*/ -srcElement: null, - - - -// Events - - -/** -* @event mouseOverEvent -* @description Fires when the mouse has entered the menu. Passes back -* the DOM Event object as an argument. -*/ -mouseOverEvent: null, - - -/** -* @event mouseOutEvent -* @description Fires when the mouse has left the menu. 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. 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. 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. 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 one of the -* menu's items 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 one of the menu's items -* 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 one of the menu's items -* has focus. Passes back the DOM Event object as an argument. -* @type YAHOO.util.CustomEvent -*/ -keyUpEvent: null, - - -/** -* @event itemAddedEvent -* @description Fires when an item is added to the menu. -* @type YAHOO.util.CustomEvent -*/ -itemAddedEvent: null, - - -/** -* @event itemRemovedEvent -* @description Fires when an item is removed to the menu. -* @type YAHOO.util.CustomEvent -*/ -itemRemovedEvent: null, - - -/** -* @method init -* @description The Menu 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_oElement String specifying the id attribute of the -* <div> element of the menu. -* @param {String} p_oElement String specifying the id attribute of the -* <select> element to be used as the data source -* for the menu. -* @param {HTMLDivElement} p_oElement Object -* specifying the <div> element of the menu. -* @param {HTMLSelectElement} p_oElement -* Object specifying the <select> element to be used as -* the data source for the menu. -* @param {Object} p_oConfig Optional. Object literal specifying the -* configuration for the menu. See configuration class documentation for -* more details. -*/ -init: function (p_oElement, p_oConfig) { - - this._aItemGroups = []; - this._aListElements = []; - this._aGroupTitleElements = []; - - if (!this.ITEM_TYPE) { - - this.ITEM_TYPE = YAHOO.widget.MenuItem; - - } - - - var oElement; - - if (typeof p_oElement == "string") { - - oElement = document.getElementById(p_oElement); - - } - else if (p_oElement.tagName) { - - oElement = p_oElement; - - } - - - if (oElement && oElement.tagName) { - - switch(oElement.tagName.toUpperCase()) { - - case "DIV": - - this.srcElement = oElement; - - if (!oElement.id) { - - oElement.setAttribute("id", Dom.generateId()); - - } - - - /* - Note: we don't pass the user config in here yet - because we only want it executed once, at the lowest - subclass level. - */ - - Menu.superclass.init.call(this, oElement); - - this.beforeInitEvent.fire(Menu); - - - - break; - - case "SELECT": - - this.srcElement = oElement; - - - /* - The source element is not something that we can use - outright, so we need to create a new Overlay - - Note: we don't pass the user config in here yet - because we only want it executed once, at the lowest - subclass level. - */ - - Menu.superclass.init.call(this, Dom.generateId()); - - this.beforeInitEvent.fire(Menu); - - - - break; - - } - - } - else { - - /* - Note: we don't pass the user config in here yet - because we only want it executed once, at the lowest - subclass level. - */ - - Menu.superclass.init.call(this, p_oElement); - - this.beforeInitEvent.fire(Menu); - - - - } - - - if (this.element) { - - Dom.addClass(this.element, this.CSS_CLASS_NAME); - - - // Subscribe to Custom Events - - this.initEvent.subscribe(this._onInit); - this.beforeRenderEvent.subscribe(this._onBeforeRender); - this.renderEvent.subscribe(this._onRender); - this.renderEvent.subscribe(this.onRender); - this.beforeShowEvent.subscribe(this._onBeforeShow); - this.hideEvent.subscribe(this.positionOffScreen); - this.showEvent.subscribe(this._onShow); - this.beforeHideEvent.subscribe(this._onBeforeHide); - this.mouseOverEvent.subscribe(this._onMouseOver); - this.mouseOutEvent.subscribe(this._onMouseOut); - this.clickEvent.subscribe(this._onClick); - this.keyDownEvent.subscribe(this._onKeyDown); - this.keyPressEvent.subscribe(this._onKeyPress); - - - if (UA.gecko || UA.webkit) { - - this.cfg.subscribeToConfigEvent("y", this._onYChange); - - } - - - if (p_oConfig) { - - this.cfg.applyConfig(p_oConfig, true); - - } - - - // Register the Menu instance with the MenuManager - - MenuManager.addMenu(this); - - - this.initEvent.fire(Menu); - - } - -}, - - - -// Private methods - - -/** -* @method _initSubTree -* @description Iterates the childNodes of the source element to find nodes -* used to instantiate menu and menu items. -* @private -*/ -_initSubTree: function () { - - var oSrcElement = this.srcElement, - sSrcElementTagName, - nGroup, - sGroupTitleTagName, - oNode, - aListElements, - nListElements, - i; - - - if (oSrcElement) { - - sSrcElementTagName = - (oSrcElement.tagName && oSrcElement.tagName.toUpperCase()); - - - if (sSrcElementTagName == "DIV") { - - // Populate the collection of item groups and item group titles - - oNode = this.body.firstChild; - - - if (oNode) { - - nGroup = 0; - sGroupTitleTagName = this.GROUP_TITLE_TAG_NAME.toUpperCase(); - - do { - - - if (oNode && oNode.tagName) { - - switch (oNode.tagName.toUpperCase()) { - - case sGroupTitleTagName: - - this._aGroupTitleElements[nGroup] = oNode; - - break; - - case "UL": - - this._aListElements[nGroup] = oNode; - this._aItemGroups[nGroup] = []; - nGroup++; - - break; - - } - - } - - } - while ((oNode = oNode.nextSibling)); - - - /* - Apply the "first-of-type" class to the first UL to mimic - the "first-of-type" CSS3 psuedo class. - */ - - if (this._aListElements[0]) { - - Dom.addClass(this._aListElements[0], "first-of-type"); - - } - - } - - } - - - oNode = null; - - - - if (sSrcElementTagName) { - - switch (sSrcElementTagName) { - - case "DIV": - - aListElements = this._aListElements; - nListElements = aListElements.length; - - if (nListElements > 0) { - - - i = nListElements - 1; - - do { - - oNode = aListElements[i].firstChild; - - if (oNode) { - - - do { - - if (oNode && oNode.tagName && - oNode.tagName.toUpperCase() == "LI") { - - - this.addItem(new this.ITEM_TYPE(oNode, - { parent: this }), i); - - } - - } - while ((oNode = oNode.nextSibling)); - - } - - } - while (i--); - - } - - break; - - case "SELECT": - - - oNode = oSrcElement.firstChild; - - do { - - if (oNode && oNode.tagName) { - - switch (oNode.tagName.toUpperCase()) { - - case "OPTGROUP": - case "OPTION": - - - this.addItem( - new this.ITEM_TYPE( - oNode, - { parent: this } - ) - ); - - break; - - } - - } - - } - while ((oNode = oNode.nextSibling)); - - break; - - } - - } - - } - -}, - - -/** -* @method _getFirstEnabledItem -* @description Returns the first enabled item in the menu. -* @return {YAHOO.widget.MenuItem} -* @private -*/ -_getFirstEnabledItem: function () { - - var aItems = this.getItems(), - nItems = aItems.length, - oItem; - - for(var i=0; i= aGroup.length); - - - if (aGroup[p_nItemIndex]) { - - aGroup.splice(p_nItemIndex, 0, oItem); - - } - else { - - aGroup[p_nItemIndex] = oItem; - - } - - - oGroupItem = aGroup[p_nItemIndex]; - - if (oGroupItem) { - - if (bAppend && (!oGroupItem.element.parentNode || - oGroupItem.element.parentNode.nodeType == 11)) { - - this._aListElements[nGroupIndex].appendChild( - oGroupItem.element); - - } - else { - - oNextItemSibling = getNextItemSibling(aGroup, - (p_nItemIndex+1)); - - if (oNextItemSibling && (!oGroupItem.element.parentNode || - oGroupItem.element.parentNode.nodeType == 11)) { - - this._aListElements[nGroupIndex].insertBefore( - oGroupItem.element, - oNextItemSibling.element); - - } - - } - - - oGroupItem.parent = this; - - this._subscribeToItemEvents(oGroupItem); - - this._configureSubmenu(oGroupItem); - - this._updateItemProperties(nGroupIndex); - - - this.itemAddedEvent.fire(oGroupItem); - this.changeContentEvent.fire(); - - return oGroupItem; - - } - - } - else { - - nItemIndex = aGroup.length; - - aGroup[nItemIndex] = oItem; - - oGroupItem = aGroup[nItemIndex]; - - - if (oGroupItem) { - - if (!Dom.isAncestor(this._aListElements[nGroupIndex], - oGroupItem.element)) { - - this._aListElements[nGroupIndex].appendChild( - oGroupItem.element); - - } - - oGroupItem.element.setAttribute("groupindex", nGroupIndex); - oGroupItem.element.setAttribute("index", nItemIndex); - - oGroupItem.parent = this; - - oGroupItem.index = nItemIndex; - oGroupItem.groupIndex = nGroupIndex; - - this._subscribeToItemEvents(oGroupItem); - - this._configureSubmenu(oGroupItem); - - if (nItemIndex === 0) { - - Dom.addClass(oGroupItem.element, "first-of-type"); - - } - - - - this.itemAddedEvent.fire(oGroupItem); - this.changeContentEvent.fire(); - - return oGroupItem; - - } - - } - - } - -}, - - -/** -* @method _removeItemFromGroupByIndex -* @description Removes a menu item from a group by index. Returns the menu -* item that was removed. -* @private -* @param {Number} p_nGroupIndex Number indicating the group to which the menu -* item belongs. -* @param {Number} p_nItemIndex Number indicating the index of the menu item -* to be removed. -* @return {YAHOO.widget.MenuItem} -*/ -_removeItemFromGroupByIndex: function (p_nGroupIndex, p_nItemIndex) { - - var nGroupIndex = typeof p_nGroupIndex == "number" ? p_nGroupIndex : 0, - aGroup = this._getItemGroup(nGroupIndex), - aArray, - oItem, - oUL; - - if (aGroup) { - - aArray = aGroup.splice(p_nItemIndex, 1); - oItem = aArray[0]; - - if (oItem) { - - // Update the index and className properties of each member - - this._updateItemProperties(nGroupIndex); - - if (aGroup.length === 0) { - - // Remove the UL - - oUL = this._aListElements[nGroupIndex]; - - if (this.body && oUL) { - - this.body.removeChild(oUL); - - } - - // Remove the group from the array of items - - this._aItemGroups.splice(nGroupIndex, 1); - - - // Remove the UL from the array of ULs - - this._aListElements.splice(nGroupIndex, 1); - - - /* - Assign the "first-of-type" class to the new first UL - in the collection - */ - - oUL = this._aListElements[0]; - - if (oUL) { - - Dom.addClass(oUL, "first-of-type"); - - } - - } - - - this.itemRemovedEvent.fire(oItem); - this.changeContentEvent.fire(); - - - // Return a reference to the item that was removed - - return oItem; - - } - - } - -}, - - -/** -* @method _removeItemFromGroupByValue -* @description Removes a menu item from a group by reference. Returns the -* menu item that was removed. -* @private -* @param {Number} p_nGroupIndex Number indicating the group to which the -* menu item belongs. -* @param {YAHOO.widget.MenuItem} p_oItem Object reference for the MenuItem -* instance to be removed. -* @return {YAHOO.widget.MenuItem} -*/ -_removeItemFromGroupByValue: function (p_nGroupIndex, p_oItem) { - - var aGroup = this._getItemGroup(p_nGroupIndex), - nItems, - nItemIndex, - i; - - if (aGroup) { - - nItems = aGroup.length; - nItemIndex = -1; - - if (nItems > 0) { - - i = nItems-1; - - do { - - if (aGroup[i] == p_oItem) { - - nItemIndex = i; - break; - - } - - } - while(i--); - - if (nItemIndex > -1) { - - return (this._removeItemFromGroupByIndex(p_nGroupIndex, - nItemIndex)); - - } - - } - - } - -}, - - -/** -* @method _updateItemProperties -* @description Updates the "index," "groupindex," and "className" properties -* of the menu items in the specified group. -* @private -* @param {Number} p_nGroupIndex Number indicating the group of items to update. -*/ -_updateItemProperties: function (p_nGroupIndex) { - - var aGroup = this._getItemGroup(p_nGroupIndex), - nItems = aGroup.length, - oItem, - oLI, - i; - - - if (nItems > 0) { - - i = nItems - 1; - - // Update the index and className properties of each member - - do { - - oItem = aGroup[i]; - - if (oItem) { - - oLI = oItem.element; - - oItem.index = i; - oItem.groupIndex = p_nGroupIndex; - - oLI.setAttribute("groupindex", p_nGroupIndex); - oLI.setAttribute("index", i); - - Dom.removeClass(oLI, "first-of-type"); - - } - - } - while(i--); - - - if (oLI) { - - Dom.addClass(oLI, "first-of-type"); - - } - - } - -}, - - -/** -* @method _createItemGroup -* @description Creates a new menu item group (array) and its associated -* <ul> element. Returns an aray of menu item groups. -* @private -* @param {Number} p_nIndex Number indicating the group to create. -* @return {Array} -*/ -_createItemGroup: function (p_nIndex) { - - var oUL; - - if (!this._aItemGroups[p_nIndex]) { - - this._aItemGroups[p_nIndex] = []; - - oUL = document.createElement("ul"); - - this._aListElements[p_nIndex] = oUL; - - return this._aItemGroups[p_nIndex]; - - } - -}, - - -/** -* @method _getItemGroup -* @description Returns the menu item group at the specified index. -* @private -* @param {Number} p_nIndex Number indicating the index of the menu item group -* to be retrieved. -* @return {Array} -*/ -_getItemGroup: function (p_nIndex) { - - var nIndex = ((typeof p_nIndex == "number") ? p_nIndex : 0); - - return this._aItemGroups[nIndex]; - -}, - - -/** -* @method _configureSubmenu -* @description Subscribes the menu item's submenu to its parent menu's events. -* @private -* @param {YAHOO.widget.MenuItem} p_oItem Object reference for the MenuItem -* instance with the submenu to be configured. -*/ -_configureSubmenu: function (p_oItem) { - - var oSubmenu = p_oItem.cfg.getProperty("submenu"); - - if (oSubmenu) { - - /* - Listen for configuration changes to the parent menu - so they they can be applied to the submenu. - */ - - this.cfg.configChangedEvent.subscribe(this._onParentMenuConfigChange, - oSubmenu, true); - - this.renderEvent.subscribe(this._onParentMenuRender, oSubmenu, true); - - oSubmenu.beforeShowEvent.subscribe(this._onSubmenuBeforeShow); - - } - -}, - - - - -/** -* @method _subscribeToItemEvents -* @description Subscribes a menu to a menu item's event. -* @private -* @param {YAHOO.widget.MenuItem} p_oItem Object reference for the MenuItem -* instance whose events should be subscribed to. -*/ -_subscribeToItemEvents: function (p_oItem) { - - p_oItem.focusEvent.subscribe(this._onMenuItemFocus); - - p_oItem.blurEvent.subscribe(this._onMenuItemBlur); - - p_oItem.destroyEvent.subscribe(this._onMenuItemDestroy, p_oItem, this); - - p_oItem.cfg.configChangedEvent.subscribe(this._onMenuItemConfigChange, - p_oItem, this); - -}, - - -/** -* @method _onVisibleChange -* @description Change event handler for the the menu's "visible" configuration -* property. -* @private -* @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. -*/ -_onVisibleChange: function (p_sType, p_aArgs) { - - var bVisible = p_aArgs[0]; - - if (bVisible) { - - Dom.addClass(this.element, "visible"); - - } - else { - - Dom.removeClass(this.element, "visible"); - - } - -}, - - -/** -* @method _cancelHideDelay -* @description Cancels the call to "hideMenu." -* @private -*/ -_cancelHideDelay: function () { - - var oRoot = this.getRoot(); - - if (oRoot._nHideDelayId) { - - window.clearTimeout(oRoot._nHideDelayId); - - } - -}, - - -/** -* @method _execHideDelay -* @description Hides the menu after the number of milliseconds specified by -* the "hidedelay" configuration property. -* @private -*/ -_execHideDelay: function () { - - this._cancelHideDelay(); - - var oRoot = this.getRoot(), - me = this; - - function hideMenu() { - - if (oRoot.activeItem) { - - oRoot.clearActiveItem(); - - } - - if (oRoot == me && !(me instanceof YAHOO.widget.MenuBar) && - me.cfg.getProperty("position") == "dynamic") { - - me.hide(); - - } - - } - - - oRoot._nHideDelayId = - window.setTimeout(hideMenu, oRoot.cfg.getProperty("hidedelay")); - -}, - - -/** -* @method _cancelShowDelay -* @description Cancels the call to the "showMenu." -* @private -*/ -_cancelShowDelay: function () { - - var oRoot = this.getRoot(); - - if (oRoot._nShowDelayId) { - - window.clearTimeout(oRoot._nShowDelayId); - - } - -}, - - -/** -* @method _execShowDelay -* @description Shows the menu after the number of milliseconds specified by -* the "showdelay" configuration property have ellapsed. -* @private -* @param {YAHOO.widget.Menu} p_oMenu Object specifying the menu that should -* be made visible. -*/ -_execShowDelay: function (p_oMenu) { - - var oRoot = this.getRoot(); - - function showMenu() { - - if (p_oMenu.parent.cfg.getProperty("selected")) { - - p_oMenu.show(); - - } - - } - - - oRoot._nShowDelayId = - window.setTimeout(showMenu, oRoot.cfg.getProperty("showdelay")); - -}, - - -/** -* @method _execSubmenuHideDelay -* @description Hides a submenu after the number of milliseconds specified by -* the "submenuhidedelay" configuration property have ellapsed. -* @private -* @param {YAHOO.widget.Menu} p_oSubmenu Object specifying the submenu that -* should be hidden. -* @param {Number} p_nMouseX The x coordinate of the mouse when it left -* the specified submenu's parent menu item. -* @param {Number} p_nHideDelay The number of milliseconds that should ellapse -* before the submenu is hidden. -*/ -_execSubmenuHideDelay: function (p_oSubmenu, p_nMouseX, p_nHideDelay) { - - var me = this; - - p_oSubmenu._nSubmenuHideDelayId = window.setTimeout(function () { - - if (me._nCurrentMouseX > (p_nMouseX + 10)) { - - p_oSubmenu._nSubmenuHideDelayId = window.setTimeout(function () { - - p_oSubmenu.hide(); - - }, p_nHideDelay); - - } - else { - - p_oSubmenu.hide(); - - } - - }, 50); - -}, - - - -// Protected methods - - -/** -* @method _disableScrollHeader -* @description Disables the header used for scrolling the body of the menu. -* @protected -*/ -_disableScrollHeader: function () { - - if (!this._bHeaderDisabled) { - - Dom.addClass(this.header, "topscrollbar_disabled"); - this._bHeaderDisabled = true; - - } - -}, - - -/** -* @method _disableScrollFooter -* @description Disables the footer used for scrolling the body of the menu. -* @protected -*/ -_disableScrollFooter: function () { - - if (!this._bFooterDisabled) { - - Dom.addClass(this.footer, "bottomscrollbar_disabled"); - this._bFooterDisabled = true; - - } - -}, - - -/** -* @method _enableScrollHeader -* @description Enables the header used for scrolling the body of the menu. -* @protected -*/ -_enableScrollHeader: function () { - - if (this._bHeaderDisabled) { - - Dom.removeClass(this.header, "topscrollbar_disabled"); - this._bHeaderDisabled = false; - - } - -}, - - -/** -* @method _enableScrollFooter -* @description Enables the footer used for scrolling the body of the menu. -* @protected -*/ -_enableScrollFooter: function () { - - if (this._bFooterDisabled) { - - Dom.removeClass(this.footer, "bottomscrollbar_disabled"); - this._bFooterDisabled = false; - - } - -}, - - -/** -* @method _onMouseOver -* @description "mouseover" event handler for the menu. -* @protected -* @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. -*/ -_onMouseOver: function (p_sType, p_aArgs) { - - if (this._bStopMouseEventHandlers) { - - return false; - - } - - - var oEvent = p_aArgs[0], - oItem = p_aArgs[1], - oTarget = Event.getTarget(oEvent), - oParentMenu, - nShowDelay, - bShowDelay, - oActiveItem, - oItemCfg, - oSubmenu; - - - if (!this._bHandledMouseOverEvent && (oTarget == this.element || - Dom.isAncestor(this.element, oTarget))) { - - // Menu mouseover logic - - this._nCurrentMouseX = 0; - - Event.on(this.element, "mousemove", this._onMouseMove, this, true); - - - if (!Dom.isAncestor(oItem.element, Event.getRelatedTarget(oEvent))) { - - this.clearActiveItem(); - - } - - - if (this.parent && this._nSubmenuHideDelayId) { - - window.clearTimeout(this._nSubmenuHideDelayId); - - this.parent.cfg.setProperty("selected", true); - - oParentMenu = this.parent.parent; - - oParentMenu._bHandledMouseOutEvent = true; - oParentMenu._bHandledMouseOverEvent = false; - - } - - - this._bHandledMouseOverEvent = true; - this._bHandledMouseOutEvent = false; - - } - - - if (oItem && !oItem.handledMouseOverEvent && - !oItem.cfg.getProperty("disabled") && - (oTarget == oItem.element || Dom.isAncestor(oItem.element, oTarget))) { - - // Menu Item mouseover logic - - nShowDelay = this.cfg.getProperty("showdelay"); - bShowDelay = (nShowDelay > 0); - - - if (bShowDelay) { - - this._cancelShowDelay(); - - } - - - oActiveItem = this.activeItem; - - if (oActiveItem) { - - oActiveItem.cfg.setProperty("selected", false); - - } - - - oItemCfg = oItem.cfg; - - // Select and focus the current menu item - - oItemCfg.setProperty("selected", true); - - - if (this.hasFocus()) { - - oItem.focus(); - - } - - - if (this.cfg.getProperty("autosubmenudisplay")) { - - // Show the submenu this menu item - - oSubmenu = oItemCfg.getProperty("submenu"); - - if (oSubmenu) { - - if (bShowDelay) { - - this._execShowDelay(oSubmenu); - - } - else { - - oSubmenu.show(); - - } - - } - - } - - oItem.handledMouseOverEvent = true; - oItem.handledMouseOutEvent = false; - - } - -}, - - -/** -* @method _onMouseOut -* @description "mouseout" event handler for the menu. -* @protected -* @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. -*/ -_onMouseOut: function (p_sType, p_aArgs) { - - if (this._bStopMouseEventHandlers) { - - return false; - - } - - - var oEvent = p_aArgs[0], - oItem = p_aArgs[1], - oRelatedTarget = Event.getRelatedTarget(oEvent), - bMovingToSubmenu = false, - oItemCfg, - oSubmenu, - nSubmenuHideDelay, - nShowDelay; - - - if (oItem && !oItem.cfg.getProperty("disabled")) { - - oItemCfg = oItem.cfg; - oSubmenu = oItemCfg.getProperty("submenu"); - - - if (oSubmenu && (oRelatedTarget == oSubmenu.element || - Dom.isAncestor(oSubmenu.element, oRelatedTarget))) { - - bMovingToSubmenu = true; - - } - - - if (!oItem.handledMouseOutEvent && ((oRelatedTarget != oItem.element && - !Dom.isAncestor(oItem.element, oRelatedTarget)) || - bMovingToSubmenu)) { - - // Menu Item mouseout logic - - if (!bMovingToSubmenu) { - - oItem.cfg.setProperty("selected", false); - - - if (oSubmenu) { - - nSubmenuHideDelay = - this.cfg.getProperty("submenuhidedelay"); - - nShowDelay = this.cfg.getProperty("showdelay"); - - if (!(this instanceof YAHOO.widget.MenuBar) && - nSubmenuHideDelay > 0 && - nShowDelay >= nSubmenuHideDelay) { - - this._execSubmenuHideDelay(oSubmenu, - Event.getPageX(oEvent), - nSubmenuHideDelay); - - } - else { - - oSubmenu.hide(); - - } - - } - - } - - - oItem.handledMouseOutEvent = true; - oItem.handledMouseOverEvent = false; - - } - - } - - - if (!this._bHandledMouseOutEvent && ((oRelatedTarget != this.element && - !Dom.isAncestor(this.element, oRelatedTarget)) || bMovingToSubmenu)) { - - // Menu mouseout logic - - Event.removeListener(this.element, "mousemove", this._onMouseMove); - - this._nCurrentMouseX = Event.getPageX(oEvent); - - this._bHandledMouseOutEvent = true; - this._bHandledMouseOverEvent = false; - - } - -}, - - -/** -* @method _onMouseMove -* @description "click" event handler for the menu. -* @protected -* @param {Event} p_oEvent Object representing the DOM event object passed -* back by the event utility (YAHOO.util.Event). -* @param {YAHOO.widget.Menu} p_oMenu Object representing the menu that -* fired the event. -*/ -_onMouseMove: function (p_oEvent, p_oMenu) { - - if (this._bStopMouseEventHandlers) { - - return false; - - } - - this._nCurrentMouseX = Event.getPageX(p_oEvent); - -}, - - -/** -* @method _onClick -* @description "click" event handler for the menu. -* @protected -* @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. -*/ -_onClick: function (p_sType, p_aArgs) { - - var Event = YAHOO.util.Event, - Dom = YAHOO.util.Dom, - oEvent = p_aArgs[0], - oItem = p_aArgs[1], - oSubmenu, - bInMenuAnchor = false, - oRoot, - sId, - sURL, - nHashPos, - nLen; - - - if (oItem) { - - if (oItem.cfg.getProperty("disabled")) { - - Event.preventDefault(oEvent); - - } - else { - - oSubmenu = oItem.cfg.getProperty("submenu"); - - - /* - Check if the URL of the anchor is pointing to an element that is - a child of the menu. - */ - - sURL = oItem.cfg.getProperty("url"); - - - if (sURL) { - - nHashPos = sURL.indexOf("#"); - - nLen = sURL.length; - - - if (nHashPos != -1) { - - sURL = sURL.substr(nHashPos, nLen); - - nLen = sURL.length; - - - if (nLen > 1) { - - sId = sURL.substr(1, nLen); - - bInMenuAnchor = Dom.isAncestor(this.element, sId); - - } - else if (nLen === 1) { - - bInMenuAnchor = true; - - } - - } - - } - - - - if (bInMenuAnchor && !oItem.cfg.getProperty("target")) { - - Event.preventDefault(oEvent); - - oItem.focus(); - - } - - - if (!oSubmenu) { - - oRoot = this.getRoot(); - - if (oRoot instanceof YAHOO.widget.MenuBar || - oRoot.cfg.getProperty("position") == "static") { - - oRoot.clearActiveItem(); - - } - else { - - oRoot.hide(); - - } - - } - - } - - } - -}, - - -/** -* @method _onKeyDown -* @description "keydown" event handler for the menu. -* @protected -* @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. -*/ -_onKeyDown: function (p_sType, p_aArgs) { - - var oEvent = p_aArgs[0], - oItem = p_aArgs[1], - me = this, - oSubmenu, - oItemCfg, - oParentItem, - oRoot, - oNextItem, - oBody, - nBodyScrollTop, - nBodyOffsetHeight, - aItems, - nItems, - nNextItemOffsetTop, - nScrollTarget, - oParentMenu; - - - /* - This function is called to prevent a bug in Firefox. In Firefox, - moving a DOM element into a stationary mouse pointer will cause the - browser to fire mouse events. This can result in the menu mouse - event handlers being called uncessarily, especially when menus are - moved into a stationary mouse pointer as a result of a - key event handler. - */ - function stopMouseEventHandlers() { - - me._bStopMouseEventHandlers = true; - - window.setTimeout(function () { - - me._bStopMouseEventHandlers = false; - - }, 10); - - } - - - if (oItem && !oItem.cfg.getProperty("disabled")) { - - oItemCfg = oItem.cfg; - oParentItem = this.parent; - - switch(oEvent.keyCode) { - - case 38: // Up arrow - case 40: // Down arrow - - oNextItem = (oEvent.keyCode == 38) ? - oItem.getPreviousEnabledSibling() : - oItem.getNextEnabledSibling(); - - if (oNextItem) { - - this.clearActiveItem(); - - oNextItem.cfg.setProperty("selected", true); - oNextItem.focus(); - - - if (this.cfg.getProperty("maxheight") > 0) { - - oBody = this.body; - nBodyScrollTop = oBody.scrollTop; - nBodyOffsetHeight = oBody.offsetHeight; - aItems = this.getItems(); - nItems = aItems.length - 1; - nNextItemOffsetTop = oNextItem.element.offsetTop; - - - if (oEvent.keyCode == 40 ) { // Down - - if (nNextItemOffsetTop >= (nBodyOffsetHeight + nBodyScrollTop)) { - - oBody.scrollTop = nNextItemOffsetTop - nBodyOffsetHeight; - - } - else if (nNextItemOffsetTop <= nBodyScrollTop) { - - oBody.scrollTop = 0; - - } - - - if (oNextItem == aItems[nItems]) { - - oBody.scrollTop = oNextItem.element.offsetTop; - - } - - } - else { // Up - - if (nNextItemOffsetTop <= nBodyScrollTop) { - - oBody.scrollTop = nNextItemOffsetTop - oNextItem.element.offsetHeight; - - } - else if (nNextItemOffsetTop >= (nBodyScrollTop + nBodyOffsetHeight)) { - - oBody.scrollTop = nNextItemOffsetTop; - - } - - - if (oNextItem == aItems[0]) { - - oBody.scrollTop = 0; - - } - - } - - - nBodyScrollTop = oBody.scrollTop; - nScrollTarget = oBody.scrollHeight - oBody.offsetHeight; - - if (nBodyScrollTop === 0) { - - this._disableScrollHeader(); - this._enableScrollFooter(); - - } - else if (nBodyScrollTop == nScrollTarget) { - - this._enableScrollHeader(); - this._disableScrollFooter(); - - } - else { - - this._enableScrollHeader(); - this._enableScrollFooter(); - - } - - } - - } - - - Event.preventDefault(oEvent); - - stopMouseEventHandlers(); - - break; - - - case 39: // Right arrow - - oSubmenu = oItemCfg.getProperty("submenu"); - - if (oSubmenu) { - - if (!oItemCfg.getProperty("selected")) { - - oItemCfg.setProperty("selected", true); - - } - - oSubmenu.show(); - oSubmenu.setInitialFocus(); - oSubmenu.setInitialSelection(); - - } - else { - - oRoot = this.getRoot(); - - if (oRoot instanceof YAHOO.widget.MenuBar) { - - oNextItem = oRoot.activeItem.getNextEnabledSibling(); - - if (oNextItem) { - - oRoot.clearActiveItem(); - - oNextItem.cfg.setProperty("selected", true); - - oSubmenu = oNextItem.cfg.getProperty("submenu"); - - if (oSubmenu) { - - oSubmenu.show(); - - } - - oNextItem.focus(); - - } - - } - - } - - - Event.preventDefault(oEvent); - - stopMouseEventHandlers(); - - break; - - - case 37: // Left arrow - - if (oParentItem) { - - oParentMenu = oParentItem.parent; - - if (oParentMenu instanceof YAHOO.widget.MenuBar) { - - oNextItem = - oParentMenu.activeItem.getPreviousEnabledSibling(); - - if (oNextItem) { - - oParentMenu.clearActiveItem(); - - oNextItem.cfg.setProperty("selected", true); - - oSubmenu = oNextItem.cfg.getProperty("submenu"); - - if (oSubmenu) { - - oSubmenu.show(); - - } - - oNextItem.focus(); - - } - - } - else { - - this.hide(); - - oParentItem.focus(); - - } - - } - - Event.preventDefault(oEvent); - - stopMouseEventHandlers(); - - break; - - } - - - } - - - if (oEvent.keyCode == 27) { // Esc key - - if (this.cfg.getProperty("position") == "dynamic") { - - this.hide(); - - if (this.parent) { - - this.parent.focus(); - - } - - } - else if (this.activeItem) { - - oSubmenu = this.activeItem.cfg.getProperty("submenu"); - - if (oSubmenu && oSubmenu.cfg.getProperty("visible")) { - - oSubmenu.hide(); - this.activeItem.focus(); - - } - else { - - this.activeItem.blur(); - this.activeItem.cfg.setProperty("selected", false); - - } - - } - - - Event.preventDefault(oEvent); - - } - -}, - - -/** -* @method _onKeyPress -* @description "keypress" event handler for a Menu instance. -* @protected -* @param {String} p_sType The name of the event that was fired. -* @param {Array} p_aArgs Collection of arguments sent when the event -* was fired. -*/ -_onKeyPress: function (p_sType, p_aArgs) { - - var oEvent = p_aArgs[0]; - - - if (oEvent.keyCode == 40 || oEvent.keyCode == 38) { - - Event.preventDefault(oEvent); - - } - -}, - - -/** -* @method _onYChange -* @description "y" event handler for a Menu instance. -* @protected -* @param {String} p_sType The name of the event that was fired. -* @param {Array} p_aArgs Collection of arguments sent when the event -* was fired. -*/ -_onYChange: function (p_sType, p_aArgs) { - - var oParent = this.parent, - nScrollTop, - oIFrame, - nY; - - - if (oParent) { - - nScrollTop = oParent.parent.body.scrollTop; - - - if (nScrollTop > 0) { - - nY = (this.cfg.getProperty("y") - nScrollTop); - - Dom.setY(this.element, nY); - - oIFrame = this.iframe; - - - if (oIFrame) { - - Dom.setY(oIFrame, nY); - - } - - this.cfg.setProperty("y", nY, true); - - } - - } - -}, - - -/** -* @method _onScrollTargetMouseOver -* @description "mouseover" event handler for the menu's "header" and "footer" -* elements. Used to scroll the body of the menu up and down when the -* menu's "maxheight" configuration property is set to a value greater than 0. -* @protected -* @param {Event} p_oEvent Object representing the DOM event object passed -* back by the event utility (YAHOO.util.Event). -* @param {YAHOO.widget.Menu} p_oMenu Object representing the menu that -* fired the event. -*/ -_onScrollTargetMouseOver: function (p_oEvent, p_oMenu) { - - this._cancelHideDelay(); - - var oTarget = Event.getTarget(p_oEvent), - oBody = this.body, - me = this, - nScrollIncrement = this.cfg.getProperty("scrollincrement"), - nScrollTarget, - fnScrollFunction; - - - function scrollBodyDown() { - - var nScrollTop = oBody.scrollTop; - - - if (nScrollTop < nScrollTarget) { - - oBody.scrollTop = (nScrollTop + nScrollIncrement); - - me._enableScrollHeader(); - - } - else { - - oBody.scrollTop = nScrollTarget; - - window.clearInterval(me._nBodyScrollId); - - me._disableScrollFooter(); - - } - - } - - - function scrollBodyUp() { - - var nScrollTop = oBody.scrollTop; - - - if (nScrollTop > 0) { - - oBody.scrollTop = (nScrollTop - nScrollIncrement); - - me._enableScrollFooter(); - - } - else { - - oBody.scrollTop = 0; - - window.clearInterval(me._nBodyScrollId); - - me._disableScrollHeader(); - - } - - } - - - if (Dom.hasClass(oTarget, "hd")) { - - fnScrollFunction = scrollBodyUp; - - } - else { - - nScrollTarget = oBody.scrollHeight - oBody.offsetHeight; - - fnScrollFunction = scrollBodyDown; - - } - - - this._nBodyScrollId = window.setInterval(fnScrollFunction, 10); - -}, - - -/** -* @method _onScrollTargetMouseOut -* @description "mouseout" event handler for the menu's "header" and "footer" -* elements. Used to stop scrolling the body of the menu up and down when the -* menu's "maxheight" configuration property is set to a value greater than 0. -* @protected -* @param {Event} p_oEvent Object representing the DOM event object passed -* back by the event utility (YAHOO.util.Event). -* @param {YAHOO.widget.Menu} p_oMenu Object representing the menu that -* fired the event. -*/ -_onScrollTargetMouseOut: function (p_oEvent, p_oMenu) { - - window.clearInterval(this._nBodyScrollId); - - this._cancelHideDelay(); - -}, - - - -// Private methods - - -/** -* @method _onInit -* @description "init" event handler for the menu. -* @private -* @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. -*/ -_onInit: function (p_sType, p_aArgs) { - - this.cfg.subscribeToConfigEvent("visible", this._onVisibleChange); - - var bRootMenu = !this.parent, - bLazyLoad = this.lazyLoad; - - - /* - Automatically initialize a menu's subtree if: - - 1) This is the root menu and lazyload is off - - 2) This is the root menu, lazyload is on, but the menu is - already visible - - 3) This menu is a submenu and lazyload is off - */ - - - - if (((bRootMenu && !bLazyLoad) || - (bRootMenu && (this.cfg.getProperty("visible") || - this.cfg.getProperty("position") == "static")) || - (!bRootMenu && !bLazyLoad)) && this.getItemGroups().length === 0) { - - if (this.srcElement) { - - this._initSubTree(); - - } - - - if (this.itemData) { - - this.addItems(this.itemData); - - } - - } - else if (bLazyLoad) { - - this.cfg.fireQueue(); - - } - -}, - - -/** -* @method _onBeforeRender -* @description "beforerender" event handler for the menu. Appends all of the -* <ul>, <li> and their accompanying -* title elements to the body element of the menu. -* @private -* @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. -*/ -_onBeforeRender: function (p_sType, p_aArgs) { - - var oEl = this.element, - nListElements = this._aListElements.length, - bFirstList = true, - i = 0, - oUL, - oGroupTitle; - - if (nListElements > 0) { - - do { - - oUL = this._aListElements[i]; - - if (oUL) { - - if (bFirstList) { - - Dom.addClass(oUL, "first-of-type"); - bFirstList = false; - - } - - - if (!Dom.isAncestor(oEl, oUL)) { - - this.appendToBody(oUL); - - } - - - oGroupTitle = this._aGroupTitleElements[i]; - - if (oGroupTitle) { - - if (!Dom.isAncestor(oEl, oGroupTitle)) { - - oUL.parentNode.insertBefore(oGroupTitle, oUL); - - } - - - Dom.addClass(oUL, "hastitle"); - - } - - } - - i++; - - } - while(i < nListElements); - - } - -}, - - -/** -* @method _onRender -* @description "render" event handler for the menu. -* @private -* @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. -*/ -_onRender: function (p_sType, p_aArgs) { - - if (this.cfg.getProperty("position") == "dynamic") { - - if (!this.cfg.getProperty("visible")) { - - this.positionOffScreen(); - - } - - } - -}, - - - - - -/** -* @method _onBeforeShow -* @description "beforeshow" event handler for the menu. -* @private -* @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. -*/ -_onBeforeShow: function (p_sType, p_aArgs) { - - var nOptions, - n, - nViewportHeight, - oRegion, - oSrcElement; - - - if (this.lazyLoad && this.getItemGroups().length === 0) { - - if (this.srcElement) { - - this._initSubTree(); - - } - - - if (this.itemData) { - - if (this.parent && this.parent.parent && - this.parent.parent.srcElement && - this.parent.parent.srcElement.tagName.toUpperCase() == - "SELECT") { - - nOptions = this.itemData.length; - - for(n=0; n= nViewportHeight) { - - nMaxHeight = (nViewportHeight - (Overlay.VIEWPORT_OFFSET * 2)); - - if (nMaxHeight < nMinScrollHeight) { - - nMaxHeight = nMinScrollHeight; - - } - - this.cfg.setProperty("maxheight", nMaxHeight); - - this.hideEvent.subscribe(clearMaxHeight); - - } - - } - - } - -}, - - -/** -* @method _onShow -* @description "show" event handler for the menu. -* @private -* @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. -*/ -_onShow: function (p_sType, p_aArgs) { - - var oParent = this.parent, - oParentMenu, - aParentAlignment, - aAlignment; - - - function disableAutoSubmenuDisplay(p_oEvent) { - - var oTarget; - - if (p_oEvent.type == "mousedown" || (p_oEvent.type == "keydown" && - p_oEvent.keyCode == 27)) { - - /* - Set the "autosubmenudisplay" to "false" if the user - clicks outside the menu bar. - */ - - oTarget = Event.getTarget(p_oEvent); - - if (oTarget != oParentMenu.element || - !Dom.isAncestor(oParentMenu.element, oTarget)) { - - oParentMenu.cfg.setProperty("autosubmenudisplay", false); - - Event.removeListener(document, "mousedown", - disableAutoSubmenuDisplay); - - Event.removeListener(document, "keydown", - disableAutoSubmenuDisplay); - - } - - } - - } - - - if (oParent) { - - oParentMenu = oParent.parent; - aParentAlignment = oParentMenu.cfg.getProperty("submenualignment"); - aAlignment = this.cfg.getProperty("submenualignment"); - - - if ((aParentAlignment[0] != aAlignment[0]) && - (aParentAlignment[1] != aAlignment[1])) { - - this.cfg.setProperty("submenualignment", - [aParentAlignment[0], aParentAlignment[1]]); - - } - - - if (!oParentMenu.cfg.getProperty("autosubmenudisplay") && - (oParentMenu instanceof YAHOO.widget.MenuBar || - oParentMenu.cfg.getProperty("position") == "static")) { - - oParentMenu.cfg.setProperty("autosubmenudisplay", true); - - Event.on(document, "mousedown", disableAutoSubmenuDisplay); - Event.on(document, "keydown", disableAutoSubmenuDisplay); - - } - - } - -}, - - -/** -* @method _onBeforeHide -* @description "beforehide" event handler for the menu. -* @private -* @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. -*/ -_onBeforeHide: function (p_sType, p_aArgs) { - - var oActiveItem = this.activeItem, - oConfig, - oSubmenu; - - if (oActiveItem) { - - oConfig = oActiveItem.cfg; - - oConfig.setProperty("selected", false); - - oSubmenu = oConfig.getProperty("submenu"); - - if (oSubmenu) { - - oSubmenu.hide(); - - } - - } - - if (this.getRoot() == this) { - - this.blur(); - - } - -}, - - -/** -* @method _onParentMenuConfigChange -* @description "configchange" event handler for a submenu. -* @private -* @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.Menu} p_oSubmenu Object representing the submenu that -* subscribed to the event. -*/ -_onParentMenuConfigChange: function (p_sType, p_aArgs, p_oSubmenu) { - - var sPropertyName = p_aArgs[0][0], - oPropertyValue = p_aArgs[0][1]; - - switch(sPropertyName) { - - case "iframe": - case "constraintoviewport": - case "hidedelay": - case "showdelay": - case "submenuhidedelay": - case "clicktohide": - case "effect": - case "classname": - case "scrollincrement": - case "minscrollheight": - - p_oSubmenu.cfg.setProperty(sPropertyName, oPropertyValue); - - break; - - } - -}, - - -/** -* @method _onParentMenuRender -* @description "render" event handler for a submenu. Renders a -* submenu in response to the firing of its parent's "render" event. -* @private -* @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.Menu} p_oSubmenu Object representing the submenu that -* subscribed to the event. -*/ -_onParentMenuRender: function (p_sType, p_aArgs, p_oSubmenu) { - - var oParentCfg = p_oSubmenu.parent.parent.cfg, - - oConfig = { - - constraintoviewport: oParentCfg.getProperty("constraintoviewport"), - - xy: [0,0], - - clicktohide: oParentCfg.getProperty("clicktohide"), - - effect: oParentCfg.getProperty("effect"), - - showdelay: oParentCfg.getProperty("showdelay"), - - hidedelay: oParentCfg.getProperty("hidedelay"), - - submenuhidedelay: oParentCfg.getProperty("submenuhidedelay"), - - classname: oParentCfg.getProperty("classname"), - - scrollincrement: oParentCfg.getProperty("scrollincrement"), - - minscrollheight: oParentCfg.getProperty("minscrollheight"), - - iframe: oParentCfg.getProperty("iframe") - - }, - - oLI; - - - p_oSubmenu.cfg.applyConfig(oConfig); - - - if (!this.lazyLoad) { - - oLI = this.parent.element; - - if (this.element.parentNode == oLI) { - - this.render(); - - } - else { - - this.render(oLI); - - } - - } - -}, - - -/** -* @method _onSubmenuBeforeShow -* @description "beforeshow" event handler for a submenu. -* @private -* @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. -*/ -_onSubmenuBeforeShow: function (p_sType, p_aArgs) { - - var oParent = this.parent, - aAlignment = oParent.parent.cfg.getProperty("submenualignment"); - - - if (!this.cfg.getProperty("context")) { - - this.cfg.setProperty("context", - [oParent.element, aAlignment[0], aAlignment[1]]); - - } - else { - - this.align(); - - } - -}, - - -/** -* @method _onMenuItemFocus -* @description "focus" event handler for the menu's items. -* @private -* @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. -*/ -_onMenuItemFocus: function (p_sType, p_aArgs) { - - this.parent.focusEvent.fire(this); - -}, - - -/** -* @method _onMenuItemBlur -* @description "blur" event handler for the menu's items. -* @private -* @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. -*/ -_onMenuItemBlur: function (p_sType, p_aArgs) { - - this.parent.blurEvent.fire(this); - -}, - - -/** -* @method _onMenuItemDestroy -* @description "destroy" event handler for the menu's items. -* @private -* @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. -*/ -_onMenuItemDestroy: function (p_sType, p_aArgs, p_oItem) { - - this._removeItemFromGroupByValue(p_oItem.groupIndex, p_oItem); - -}, - - -/** -* @method _onMenuItemConfigChange -* @description "configchange" event handler for the menu's items. -* @private -* @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. -*/ -_onMenuItemConfigChange: function (p_sType, p_aArgs, p_oItem) { - - var sPropertyName = p_aArgs[0][0], - oPropertyValue = p_aArgs[0][1], - oSubmenu; - - - switch(sPropertyName) { - - case "selected": - - if (oPropertyValue === true) { - - this.activeItem = p_oItem; - - } - - break; - - case "submenu": - - oSubmenu = p_aArgs[0][1]; - - if (oSubmenu) { - - this._configureSubmenu(p_oItem); - - } - - break; - - } - -}, - - - -// Public event handlers for configuration properties - - -/** -* @method enforceConstraints -* @description The default event handler executed when the moveEvent is fired, -* if the "constraintoviewport" configuration property is set to true. -* @param {String} type The name of the event that was fired. -* @param {Array} args Collection of arguments sent when the -* event was fired. -* @param {Array} obj Array containing the current Menu instance -* and the item that fired the event. -*/ -enforceConstraints: function (type, args, obj) { - - var oParentMenuItem = this.parent, - nViewportOffset = Overlay.VIEWPORT_OFFSET, - oElement = this.element, - oConfig = this.cfg, - pos = args[0], - offsetHeight = oElement.offsetHeight, - offsetWidth = oElement.offsetWidth, - viewPortWidth = Dom.getViewportWidth(), - viewPortHeight = Dom.getViewportHeight(), - nPadding = (oParentMenuItem && - oParentMenuItem.parent instanceof YAHOO.widget.MenuBar) ? - 0 : nViewportOffset, - aContext = oConfig.getProperty("context"), - oContextElement = aContext ? aContext[0] : null, - topConstraint, - leftConstraint, - bottomConstraint, - rightConstraint, - scrollX, - scrollY, - x, - y; - - - if (offsetWidth < viewPortWidth) { - - x = pos[0]; - scrollX = Dom.getDocumentScrollLeft(); - leftConstraint = scrollX + nPadding; - rightConstraint = scrollX + viewPortWidth - offsetWidth - nPadding; - - if (x < nViewportOffset) { - - x = leftConstraint; - - } else if ((x + offsetWidth) > viewPortWidth) { - - if(oContextElement && - ((x - oContextElement.offsetWidth) > offsetWidth)) { - - if (oParentMenuItem && - oParentMenuItem.parent instanceof YAHOO.widget.MenuBar) { - - x = (x - (offsetWidth - oContextElement.offsetWidth)); - - } - else { - - x = (x - (oContextElement.offsetWidth + offsetWidth)); - - } - - } - else { - - x = rightConstraint; - - } - - } - - } - - - if (offsetHeight < viewPortHeight) { - - y = pos[1]; - scrollY = Dom.getDocumentScrollTop(); - topConstraint = scrollY + nPadding; - bottomConstraint = scrollY + viewPortHeight - offsetHeight - nPadding; - - - - if (y < nViewportOffset) { - - y = topConstraint; - - } else if (y > bottomConstraint) { - - if (oContextElement && (y > offsetHeight)) { - - y = ((y + oContextElement.offsetHeight) - offsetHeight); - - } - else { - - y = bottomConstraint; - - - - } - - } - - } - - - oConfig.setProperty("x", x, true); - oConfig.setProperty("y", y, true); - oConfig.setProperty("xy", [x,y], true); - -}, - - -/** -* @method configVisible -* @description Event handler for when the "visible" configuration property -* the menu 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.Menu} p_oMenu Object representing the menu that -* fired the event. -*/ -configVisible: function (p_sType, p_aArgs, p_oMenu) { - - var bVisible, - sDisplay; - - if (this.cfg.getProperty("position") == "dynamic") { - - Menu.superclass.configVisible.call(this, p_sType, p_aArgs, p_oMenu); - - } - else { - - bVisible = p_aArgs[0]; - sDisplay = Dom.getStyle(this.element, "display"); - - Dom.setStyle(this.element, "visibility", "visible"); - - if (bVisible) { - - if (sDisplay != "block") { - this.beforeShowEvent.fire(); - Dom.setStyle(this.element, "display", "block"); - this.showEvent.fire(); - } - - } - else { - - if (sDisplay == "block") { - this.beforeHideEvent.fire(); - Dom.setStyle(this.element, "display", "none"); - this.hideEvent.fire(); - } - - } - - } - -}, - - -/** -* @method configPosition -* @description Event handler for when the "position" configuration property -* of the menu 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.Menu} p_oMenu Object representing the menu that -* fired the event. -*/ -configPosition: function (p_sType, p_aArgs, p_oMenu) { - - var oElement = this.element, - sCSSPosition = p_aArgs[0] == "static" ? "static" : "absolute", - oCfg = this.cfg, - nZIndex; - - - Dom.setStyle(oElement, "position", sCSSPosition); - - - if (sCSSPosition == "static") { - - // Statically positioned menus are visible by default - - Dom.setStyle(oElement, "display", "block"); - - oCfg.setProperty("visible", true); - - } - else { - - /* - Even though the "visible" property is queued to - "false" by default, we need to set the "visibility" property to - "hidden" since Overlay's "configVisible" implementation checks the - element's "visibility" style property before deciding whether - or not to show an Overlay instance. - */ - - Dom.setStyle(oElement, "visibility", "hidden"); - - } - - - if (sCSSPosition == "absolute") { - - nZIndex = oCfg.getProperty("zindex"); - - if (!nZIndex || nZIndex === 0) { - - nZIndex = this.parent ? - (this.parent.parent.cfg.getProperty("zindex") + 1) : 1; - - oCfg.setProperty("zindex", nZIndex); - - } - - } - -}, - - -/** -* @method configIframe -* @description Event handler for when the "iframe" configuration property of -* the menu 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.Menu} p_oMenu Object representing the menu that -* fired the event. -*/ -configIframe: function (p_sType, p_aArgs, p_oMenu) { - - if (this.cfg.getProperty("position") == "dynamic") { - - Menu.superclass.configIframe.call(this, p_sType, p_aArgs, p_oMenu); - - } - -}, - - -/** -* @method configHideDelay -* @description Event handler for when the "hidedelay" configuration property -* of the menu 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.Menu} p_oMenu Object representing the menu that -* fired the event. -*/ -configHideDelay: function (p_sType, p_aArgs, p_oMenu) { - - var nHideDelay = p_aArgs[0], - oMouseOutEvent = this.mouseOutEvent, - oMouseOverEvent = this.mouseOverEvent, - oKeyDownEvent = this.keyDownEvent; - - if (nHideDelay > 0) { - - /* - Only assign event handlers once. This way the user change - the value for the hidedelay as many times as they want. - */ - - if (!this._bHideDelayEventHandlersAssigned) { - - oMouseOutEvent.subscribe(this._execHideDelay); - oMouseOverEvent.subscribe(this._cancelHideDelay); - oKeyDownEvent.subscribe(this._cancelHideDelay); - - this._bHideDelayEventHandlersAssigned = true; - - } - - } - else { - - oMouseOutEvent.unsubscribe(this._execHideDelay); - oMouseOverEvent.unsubscribe(this._cancelHideDelay); - oKeyDownEvent.unsubscribe(this._cancelHideDelay); - - this._bHideDelayEventHandlersAssigned = false; - - } - -}, - - -/** -* @method configContainer -* @description Event handler for when the "container" configuration property -* of the menu 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.Menu} p_oMenu Object representing the menu that -* fired the event. -*/ -configContainer: function (p_sType, p_aArgs, p_oMenu) { - - var oElement = p_aArgs[0]; - - if (typeof oElement == 'string') { - - this.cfg.setProperty("container", document.getElementById(oElement), - true); - - } - -}, - - -/** -* @method _setMaxHeight -* @description "renderEvent" handler used to defer the setting of the -* "maxheight" configuration property until the menu is rendered in lazy -* load scenarios. -* @param {String} p_sType The name of the event that was fired. -* @param {Array} p_aArgs Collection of arguments sent when the event -* was fired. -* @param {Number} p_nMaxHeight Number representing the value to set for the -* "maxheight" configuration property. -* @private -*/ -_setMaxHeight: function (p_sType, p_aArgs, p_nMaxHeight) { - - this.cfg.setProperty("maxheight", p_nMaxHeight); - this.renderEvent.unsubscribe(this._setMaxHeight); - -}, - - -/** -* @method configMaxHeight -* @description Event handler for when the "maxheight" configuration property of -* a Menu changes. -* @param {String} p_sType The name of the event that was fired. -* @param {Array} p_aArgs Collection of arguments sent when the event -* was fired. -* @param {YAHOO.widget.Menu} p_oMenu The Menu instance fired -* the event. -*/ -configMaxHeight: function (p_sType, p_aArgs, p_oMenu) { - - var nMaxHeight = p_aArgs[0], - oElement = this.element, - oBody = this.body, - oHeader = this.header, - oFooter = this.footer, - fnMouseOver = this._onScrollTargetMouseOver, - fnMouseOut = this._onScrollTargetMouseOut, - nMinScrollHeight = this.cfg.getProperty("minscrollheight"), - nHeight, - nOffsetWidth, - sWidth; - - - if (nMaxHeight !== 0 && nMaxHeight < nMinScrollHeight) { - - nMaxHeight = nMinScrollHeight; - - } - - - if (this.lazyLoad && !oBody) { - - this.renderEvent.unsubscribe(this._setMaxHeight); - - if (nMaxHeight > 0) { - - this.renderEvent.subscribe(this._setMaxHeight, nMaxHeight, this); - - } - - return; - - } - - - Dom.setStyle(oBody, "height", ""); - Dom.removeClass(oBody, "yui-menu-body-scrolled"); - - - /* - There is a bug in gecko-based browsers where an element whose - "position" property is set to "absolute" and "overflow" property is set - to "hidden" will not render at the correct width when its - offsetParent's "position" property is also set to "absolute." It is - possible to work around this bug by specifying a value for the width - property in addition to overflow. - - In IE it is also necessary to give the Menu a width when the scrollbars are - rendered to prevent the Menu from rendering with a width that is 100% of - the browser viewport. - */ - - var bSetWidth = ((UA.gecko && this.parent && this.parent.parent && - this.parent.parent.cfg.getProperty("position") == "dynamic") || UA.ie); - - - if (bSetWidth) { - - if (!this.cfg.getProperty("width")) { - - nOffsetWidth = oElement.offsetWidth; - - /* - Measuring the difference of the offsetWidth before and after - setting the "width" style attribute allows us to compute the - about of padding and borders applied to the element, which in - turn allows us to set the "width" property correctly. - */ - - oElement.style.width = nOffsetWidth + "px"; - - sWidth = (nOffsetWidth - (oElement.offsetWidth - nOffsetWidth)) + "px"; - - this.cfg.setProperty("width", sWidth); - - } - - } - - - if (!oHeader && !oFooter) { - - this.setHeader(" "); - this.setFooter(" "); - - oHeader = this.header; - oFooter = this.footer; - - Dom.addClass(oHeader, "topscrollbar"); - Dom.addClass(oFooter, "bottomscrollbar"); - - oElement.insertBefore(oHeader, oBody); - oElement.appendChild(oFooter); - - } - - - nHeight = (nMaxHeight - (oHeader.offsetHeight + oHeader.offsetHeight)); - - - if (nHeight > 0 && (oBody.offsetHeight > nMaxHeight)) { - - Dom.addClass(oBody, "yui-menu-body-scrolled"); - Dom.setStyle(oBody, "height", (nHeight + "px")); - - Event.on(oHeader, "mouseover", fnMouseOver, this, true); - Event.on(oHeader, "mouseout", fnMouseOut, this, true); - Event.on(oFooter, "mouseover", fnMouseOver, this, true); - Event.on(oFooter, "mouseout", fnMouseOut, this, true); - - this._disableScrollHeader(); - this._enableScrollFooter(); - - } - else if (oHeader && oFooter) { - - if (bSetWidth) { - - this.cfg.setProperty("width", ""); - - } - - - this._enableScrollHeader(); - this._enableScrollFooter(); - - Event.removeListener(oHeader, "mouseover", fnMouseOver); - Event.removeListener(oHeader, "mouseout", fnMouseOut); - Event.removeListener(oFooter, "mouseover", fnMouseOver); - Event.removeListener(oFooter, "mouseout", fnMouseOut); - - oElement.removeChild(oHeader); - oElement.removeChild(oFooter); - - this.header = null; - this.footer = null; - - } - - this.cfg.refireEvent("iframe"); - -}, - - -/** -* @method configClassName -* @description Event handler for when the "classname" configuration property of -* a menu changes. -* @param {String} p_sType The name of the event that was fired. -* @param {Array} p_aArgs Collection of arguments sent when the event was fired. -* @param {YAHOO.widget.Menu} p_oMenu The Menu instance fired the event. -*/ -configClassName: function (p_sType, p_aArgs, p_oMenu) { - - var sClassName = p_aArgs[0]; - - if (this._sClassName) { - - Dom.removeClass(this.element, this._sClassName); - - } - - Dom.addClass(this.element, sClassName); - this._sClassName = sClassName; - -}, - - -/** -* @method _onItemAdded -* @description "itemadded" event handler for a Menu instance. -* @private -* @param {String} p_sType The name of the event that was fired. -* @param {Array} p_aArgs Collection of arguments sent when the event -* was fired. -*/ -_onItemAdded: function (p_sType, p_aArgs) { - - var oItem = p_aArgs[0]; - - if (oItem) { - - oItem.cfg.setProperty("disabled", true); - - } - -}, - - -/** -* @method configDisabled -* @description Event handler for when the "disabled" configuration property of -* a menu changes. -* @param {String} p_sType The name of the event that was fired. -* @param {Array} p_aArgs Collection of arguments sent when the event was fired. -* @param {YAHOO.widget.Menu} p_oMenu The Menu instance fired the event. -*/ -configDisabled: function (p_sType, p_aArgs, p_oMenu) { - - var bDisabled = p_aArgs[0], - aItems = this.getItems(), - nItems, - i; - - if (Lang.isArray(aItems)) { - - nItems = aItems.length; - - if (nItems > 0) { - - i = nItems - 1; - - do { - - aItems[i].cfg.setProperty("disabled", bDisabled); - - } - while (i--); - - } - - - if (bDisabled) { - - this.clearActiveItem(true); - - Dom.addClass(this.element, "disabled"); - - this.itemAddedEvent.subscribe(this._onItemAdded); - - } - else { - - Dom.removeClass(this.element, "disabled"); - - this.itemAddedEvent.unsubscribe(this._onItemAdded); - - } - - } - -}, - - -/** -* @method onRender -* @description "render" event handler for the menu. -* @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. -*/ -onRender: function (p_sType, p_aArgs) { - - function sizeShadow() { - - var oElement = this.element, - oShadow = this._shadow; - - if (oShadow && oElement) { - - oShadow.style.width = (oElement.offsetWidth + 6) + "px"; - oShadow.style.height = (oElement.offsetHeight + 1) + "px"; - - } - - } - - - function replaceShadow() { - - this.element.appendChild(this._shadow); - - } - - - function addShadowVisibleClass() { - - Dom.addClass(this._shadow, "yui-menu-shadow-visible"); - - } - - - function removeShadowVisibleClass() { - - Dom.removeClass(this._shadow, "yui-menu-shadow-visible"); - - } - - - function createShadow() { - - var oShadow = this._shadow, - oElement, - me; - - if (!oShadow) { - - oElement = this.element; - me = this; - - if (!m_oShadowTemplate) { - - m_oShadowTemplate = document.createElement("div"); - m_oShadowTemplate.className = - "yui-menu-shadow yui-menu-shadow-visible"; - - } - - oShadow = m_oShadowTemplate.cloneNode(false); - - oElement.appendChild(oShadow); - - this._shadow = oShadow; - - this.beforeShowEvent.subscribe(addShadowVisibleClass); - this.beforeHideEvent.subscribe(removeShadowVisibleClass); - - if (UA.ie) { - - /* - Need to call sizeShadow & syncIframe via setTimeout for - IE 7 Quirks Mode and IE 6 Standards Mode and Quirks Mode - or the shadow and iframe shim will not be sized and - positioned properly. - */ - - window.setTimeout(function () { - - sizeShadow.call(me); - me.syncIframe(); - - }, 0); - - this.cfg.subscribeToConfigEvent("width", sizeShadow); - this.cfg.subscribeToConfigEvent("height", sizeShadow); - this.cfg.subscribeToConfigEvent("maxheight", sizeShadow); - this.changeContentEvent.subscribe(sizeShadow); - - Module.textResizeEvent.subscribe(sizeShadow, me, true); - - this.destroyEvent.subscribe(function () { - - Module.textResizeEvent.unsubscribe(sizeShadow, me); - - }); - - } - - this.cfg.subscribeToConfigEvent("maxheight", replaceShadow); - - } - - } - - - function onBeforeShow() { - - createShadow.call(this); - - this.beforeShowEvent.unsubscribe(onBeforeShow); - - } - - - if (this.cfg.getProperty("position") == "dynamic") { - - if (this.cfg.getProperty("visible")) { - - createShadow.call(this); - - } - else { - - this.beforeShowEvent.subscribe(onBeforeShow); - - } - - } - -}, - - -// Public methods - - -/** -* @method initEvents -* @description Initializes the custom events for the menu. -*/ -initEvents: function () { - - Menu.superclass.initEvents.call(this); - - // Create custom events - - var SIGNATURE = CustomEvent.LIST; - - this.mouseOverEvent = this.createEvent(EVENT_TYPES.MOUSE_OVER); - this.mouseOverEvent.signature = SIGNATURE; - - this.mouseOutEvent = this.createEvent(EVENT_TYPES.MOUSE_OUT); - this.mouseOutEvent.signature = SIGNATURE; - - this.mouseDownEvent = this.createEvent(EVENT_TYPES.MOUSE_DOWN); - this.mouseDownEvent.signature = SIGNATURE; - - this.mouseUpEvent = this.createEvent(EVENT_TYPES.MOUSE_UP); - this.mouseUpEvent.signature = SIGNATURE; - - this.clickEvent = this.createEvent(EVENT_TYPES.CLICK); - this.clickEvent.signature = SIGNATURE; - - this.keyPressEvent = this.createEvent(EVENT_TYPES.KEY_PRESS); - this.keyPressEvent.signature = SIGNATURE; - - this.keyDownEvent = this.createEvent(EVENT_TYPES.KEY_DOWN); - this.keyDownEvent.signature = SIGNATURE; - - this.keyUpEvent = this.createEvent(EVENT_TYPES.KEY_UP); - this.keyUpEvent.signature = SIGNATURE; - - this.focusEvent = this.createEvent(EVENT_TYPES.FOCUS); - this.focusEvent.signature = SIGNATURE; - - this.blurEvent = this.createEvent(EVENT_TYPES.BLUR); - this.blurEvent.signature = SIGNATURE; - - this.itemAddedEvent = this.createEvent(EVENT_TYPES.ITEM_ADDED); - this.itemAddedEvent.signature = SIGNATURE; - - this.itemRemovedEvent = this.createEvent(EVENT_TYPES.ITEM_REMOVED); - this.itemRemovedEvent.signature = SIGNATURE; - -}, - - -/** -* @method positionOffScreen -* @description Positions the menu outside of the boundaries of the browser's -* viewport. Called automatically when a menu is hidden to ensure that -* it doesn't force the browser to render uncessary scrollbars. -*/ -positionOffScreen: function () { - - var oIFrame = this.iframe, - aPos = this.OFF_SCREEN_POSITION; - - Dom.setXY(this.element, aPos); - - if (oIFrame) { - - Dom.setXY(oIFrame, aPos); - - } - -}, - - -/** -* @method getRoot -* @description Finds the menu's root menu. -*/ -getRoot: function () { - - var oItem = this.parent, - oParentMenu; - - if (oItem) { - - oParentMenu = oItem.parent; - - return oParentMenu ? oParentMenu.getRoot() : this; - - } - else { - - return this; - - } - -}, - - -/** -* @method toString -* @description Returns a string representing the menu. -* @return {String} -*/ -toString: function () { - - var sReturnVal = "Menu", - sId = this.id; - - if (sId) { - - sReturnVal += (" " + sId); - - } - - return sReturnVal; - -}, - - -/** -* @method setItemGroupTitle -* @description Sets the title of a group of menu items. -* @param {String} p_sGroupTitle String specifying the title of the group. -* @param {Number} p_nGroupIndex Optional. Number specifying the group to which -* the title belongs. -*/ -setItemGroupTitle: function (p_sGroupTitle, p_nGroupIndex) { - - var nGroupIndex, - oTitle, - i, - nFirstIndex; - - if (typeof p_sGroupTitle == "string" && p_sGroupTitle.length > 0) { - - nGroupIndex = typeof p_nGroupIndex == "number" ? p_nGroupIndex : 0; - oTitle = this._aGroupTitleElements[nGroupIndex]; - - - if (oTitle) { - - oTitle.innerHTML = p_sGroupTitle; - - } - else { - - oTitle = document.createElement(this.GROUP_TITLE_TAG_NAME); - - oTitle.innerHTML = p_sGroupTitle; - - this._aGroupTitleElements[nGroupIndex] = oTitle; - - } - - - i = this._aGroupTitleElements.length - 1; - - do { - - if (this._aGroupTitleElements[i]) { - - Dom.removeClass(this._aGroupTitleElements[i], "first-of-type"); - - nFirstIndex = i; - - } - - } - while(i--); - - - if (nFirstIndex !== null) { - - Dom.addClass(this._aGroupTitleElements[nFirstIndex], - "first-of-type"); - - } - - this.changeContentEvent.fire(); - - } - -}, - - - -/** -* @method addItem -* @description Appends an item to the menu. -* @param {YAHOO.widget.MenuItem} p_oItem Object reference for the MenuItem -* instance to be added to the menu. -* @param {String} p_oItem String specifying the text of the item to be added -* to the menu. -* @param {Object} p_oItem Object literal containing a set of menu item -* configuration properties. -* @param {Number} p_nGroupIndex Optional. Number indicating the group to -* which the item belongs. -* @return {YAHOO.widget.MenuItem} -*/ -addItem: function (p_oItem, p_nGroupIndex) { - - if (p_oItem) { - - return this._addItemToGroup(p_nGroupIndex, p_oItem); - - } - -}, - - -/** -* @method addItems -* @description Adds an array of items to the menu. -* @param {Array} p_aItems Array of items to be added to the menu. The array -* can contain strings specifying the text for each item to be created, object -* literals specifying each of the menu item configuration properties, -* or MenuItem instances. -* @param {Number} p_nGroupIndex Optional. Number specifying the group to -* which the items belongs. -* @return {Array} -*/ -addItems: function (p_aItems, p_nGroupIndex) { - - var nItems, - aItems, - oItem, - i; - - if (Lang.isArray(p_aItems)) { - - nItems = p_aItems.length; - aItems = []; - - for(i=0; i 0) { - - aSubmenus = []; - - for(i=0; i 0) { - - i = nItems - 1; - - do { - - oItem = aItems[i]; - - if (oItem) { - - oSubmenu = oItem.cfg.getProperty("submenu"); - - if (oSubmenu) { - - this.cfg.configChangedEvent.unsubscribe( - this._onParentMenuConfigChange, oSubmenu); - - this.renderEvent.unsubscribe(this._onParentMenuRender, - oSubmenu); - - } - - this.removeItem(oItem); - - } - - } - while(i--); - - } - - - if (oHeader) { - - Event.purgeElement(oHeader); - oElement.removeChild(oHeader); - - } - - - if (oFooter) { - - Event.purgeElement(oFooter); - oElement.removeChild(oFooter); - } - - - if (oBody) { - - Event.purgeElement(oBody); - - oBody.innerHTML = ""; - - } - - this.activeItem = null; - - this._aItemGroups = []; - this._aListElements = []; - this._aGroupTitleElements = []; - - this.cfg.setProperty("width", null); - -}, - - -/** -* @method destroy -* @description Removes the menu's <div> element -* (and accompanying child nodes) from the document. -*/ -destroy: function () { - - // Remove all items - - this.clearContent(); - - this._aItemGroups = null; - this._aListElements = null; - this._aGroupTitleElements = null; - - - // Continue with the superclass implementation of this method - - Menu.superclass.destroy.call(this); - - -}, - - -/** -* @method setInitialFocus -* @description Sets focus to the menu's first enabled item. -*/ -setInitialFocus: function () { - - var oItem = this._getFirstEnabledItem(); - - if (oItem) { - - oItem.focus(); - - } - -}, - - -/** -* @method setInitialSelection -* @description Sets the "selected" configuration property of the menu's first -* enabled item to "true." -*/ -setInitialSelection: function () { - - var oItem = this._getFirstEnabledItem(); - - if (oItem) { - - oItem.cfg.setProperty("selected", true); - } - -}, - - -/** -* @method clearActiveItem -* @description Sets the "selected" configuration property of the menu's active -* item to "false" and hides the item's submenu. -* @param {Boolean} p_bBlur Boolean indicating if the menu's active item -* should be blurred. -*/ -clearActiveItem: function (p_bBlur) { - - if (this.cfg.getProperty("showdelay") > 0) { - - this._cancelShowDelay(); - - } - - - var oActiveItem = this.activeItem, - oConfig, - oSubmenu; - - if (oActiveItem) { - - oConfig = oActiveItem.cfg; - - if (p_bBlur) { - - oActiveItem.blur(); - - } - - oConfig.setProperty("selected", false); - - oSubmenu = oConfig.getProperty("submenu"); - - if (oSubmenu) { - - oSubmenu.hide(); - - } - - this.activeItem = null; - - } - -}, - - -/** -* @method focus -* @description Causes the menu to receive focus and fires the "focus" event. -*/ -focus: function () { - - if (!this.hasFocus()) { - - this.setInitialFocus(); - - } - -}, - - -/** -* @method blur -* @description Causes the menu to lose focus and fires the "blur" event. -*/ -blur: function () { - - var oItem; - - if (this.hasFocus()) { - - oItem = MenuManager.getFocusedMenuItem(); - - if (oItem) { - - oItem.blur(); - - } - - } - -}, - - -/** -* @method hasFocus -* @description Returns a boolean indicating whether or not the menu has focus. -* @return {Boolean} -*/ -hasFocus: function () { - - return (MenuManager.getFocusedMenu() == this.getRoot()); - -}, - - -/** -* Adds the specified CustomEvent subscriber to the menu and each of -* its submenus. -* @method subscribe -* @param p_type {string} the type, or name of the event -* @param p_fn {function} the function to exectute when the event fires -* @param p_obj {Object} An object to be passed along when the event -* fires -* @param p_override {boolean} If true, the obj passed in becomes the -* execution scope of the listener -*/ -subscribe: function () { - - function onItemAdded(p_sType, p_aArgs, p_oObject) { - - var oItem = p_aArgs[0], - oSubmenu = oItem.cfg.getProperty("submenu"); - - if (oSubmenu) { - - oSubmenu.subscribe.apply(oSubmenu, p_oObject); - - } - - } - - - function onSubmenuAdded(p_sType, p_aArgs, p_oObject) { - - var oSubmenu = this.cfg.getProperty("submenu"); - - if (oSubmenu) { - - oSubmenu.subscribe.apply(oSubmenu, p_oObject); - - } - - } - - - Menu.superclass.subscribe.apply(this, arguments); - Menu.superclass.subscribe.call(this, "itemAdded", onItemAdded, arguments); - - - var aItems = this.getItems(), - nItems, - oItem, - oSubmenu, - i; - - - if (aItems) { - - nItems = aItems.length; - - if (nItems > 0) { - - i = nItems - 1; - - do { - - oItem = aItems[i]; - - oSubmenu = oItem.cfg.getProperty("submenu"); - - if (oSubmenu) { - - oSubmenu.subscribe.apply(oSubmenu, arguments); - - } - else { - - oItem.cfg.subscribeToConfigEvent("submenu", onSubmenuAdded, arguments); - - } - - } - while (i--); - - } - - } - -}, - - -/** -* @description Initializes the class's configurable properties which can be -* changed using the menu's Config object ("cfg"). -* @method initDefaultConfig -*/ -initDefaultConfig: function () { - - Menu.superclass.initDefaultConfig.call(this); - - var oConfig = this.cfg; - - - // Module documentation overrides - - /** - * @config effect - * @description Object or array of objects representing the ContainerEffect - * classes that are active for animating the container. When set this - * property is automatically applied to all submenus. - * @type Object - * @default null - */ - - // Overlay documentation overrides - - - /** - * @config x - * @description Number representing the absolute x-coordinate position of - * the Menu. This property is only applied when the "position" - * configuration property is set to dynamic. - * @type Number - * @default null - */ - - - /** - * @config y - * @description Number representing the absolute y-coordinate position of - * the Menu. This property is only applied when the "position" - * configuration property is set to dynamic. - * @type Number - * @default null - */ - - - /** - * @description Array of the absolute x and y positions of the Menu. This - * property is only applied when the "position" configuration property is - * set to dynamic. - * @config xy - * @type Number[] - * @default null - */ - - - /** - * @config context - * @description Array of context arguments for context-sensitive positioning. - * The format is: [id or element, element corner, context corner]. - * For example, setting this property to ["img1", "tl", "bl"] would - * align the Mnu's top left corner to the context element's - * bottom left corner. This property is only applied when the "position" - * configuration property is set to dynamic. - * @type Array - * @default null - */ - - - /** - * @config fixedcenter - * @description Boolean indicating if the Menu should be anchored to the - * center of the viewport. This property is only applied when the - * "position" configuration property is set to dynamic. - * @type Boolean - * @default false - */ - - - /** - * @config zindex - * @description Number representing the CSS z-index of the Menu. This - * property is only applied when the "position" configuration property is - * set to dynamic. - * @type Number - * @default null - */ - - - /** - * @config iframe - * @description Boolean indicating whether or not the Menu should - * have an IFRAME shim; used to prevent SELECT elements from - * poking through an Overlay instance in IE6. When set to "true", - * the iframe shim is created when the Menu instance is intially - * made visible. This property is only applied when the "position" - * configuration property is set to dynamic and is automatically applied - * to all submenus. - * @type Boolean - * @default true for IE6 and below, false for all other browsers. - */ - - - // Add configuration attributes - - /* - Change the default value for the "visible" configuration - property to "false" by re-adding the property. - */ - - /** - * @config visible - * @description Boolean indicating whether or not the menu is visible. If - * the menu's "position" configuration property is set to "dynamic" (the - * default), this property toggles the menu's <div> - * element's "visibility" style property between "visible" (true) or - * "hidden" (false). If the menu's "position" configuration property is - * set to "static" this property toggles the menu's - * <div> element's "display" style property - * between "block" (true) or "none" (false). - * @default false - * @type Boolean - */ - oConfig.addProperty( - DEFAULT_CONFIG.VISIBLE.key, - { - handler: this.configVisible, - value: DEFAULT_CONFIG.VISIBLE.value, - validator: DEFAULT_CONFIG.VISIBLE.validator - } - ); - - - /* - Change the default value for the "constraintoviewport" configuration - property to "true" by re-adding the property. - */ - - /** - * @config constraintoviewport - * @description Boolean indicating if the menu will try to remain inside - * the boundaries of the size of viewport. This property is only applied - * when the "position" configuration property is set to dynamic and is - * automatically applied to all submenus. - * @default true - * @type Boolean - */ - oConfig.addProperty( - DEFAULT_CONFIG.CONSTRAIN_TO_VIEWPORT.key, - { - handler: this.configConstrainToViewport, - value: DEFAULT_CONFIG.CONSTRAIN_TO_VIEWPORT.value, - validator: DEFAULT_CONFIG.CONSTRAIN_TO_VIEWPORT.validator, - supercedes: DEFAULT_CONFIG.CONSTRAIN_TO_VIEWPORT.supercedes - } - ); - - - /** - * @config position - * @description String indicating how a menu should be positioned on the - * screen. Possible values are "static" and "dynamic." Static menus are - * visible by default and reside in the normal flow of the document - * (CSS position: static). Dynamic menus are hidden by default, reside - * out of the normal flow of the document (CSS position: absolute), and - * can overlay other elements on the screen. - * @default dynamic - * @type String - */ - oConfig.addProperty( - DEFAULT_CONFIG.POSITION.key, - { - handler: this.configPosition, - value: DEFAULT_CONFIG.POSITION.value, - validator: DEFAULT_CONFIG.POSITION.validator, - supercedes: DEFAULT_CONFIG.POSITION.supercedes - } - ); - - - /** - * @config submenualignment - * @description Array defining how submenus should be aligned to their - * parent menu item. The format is: [itemCorner, submenuCorner]. By default - * a submenu's top left corner is aligned to its parent menu item's top - * right corner. - * @default ["tl","tr"] - * @type Array - */ - oConfig.addProperty( - DEFAULT_CONFIG.SUBMENU_ALIGNMENT.key, - { - value: DEFAULT_CONFIG.SUBMENU_ALIGNMENT.value, - suppressEvent: DEFAULT_CONFIG.SUBMENU_ALIGNMENT.suppressEvent - } - ); - - - /** - * @config autosubmenudisplay - * @description Boolean indicating if submenus are automatically made - * visible when the user mouses over the menu's items. - * @default true - * @type Boolean - */ - oConfig.addProperty( - DEFAULT_CONFIG.AUTO_SUBMENU_DISPLAY.key, - { - value: DEFAULT_CONFIG.AUTO_SUBMENU_DISPLAY.value, - validator: DEFAULT_CONFIG.AUTO_SUBMENU_DISPLAY.validator, - suppressEvent: DEFAULT_CONFIG.AUTO_SUBMENU_DISPLAY.suppressEvent - } - ); - - - /** - * @config showdelay - * @description Number indicating the time (in milliseconds) that should - * expire before a submenu is made visible when the user mouses over - * the menu's items. This property is only applied when the "position" - * configuration property is set to dynamic and is automatically applied - * to all submenus. - * @default 250 - * @type Number - */ - oConfig.addProperty( - DEFAULT_CONFIG.SHOW_DELAY.key, - { - value: DEFAULT_CONFIG.SHOW_DELAY.value, - validator: DEFAULT_CONFIG.SHOW_DELAY.validator, - suppressEvent: DEFAULT_CONFIG.SHOW_DELAY.suppressEvent - } - ); - - - /** - * @config hidedelay - * @description Number indicating the time (in milliseconds) that should - * expire before the menu is hidden. This property is only applied when - * the "position" configuration property is set to dynamic and is - * automatically applied to all submenus. - * @default 0 - * @type Number - */ - oConfig.addProperty( - DEFAULT_CONFIG.HIDE_DELAY.key, - { - handler: this.configHideDelay, - value: DEFAULT_CONFIG.HIDE_DELAY.value, - validator: DEFAULT_CONFIG.HIDE_DELAY.validator, - suppressEvent: DEFAULT_CONFIG.HIDE_DELAY.suppressEvent - } - ); - - - /** - * @config submenuhidedelay - * @description Number indicating the time (in milliseconds) that should - * expire before a submenu is hidden when the user mouses out of a menu item - * heading in the direction of a submenu. The value must be greater than or - * equal to the value specified for the "showdelay" configuration property. - * This property is only applied when the "position" configuration property - * is set to dynamic and is automatically applied to all submenus. - * @default 250 - * @type Number - */ - oConfig.addProperty( - DEFAULT_CONFIG.SUBMENU_HIDE_DELAY.key, - { - value: DEFAULT_CONFIG.SUBMENU_HIDE_DELAY.value, - validator: DEFAULT_CONFIG.SUBMENU_HIDE_DELAY.validator, - suppressEvent: DEFAULT_CONFIG.SUBMENU_HIDE_DELAY.suppressEvent - } - ); - - - /** - * @config clicktohide - * @description Boolean indicating if the menu will automatically be - * hidden if the user clicks outside of it. This property is only - * applied when the "position" configuration property is set to dynamic - * and is automatically applied to all submenus. - * @default true - * @type Boolean - */ - oConfig.addProperty( - DEFAULT_CONFIG.CLICK_TO_HIDE.key, - { - value: DEFAULT_CONFIG.CLICK_TO_HIDE.value, - validator: DEFAULT_CONFIG.CLICK_TO_HIDE.validator, - suppressEvent: DEFAULT_CONFIG.CLICK_TO_HIDE.suppressEvent - } - ); - - - /** - * @config container - * @description HTML element reference or string specifying the id - * attribute of the HTML element that the menu's markup should be - * rendered into. - * @type HTMLElement|String - * @default document.body - */ - oConfig.addProperty( - DEFAULT_CONFIG.CONTAINER.key, - { - handler: this.configContainer, - value: document.body, - suppressEvent: DEFAULT_CONFIG.CONTAINER.suppressEvent - } - ); - - - /** - * @config scrollincrement - * @description Number used to control the scroll speed of a menu. Used to - * increment the "scrollTop" property of the menu's body by when a menu's - * content is scrolling. When set this property is automatically applied - * to all submenus. - * @default 1 - * @type Number - */ - oConfig.addProperty( - DEFAULT_CONFIG.SCROLL_INCREMENT.key, - { - value: DEFAULT_CONFIG.SCROLL_INCREMENT.value, - validator: DEFAULT_CONFIG.SCROLL_INCREMENT.validator, - supercedes: DEFAULT_CONFIG.SCROLL_INCREMENT.supercedes, - suppressEvent: DEFAULT_CONFIG.SCROLL_INCREMENT.suppressEvent - } - ); - - - /** - * @config minscrollheight - * @description Number defining the minimum threshold for the "maxheight" - * configuration property. When set this property is automatically applied - * to all submenus. - * @default 90 - * @type Number - */ - oConfig.addProperty( - DEFAULT_CONFIG.MIN_SCROLL_HEIGHT.key, - { - value: DEFAULT_CONFIG.MIN_SCROLL_HEIGHT.value, - validator: DEFAULT_CONFIG.MIN_SCROLL_HEIGHT.validator, - supercedes: DEFAULT_CONFIG.MIN_SCROLL_HEIGHT.supercedes, - suppressEvent: DEFAULT_CONFIG.MIN_SCROLL_HEIGHT.suppressEvent - } - ); - - - /** - * @config maxheight - * @description Number defining the maximum height (in pixels) for a menu's - * body element (<div class="bd"<). Once a menu's body - * exceeds this height, the contents of the body are scrolled to maintain - * this value. This value cannot be set lower than the value of the - * "minscrollheight" configuration property. - * @default 0 - * @type Number - */ - oConfig.addProperty( - DEFAULT_CONFIG.MAX_HEIGHT.key, - { - handler: this.configMaxHeight, - value: DEFAULT_CONFIG.MAX_HEIGHT.value, - validator: DEFAULT_CONFIG.MAX_HEIGHT.validator, - suppressEvent: DEFAULT_CONFIG.MAX_HEIGHT.suppressEvent, - supercedes: DEFAULT_CONFIG.MAX_HEIGHT.supercedes - } - ); - - - /** - * @config classname - * @description String representing the CSS class to be applied to the - * menu's root <div> element. The specified class(es) - * are appended in addition to the default class as specified by the menu's - * CSS_CLASS_NAME constant. When set this property is automatically - * applied to all submenus. - * @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, - supercedes: DEFAULT_CONFIG.CLASS_NAME.supercedes - } - ); - - - /** - * @config disabled - * @description Boolean indicating if the menu should be disabled. - * Disabling a menu disables each of its items. (Disabled menu items are - * dimmed and will not respond to user input or fire events.) Disabled - * menus have a corresponding "disabled" CSS class applied to their root - * <div> element. - * @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 - } - ); - -} - -}); // END YAHOO.lang.extend - -})(); - - - -(function () { - - -/** -* Creates an item for a menu. -* -* @param {String} p_oObject String specifying the text of the menu item. -* @param {HTMLLIElement} p_oObject Object specifying -* the <li> element of the menu item. -* @param {HTMLOptGroupElement} p_oObject Object -* specifying the <optgroup> element of the menu item. -* @param {HTMLOptionElement} p_oObject Object -* specifying the <option> 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); - - } - -}; - - -var Dom = YAHOO.util.Dom, - Module = YAHOO.widget.Module, - Menu = YAHOO.widget.Menu, - MenuItem = YAHOO.widget.MenuItem, - CustomEvent = YAHOO.util.CustomEvent, - Lang = YAHOO.lang, - - m_oMenuItemTemplate, - - /** - * Constant representing the name of the MenuItem's events - * @property EVENT_TYPES - * @private - * @final - * @type Object - */ - 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 DEFAULT_CONFIG - * @private - * @final - * @type Object - */ - DEFAULT_CONFIG = { - - "TEXT": { - key: "text", - value: "", - validator: Lang.isString, - suppressEvent: true - }, - - "HELP_TEXT": { - key: "helptext", - supercedes: ["text"], - suppressEvent: true - }, - - "URL": { - key: "url", - value: "#", - suppressEvent: true - }, - - "TARGET": { - key: "target", - suppressEvent: true - }, - - "EMPHASIS": { - key: "emphasis", - value: false, - validator: Lang.isBoolean, - suppressEvent: true, - supercedes: ["text"] - }, - - "STRONG_EMPHASIS": { - key: "strongemphasis", - value: false, - validator: Lang.isBoolean, - suppressEvent: true, - supercedes: ["text"] - }, - - "CHECKED": { - key: "checked", - value: false, - validator: Lang.isBoolean, - suppressEvent: true, - supercedes: ["disabled", "selected"] - }, - - "SUBMENU": { - key: "submenu", - suppressEvent: true, - supercedes: ["disabled", "selected"] - }, - - "DISABLED": { - key: "disabled", - value: false, - validator: Lang.isBoolean, - suppressEvent: true, - supercedes: ["text", "selected"] - }, - - "SELECTED": { - key: "selected", - value: false, - validator: Lang.isBoolean, - suppressEvent: true - }, - - "ONCLICK": { - key: "onclick", - suppressEvent: true - }, - - "CLASS_NAME": { - key: "classname", - value: null, - validator: Lang.isString, - suppressEvent: true - } - - }; - - -MenuItem.prototype = { - - /** - * @property CSS_CLASS_NAME - * @description String representing the CSS class(es) to be applied to the - * <li> element of the menu item. - * @default "yuimenuitem" - * @final - * @type String - */ - CSS_CLASS_NAME: "yuimenuitem", - - - /** - * @property CSS_LABEL_CLASS_NAME - * @description String representing the CSS class(es) to be applied to the - * menu item's <a> element. - * @default "yuimenuitemlabel" - * @final - * @type String - */ - CSS_LABEL_CLASS_NAME: "yuimenuitemlabel", - - - /** - * @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 - * <a> element. - * @default null - * @private - * @type HTMLAnchorElement - */ - _oAnchor: null, - - - /** - * @property _oHelpTextEM - * @description Object reference to the menu item's help text - * <em> element. - * @default null - * @private - * @type HTMLElement - */ - _oHelpTextEM: null, - - - /** - * @property _oSubmenu - * @description Object reference to the menu item's submenu. - * @default null - * @private - * @type YAHOO.widget.Menu - */ - _oSubmenu: 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: 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 - * <li> element. - * @default HTMLLIElement - * @type HTMLLIElement - */ - element: null, - - - /** - * @property srcElement - * @description Object reference to the HTML element (either - * <li>, <optgroup> or - * <option>) used create the menu item. - * @default HTMLLIElement|HTMLOptGroupElement|HTMLOptionElement - * @type HTMLLIElement| - * HTMLOptGroupElement|HTMLOptionElement - */ - srcElement: null, - - - /** - * @property value - * @description Object reference to the menu item's value. - * @default null - * @type Object - */ - value: null, - - - /** - * @property browser - * @deprecated Use YAHOO.env.ua - * @description String representing the browser. - * @type String - */ - browser: Module.prototype.browser, - - - /** - * @property id - * @description Id of the menu item's root <li> - * 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 <li> - * element is removed from its parent <ul> 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 {HTMLLIElement} p_oObject Object specifying - * the <li> element of the menu item. - * @param {HTMLOptGroupElement} p_oObject Object - * specifying the <optgroup> element of the menu item. - * @param {HTMLOptionElement} p_oObject Object - * specifying the <option> 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 SIGNATURE = CustomEvent.LIST, - oConfig = this.cfg, - sURL = "#", - oAnchor, - sTarget, - sText, - sId; - - - if (Lang.isString(p_oObject)) { - - this._createRootNodeStructure(); - - oConfig.queueProperty("text", p_oObject); - - } - else if (p_oObject && p_oObject.tagName) { - - switch(p_oObject.tagName.toUpperCase()) { - - case "OPTION": - - this._createRootNodeStructure(); - - oConfig.queueProperty("text", p_oObject.text); - oConfig.queueProperty("disabled", p_oObject.disabled); - - this.value = p_oObject.value; - - this.srcElement = p_oObject; - - break; - - case "OPTGROUP": - - this._createRootNodeStructure(); - - oConfig.queueProperty("text", p_oObject.label); - oConfig.queueProperty("disabled", p_oObject.disabled); - - this.srcElement = p_oObject; - - this._initSubTree(); - - break; - - case "LI": - - // Get the anchor node (if it exists) - - oAnchor = Dom.getFirstChild(p_oObject); - - - // Capture the "text" and/or the "URL" - - if (oAnchor) { - - sURL = oAnchor.getAttribute("href"); - sTarget = oAnchor.getAttribute("target"); - - sText = oAnchor.innerHTML; - - } - - this.srcElement = p_oObject; - this.element = p_oObject; - this._oAnchor = oAnchor; - - /* - 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); - - this._initSubTree(); - - break; - - } - - } - - - if (this.element) { - - sId = (this.srcElement || 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); - Dom.addClass(this._oAnchor, this.CSS_LABEL_CLASS_NAME); - - - // Create custom events - - this.mouseOverEvent = this.createEvent(EVENT_TYPES.MOUSE_OVER); - this.mouseOverEvent.signature = SIGNATURE; - - this.mouseOutEvent = this.createEvent(EVENT_TYPES.MOUSE_OUT); - this.mouseOutEvent.signature = SIGNATURE; - - this.mouseDownEvent = this.createEvent(EVENT_TYPES.MOUSE_DOWN); - this.mouseDownEvent.signature = SIGNATURE; - - this.mouseUpEvent = this.createEvent(EVENT_TYPES.MOUSE_UP); - this.mouseUpEvent.signature = SIGNATURE; - - this.clickEvent = this.createEvent(EVENT_TYPES.CLICK); - this.clickEvent.signature = SIGNATURE; - - this.keyPressEvent = this.createEvent(EVENT_TYPES.KEY_PRESS); - this.keyPressEvent.signature = SIGNATURE; - - this.keyDownEvent = this.createEvent(EVENT_TYPES.KEY_DOWN); - this.keyDownEvent.signature = SIGNATURE; - - this.keyUpEvent = this.createEvent(EVENT_TYPES.KEY_UP); - this.keyUpEvent.signature = SIGNATURE; - - this.focusEvent = this.createEvent(EVENT_TYPES.FOCUS); - this.focusEvent.signature = SIGNATURE; - - this.blurEvent = this.createEvent(EVENT_TYPES.BLUR); - this.blurEvent.signature = SIGNATURE; - - this.destroyEvent = this.createEvent(EVENT_TYPES.DESTROY); - this.destroyEvent.signature = SIGNATURE; - - if (p_oConfig) { - - oConfig.applyConfig(p_oConfig); - - } - - oConfig.fireQueue(); - - } - - }, - - - - // Private methods - - - /** - * @method _createRootNodeStructure - * @description Creates the core DOM structure for the menu item. - * @private - */ - _createRootNodeStructure: function () { - - var oElement, - oAnchor; - - if (!m_oMenuItemTemplate) { - - m_oMenuItemTemplate = document.createElement("li"); - m_oMenuItemTemplate.innerHTML = ""; - - } - - oElement = m_oMenuItemTemplate.cloneNode(true); - oElement.className = this.CSS_CLASS_NAME; - - oAnchor = oElement.firstChild; - oAnchor.className = this.CSS_LABEL_CLASS_NAME; - - this.element = oElement; - this._oAnchor = 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, - oNode, - aOptions, - nOptions, - oMenu, - n; - - - 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 { - - 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)); - - - nOptions = aOptions.length; - - if (nOptions > 0) { - - oMenu = new this.SUBMENU_TYPE(Dom.generateId()); - - oConfig.setProperty("submenu", oMenu); - - for(n=0; n" + sHelpText + ""; - - } - - - if (oConfig.getProperty("emphasis")) { - - sEmphasisStartTag = ""; - sEmphasisEndTag = ""; - - } - - - if (oConfig.getProperty("strongemphasis")) { - - sEmphasisStartTag = ""; - sEmphasisEndTag = ""; - - } - - - oAnchor.innerHTML = (sEmphasisStartTag + sText + - sEmphasisEndTag + sHelpTextHTML); - - } - - }, - - - /** - * @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) { - - this.cfg.refireEvent("text"); - - }, - - - /** - * @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 = "#"; - - } - - var oAnchor = this._oAnchor; - - if (YAHOO.env.ua.opera) { - - oAnchor.removeAttribute("href"); - - } - - 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], - oConfig = this.cfg; - - - if (bEmphasis && oConfig.getProperty("strongemphasis")) { - - oConfig.setProperty("strongemphasis", false); - - } - - - oConfig.refireEvent("text"); - - }, - - - /** - * @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], - oConfig = this.cfg; - - - if (bStrongEmphasis && oConfig.getProperty("emphasis")) { - - oConfig.setProperty("emphasis", false); - - } - - oConfig.refireEvent("text"); - - }, - - - /** - * @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], - oElement = this.element, - oAnchor = this._oAnchor, - oConfig = this.cfg, - sState = "-checked", - sClassName = this.CSS_CLASS_NAME + sState, - sLabelClassName = this.CSS_LABEL_CLASS_NAME + sState; - - - if (bChecked) { - - Dom.addClass(oElement, sClassName); - Dom.addClass(oAnchor, sLabelClassName); - - } - else { - - Dom.removeClass(oElement, sClassName); - Dom.removeClass(oAnchor, sLabelClassName); - - } - - - oConfig.refireEvent("text"); - - - if (oConfig.getProperty("disabled")) { - - oConfig.refireEvent("disabled"); - - } - - - if (oConfig.getProperty("selected")) { - - oConfig.refireEvent("selected"); - - } - - }, - - - - /** - * @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, - oSubmenu = oConfig.getProperty("submenu"), - bChecked = oConfig.getProperty("checked"), - oElement = this.element, - oAnchor = this._oAnchor, - sState = "-disabled", - sCheckedState = "-checked" + sState, - sSubmenuState = "-hassubmenu" + sState, - sClassName = this.CSS_CLASS_NAME + sState, - sLabelClassName = this.CSS_LABEL_CLASS_NAME + sState, - sCheckedClassName = this.CSS_CLASS_NAME + sCheckedState, - sLabelCheckedClassName = this.CSS_LABEL_CLASS_NAME + sCheckedState, - sSubmenuClassName = this.CSS_CLASS_NAME + sSubmenuState, - sLabelSubmenuClassName = this.CSS_LABEL_CLASS_NAME + sSubmenuState; - - - if (bDisabled) { - - if (oConfig.getProperty("selected")) { - - oConfig.setProperty("selected", false); - - } - - Dom.addClass(oElement, sClassName); - Dom.addClass(oAnchor, sLabelClassName); - - - if (oSubmenu) { - - Dom.addClass(oElement, sSubmenuClassName); - Dom.addClass(oAnchor, sLabelSubmenuClassName); - - } - - - if (bChecked) { - - Dom.addClass(oElement, sCheckedClassName); - Dom.addClass(oAnchor, sLabelCheckedClassName); - - } - - } - else { - - Dom.removeClass(oElement, sClassName); - Dom.removeClass(oAnchor, sLabelClassName); - - - if (oSubmenu) { - - Dom.removeClass(oElement, sSubmenuClassName); - Dom.removeClass(oAnchor, sLabelSubmenuClassName); - - } - - - if (bChecked) { - - Dom.removeClass(oElement, sCheckedClassName); - Dom.removeClass(oAnchor, sLabelCheckedClassName); - - } - - } - - }, - - - /** - * @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) { - - var oConfig = this.cfg, - bSelected = p_aArgs[0], - oElement = this.element, - oAnchor = this._oAnchor, - bChecked = oConfig.getProperty("checked"), - oSubmenu = oConfig.getProperty("submenu"), - sState = "-selected", - sCheckedState = "-checked" + sState, - sSubmenuState = "-hassubmenu" + sState, - sClassName = this.CSS_CLASS_NAME + sState, - sLabelClassName = this.CSS_LABEL_CLASS_NAME + sState, - sCheckedClassName = this.CSS_CLASS_NAME + sCheckedState, - sLabelCheckedClassName = this.CSS_LABEL_CLASS_NAME + sCheckedState, - sSubmenuClassName = this.CSS_CLASS_NAME + sSubmenuState, - sLabelSubmenuClassName = this.CSS_LABEL_CLASS_NAME + sSubmenuState; - - - if (YAHOO.env.ua.opera) { - - oAnchor.blur(); - - } - - - if (bSelected && !oConfig.getProperty("disabled")) { - - Dom.addClass(oElement, sClassName); - Dom.addClass(oAnchor, sLabelClassName); - - - if (oSubmenu) { - - Dom.addClass(oElement, sSubmenuClassName); - Dom.addClass(oAnchor, sLabelSubmenuClassName); - - } - - - if (bChecked) { - - Dom.addClass(oElement, sCheckedClassName); - Dom.addClass(oAnchor, sLabelCheckedClassName); - - } - - } - else { - - Dom.removeClass(oElement, sClassName); - Dom.removeClass(oAnchor, sLabelClassName); - - - if (oSubmenu) { - - Dom.removeClass(oElement, sSubmenuClassName); - Dom.removeClass(oAnchor, sLabelSubmenuClassName); - - } - - - if (bChecked) { - - Dom.removeClass(oElement, sCheckedClassName); - Dom.removeClass(oAnchor, sLabelCheckedClassName); - - } - - } - - - if (this.hasFocus() && YAHOO.env.ua.opera) { - - oAnchor.focus(); - - } - - }, - - - /** - * @method _onSubmenuBeforeHide - * @description "beforehide" Custom Event handler for a submenu. - * @private - * @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. - */ - _onSubmenuBeforeHide: function (p_sType, p_aArgs) { - - var oItem = this.parent, - oMenu; - - function onHide() { - - oItem._oAnchor.blur(); - oMenu.beforeHideEvent.unsubscribe(onHide); - - } - - - if (oItem.hasFocus()) { - - oMenu = oItem.parent; - - oMenu.beforeHideEvent.subscribe(onHide); - - } - - }, - - - /** - * @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 oSubmenu = p_aArgs[0], - oConfig = this.cfg, - oElement = this.element, - oAnchor = this._oAnchor, - bLazyLoad = this.parent && this.parent.lazyLoad, - sState = "-hassubmenu", - sClassName = this.CSS_CLASS_NAME + sState, - sLabelClassName = this.CSS_LABEL_CLASS_NAME + sState, - oMenu, - sSubmenuId, - oSubmenuConfig; - - - if (oSubmenu) { - - if (oSubmenu instanceof Menu) { - - oMenu = oSubmenu; - oMenu.parent = this; - oMenu.lazyLoad = bLazyLoad; - - } - else if (typeof oSubmenu == "object" && oSubmenu.id && - !oSubmenu.nodeType) { - - 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 - - oConfig.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 - - oConfig.setProperty("submenu", oMenu, true); - - } - - - if (oMenu) { - - Dom.addClass(oElement, sClassName); - Dom.addClass(oAnchor, sLabelClassName); - - this._oSubmenu = oMenu; - - if (YAHOO.env.ua.opera) { - - oMenu.beforeHideEvent.subscribe(this._onSubmenuBeforeHide); - - } - - } - - } - else { - - Dom.removeClass(oElement, sClassName); - Dom.removeClass(oAnchor, sLabelClassName); - - if (this._oSubmenu) { - - this._oSubmenu.destroy(); - - } - - } - - - if (oConfig.getProperty("disabled")) { - - oConfig.refireEvent("disabled"); - - } - - - if (oConfig.getProperty("selected")) { - - oConfig.refireEvent("selected"); - - } - - }, - - - /** - * @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, - ((!YAHOO.lang.isUndefined(oObject.obj)) ? 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; - - - // 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 menu item. - * @deprecated Use "text" configuration property to add help text markup. - * For example: oMenuItem.cfg.setProperty("text", "Copy <em - * class=\"helptext\">Ctrl + C</em>"); - * @default null - * @type String| - * HTMLElement - */ - oConfig.addProperty( - DEFAULT_CONFIG.HELP_TEXT.key, - { - handler: this.configHelpText, - supercedes: DEFAULT_CONFIG.HELP_TEXT.supercedes, - suppressEvent: DEFAULT_CONFIG.HELP_TEXT.suppressEvent - } - ); - - - /** - * @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. 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. - * 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. - * @deprecated Use "text" configuration property to add emphasis. - * For example: oMenuItem.cfg.setProperty("text", "<em>Some - * Text</em>"); - * @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, - supercedes: DEFAULT_CONFIG.EMPHASIS.supercedes - } - ); - - - /** - * @config strongemphasis - * @description Boolean indicating if the text of the menu item will be - * rendered with strong emphasis. - * @deprecated Use "text" configuration property to add strong emphasis. - * For example: oMenuItem.cfg.setProperty("text", "<strong> - * Some Text</strong>"); - * @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, - supercedes: DEFAULT_CONFIG.STRONG_EMPHASIS.supercedes - } - ); - - - /** - * @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:
Object - * specifying a Menu instance.
Object literal specifying the - * menu to be created. Format: { id: [menu id], itemdata: - * [array of values for - * items] }.
String specifying the id attribute - * of the <div> element of the menu.
- * Object specifying the <div> element of the - * menu.
- * @default null - * @type Menu|String|Object| - * HTMLElement - */ - oConfig.addProperty( - DEFAULT_CONFIG.SUBMENU.key, - { - handler: this.configSubmenu, - supercedes: DEFAULT_CONFIG.SUBMENU.supercedes, - suppressEvent: DEFAULT_CONFIG.SUBMENU.suppressEvent - } - ); - - - /** - * @config onclick - * @description Object literal representing the code to be executed when - * the item is clicked. Format:
{ - * fn: Function, // The handler to call when - * the event fires. obj: Object, // An - * object to pass back to the handler. scope: - * Object // The object to use for the scope of the handler. - * } - * @type Object - * @default null - */ - oConfig.addProperty( - DEFAULT_CONFIG.ONCLICK.key, - { - handler: this.configOnClick, - suppressEvent: DEFAULT_CONFIG.ONCLICK.suppressEvent - } - ); - - - /** - * @config classname - * @description CSS class to be applied to the menu item's root - * <li> 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, - suppressEvent: DEFAULT_CONFIG.CLASS_NAME.suppressEvent - } - ); - - }, - - - /** - * @method getNextEnabledSibling - * @description Finds the menu item's next enabled sibling. - * @return YAHOO.widget.MenuItem - */ - getNextEnabledSibling: function () { - - var nGroupIndex, - aItemGroups, - oNextItem, - nNextGroupIndex, - aNextGroup; - - function getNextArrayItem(p_aArray, p_nStartIndex) { - - return p_aArray[p_nStartIndex] || - getNextArrayItem(p_aArray, (p_nStartIndex+1)); - - } - - if (this.parent instanceof Menu) { - - nGroupIndex = this.groupIndex; - - aItemGroups = this.parent.getItemGroups(); - - if (this.index < (aItemGroups[nGroupIndex].length - 1)) { - - oNextItem = getNextArrayItem(aItemGroups[nGroupIndex], - (this.index+1)); - - } - else { - - if (nGroupIndex < (aItemGroups.length - 1)) { - - nNextGroupIndex = nGroupIndex + 1; - - } - else { - - nNextGroupIndex = 0; - - } - - 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 () { - - var nGroupIndex, - aItemGroups, - oPreviousItem, - nPreviousGroupIndex, - aPreviousGroup; - - 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)); - - } - - if (this.parent instanceof Menu) { - - nGroupIndex = this.groupIndex; - aItemGroups = this.parent.getItemGroups(); - - - if (this.index > getFirstItemIndex(aItemGroups[nGroupIndex], 0)) { - - oPreviousItem = getPreviousArrayItem(aItemGroups[nGroupIndex], - (this.index-1)); - - } - else { - - if (nGroupIndex > getFirstItemIndex(aItemGroups, 0)) { - - nPreviousGroupIndex = nGroupIndex - 1; - - } - else { - - nPreviousGroupIndex = aItemGroups.length - 1; - - } - - 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 (YAHOO.env.ua.ie && !document.hasFocus()) { - - return; - - } - - if (oActiveItem) { - - oActiveItem.blurEvent.fire(); - - } - - oAnchor.focus(); - - me.focusEvent.fire(); - - } - catch(e) { - - } - - } - - - if (!this.cfg.getProperty("disabled") && oParent && - oParent.cfg.getProperty("visible") && - this.element.style.display != "none") { - - - /* - 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); - - } - - }, - - - /** - * @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 && - oParent.cfg.getProperty("visible")) { - - - var me = this; - - window.setTimeout(function () { - - try { - - me._oAnchor.blur(); - me.blurEvent.fire(); - - } - catch (e) { - - } - - }, 0); - - } - - }, - - - /** - * @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 <li> element - * from its parent <ul> element. - */ - destroy: function () { - - var oEl = this.element, - oSubmenu, - oParentNode; - - if (oEl) { - - - // If the item has a submenu, destroy it first - - 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 - - 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", - sId = this.id; - - if (sId) { - - sReturnVal += (" " + sId); - - } - - return sReturnVal; - - } - -}; - -Lang.augmentProto(MenuItem, YAHOO.util.EventProvider); - -})(); -(function () { - - -/** -* Creates a list of options or commands which are made visible in response to -* an HTML element's "contextmenu" event ("mousedown" for Opera). -* -* @param {String} p_oElement String specifying the id attribute of the -* <div> element of the context menu. -* @param {String} p_oElement String specifying the id attribute of the -* <select> element to be used as the data source for the -* context menu. -* @param {HTMLDivElement} p_oElement Object specifying the -* <div> element of the context menu. -* @param {HTMLSelectElement} p_oElement Object specifying -* the <select> element to be used as the data source for -* the context menu. -* @param {Object} p_oConfig Optional. Object literal specifying the -* configuration for the context menu. See configuration class documentation -* for more details. -* @class ContextMenu -* @constructor -* @extends YAHOO.widget.Menu -* @namespace YAHOO.widget -*/ -YAHOO.widget.ContextMenu = function(p_oElement, p_oConfig) { - - YAHOO.widget.ContextMenu.superclass.constructor.call(this, - p_oElement, p_oConfig); - -}; - - -var Event = YAHOO.util.Event, - ContextMenu = YAHOO.widget.ContextMenu, - - - - /** - * Constant representing the name of the ContextMenu's events - * @property EVENT_TYPES - * @private - * @final - * @type Object - */ - EVENT_TYPES = { - - "TRIGGER_CONTEXT_MENU": "triggerContextMenu", - "CONTEXT_MENU": (YAHOO.env.ua.opera ? "mousedown" : "contextmenu"), - "CLICK": "click" - - }, - - - /** - * Constant representing the ContextMenu's configuration properties - * @property DEFAULT_CONFIG - * @private - * @final - * @type Object - */ - DEFAULT_CONFIG = { - - "TRIGGER": { - key: "trigger", - suppressEvent: true - } - - }; - - -/** -* @method position -* @description "beforeShow" event handler used to position the contextmenu. -* @private -* @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 {Array} p_aPos Array representing the xy position for the context menu. -*/ -function position(p_sType, p_aArgs, p_aPos) { - - this.cfg.setProperty("xy", p_aPos); - - this.beforeShowEvent.unsubscribe(position, p_aPos); - -} - - -YAHOO.lang.extend(ContextMenu, YAHOO.widget.Menu, { - - - -// Private properties - - -/** -* @property _oTrigger -* @description Object reference to the current value of the "trigger" -* configuration property. -* @default null -* @private -* @type String|HTMLElement|Array -*/ -_oTrigger: null, - - -/** -* @property _bCancelled -* @description Boolean indicating if the display of the context menu should -* be cancelled. -* @default false -* @private -* @type Boolean -*/ -_bCancelled: false, - - - -// Public properties - - -/** -* @property contextEventTarget -* @description Object reference for the HTML element that was the target of the -* "contextmenu" DOM event ("mousedown" for Opera) that triggered the display of -* the context menu. -* @default null -* @type HTMLElement -*/ -contextEventTarget: null, - - - -// Events - - -/** -* @event triggerContextMenuEvent -* @description Custom Event wrapper for the "contextmenu" DOM event -* ("mousedown" for Opera) fired by the element(s) that trigger the display of -* the context menu. -*/ -triggerContextMenuEvent: null, - - - -/** -* @method init -* @description The ContextMenu 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_oElement String specifying the id attribute of the -* <div> element of the context menu. -* @param {String} p_oElement String specifying the id attribute of the -* <select> element to be used as the data source for -* the context menu. -* @param {HTMLDivElement} p_oElement Object specifying the -* <div> element of the context menu. -* @param {HTMLSelectElement} p_oElement Object specifying -* the <select> element to be used as the data source for -* the context menu. -* @param {Object} p_oConfig Optional. Object literal specifying the -* configuration for the context menu. See configuration class documentation -* for more details. -*/ -init: function(p_oElement, p_oConfig) { - - - // Call the init of the superclass (YAHOO.widget.Menu) - - ContextMenu.superclass.init.call(this, p_oElement); - - - this.beforeInitEvent.fire(ContextMenu); - - - if(p_oConfig) { - - this.cfg.applyConfig(p_oConfig, true); - - } - - - this.initEvent.fire(ContextMenu); - -}, - - -/** -* @method initEvents -* @description Initializes the custom events for the context menu. -*/ -initEvents: function() { - - ContextMenu.superclass.initEvents.call(this); - - // Create custom events - - this.triggerContextMenuEvent = - this.createEvent(EVENT_TYPES.TRIGGER_CONTEXT_MENU); - - this.triggerContextMenuEvent.signature = YAHOO.util.CustomEvent.LIST; - -}, - - -/** -* @method cancel -* @description Cancels the display of the context menu. -*/ -cancel: function() { - - this._bCancelled = true; - -}, - - - -// Private methods - - -/** -* @method _removeEventHandlers -* @description Removes all of the DOM event handlers from the HTML element(s) -* whose "context menu" event ("click" for Opera) trigger the display of -* the context menu. -* @private -*/ -_removeEventHandlers: function() { - - var oTrigger = this._oTrigger; - - - // Remove the event handlers from the trigger(s) - - if (oTrigger) { - - Event.removeListener(oTrigger, EVENT_TYPES.CONTEXT_MENU, - this._onTriggerContextMenu); - - if(YAHOO.env.ua.opera) { - - Event.removeListener(oTrigger, EVENT_TYPES.CLICK, - this._onTriggerClick); - - } - - } - -}, - - - -// Private event handlers - - - -/** -* @method _onTriggerClick -* @description "click" event handler for the HTML element(s) identified as the -* "trigger" for the context menu. Used to cancel default behaviors in Opera. -* @private -* @param {Event} p_oEvent Object representing the DOM event object passed back -* by the event utility (YAHOO.util.Event). -* @param {YAHOO.widget.ContextMenu} p_oMenu Object representing the context -* menu that is handling the event. -*/ -_onTriggerClick: function(p_oEvent, p_oMenu) { - - if(p_oEvent.ctrlKey) { - - Event.stopEvent(p_oEvent); - - } - -}, - - -/** -* @method _onTriggerContextMenu -* @description "contextmenu" event handler ("mousedown" for Opera) for the HTML -* element(s) that trigger the display of the context menu. -* @private -* @param {Event} p_oEvent Object representing the DOM event object passed back -* by the event utility (YAHOO.util.Event). -* @param {YAHOO.widget.ContextMenu} p_oMenu Object representing the context -* menu that is handling the event. -*/ -_onTriggerContextMenu: function(p_oEvent, p_oMenu) { - - if (p_oEvent.type == "mousedown" && !p_oEvent.ctrlKey) { - - return; - - } - - - var aXY; - - - /* - Prevent the browser's default context menu from appearing and - stop the propagation of the "contextmenu" event so that - other ContextMenu instances are not displayed. - */ - - Event.stopEvent(p_oEvent); - - - this.contextEventTarget = Event.getTarget(p_oEvent); - - this.triggerContextMenuEvent.fire(p_oEvent); - - - // Hide any other Menu instances that might be visible - - YAHOO.widget.MenuManager.hideVisible(); - - - - if(!this._bCancelled) { - - // Position and display the context menu - - aXY = Event.getXY(p_oEvent); - - - if (!YAHOO.util.Dom.inDocument(this.element)) { - - this.beforeShowEvent.subscribe(position, aXY); - - } - else { - - this.cfg.setProperty("xy", aXY); - - } - - - this.show(); - - } - - this._bCancelled = false; - -}, - - - -// Public methods - - -/** -* @method toString -* @description Returns a string representing the context menu. -* @return {String} -*/ -toString: function() { - - var sReturnVal = "ContextMenu", - sId = this.id; - - if(sId) { - - sReturnVal += (" " + sId); - - } - - return sReturnVal; - -}, - - -/** -* @method initDefaultConfig -* @description Initializes the class's configurable properties which can be -* changed using the context menu's Config object ("cfg"). -*/ -initDefaultConfig: function() { - - ContextMenu.superclass.initDefaultConfig.call(this); - - /** - * @config trigger - * @description The HTML element(s) whose "contextmenu" event ("mousedown" - * for Opera) trigger the display of the context menu. Can be a string - * representing the id attribute of the HTML element, an object reference - * for the HTML element, or an array of strings or HTML element references. - * @default null - * @type String|HTMLElement|Array - */ - this.cfg.addProperty(DEFAULT_CONFIG.TRIGGER.key, - { - handler: this.configTrigger, - suppressEvent: DEFAULT_CONFIG.TRIGGER.suppressEvent - } - ); - -}, - - -/** -* @method destroy -* @description Removes the context menu's <div> element -* (and accompanying child nodes) from the document. -*/ -destroy: function() { - - // Remove the DOM event handlers from the current trigger(s) - - this._removeEventHandlers(); - - - // Continue with the superclass implementation of this method - - ContextMenu.superclass.destroy.call(this); - -}, - - - -// Public event handlers for configuration properties - - -/** -* @method configTrigger -* @description Event handler for when the value of the "trigger" configuration -* property 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.ContextMenu} p_oMenu Object representing the context -* menu that fired the event. -*/ -configTrigger: function(p_sType, p_aArgs, p_oMenu) { - - var oTrigger = p_aArgs[0]; - - if(oTrigger) { - - /* - If there is a current "trigger" - remove the event handlers - from that element(s) before assigning new ones - */ - - if(this._oTrigger) { - - this._removeEventHandlers(); - - } - - this._oTrigger = oTrigger; - - - /* - Listen for the "mousedown" event in Opera b/c it does not - support the "contextmenu" event - */ - - Event.on(oTrigger, EVENT_TYPES.CONTEXT_MENU, - this._onTriggerContextMenu, this, true); - - - /* - Assign a "click" event handler to the trigger element(s) for - Opera to prevent default browser behaviors. - */ - - if(YAHOO.env.ua.opera) { - - Event.on(oTrigger, EVENT_TYPES.CLICK, this._onTriggerClick, - this, true); - - } - - } - else { - - this._removeEventHandlers(); - - } - -} - -}); // END YAHOO.lang.extend - -}()); - - - -/** -* Creates an item for a context menu. -* -* @param {String} p_oObject String specifying the text of the context menu item. -* @param {HTMLLIElement} p_oObject Object specifying the -* <li> element of the context menu item. -* @param {HTMLOptGroupElement} p_oObject Object -* specifying the <optgroup> element of the context -* menu item. -* @param {HTMLOptionElement} p_oObject Object specifying -* the <option> element of the context menu item. -* @param {Object} p_oConfig Optional. Object literal specifying the -* configuration for the context menu item. See configuration class -* documentation for more details. -* @class ContextMenuItem -* @constructor -* @extends YAHOO.widget.MenuItem -* @deprecated As of version 2.4.0 items for YAHOO.widget.ContextMenu instances -* are of type YAHOO.widget.MenuItem. -*/ -YAHOO.widget.ContextMenuItem = YAHOO.widget.MenuItem; -(function () { - - -/** -* Horizontal collection of items, each of which can contain a submenu. -* -* @param {String} p_oElement String specifying the id attribute of the -* <div> element of the menu bar. -* @param {String} p_oElement String specifying the id attribute of the -* <select> element to be used as the data source for the -* menu bar. -* @param {HTMLDivElement} p_oElement Object specifying -* the <div> element of the menu bar. -* @param {HTMLSelectElement} p_oElement Object -* specifying the <select> element to be used as the data -* source for the menu bar. -* @param {Object} p_oConfig Optional. Object literal specifying the -* configuration for the menu bar. See configuration class documentation for -* more details. -* @class MenuBar -* @constructor -* @extends YAHOO.widget.Menu -* @namespace YAHOO.widget -*/ -YAHOO.widget.MenuBar = function(p_oElement, p_oConfig) { - - YAHOO.widget.MenuBar.superclass.constructor.call(this, - p_oElement, p_oConfig); - -}; - - -/** -* @method checkPosition -* @description Checks to make sure that the value of the "position" property -* is one of the supported strings. Returns true if the position is supported. -* @private -* @param {Object} p_sPosition String specifying the position of the menu. -* @return {Boolean} -*/ -function checkPosition(p_sPosition) { - - if (typeof p_sPosition == "string") { - - return ("dynamic,static".indexOf((p_sPosition.toLowerCase())) != -1); - - } - -} - - -var Event = YAHOO.util.Event, - MenuBar = YAHOO.widget.MenuBar, - - /** - * Constant representing the MenuBar's configuration properties - * @property DEFAULT_CONFIG - * @private - * @final - * @type Object - */ - DEFAULT_CONFIG = { - - "POSITION": { - key: "position", - value: "static", - validator: checkPosition, - supercedes: ["visible"] - }, - - "SUBMENU_ALIGNMENT": { - key: "submenualignment", - value: ["tl","bl"], - suppressEvent: true - }, - - "AUTO_SUBMENU_DISPLAY": { - key: "autosubmenudisplay", - value: false, - validator: YAHOO.lang.isBoolean, - suppressEvent: true - } - - }; - - - -YAHOO.lang.extend(MenuBar, YAHOO.widget.Menu, { - -/** -* @method init -* @description The MenuBar 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_oElement String specifying the id attribute of the -* <div> element of the menu bar. -* @param {String} p_oElement String specifying the id attribute of the -* <select> element to be used as the data source for the -* menu bar. -* @param {HTMLDivElement} p_oElement Object specifying -* the <div> element of the menu bar. -* @param {HTMLSelectElement} p_oElement Object -* specifying the <select> element to be used as the data -* source for the menu bar. -* @param {Object} p_oConfig Optional. Object literal specifying the -* configuration for the menu bar. See configuration class documentation for -* more details. -*/ -init: function(p_oElement, p_oConfig) { - - if(!this.ITEM_TYPE) { - - this.ITEM_TYPE = YAHOO.widget.MenuBarItem; - - } - - - // Call the init of the superclass (YAHOO.widget.Menu) - - MenuBar.superclass.init.call(this, p_oElement); - - - this.beforeInitEvent.fire(MenuBar); - - - if(p_oConfig) { - - this.cfg.applyConfig(p_oConfig, true); - - } - - this.initEvent.fire(MenuBar); - -}, - - - -// Constants - - -/** -* @property CSS_CLASS_NAME -* @description String representing the CSS class(es) to be applied to the menu -* bar's <div> element. -* @default "yuimenubar" -* @final -* @type String -*/ -CSS_CLASS_NAME: "yuimenubar", - - - -// Protected event handlers - - -/** -* @method _onKeyDown -* @description "keydown" Custom Event handler for the menu bar. -* @private -* @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.MenuBar} p_oMenuBar Object representing the menu bar -* that fired the event. -*/ -_onKeyDown: function(p_sType, p_aArgs, p_oMenuBar) { - - var oEvent = p_aArgs[0], - oItem = p_aArgs[1], - oSubmenu, - oItemCfg, - oNextItem; - - - if(oItem && !oItem.cfg.getProperty("disabled")) { - - oItemCfg = oItem.cfg; - - switch(oEvent.keyCode) { - - case 37: // Left arrow - case 39: // Right arrow - - if(oItem == this.activeItem && - !oItemCfg.getProperty("selected")) { - - oItemCfg.setProperty("selected", true); - - } - else { - - oNextItem = (oEvent.keyCode == 37) ? - oItem.getPreviousEnabledSibling() : - oItem.getNextEnabledSibling(); - - if(oNextItem) { - - this.clearActiveItem(); - - oNextItem.cfg.setProperty("selected", true); - - - if(this.cfg.getProperty("autosubmenudisplay")) { - - oSubmenu = oNextItem.cfg.getProperty("submenu"); - - if(oSubmenu) { - - oSubmenu.show(); - - } - - } - - oNextItem.focus(); - - } - - } - - Event.preventDefault(oEvent); - - break; - - case 40: // Down arrow - - if(this.activeItem != oItem) { - - this.clearActiveItem(); - - oItemCfg.setProperty("selected", true); - oItem.focus(); - - } - - oSubmenu = oItemCfg.getProperty("submenu"); - - if(oSubmenu) { - - if(oSubmenu.cfg.getProperty("visible")) { - - oSubmenu.setInitialSelection(); - oSubmenu.setInitialFocus(); - - } - else { - - oSubmenu.show(); - - } - - } - - Event.preventDefault(oEvent); - - break; - - } - - } - - - if(oEvent.keyCode == 27 && this.activeItem) { // Esc key - - oSubmenu = this.activeItem.cfg.getProperty("submenu"); - - if(oSubmenu && oSubmenu.cfg.getProperty("visible")) { - - oSubmenu.hide(); - this.activeItem.focus(); - - } - else { - - this.activeItem.cfg.setProperty("selected", false); - this.activeItem.blur(); - - } - - Event.preventDefault(oEvent); - - } - -}, - - -/** -* @method _onClick -* @description "click" event handler for the menu bar. -* @protected -* @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.MenuBar} p_oMenuBar Object representing the menu bar -* that fired the event. -*/ -_onClick: function(p_sType, p_aArgs, p_oMenuBar) { - - MenuBar.superclass._onClick.call(this, p_sType, p_aArgs, p_oMenuBar); - - var oItem = p_aArgs[1], - oEvent, - oTarget, - oActiveItem, - oConfig, - oSubmenu; - - - if(oItem && !oItem.cfg.getProperty("disabled")) { - - oEvent = p_aArgs[0]; - oTarget = Event.getTarget(oEvent); - oActiveItem = this.activeItem; - oConfig = this.cfg; - - - // Hide any other submenus that might be visible - - if(oActiveItem && oActiveItem != oItem) { - - this.clearActiveItem(); - - } - - - oItem.cfg.setProperty("selected", true); - - - // Show the submenu for the item - - oSubmenu = oItem.cfg.getProperty("submenu"); - - - if(oSubmenu) { - - if(oSubmenu.cfg.getProperty("visible")) { - - oSubmenu.hide(); - - } - else { - - oSubmenu.show(); - - } - - } - - } - -}, - - - -// Public methods - - -/** -* @method toString -* @description Returns a string representing the menu bar. -* @return {String} -*/ -toString: function() { - - var sReturnVal = "MenuBar", - sId = this.id; - - if(sId) { - - sReturnVal += (" " + sId); - - } - - return sReturnVal; - -}, - - -/** -* @description Initializes the class's configurable properties which can be -* changed using the menu bar's Config object ("cfg"). -* @method initDefaultConfig -*/ -initDefaultConfig: function() { - - MenuBar.superclass.initDefaultConfig.call(this); - - var oConfig = this.cfg; - - // Add configuration properties - - - /* - Set the default value for the "position" configuration property - to "static" by re-adding the property. - */ - - - /** - * @config position - * @description String indicating how a menu bar should be positioned on the - * screen. Possible values are "static" and "dynamic." Static menu bars - * are visible by default and reside in the normal flow of the document - * (CSS position: static). Dynamic menu bars are hidden by default, reside - * out of the normal flow of the document (CSS position: absolute), and can - * overlay other elements on the screen. - * @default static - * @type String - */ - oConfig.addProperty( - DEFAULT_CONFIG.POSITION.key, - { - handler: this.configPosition, - value: DEFAULT_CONFIG.POSITION.value, - validator: DEFAULT_CONFIG.POSITION.validator, - supercedes: DEFAULT_CONFIG.POSITION.supercedes - } - ); - - - /* - Set the default value for the "submenualignment" configuration property - to ["tl","bl"] by re-adding the property. - */ - - /** - * @config submenualignment - * @description Array defining how submenus should be aligned to their - * parent menu bar item. The format is: [itemCorner, submenuCorner]. - * @default ["tl","bl"] - * @type Array - */ - oConfig.addProperty( - DEFAULT_CONFIG.SUBMENU_ALIGNMENT.key, - { - value: DEFAULT_CONFIG.SUBMENU_ALIGNMENT.value, - suppressEvent: DEFAULT_CONFIG.SUBMENU_ALIGNMENT.suppressEvent - } - ); - - - /* - Change the default value for the "autosubmenudisplay" configuration - property to "false" by re-adding the property. - */ - - /** - * @config autosubmenudisplay - * @description Boolean indicating if submenus are automatically made - * visible when the user mouses over the menu bar's items. - * @default false - * @type Boolean - */ - oConfig.addProperty( - DEFAULT_CONFIG.AUTO_SUBMENU_DISPLAY.key, - { - value: DEFAULT_CONFIG.AUTO_SUBMENU_DISPLAY.value, - validator: DEFAULT_CONFIG.AUTO_SUBMENU_DISPLAY.validator, - suppressEvent: DEFAULT_CONFIG.AUTO_SUBMENU_DISPLAY.suppressEvent - } - ); - -} - -}); // END YAHOO.lang.extend - -}()); - - - -/** -* Creates an item for a menu bar. -* -* @param {String} p_oObject String specifying the text of the menu bar item. -* @param {HTMLLIElement} p_oObject Object specifying the -* <li> element of the menu bar item. -* @param {HTMLOptGroupElement} p_oObject Object -* specifying the <optgroup> element of the menu bar item. -* @param {HTMLOptionElement} p_oObject Object specifying -* the <option> element of the menu bar item. -* @param {Object} p_oConfig Optional. Object literal specifying the -* configuration for the menu bar item. See configuration class documentation -* for more details. -* @class MenuBarItem -* @constructor -* @extends YAHOO.widget.MenuItem -*/ -YAHOO.widget.MenuBarItem = function(p_oObject, p_oConfig) { - - YAHOO.widget.MenuBarItem.superclass.constructor.call(this, - p_oObject, p_oConfig); - -}; - -YAHOO.lang.extend(YAHOO.widget.MenuBarItem, YAHOO.widget.MenuItem, { - - - -/** -* @method init -* @description The MenuBarItem 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 bar item. -* @param {HTMLLIElement} p_oObject Object specifying the -* <li> element of the menu bar item. -* @param {HTMLOptGroupElement} p_oObject Object -* specifying the <optgroup> element of the menu bar item. -* @param {HTMLOptionElement} p_oObject Object specifying -* the <option> element of the menu bar item. -* @param {Object} p_oConfig Optional. Object literal specifying the -* configuration for the menu bar item. See configuration class documentation -* for more details. -*/ -init: function(p_oObject, p_oConfig) { - - if(!this.SUBMENU_TYPE) { - - this.SUBMENU_TYPE = YAHOO.widget.Menu; - - } - - - /* - Call the init of the superclass (YAHOO.widget.MenuItem) - Note: We don't pass the user config in here yet - because we only want it executed once, at the lowest - subclass level. - */ - - YAHOO.widget.MenuBarItem.superclass.init.call(this, p_oObject); - - - var oConfig = this.cfg; - - if(p_oConfig) { - - oConfig.applyConfig(p_oConfig, true); - - } - - oConfig.fireQueue(); - -}, - - - -// Constants - - -/** -* @property CSS_CLASS_NAME -* @description String representing the CSS class(es) to be applied to the -* <li> element of the menu bar item. -* @default "yuimenubaritem" -* @final -* @type String -*/ -CSS_CLASS_NAME: "yuimenubaritem", - - -/** -* @property CSS_LABEL_CLASS_NAME -* @description String representing the CSS class(es) to be applied to the -* menu bar item's <a> element. -* @default "yuimenubaritemlabel" -* @final -* @type String -*/ -CSS_LABEL_CLASS_NAME: "yuimenubaritemlabel", - - - -// Public methods - - -/** -* @method toString -* @description Returns a string representing the menu bar item. -* @return {String} -*/ -toString: function() { - - var sReturnVal = "MenuBarItem"; - - if(this.cfg && this.cfg.getProperty("text")) { - - sReturnVal += (": " + this.cfg.getProperty("text")); - - } - - return sReturnVal; - -} - -}); // END YAHOO.lang.extend -YAHOO.register("menu", YAHOO.widget.Menu, {version: "2.5.0", build: "895"}); diff --git a/lib/yui/reset/README b/lib/yui/reset/README deleted file mode 100755 index ba10a1a3b4..0000000000 --- a/lib/yui/reset/README +++ /dev/null @@ -1,45 +0,0 @@ -YUI Library - Reset - Release Notes - -Version 2.5.0 - - * Added input,textarea,select{*font-size:100%;} to enable resizing on IE - -Version 2.4.0 - - * Moved background and default font color to HTML from BODY - * Removed invalid sub/sup negative line-height values because they - were invalid and because they weren't have a big impact. - * Added legent element color to accomodate IE6 issues. - -Version 2.3.0 - - * Removed: ul,ol {list-style:none;} - * Added: li {list-style:none;} because it's less impactful (easier to rebuild) and shorter - * Added: acronym {font-variant:normal;} to reset the "small-caps" variant that Opera displays - * Added: body {color:#000;background:#FFF;} - * Added: sup,sub {line-height:-1px;vertical-align: text-top;}sub{vertical-align:text-bottom;} - * Added: input, textarea, select{font-family:inherit;font-size:inherit;font-weight:inherit;} (doesn't fix textareas in Opera/Win+Mac, IE6/7 - * Added: padding:0;margin:0; for the legend element which wasn't fully reset before (has 2px lateral padding on some browsers) - - -Version 2.2.0 - 2.2.2 - - * No changes. - -Version 0.12.1 - 0.12.2 - - * No changes. - -Version 0.12.0 - - * Added: h1,h2,h3,h4,h5,h6{font-weight:normal;} - * Added: abbr,acronym {border:0;} - * Added: textarea {padding:0;margin:0;} - -Version 0.11.0 - - * No changes. - -Version 0.10.0 - - * Initial release. \ No newline at end of file diff --git a/lib/yui/reset/reset-min.css b/lib/yui/reset/reset-min.css deleted file mode 100755 index e243f48852..0000000000 --- a/lib/yui/reset/reset-min.css +++ /dev/null @@ -1,7 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -html{color:#000;background:#FFF;}body,div,dl,dt,dd,ul,ol,li,h1,h2,h3,h4,h5,h6,pre,code,form,fieldset,legend,input,textarea,p,blockquote,th,td{margin:0;padding:0;}table{border-collapse:collapse;border-spacing:0;}fieldset,img{border:0;}address,caption,cite,code,dfn,em,strong,th,var{font-style:normal;font-weight:normal;}li{list-style:none;}caption,th{text-align:left;}h1,h2,h3,h4,h5,h6{font-size:100%;font-weight:normal;}q:before,q:after{content:'';}abbr,acronym {border:0;font-variant:normal;}sup {vertical-align:text-top;}sub {vertical-align:text-bottom;}input,textarea,select{font-family:inherit;font-size:inherit;font-weight:inherit;}input,textarea,select{*font-size:100%;}legend{color:#000;} \ No newline at end of file diff --git a/lib/yui/reset/reset.css b/lib/yui/reset/reset.css deleted file mode 100755 index 7c34f66360..0000000000 --- a/lib/yui/reset/reset.css +++ /dev/null @@ -1,24 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -html{color:#000;background:#FFF;} -body,div,dl,dt,dd,ul,ol,li,h1,h2,h3,h4,h5,h6,pre,code,form,fieldset,legend,input,textarea,p,blockquote,th,td{margin:0;padding:0;} -table{border-collapse:collapse;border-spacing:0;} -fieldset,img{border:0;} -address,caption,cite,code,dfn,em,strong,th,var{font-style:normal;font-weight:normal;} -li{list-style:none;} -caption,th{text-align:left;} -h1,h2,h3,h4,h5,h6{font-size:100%;font-weight:normal;} -q:before,q:after{content:'';} -abbr,acronym {border:0;font-variant:normal;} -/* to preserve line-height and selector appearance */ -sup {vertical-align:text-top;} -sub {vertical-align:text-bottom;} -input,textarea,select{font-family:inherit;font-size:inherit;font-weight:inherit;} -/*to enable resizing for IE*/ -input,textarea,select{*font-size:100%;} -/*because legend doesn't inherit in IE */ -legend{color:#000;} \ No newline at end of file diff --git a/lib/yui/resize/README b/lib/yui/resize/README deleted file mode 100644 index 84e27d41b8..0000000000 --- a/lib/yui/resize/README +++ /dev/null @@ -1,3 +0,0 @@ -**** version 2.5.0 *** - -Initial Release diff --git a/lib/yui/resize/assets/skins/sam/layout_sprite.png b/lib/yui/resize/assets/skins/sam/layout_sprite.png deleted file mode 100644 index d6fce3c7a5..0000000000 Binary files a/lib/yui/resize/assets/skins/sam/layout_sprite.png and /dev/null differ diff --git a/lib/yui/resize/assets/skins/sam/resize-skin.css b/lib/yui/resize/assets/skins/sam/resize-skin.css deleted file mode 100644 index 2b2333cbde..0000000000 --- a/lib/yui/resize/assets/skins/sam/resize-skin.css +++ /dev/null @@ -1,114 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -/* Give the handle a background color */ -.yui-skin-sam .yui-resize .yui-resize-handle { - background-color: #F2F2F2; -} -/* Give the active handle a different color */ -.yui-skin-sam .yui-resize .yui-resize-handle-active { - background-color: #7D98B8; - zoom: 1; -} -/* Give a border to the 8-way knob style handles */ -.yui-skin-sam .yui-resize-knob .yui-resize-handle { - border: 1px solid #808080; -} -/* Show the active handle when hovered */ -.yui-skin-sam .yui-resize-hover .yui-resize-handle-active { - opacity: 1; - filter: alpha(opacity=100); -} - -/* Style the resize proxy */ -.yui-skin-sam .yui-resize-proxy { - border: 1px dashed #426FD9; -} - -/* Style the status box similar to a tooltip */ -.yui-skin-sam .yui-resize-status { - border: 1px solid #A6982B; - border-top: 1px solid #D4C237; - background-color: #FFEE69 -} - - -/* Style the content of the status box */ -.yui-skin-sam .yui-resize-status strong, .yui-skin-sam .yui-resize-status em { - float: left; - display: block; - clear: both; - padding: 1px; - text-align: center; -} - -/* Setup the gripper */ -.yui-skin-sam .yui-resize .yui-resize-handle-inner-r, -.yui-skin-sam .yui-resize .yui-resize-handle-inner-l { - background: transparent url( layout_sprite.png) no-repeat 0 -5px; - height: 16px; - width: 5px; - position: absolute; - top: 45%; -} - -/* Setup the gripper */ -.yui-skin-sam .yui-resize .yui-resize-handle-inner-t, -.yui-skin-sam .yui-resize .yui-resize-handle-inner-b { - background: transparent url(layout_sprite.png) no-repeat -20px 0; - height: 5px; - width: 16px; - position: absolute; - left: 50%; -} - -/* Bottom Right Gripper */ -.yui-skin-sam .yui-resize .yui-resize-handle-br { - background-image: url( layout_sprite.png ); - background-repeat: no-repeat; - background-position: -22px -62px; -} - -/* Top Right Gripper */ -.yui-skin-sam .yui-resize .yui-resize-handle-tr { - background-image: url( layout_sprite.png ); - background-repeat: no-repeat; - background-position: -22px -42px; -} - -/* Top Left Gripper */ -.yui-skin-sam .yui-resize .yui-resize-handle-tl { - background-image: url( layout_sprite.png ); - background-repeat: no-repeat; - background-position: -22px -82px; -} - -/* Bottom Left Gripper */ -.yui-skin-sam .yui-resize .yui-resize-handle-bl { - background-image: url( layout_sprite.png ); - background-repeat: no-repeat; - background-position: -22px -23px; -} - -/* Remove the background image from the 8-way knobs */ -.yui-skin-sam .yui-resize-knob .yui-resize-handle-t, -.yui-skin-sam .yui-resize-knob .yui-resize-handle-r, -.yui-skin-sam .yui-resize-knob .yui-resize-handle-b, -.yui-skin-sam .yui-resize-knob .yui-resize-handle-l, -.yui-skin-sam .yui-resize-knob .yui-resize-handle-tl, -.yui-skin-sam .yui-resize-knob .yui-resize-handle-tr, -.yui-skin-sam .yui-resize-knob .yui-resize-handle-bl, -.yui-skin-sam .yui-resize-knob .yui-resize-handle-br, -.yui-skin-sam .yui-resize-knob .yui-resize-handle-inner-t, -.yui-skin-sam .yui-resize-knob .yui-resize-handle-inner-r, -.yui-skin-sam .yui-resize-knob .yui-resize-handle-inner-b, -.yui-skin-sam .yui-resize-knob .yui-resize-handle-inner-l, -.yui-skin-sam .yui-resize-knob .yui-resize-handle-inner-tl, -.yui-skin-sam .yui-resize-knob .yui-resize-handle-inner-tr, -.yui-skin-sam .yui-resize-knob .yui-resize-handle-inner-bl, -.yui-skin-sam .yui-resize-knob .yui-resize-handle-inner-br { - background-image: none; -} diff --git a/lib/yui/resize/assets/skins/sam/resize.css b/lib/yui/resize/assets/skins/sam/resize.css deleted file mode 100644 index 45a907d04c..0000000000 --- a/lib/yui/resize/assets/skins/sam/resize.css +++ /dev/null @@ -1,7 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -.yui-resize{position:relative;zoom:1;z-index:0;}.yui-resize-wrap{zoom:1;}.yui-draggable{cursor:move;}.yui-resize .yui-resize-handle{position:absolute;z-index:1;font-size:0;margin:0;padding:0;zoom:1;height:1px;width:1px;}.yui-resize .yui-resize-handle-br{height:5px;width:5px;bottom:0;right:0;cursor:se-resize;z-index:2;zoom:1;}.yui-resize .yui-resize-handle-bl{height:5px;width:5px;bottom:0;left:0;cursor:sw-resize;z-index:2;zoom:1;}.yui-resize .yui-resize-handle-tl{height:5px;width:5px;top:0;left:0;cursor:nw-resize;z-index:2;zoom:1;}.yui-resize .yui-resize-handle-tr{height:5px;width:5px;top:0;right:0;cursor:ne-resize;z-index:2;zoom:1;}.yui-resize .yui-resize-handle-r{width:5px;height:100%;top:0;right:0;cursor:e-resize;zoom:1;}.yui-resize .yui-resize-handle-l{height:100%;width:5px;top:0;left:0;cursor:w-resize;zoom:1;}.yui-resize .yui-resize-handle-b{width:100%;height:5px;bottom:0;right:0;cursor:s-resize;zoom:1;}.yui-resize .yui-resize-handle-t{width:100%;height:5px;top:0;right:0;cursor:n-resize;zoom:1;}.yui-resize-proxy{position:absolute;border:1px dashed #000;visibility:hidden;z-index:1000;}.yui-resize-hover .yui-resize-handle,.yui-resize-hidden .yui-resize-handle{opacity:0;filter:alpha(opacity=0);}.yui-resize-ghost{opacity:.5;filter:alpha(opacity=50);}.yui-resize-knob .yui-resize-handle{height:6px;width:6px;}.yui-resize-knob .yui-resize-handle-tr{right:-3px;top:-3px;}.yui-resize-knob .yui-resize-handle-tl{left:-3px;top:-3px;}.yui-resize-knob .yui-resize-handle-bl{left:-3px;bottom:-3px;}.yui-resize-knob .yui-resize-handle-br{right:-3px;bottom:-3px;}.yui-resize-knob .yui-resize-handle-t{left:45%;top:-3px;}.yui-resize-knob .yui-resize-handle-r{right:-3px;top:45%;}.yui-resize-knob .yui-resize-handle-l{left:-3px;top:45%;}.yui-resize-knob .yui-resize-handle-b{left:45%;bottom:-3px;}.yui-resize-status{position:absolute;top:-999px;left:-999px;padding:2px;font-size:80%;display:none;zoom:1;z-index:9999;}.yui-resize-status strong,.yui-resize-status em{font-weight:normal;font-style:normal;padding:1px;zoom:1;}.yui-skin-sam .yui-resize .yui-resize-handle{background-color:#F2F2F2;}.yui-skin-sam .yui-resize .yui-resize-handle-active{background-color:#7D98B8;zoom:1;}.yui-skin-sam .yui-resize-knob .yui-resize-handle{border:1px solid #808080;}.yui-skin-sam .yui-resize-hover .yui-resize-handle-active{opacity:1;filter:alpha(opacity=100);}.yui-skin-sam .yui-resize-proxy{border:1px dashed #426FD9;}.yui-skin-sam .yui-resize-status{border:1px solid #A6982B;border-top:1px solid #D4C237;background-color:#FFEE69}.yui-skin-sam .yui-resize-status strong,.yui-skin-sam .yui-resize-status em{float:left;display:block;clear:both;padding:1px;text-align:center;}.yui-skin-sam .yui-resize .yui-resize-handle-inner-r,.yui-skin-sam .yui-resize .yui-resize-handle-inner-l{background:transparent url( layout_sprite.png) no-repeat 0 -5px;height:16px;width:5px;position:absolute;top:45%;}.yui-skin-sam .yui-resize .yui-resize-handle-inner-t,.yui-skin-sam .yui-resize .yui-resize-handle-inner-b{background:transparent url(layout_sprite.png) no-repeat -20px 0;height:5px;width:16px;position:absolute;left:50%;}.yui-skin-sam .yui-resize .yui-resize-handle-br{background-image:url( layout_sprite.png );background-repeat:no-repeat;background-position:-22px -62px;}.yui-skin-sam .yui-resize .yui-resize-handle-tr{background-image:url( layout_sprite.png );background-repeat:no-repeat;background-position:-22px -42px;}.yui-skin-sam .yui-resize .yui-resize-handle-tl{background-image:url( layout_sprite.png );background-repeat:no-repeat;background-position:-22px -82px;}.yui-skin-sam .yui-resize .yui-resize-handle-bl{background-image:url( layout_sprite.png );background-repeat:no-repeat;background-position:-22px -23px;}.yui-skin-sam .yui-resize-knob .yui-resize-handle-t,.yui-skin-sam .yui-resize-knob .yui-resize-handle-r,.yui-skin-sam .yui-resize-knob .yui-resize-handle-b,.yui-skin-sam .yui-resize-knob .yui-resize-handle-l,.yui-skin-sam .yui-resize-knob .yui-resize-handle-tl,.yui-skin-sam .yui-resize-knob .yui-resize-handle-tr,.yui-skin-sam .yui-resize-knob .yui-resize-handle-bl,.yui-skin-sam .yui-resize-knob .yui-resize-handle-br,.yui-skin-sam .yui-resize-knob .yui-resize-handle-inner-t,.yui-skin-sam .yui-resize-knob .yui-resize-handle-inner-r,.yui-skin-sam .yui-resize-knob .yui-resize-handle-inner-b,.yui-skin-sam .yui-resize-knob .yui-resize-handle-inner-l,.yui-skin-sam .yui-resize-knob .yui-resize-handle-inner-tl,.yui-skin-sam .yui-resize-knob .yui-resize-handle-inner-tr,.yui-skin-sam .yui-resize-knob .yui-resize-handle-inner-bl,.yui-skin-sam .yui-resize-knob .yui-resize-handle-inner-br{background-image:none;} diff --git a/lib/yui/resize/resize-beta-debug.js b/lib/yui/resize/resize-beta-debug.js deleted file mode 100644 index b1d2583dca..0000000000 --- a/lib/yui/resize/resize-beta-debug.js +++ /dev/null @@ -1,1640 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -/** - * @description
Makes an element resizable
- * @namespace YAHOO.util - * @requires yahoo, dom, dragdrop, element, event - * @optional animation - * @module resize - * @beta - */ -(function() { -var D = YAHOO.util.Dom, - Event = YAHOO.util.Event, - Lang = YAHOO.lang; - - /** - * @constructor - * @class Resize - * @extends YAHOO.util.Element - * @description
Makes an element resizable
- * @param {String/HTMLElement} el The element to make resizable. - * @param {Object} attrs Object liternal containing configuration parameters. - */ - - var Resize = function(el, config) { - YAHOO.log('Creating Resize Object', 'info', 'Resize'); - var oConfig = { - element: el, - attributes: config || {} - }; - - Resize.superclass.constructor.call(this, oConfig.element, oConfig.attributes); - }; - - /** - * @private - * @static - * @property _instances - * @description Internal hash table for all resize instances - * @type Object - */ - Resize._instances = {}; - /** - * @static - * @method getResizeById - * @description Get's a resize object by the HTML id of the element associated with the Resize object. - * @return {Object} The Resize Object - */ - Resize.getResizeById = function(id) { - if (Resize._instances[id]) { - return Resize._instances[id]; - } - YAHOO.log('No Instance Found', 'error', 'Resize'); - return false; - }; - - YAHOO.extend(Resize, YAHOO.util.Element, { - /** - * @private - * @property CSS_RESIZE - * @description Base CSS class name - * @type String - */ - CSS_RESIZE: 'yui-resize', - /** - * @private - * @property CSS_DRAG - * @description Class name added when dragging is enabled - * @type String - */ - CSS_DRAG: 'yui-draggable', - /** - * @private - * @property CSS_HOVER - * @description Class name used for hover only handles - * @type String - */ - CSS_HOVER: 'yui-resize-hover', - /** - * @private - * @property CSS_PROXY - * @description Class name given to the proxy element - * @type String - */ - CSS_PROXY: 'yui-resize-proxy', - /** - * @private - * @property CSS_WRAP - * @description Class name given to the wrap element - * @type String - */ - CSS_WRAP: 'yui-resize-wrap', - /** - * @private - * @property CSS_KNOB - * @description Class name used to make the knob style handles - * @type String - */ - CSS_KNOB: 'yui-resize-knob', - /** - * @private - * @property CSS_HIDDEN - * @description Class name given to the wrap element to make all handles hidden - * @type String - */ - CSS_HIDDEN: 'yui-resize-hidden', - /** - * @private - * @property CSS_HANDLE - * @description Class name given to all handles, used as a base for single handle names as well.. Handle "t" will get this.CSS_HANDLE + '-t' as well as this.CSS_HANDLE - * @type String - */ - CSS_HANDLE: 'yui-resize-handle', - /** - * @private - * @property CSS_STATUS - * @description Class name given to the status element - * @type String - */ - CSS_STATUS: 'yui-resize-status', - /** - * @private - * @property CSS_GHOST - * @description Class name given to the wrap element when the ghost property is active - * @type String - */ - CSS_GHOST: 'yui-resize-ghost', - /** - * @private - * @property CSS_RESIZING - * @description Class name given to the wrap element when a resize action is taking place. - * @type String - */ - CSS_RESIZING: 'yui-resize-resizing', - /** - * @private - * @property _resizeEvent - * @description The mouse event used to resize with - * @type Event - */ - _resizeEvent: null, - /** - * @private - * @property dd - * @description The YAHOO.util.DragDrop instance used if draggable is true - * @type Object - */ - dd: null, - /** - * @private - * @property browser - * @description A copy of the YAHOO.env.ua property - * @type Object - */ - browser: YAHOO.env.ua, - /** - * @private - * @property _positioned - * @description A flag to show if the element is absolutely positioned - * @type Boolean - */ - _positioned: null, - /** - * @private - * @property _dds - * @description An Object containing references to all of the YAHOO.util.DragDrop instances used for the resize handles - * @type Object - */ - _dds: null, - /** - * @private - * @property _wrap - * @description The HTML reference of the element wrapper - * @type HTMLElement - */ - _wrap: null, - /** - * @private - * @property _proxy - * @description The HTML reference of the element proxy - * @type HTMLElement - */ - _proxy: null, - /** - * @private - * @property _handles - * @description An object containing references to all of the resize handles. - * @type Object - */ - _handles: null, - /** - * @private - * @property _currentHandle - * @description The string identifier of the currently active handle. e.g. 'r', 'br', 'tl' - * @type String - */ - _currentHandle: null, - /** - * @private - * @property _currentDD - * @description A link to the currently active DD object - * @type Object - */ - _currentDD: null, - /** - * @private - * @property _cache - * @description An lookup table containing key information for the element being resized. e.g. height, width, x position, y position, etc.. - * @type Object - */ - _cache: null, - /** - * @private - * @property _active - * @description Flag to show if the resize is active. Used for events. - * @type Boolean - */ - _active: null, - /** - * @private - * @method _createProxy - * @description Creates the proxy element if the proxy config is true - */ - _createProxy: function() { - if (this.get('proxy')) { - YAHOO.log('Creating the Proxy Element', 'info', 'Resize'); - this._proxy = document.createElement('div'); - this._proxy.className = this.CSS_PROXY; - this._proxy.style.height = this.get('element').clientHeight + 'px'; - this._proxy.style.width = this.get('element').clientWidth + 'px'; - this._wrap.parentNode.appendChild(this._proxy); - } else { - YAHOO.log('No proxy element, turn off animate config option', 'info', 'Resize'); - this.set('animate', false); - } - }, - /** - * @private - * @method _createWrap - * @description Creates the wrap element if the wrap config is true. It will auto wrap the following element types: img, textarea, input, iframe, select - */ - _createWrap: function() { - YAHOO.log('Create the wrap element', 'info', 'Resize'); - this._positioned = false; - //Force wrap for elements that can't have children - switch (this.get('element').tagName.toLowerCase()) { - case 'img': - case 'textarea': - case 'input': - case 'iframe': - case 'select': - this.set('wrap', true); - YAHOO.log('Auto-wrapping the element (' + this.get('element').tagName.toLowerCase() + ')', 'warn', 'Resize'); - break; - } - if (this.get('wrap')) { - YAHOO.log('Creating the wrap element', 'info', 'Resize'); - this._wrap = document.createElement('div'); - this._wrap.id = this.get('element').id + '_wrap'; - this._wrap.className = this.CSS_WRAP; - D.setStyle(this._wrap, 'width', this.get('width')); - D.setStyle(this._wrap, 'height', this.get('height')); - D.setStyle(this._wrap, 'z-index', this.getStyle('z-index')); - this.setStyle('z-index', 0); - var pos = D.getStyle(this.get('element'), 'position'); - D.setStyle(this._wrap, 'position', ((pos == 'static') ? 'relative' : pos)); - D.setStyle(this._wrap, 'top', D.getStyle(this.get('element'), 'top')); - D.setStyle(this._wrap, 'left', D.getStyle(this.get('element'), 'left')); - if (D.getStyle(this.get('element'), 'position') == 'absolute') { - this._positioned = true; - YAHOO.log('The element is positioned absolute', 'info', 'Resize'); - D.setStyle(this.get('element'), 'position', 'relative'); - D.setStyle(this.get('element'), 'top', '0'); - D.setStyle(this.get('element'), 'left', '0'); - } - var par = this.get('element').parentNode; - par.replaceChild(this._wrap, this.get('element')); - this._wrap.appendChild(this.get('element')); - } else { - this._wrap = this.get('element'); - if (D.getStyle(this._wrap, 'position') == 'absolute') { - this._positioned = true; - } - } - if (this.get('draggable')) { - this._setupDragDrop(); - } - if (this.get('hover')) { - D.addClass(this._wrap, this.CSS_HOVER); - } - if (this.get('knobHandles')) { - D.addClass(this._wrap, this.CSS_KNOB); - } - if (this.get('hiddenHandles')) { - D.addClass(this._wrap, this.CSS_HIDDEN); - } - D.addClass(this._wrap, this.CSS_RESIZE); - }, - /** - * @private - * @method _setupDragDrop - * @description Setup the YAHOO.util.DragDrop instance on the element - */ - _setupDragDrop: function() { - YAHOO.log('Setting up the dragdrop instance on the element', 'info', 'Resize'); - D.addClass(this._wrap, this.CSS_DRAG); - this.dd = new YAHOO.util.DD(this._wrap, this.get('id') + '-resize', { dragOnly: true }); - this.dd.on('dragEvent', function() { - this.fireEvent('dragEvent', arguments); - }, this, true); - }, - /** - * @private - * @method _createHandles - * @description Creates the handles as specified in the config - */ - _createHandles: function() { - YAHOO.log('Creating the handles', 'info', 'Resize'); - this._handles = {}; - this._dds = {}; - var h = this.get('handles'); - for (var i = 0; i < h.length; i++) { - YAHOO.log('Creating handle position: ' + h[i], 'info', 'Resize'); - this._handles[h[i]] = document.createElement('div'); - this._handles[h[i]].id = D.generateId(this._handles[h[i]]); - this._handles[h[i]].className = this.CSS_HANDLE + ' ' + this.CSS_HANDLE + '-' + h[i]; - var k = document.createElement('div'); - k.className = this.CSS_HANDLE + '-inner-' + h[i]; - this._handles[h[i]].appendChild(k); - this._wrap.appendChild(this._handles[h[i]]); - Event.on(this._handles[h[i]], 'mouseover', this._handleMouseOver, this, true); - Event.on(this._handles[h[i]], 'mouseout', this._handleMouseOut, this, true); - this._dds[h[i]] = new YAHOO.util.DragDrop(this._handles[h[i]], this.get('id') + '-handle-' + h); - this._dds[h[i]].setPadding(15, 15, 15, 15); - this._dds[h[i]].on('startDragEvent', this._handleStartDrag, this._dds[h[i]], this); - this._dds[h[i]].on('mouseDownEvent', this._handleMouseDown, this._dds[h[i]], this); - } - YAHOO.log('Creating the Status box', 'info', 'Resize'); - this._status = document.createElement('span'); - this._status.className = this.CSS_STATUS; - document.body.insertBefore(this._status, document.body.firstChild); - }, - /** - * @private - * @method _ieSelectFix - * @description The function we use as the onselectstart handler when we start a drag in Internet Explorer - */ - _ieSelectFix: function() { - return false; - }, - /** - * @private - * @property _ieSelectBack - * @description We will hold a copy of the current "onselectstart" method on this property, and reset it after we are done using it. - */ - _ieSelectBack: null, - /** - * @private - * @method _setAutoRatio - * @param {Event} ev A mouse event. - * @description This method checks to see if the "autoRatio" config is set. If it is, we will check to see if the "Shift Key" is pressed. If so, we will set the config ratio to true. - */ - _setAutoRatio: function(ev) { - if (this.get('autoRatio')) { - YAHOO.log('Setting up AutoRatio', 'info', 'Resize'); - if (ev && ev.shiftKey) { - //Shift Pressed - YAHOO.log('Shift key presses, turning on ratio', 'info', 'Resize'); - this.set('ratio', true); - } else { - YAHOO.log('Resetting ratio back to default', 'info', 'Resize'); - this.set('ratio', this._configs.ratio._initialConfig.value); - } - } - }, - /** - * @private - * @method _handleMouseDown - * @param {Event} ev A mouse event. - * @description This method preps the autoRatio on MouseDown. - */ - _handleMouseDown: function(ev) { - if (D.getStyle(this._wrap, 'position') == 'absolute') { - this._positioned = true; - } - if (ev) { - this._setAutoRatio(ev); - } - if (this.browser.ie) { - this._ieSelectBack = document.body.onselectstart; - document.body.onselectstart = this._ieSelectFix; - } - }, - /** - * @private - * @method _handleMouseOver - * @param {Event} ev A mouse event. - * @description Adds CSS class names to the handles - */ - _handleMouseOver: function(ev) { - //Internet Explorer needs this - D.removeClass(this._wrap, this.CSS_RESIZE); - if (this.get('hover')) { - D.removeClass(this._wrap, this.CSS_HOVER); - } - var tar = Event.getTarget(ev); - if (!D.hasClass(tar, this.CSS_HANDLE)) { - tar = tar.parentNode; - } - if (D.hasClass(tar, this.CSS_HANDLE) && !this._active) { - D.addClass(tar, this.CSS_HANDLE + '-active'); - for (var i in this._handles) { - if (Lang.hasOwnProperty(this._handles, i)) { - if (this._handles[i] == tar) { - D.addClass(tar, this.CSS_HANDLE + '-' + i + '-active'); - break; - } - } - } - } - - //Internet Explorer needs this - D.addClass(this._wrap, this.CSS_RESIZE); - }, - /** - * @private - * @method _handleMouseOut - * @param {Event} ev A mouse event. - * @description Removes CSS class names to the handles - */ - _handleMouseOut: function(ev) { - //Internet Explorer needs this - D.removeClass(this._wrap, this.CSS_RESIZE); - if (this.get('hover') && !this._active) { - D.addClass(this._wrap, this.CSS_HOVER); - } - var tar = Event.getTarget(ev); - if (!D.hasClass(tar, this.CSS_HANDLE)) { - tar = tar.parentNode; - } - if (D.hasClass(tar, this.CSS_HANDLE) && !this._active) { - D.removeClass(tar, this.CSS_HANDLE + '-active'); - for (var i in this._handles) { - if (Lang.hasOwnProperty(this._handles, i)) { - if (this._handles[i] == tar) { - D.removeClass(tar, this.CSS_HANDLE + '-' + i + '-active'); - break; - } - } - } - } - //Internet Explorer needs this - D.addClass(this._wrap, this.CSS_RESIZE); - }, - /** - * @private - * @method _handleStartDrag - * @param {Object} args The args passed from the CustomEvent. - * @param {Object} dd The YAHOO.util.DragDrop object we are working with. - * @description Resizes the proxy, sets up the YAHOO.util.DragDrop handlers, updates the status div and preps the cache - */ - _handleStartDrag: function(args, dd) { - YAHOO.log('startDrag', 'info', 'Resize'); - var tar = dd.getDragEl(); - if (D.hasClass(tar, this.CSS_HANDLE)) { - if (D.getStyle(this._wrap, 'position') == 'absolute') { - this._positioned = true; - } - this._active = true; - this._currentDD = dd; - if (this._proxy) { - YAHOO.log('Activate proxy element', 'info', 'Resize'); - this._proxy.style.visibility = 'visible'; - this._proxy.style.zIndex = '1000'; - this._proxy.style.height = this.get('element').clientHeight + 'px'; - this._proxy.style.width = this.get('element').clientWidth + 'px'; - } - - for (var i in this._handles) { - if (Lang.hasOwnProperty(this._handles, i)) { - if (this._handles[i] == tar) { - this._currentHandle = i; - var handle = '_handle_for_' + i; - D.addClass(tar, this.CSS_HANDLE + '-' + i + '-active'); - dd.on('dragEvent', this[handle], this, true); - dd.on('mouseUpEvent', this._handleMouseUp, this, true); - YAHOO.log('Adding DragEvents to: ' + i, 'info', 'Resize'); - break; - } - } - } - - - D.addClass(tar, this.CSS_HANDLE + '-active'); - - if (this.get('proxy')) { - YAHOO.log('Posiiton Proxy Element', 'info', 'Resize'); - var xy = D.getXY(this.get('element')); - D.setXY(this._proxy, xy); - if (this.get('ghost')) { - YAHOO.log('Add Ghost Class', 'info', 'Resize'); - this.addClass(this.CSS_GHOST); - } - } - D.addClass(this._wrap, this.CSS_RESIZING); - this._setCache(); - this._updateStatus(this._cache.height, this._cache.width, this._cache.top, this._cache.left); - YAHOO.log('Firing startResize Event', 'info', 'Resize'); - this.fireEvent('startResize', { type: 'startresize', target: this}); - } - }, - /** - * @private - * @method _setCache - * @description Sets up the this._cache hash table. - */ - _setCache: function() { - YAHOO.log('Setting up property cache', 'info', 'Resize'); - this._cache.xy = D.getXY(this._wrap); - D.setXY(this._wrap, this._cache.xy); - this._cache.height = this.get('clientHeight'); - this._cache.width = this.get('clientWidth'); - this._cache.start.height = this._cache.height; - this._cache.start.width = this._cache.width; - this._cache.start.top = this._cache.xy[1]; - this._cache.start.left = this._cache.xy[0]; - this._cache.top = this._cache.xy[1]; - this._cache.left = this._cache.xy[0]; - }, - /** - * @private - * @method _handleMouseUp - * @param {Event} ev A mouse event. - * @description Cleans up listeners, hides proxy element and removes class names. - */ - _handleMouseUp: function(ev) { - this._active = false; - - var handle = '_handle_for_' + this._currentHandle; - this._currentDD.unsubscribe('dragEvent', this[handle], this, true); - this._currentDD.unsubscribe('mouseUpEvent', this._handleMouseUp, this, true); - - D.removeClass(this._handles[this._currentHandle], this.CSS_HANDLE + '-' + this._currentHandle + '-active'); - D.removeClass(this._handles[this._currentHandle], this.CSS_HANDLE + '-active'); - - this._currentHandle = null; - if (!this.get('animate')) { - if (this.get('setSize')) { - YAHOO.log('Setting Height and Width', 'info', 'Resize'); - this.set('height', this._cache.height); - this.set('width', this._cache.width); - } else { - YAHOO.log('Setting Height and Width silently', 'info', 'Resize'); - this.set('height', this._cache.height, true); - this.set('width', this._cache.width, true); - } - } - - if (this._proxy) { - YAHOO.log('Hide Proxy Element', 'info', 'Resize'); - this._proxy.style.visibility = 'hidden'; - this._proxy.style.zIndex = '-1'; - if (this.get('setSize')) { - YAHOO.log('Setting Size', 'info', 'Resize'); - this.resize(ev, this._cache.height, this._cache.width, this._cache.top, this._cache.left, true); - } else { - YAHOO.log('Firing Resize Event', 'info', 'Resize'); - this.fireEvent('resize', { ev: 'resize', target: this, height: this._cache.height, width: this._cache.width, top: this._cache.top, left: this._cache.left }); - } - - if (this.get('ghost')) { - YAHOO.log('Removing Ghost Class', 'info', 'Resize'); - this.removeClass(this.CSS_GHOST); - } - } - - D.removeClass(this._wrap, this.CSS_RESIZING); - if (this.get('hover')) { - YAHOO.log('Adding hover class', 'info', 'Resize'); - D.addClass(this._wrap, this.CSS_HOVER); - } - if (this._status) { - YAHOO.log('Hiding Status Box', 'info', 'Resize'); - D.setStyle(this._status, 'display', 'none'); - } - if (this.browser.ie) { - YAHOO.log('Resetting IE onselectstart function', 'info', 'Resize'); - document.body.onselectstart = this._ieSelectBack; - } - for (var i in this._handles) { - if (Lang.hasOwnProperty(this._handles, i)) { - YAHOO.log('Removing active class', 'info', 'Resize'); - D.removeClass(this._handles[i], this.CSS_HANDLE + '-active'); - } - } - if (this.get('hover') && !this._active) { - YAHOO.log('Adding Hover Class', 'info', 'Resize'); - D.addClass(this._wrap, this.CSS_HOVER); - } - this._resizeEvent = null; - }, - /** - * @private - * @method _setRatio - * @param {Number} h The height offset. - * @param {Number} w The with offset. - * @param {Number} t The top offset. - * @param {Number} l The left offset. - * @description Using the Height, Width, Top & Left, it recalcuates them based on the original element size. - * @return {Array} The new Height, Width, Top & Left settings - */ - _setRatio: function(h, w, t, l) { - YAHOO.log('Setting Ratio', 'info', 'Resize'); - var oh = h, ow = w; - if (this.get('ratio')) { - var orgH = this._cache.height, - orgW = this._cache.width, - nh = parseInt(this.get('height'), 10), - nw = parseInt(this.get('width'), 10), - maxH = this.get('maxHeight'), - minH = this.get('minHeight'), - maxW = this.get('maxWidth'), - minW = this.get('minWidth'); - - switch (this._currentHandle) { - case 'l': - h = nh * (w / nw); - h = Math.min(Math.max(minH, h), maxH); - w = nw * (h / nh); - t = (this._cache.start.top - (-((nh - h) / 2))); - l = (this._cache.start.left - (-((nw - w)))); - break; - case 'r': - h = nh * (w / nw); - h = Math.min(Math.max(minH, h), maxH); - w = nw * (h / nh); - t = (this._cache.start.top - (-((nh - h) / 2))); - break; - case 't': - w = nw * (h / nh); - h = nh * (w / nw); - l = (this._cache.start.left - (-((nw - w) / 2))); - t = (this._cache.start.top - (-((nh - h)))); - break; - case 'b': - w = nw * (h / nh); - h = nh * (w / nw); - l = (this._cache.start.left - (-((nw - w) / 2))); - break; - case 'bl': - h = nh * (w / nw); - w = nw * (h / nh); - l = (this._cache.start.left - (-((nw - w)))); - break; - case 'br': - h = nh * (w / nw); - w = nw * (h / nh); - break; - case 'tl': - h = nh * (w / nw); - w = nw * (h / nh); - l = (this._cache.start.left - (-((nw - w)))); - t = (this._cache.start.top - (-((nh - h)))); - break; - case 'tr': - h = nh * (w / nw); - w = nw * (h / nh); - l = (this._cache.start.left); - t = (this._cache.start.top - (-((nh - h)))); - break; - } - oh = this._checkHeight(h); - ow = this._checkWidth(w); - if ((oh != h) || (ow != w)) { - t = 0; - l = 0; - } - } - return [oh, ow, t, l]; - }, - /** - * @private - * @method _updateStatus - * @param {Number} h The new height setting. - * @param {Number} w The new width setting. - * @param {Number} t The new top setting. - * @param {Number} l The new left setting. - * @description Using the Height, Width, Top & Left, it updates the status element with the elements sizes. - */ - _updateStatus: function(h, w, t, l) { - if (this._resizeEvent && (!Lang.isString(this._resizeEvent))) { - YAHOO.log('Updating Status Box', 'info', 'Resize'); - if (this.get('status')) { - YAHOO.log('Showing Status Box', 'info', 'Resize'); - D.setStyle(this._status, 'display', 'inline'); - } - h = ((h === 0) ? this._cache.start.height : h); - w = ((w === 0) ? this._cache.start.width : w); - var h1 = parseInt(this.get('height'), 10), - w1 = parseInt(this.get('width'), 10); - - if (isNaN(h1)) { - h1 = parseInt(h, 10); - } - if (isNaN(w1)) { - w1 = parseInt(w, 10); - } - var diffH = (parseInt(h, 10) - h1); - var diffW = (parseInt(w, 10) - w1); - this._cache.offsetHeight = diffH; - this._cache.offsetWidth = diffW; - this._status.innerHTML = '' + parseInt(h, 10) + ' x ' + parseInt(w, 10) + '' + ((diffH > 0) ? '+' : '') + diffH + ' x ' + ((diffW > 0) ? '+' : '') + diffW + ''; - D.setXY(this._status, [Event.getPageX(this._resizeEvent) + 12, Event.getPageY(this._resizeEvent) + 12]); - } - }, - /** - * @method reset - * @description Resets the element to is start state. - * @return {YAHOO.util.Resize} The Resize instance - */ - reset: function() { - YAHOO.log('Resetting to cached sizes and position', 'info', 'Resize'); - this.resize(null, this._cache.start.height, this._cache.start.width, this._cache.start.top, this._cache.start.left, true); - return this; - }, - /** - * @method resize - * @param {Event} ev The mouse event. - * @param {Number} h The new height setting. - * @param {Number} w The new width setting. - * @param {Number} t The new top setting. - * @param {Number} l The new left setting. - * @param {Boolean} force Resize the element (used for proxy resize). - * @description Resizes the element, wrapper or proxy based on the data from the handlers. - * @return {YAHOO.util.Resize} The Resize instance - */ - resize: function(ev, h, w, t, l, force) { - YAHOO.log('Resize: ' + h + ',' + w, 'info', 'Resize'); - this._resizeEvent = ev; - var el = this._wrap, anim = this.get('animate'), set = true; - if (this._proxy && !force) { - el = this._proxy; - anim = false; - } - this._setAutoRatio(ev); - if (this._positioned) { - if (this._proxy) { - t = this._cache.top - t; - l = this._cache.left - l; - } - } - - var ratio = this._setRatio(h, w, t, l); - h = parseInt(ratio[0], 10); - w = parseInt(ratio[1], 10); - t = parseInt(ratio[2], 10); - l = parseInt(ratio[3], 10); - - if (t == 0) { - //No Offset, get from cache - t = D.getY(el); - } - if (l == 0) { - //No Offset, get from cache - l = D.getX(el); - } - - this._updateStatus(h, w, t, l); - - - if (this._positioned) { - if (this._proxy && force) { - if (!anim) { - el.style.top = this._proxy.style.top; - el.style.left = this._proxy.style.left; - } else { - t = this._proxy.style.top; - l = this._proxy.style.left; - } - } else { - if (!this.get('ratio') && !this._proxy) { - t = this._cache.top + -(t); - l = this._cache.left + -(l); - } - if (t) { - if (this.get('minY')) { - if (t < this.get('minY')) { - t = this.get('minY'); - } - } - if (this.get('maxY')) { - if ((t + h) > this.get('maxY')) { - t = (this.get('maxY') - h); - } - } - } - if (l) { - if (this.get('minX')) { - if (l < this.get('minX')) { - l = this.get('minX'); - } - } - if (this.get('maxX')) { - if ((l + w) > this.get('maxX')) { - l = (this.get('maxX') - w); - } - } - } - } - } - YAHOO.log('beforeResize', 'info', 'Resize'); - var beforeReturn = this.fireEvent('beforeResize', { ev: 'beforeResize', target: this, height: h, width: w, top: t, left: l }); - if (beforeReturn === false) { - YAHOO.log('Resized cancelled because befireResize returned false', 'info', 'Resize'); - return false; - } - if (this._positioned) { - if (this._proxy && force) { - //Do nothing - } else { - if (t) { - D.setY(el, t); - this._cache.top = t; - } - if (l) { - D.setX(el, l); - this._cache.left = l; - } - } - } - if (h) { - if (!anim) { - set = true; - if (this._proxy && force) { - if (!this.get('setSize')) { - set = false; - } - } - if (set) { - if (this.browser.ie > 6) { - if (h === this._cache.height) { - h = h + 1; - } - } - el.style.height = h + 'px'; - } - if ((this._proxy && force) || !this._proxy) { - if (this._wrap != this.get('element')) { - this.get('element').style.height = h + 'px'; - } - } - } - this._cache.height = h; - } - if (w) { - this._cache.width = w; - if (!anim) { - set = true; - if (this._proxy && force) { - if (!this.get('setSize')) { - set = false; - } - } - if (set) { - el.style.width = w + 'px'; - } - if ((this._proxy && force) || !this._proxy) { - if (this._wrap != this.get('element')) { - this.get('element').style.width = w + 'px'; - } - } - } - } - if (anim) { - if (YAHOO.util.Anim) { - var _anim = new YAHOO.util.Anim(el, { - height: { - to: this._cache.height - }, - width: { - to: this._cache.width - } - }, this.get('animateDuration'), this.get('animateEasing')); - if (this._positioned) { - if (t) { - _anim.attributes.top = { - to: parseInt(t, 10) - }; - } - if (l) { - _anim.attributes.left = { - to: parseInt(l, 10) - }; - } - } - - if (this._wrap != this.get('element')) { - _anim.onTween.subscribe(function() { - this.get('element').style.height = el.style.height; - this.get('element').style.width = el.style.width; - }, this, true); - } - - _anim.onComplete.subscribe(function() { - YAHOO.log('Animation onComplete fired', 'info', 'Resize'); - this.set('height', h); - this.set('width', w); - this.fireEvent('resize', { ev: 'resize', target: this, height: h, width: w, top: t, left: l }); - }, this, true); - _anim.animate(); - - } - } else { - if (this._proxy && !force) { - YAHOO.log('proxyResize', 'info', 'Resize'); - this.fireEvent('proxyResize', { ev: 'proxyresize', target: this, height: h, width: w, top: t, left: l }); - } else { - YAHOO.log('resize', 'info', 'Resize'); - this.fireEvent('resize', { ev: 'resize', target: this, height: h, width: w, top: t, left: l }); - } - } - return this; - }, - /** - * @private - * @method _handle_for_br - * @param {Object} args The arguments from the CustomEvent. - * @description Handles the sizes for the Bottom Right handle. - */ - _handle_for_br: function(args) { - YAHOO.log('Handle BR', 'info', 'Resize'); - var newW = this._setWidth(args.e); - var newH = this._setHeight(args.e); - this.resize(args.e, (newH + 1), newW, 0, 0); - }, - /** - * @private - * @method _handle_for_bl - * @param {Object} args The arguments from the CustomEvent. - * @description Handles the sizes for the Bottom Left handle. - */ - _handle_for_bl: function(args) { - YAHOO.log('Handle BL', 'info', 'Resize'); - var newW = this._setWidth(args.e, true); - var newH = this._setHeight(args.e); - var l = (newW - this._cache.width); - this.resize(args.e, newH, newW, 0, l); - }, - /** - * @private - * @method _handle_for_tl - * @param {Object} args The arguments from the CustomEvent. - * @description Handles the sizes for the Top Left handle. - */ - _handle_for_tl: function(args) { - YAHOO.log('Handle TL', 'info', 'Resize'); - var newW = this._setWidth(args.e, true); - var newH = this._setHeight(args.e, true); - var t = (newH - this._cache.height); - var l = (newW - this._cache.width); - this.resize(args.e, newH, newW, t, l); - }, - /** - * @private - * @method _handle_for_tr - * @param {Object} args The arguments from the CustomEvent. - * @description Handles the sizes for the Top Right handle. - */ - _handle_for_tr: function(args) { - YAHOO.log('Handle TR', 'info', 'Resize'); - var newW = this._setWidth(args.e); - var newH = this._setHeight(args.e, true); - var t = (newH - this._cache.height); - this.resize(args.e, newH, newW, t, 0); - }, - /** - * @private - * @method _handle_for_r - * @param {Object} args The arguments from the CustomEvent. - * @description Handles the sizes for the Right handle. - */ - _handle_for_r: function(args) { - YAHOO.log('Handle R', 'info', 'Resize'); - this._dds.r.setYConstraint(0,0); - var newW = this._setWidth(args.e); - this.resize(args.e, 0, newW, 0, 0); - }, - /** - * @private - * @method _handle_for_l - * @param {Object} args The arguments from the CustomEvent. - * @description Handles the sizes for the Left handle. - */ - _handle_for_l: function(args) { - YAHOO.log('Handle L', 'info', 'Resize'); - this._dds.l.setYConstraint(0,0); - var newW = this._setWidth(args.e, true); - var l = (newW - this._cache.width); - this.resize(args.e, 0, newW, 0, l); - }, - /** - * @private - * @method _handle_for_b - * @param {Object} args The arguments from the CustomEvent. - * @description Handles the sizes for the Bottom handle. - */ - _handle_for_b: function(args) { - YAHOO.log('Handle B', 'info', 'Resize'); - this._dds.b.setXConstraint(0,0); - var newH = this._setHeight(args.e); - this.resize(args.e, newH, 0, 0, 0); - }, - /** - * @private - * @method _handle_for_t - * @param {Object} args The arguments from the CustomEvent. - * @description Handles the sizes for the Top handle. - */ - _handle_for_t: function(args) { - YAHOO.log('Handle T', 'info', 'Resize'); - this._dds.t.setXConstraint(0,0); - var newH = this._setHeight(args.e, true); - var t = (newH - this._cache.height); - this.resize(args.e, newH, 0, t, 0); - }, - /** - * @private - * @method _setWidth - * @param {Event} ev The mouse event. - * @param {Boolean} flip Argument to determine the direction of the movement. - * @description Calculates the width based on the mouse event. - * @return {Number} The new value - */ - _setWidth: function(ev, flip) { - YAHOO.log('Set width based on Event', 'info', 'Resize'); - var xy = this._cache.xy[0], - w = this._cache.width, - x = Event.getPageX(ev), - nw = (x - xy); - - if (flip) { - nw = (xy - x) + parseInt(this.get('width'), 10); - } - - nw = this._snapTick(nw, this.get('yTicks')); - nw = this._checkWidth(nw); - return nw; - }, - /** - * @private - * @method _checkWidth - * @param {Number} w The width to check. - * @description Checks the value passed against the maxWidth and minWidth. - * @return {Number} the new value - */ - _checkWidth: function(w) { - YAHOO.log('Checking the min/max width', 'info', 'Resize'); - if (this.get('minWidth')) { - if (w <= this.get('minWidth')) { - YAHOO.log('Using minWidth', 'info', 'Resize'); - w = this.get('minWidth'); - } - } - if (this.get('maxWidth')) { - if (w >= this.get('maxWidth')) { - YAHOO.log('Using Max Width', 'info', 'Resize'); - w = this.get('maxWidth'); - } - } - return w; - }, - /** - * @private - * @method _checkHeight - * @param {Number} h The height to check. - * @description Checks the value passed against the maxHeight and minHeight. - * @return {Number} The new value - */ - _checkHeight: function(h) { - YAHOO.log('Checking the min/max height', 'info', 'Resize'); - if (this.get('minHeight')) { - if (h <= this.get('minHeight')) { - YAHOO.log('Using minHeight', 'info', 'Resize'); - h = this.get('minHeight'); - } - } - if (this.get('maxHeight')) { - if (h >= this.get('maxHeight')) { - YAHOO.log('using maxHeight', 'info', 'Resize'); - h = this.get('maxHeight'); - } - } - return h; - }, - /** - * @private - * @method _setHeight - * @param {Event} ev The mouse event. - * @param {Boolean} flip Argument to determine the direction of the movement. - * @description Calculated the height based on the mouse event. - * @return {Number} The new value - */ - _setHeight: function(ev, flip) { - YAHOO.log('Setting the height based on the Event', 'info', 'Resize'); - var xy = this._cache.xy[1], - h = this._cache.height, - y = Event.getPageY(ev), - nh = (y - xy); - - if (flip) { - nh = (xy - y) + parseInt(this.get('height'), 10); - } - nh = this._snapTick(nh, this.get('xTicks')); - nh = this._checkHeight(nh); - - return nh; - }, - /** - * @private - * @method _snapTick - * @param {Number} size The size to tick against. - * @param {Number} pix The tick pixels. - * @description Adjusts the number based on the ticks used. - * @return {Number} the new snapped position - */ - _snapTick: function(size, pix) { - YAHOO.log('Snapping to ticks', 'info', 'Resize'); - if (!size || !pix) { - return size; - } - var _s = size; - var _x = size % pix; - if (_x > 0) { - if (_x > (pix / 2)) { - _s = size + (pix - _x); - } else { - _s = size - _x; - } - } - return _s; - }, - /** - * @private - * @method init - * @description The Resize class's initialization method - */ - init: function(p_oElement, p_oAttributes) { - YAHOO.log('init', 'info', 'Resize'); - this._cache = { - xy: [], - height: 0, - width: 0, - top: 0, - left: 0, - offsetHeight: 0, - offsetWidth: 0, - start: { - height: 0, - width: 0, - top: 0, - left: 0 - } - }; - - Resize.superclass.init.call(this, p_oElement, p_oAttributes); - - this.set('setSize', this.get('setSize')); - - if (p_oAttributes.height) { - this.set('height', parseInt(p_oAttributes.height, 10)); - } - if (p_oAttributes.width) { - this.set('width', parseInt(p_oAttributes.width, 10)); - } - - var id = p_oElement; - if (!Lang.isString(id)) { - id = D.generateId(id); - } - Resize._instances[id] = this; - - this._active = false; - - this._createWrap(); - this._createProxy(); - this._createHandles(); - - }, - /** - * @method getProxyEl - * @description Get the HTML reference for the proxy, returns null if no proxy. - * @return {HTMLElement} The proxy element - */ - getProxyEl: function() { - return this._proxy; - }, - /** - * @method getWrapEl - * @description Get the HTML reference for the wrap element, returns the current element if not wrapped. - * @return {HTMLElement} The wrap element - */ - getWrapEl: function() { - return this._wrap; - }, - /** - * @method getStatusEl - * @description Get the HTML reference for the status element. - * @return {HTMLElement} The status element - */ - getStatusEl: function() { - return this._status; - }, - /** - * @method getActiveHandleEl - * @description Get the HTML reference for the currently active resize handle. - * @return {HTMLElement} The handle element that is active - */ - getActiveHandleEl: function() { - return this._handles[this._currentHandle]; - }, - /** - * @method isActive - * @description Returns true or false if a resize operation is currently active on the element. - * @return {Boolean} - */ - isActive: function() { - return ((this._active) ? true : false); - }, - /** - * @private - * @method initAttributes - * @description Initializes all of the configuration attributes used to create a resizable element. - * @param {Object} attr Object literal specifying a set of - * configuration attributes used to create the utility. - */ - initAttributes: function(attr) { - Resize.superclass.initAttributes.call(this, attr); - - /** - * @attribute setSize - * @description Set the size of the resized element, if set to false the element will not be auto resized, - * the resize event will contain the dimensions so the end user can resize it on their own. - * This setting will only work with proxy set to true and animate set to false. - * @type Boolean - */ - this.setAttributeConfig('setSize', { - value: ((attr.setSize === false) ? false : true), - validator: YAHOO.lang.isBoolean - }); - - /** - * @attribute wrap - * @description Should we wrap the element - * @type Boolean - */ - this.setAttributeConfig('wrap', { - writeOnce: true, - validator: YAHOO.lang.isBoolean, - value: attr.wrap || false - }); - - /** - * @attribute handles - * @description The handles to use (any combination of): 't', 'b', 'r', 'l', 'bl', 'br', 'tl', 'tr'. Defaults to: ['r', 'b', 'br']. - * Can use a shortcut of All. Note: 8 way resizing should be done on an element that is absolutely positioned. - * @type Array - */ - this.setAttributeConfig('handles', { - writeOnce: true, - value: attr.handles || ['r', 'b', 'br'], - validator: function(handles) { - if (Lang.isString(handles) && handles.toLowerCase() == 'all') { - handles = ['t', 'b', 'r', 'l', 'bl', 'br', 'tl', 'tr']; - } - if (!Lang.isArray(handles)) { - handles = handles.replace(/, /g, ','); - handles = handles.split(','); - } - this._configs.handles.value = handles; - } - }); - - /** - * @attribute width - * @description The width of the element - * @type Number - */ - this.setAttributeConfig('width', { - value: attr.width || parseInt(this.getStyle('width'), 10), - validator: YAHOO.lang.isNumber, - method: function(width) { - width = parseInt(width, 10); - if (width > 0) { - if (this.get('setSize')) { - this.setStyle('width', width + 'px'); - } - this._cache.width = width; - this._configs.width.value = width; - } - } - }); - - /** - * @attribute height - * @description The height of the element - * @type Number - */ - this.setAttributeConfig('height', { - value: attr.height || parseInt(this.getStyle('height'), 10), - validator: YAHOO.lang.isNumber, - method: function(height) { - height = parseInt(height, 10); - if (height > 0) { - if (this.get('setSize')) { - this.setStyle('height', height + 'px'); - } - this._cache.height = height; - this._configs.height.value = height; - } - } - }); - - /** - * @attribute minWidth - * @description The minimum width of the element - * @type Number - */ - this.setAttributeConfig('minWidth', { - value: attr.minWidth || 15, - validator: YAHOO.lang.isNumber - }); - - /** - * @attribute minHeight - * @description The minimum height of the element - * @type Number - */ - this.setAttributeConfig('minHeight', { - value: attr.minHeight || 15, - validator: YAHOO.lang.isNumber - }); - - /** - * @attribute maxWidth - * @description The maximum width of the element - * @type Number - */ - this.setAttributeConfig('maxWidth', { - value: attr.maxWidth || 10000, - validator: YAHOO.lang.isNumber - }); - - /** - * @attribute maxHeight - * @description The maximum height of the element - * @type Number - */ - this.setAttributeConfig('maxHeight', { - value: attr.maxHeight || 10000, - validator: YAHOO.lang.isNumber - }); - - /** - * @attribute minY - * @description The minimum y coord of the element - * @type Number - */ - this.setAttributeConfig('minY', { - value: attr.minY || false - }); - - /** - * @attribute minX - * @description The minimum x coord of the element - * @type Number - */ - this.setAttributeConfig('minX', { - value: attr.minX || false - }); - /** - * @attribute maxY - * @description The max y coord of the element - * @type Number - */ - this.setAttributeConfig('maxY', { - value: attr.maxY || false - }); - - /** - * @attribute maxX - * @description The max x coord of the element - * @type Number - */ - this.setAttributeConfig('maxX', { - value: attr.maxX || false - }); - - /** - * @attribute animate - * @description Should be use animation to resize the element (can only be used if we use proxy). - * @type Boolean - */ - this.setAttributeConfig('animate', { - value: attr.animate || false, - validator: function(value) { - var ret = true; - if (!YAHOO.util.Anim) { - ret = false; - } - return ret; - } - }); - - /** - * @attribute animateEasing - * @description The Easing to apply to the animation. - * @type Object - */ - this.setAttributeConfig('animateEasing', { - value: attr.animateEasing || function() { - var easing = false; - try { - easing = YAHOO.util.Easing.easeOut; - } catch (e) {} - return easing; - }() - }); - - /** - * @attribute animateDuration - * @description The Duration to apply to the animation. - * @type Number - */ - this.setAttributeConfig('animateDuration', { - value: attr.animateDuration || 0.5 - }); - - /** - * @attribute proxy - * @description Resize a proxy element instead of the real element. - * @type Boolean - */ - this.setAttributeConfig('proxy', { - value: attr.proxy || false, - validator: YAHOO.lang.isBoolean - }); - - /** - * @attribute ratio - * @description Maintain the element's ratio when resizing. - * @type Boolean - */ - this.setAttributeConfig('ratio', { - value: attr.ratio || false, - validator: YAHOO.lang.isBoolean - }); - - /** - * @attribute ghost - * @description Apply an opacity filter to the element being resized (only works with proxy). - * @type Boolean - */ - this.setAttributeConfig('ghost', { - value: attr.ghost || false, - validator: YAHOO.lang.isBoolean - }); - - /** - * @attribute draggable - * @description A convienence method to make the element draggable - * @type Boolean - */ - this.setAttributeConfig('draggable', { - value: attr.draggable || false, - validator: YAHOO.lang.isBoolean, - method: function(dd) { - if (dd && this._wrap) { - this._setupDragDrop(); - } else { - if (this.dd) { - D.removeClass(this._wrap, this.CSS_DRAG); - this.dd.unreg(); - } - } - } - }); - - /** - * @attribute hover - * @description Only show the handles when they are being moused over. - * @type Boolean - */ - this.setAttributeConfig('hover', { - value: attr.hover || false, - validator: YAHOO.lang.isBoolean - }); - - /** - * @attribute hiddenHandles - * @description Don't show the handles, just use the cursor to the user. - * @type Boolean - */ - this.setAttributeConfig('hiddenHandles', { - value: attr.hiddenHandles || false, - validator: YAHOO.lang.isBoolean - }); - - /** - * @attribute knobHandles - * @description Use the smaller handles, instead if the full size handles. - * @type Boolean - */ - this.setAttributeConfig('knobHandles', { - value: attr.knobHandles || false, - validator: YAHOO.lang.isBoolean - }); - - /** - * @attribute xTicks - * @description The number of x ticks to span the resize to. - * @type Number or False - */ - this.setAttributeConfig('xTicks', { - value: attr.xTicks || false - }); - - /** - * @attribute yTicks - * @description The number of y ticks to span the resize to. - * @type Number or False - */ - this.setAttributeConfig('yTicks', { - value: attr.yTicks || false - }); - - /** - * @attribute status - * @description Show the status (new size) of the resize. - * @type Boolean - */ - this.setAttributeConfig('status', { - value: attr.status || false, - validator: YAHOO.lang.isBoolean - }); - - /** - * @attribute autoRatio - * @description Using the shift key during a resize will toggle the ratio config. - * @type Boolean - */ - this.setAttributeConfig('autoRatio', { - value: attr.autoRatio || false, - validator: YAHOO.lang.isBoolean - }); - - }, - /** - * @method destroy - * @description Destroys the resize object and all of it's elements & listeners. - */ - destroy: function() { - YAHOO.log('Destroying Resize', 'info', 'Resize'); - for (var h in this._handles) { - if (Lang.hasOwnProperty(this._handles, h)) { - Event.purgeElement(this._handles[h]); - this._handles[h].parentNode.removeChild(this._handles[h]); - } - } - if (this._proxy) { - this._proxy.parentNode.removeChild(this._proxy); - } - if (this.dd) { - this.dd.unreg(); - D.removeClass(this._wrap, this.CSS_DRAG); - } - if (this._wrap != this.get('element')) { - this.setStyle('position', ''); - this.setStyle('top', ''); - this.setStyle('left', ''); - this._wrap.parentNode.replaceChild(this.get('element'), this._wrap); - } - this.removeClass(this.CSS_RESIZE); - - delete YAHOO.util.Resize._instances[this.get('id')]; - //Brutal Object Destroy - for (var i in this) { - if (Lang.hasOwnProperty(this, i)) { - this[i] = null; - delete this[i]; - } - } - }, - /** - * @method toString - * @description Returns a string representing the Resize Object. - * @return {String} - */ - toString: function() { - if (this.get) { - return 'Resize (#' + this.get('id') + ')'; - } - return 'Resize Utility'; - } - }); - - YAHOO.util.Resize = Resize; - -/** -* @event dragEvent -* @description Fires when the YAHOO.util.DragDrop dragEvent is fired for the config option draggable. -* @type YAHOO.util.CustomEvent -*/ -/** -* @event startResize -* @description Fires when when a resize action is started. -* @type YAHOO.util.CustomEvent -*/ -/** -* @event resize -* @description Fires on every element resize (only fires once when used with proxy config setting). -* @type YAHOO.util.CustomEvent -*/ -/** -* @event beforeResize -* @description Fires before every element resize after the size calculations, returning false will stop the resize. -* @type YAHOO.util.CustomEvent -*/ -/** -* @event proxyResize -* @description Fires on every proxy resize (only fires when used with proxy config setting). -* @type YAHOO.util.CustomEvent -*/ - -})(); - -YAHOO.register("resize", YAHOO.util.Resize, {version: "2.5.0", build: "895"}); diff --git a/lib/yui/resize/resize-beta-min.js b/lib/yui/resize/resize-beta-min.js deleted file mode 100644 index e1052eeb84..0000000000 --- a/lib/yui/resize/resize-beta-min.js +++ /dev/null @@ -1,10 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -(function(){var E=YAHOO.util.Dom,A=YAHOO.util.Event,C=YAHOO.lang;var B=function(F,D){var G={element:F,attributes:D||{}};B.superclass.constructor.call(this,G.element,G.attributes);};B._instances={};B.getResizeById=function(D){if(B._instances[D]){return B._instances[D];}return false;};YAHOO.extend(B,YAHOO.util.Element,{CSS_RESIZE:"yui-resize",CSS_DRAG:"yui-draggable",CSS_HOVER:"yui-resize-hover",CSS_PROXY:"yui-resize-proxy",CSS_WRAP:"yui-resize-wrap",CSS_KNOB:"yui-resize-knob",CSS_HIDDEN:"yui-resize-hidden",CSS_HANDLE:"yui-resize-handle",CSS_STATUS:"yui-resize-status",CSS_GHOST:"yui-resize-ghost",CSS_RESIZING:"yui-resize-resizing",_resizeEvent:null,dd:null,browser:YAHOO.env.ua,_positioned:null,_dds:null,_wrap:null,_proxy:null,_handles:null,_currentHandle:null,_currentDD:null,_cache:null,_active:null,_createProxy:function(){if(this.get("proxy")){this._proxy=document.createElement("div");this._proxy.className=this.CSS_PROXY;this._proxy.style.height=this.get("element").clientHeight+"px";this._proxy.style.width=this.get("element").clientWidth+"px";this._wrap.parentNode.appendChild(this._proxy);}else{this.set("animate",false);}},_createWrap:function(){this._positioned=false;switch(this.get("element").tagName.toLowerCase()){case"img":case"textarea":case"input":case"iframe":case"select":this.set("wrap",true);break;}if(this.get("wrap")){this._wrap=document.createElement("div");this._wrap.id=this.get("element").id+"_wrap";this._wrap.className=this.CSS_WRAP;E.setStyle(this._wrap,"width",this.get("width"));E.setStyle(this._wrap,"height",this.get("height"));E.setStyle(this._wrap,"z-index",this.getStyle("z-index"));this.setStyle("z-index",0);var F=E.getStyle(this.get("element"),"position");E.setStyle(this._wrap,"position",((F=="static")?"relative":F));E.setStyle(this._wrap,"top",E.getStyle(this.get("element"),"top"));E.setStyle(this._wrap,"left",E.getStyle(this.get("element"),"left"));if(E.getStyle(this.get("element"),"position")=="absolute"){this._positioned=true;E.setStyle(this.get("element"),"position","relative");E.setStyle(this.get("element"),"top","0");E.setStyle(this.get("element"),"left","0");}var D=this.get("element").parentNode;D.replaceChild(this._wrap,this.get("element"));this._wrap.appendChild(this.get("element"));}else{this._wrap=this.get("element");if(E.getStyle(this._wrap,"position")=="absolute"){this._positioned=true;}}if(this.get("draggable")){this._setupDragDrop();}if(this.get("hover")){E.addClass(this._wrap,this.CSS_HOVER);}if(this.get("knobHandles")){E.addClass(this._wrap,this.CSS_KNOB);}if(this.get("hiddenHandles")){E.addClass(this._wrap,this.CSS_HIDDEN);}E.addClass(this._wrap,this.CSS_RESIZE);},_setupDragDrop:function(){E.addClass(this._wrap,this.CSS_DRAG);this.dd=new YAHOO.util.DD(this._wrap,this.get("id")+"-resize",{dragOnly:true});this.dd.on("dragEvent",function(){this.fireEvent("dragEvent",arguments);},this,true);},_createHandles:function(){this._handles={};this._dds={};var G=this.get("handles");for(var F=0;F"+parseInt(K,10)+" x "+parseInt(G,10)+""+((L>0)?"+":"")+L+" x "+((H>0)?"+":"")+H+"";E.setXY(this._status,[A.getPageX(this._resizeEvent)+12,A.getPageY(this._resizeEvent)+12]);}},reset:function(){this.resize(null,this._cache.start.height,this._cache.start.width,this._cache.start.top,this._cache.start.left,true);return this;},resize:function(L,J,O,P,H,F){this._resizeEvent=L;var G=this._wrap,I=this.get("animate"),N=true;if(this._proxy&&!F){G=this._proxy;I=false;}this._setAutoRatio(L);if(this._positioned){if(this._proxy){P=this._cache.top-P;H=this._cache.left-H;}}var K=this._setRatio(J,O,P,H);J=parseInt(K[0],10);O=parseInt(K[1],10);P=parseInt(K[2],10);H=parseInt(K[3],10);if(P==0){P=E.getY(G);}if(H==0){H=E.getX(G);}this._updateStatus(J,O,P,H);if(this._positioned){if(this._proxy&&F){if(!I){G.style.top=this._proxy.style.top;G.style.left=this._proxy.style.left;}else{P=this._proxy.style.top;H=this._proxy.style.left;}}else{if(!this.get("ratio")&&!this._proxy){P=this._cache.top+-(P);H=this._cache.left+-(H);}if(P){if(this.get("minY")){if(Pthis.get("maxY")){P=(this.get("maxY")-J);}}}if(H){if(this.get("minX")){if(Hthis.get("maxX")){H=(this.get("maxX")-O);}}}}}var M=this.fireEvent("beforeResize",{ev:"beforeResize",target:this,height:J,width:O,top:P,left:H});if(M===false){return false;}if(this._positioned){if(this._proxy&&F){}else{if(P){E.setY(G,P);this._cache.top=P;}if(H){E.setX(G,H);this._cache.left=H;}}}if(J){if(!I){N=true;if(this._proxy&&F){if(!this.get("setSize")){N=false;}}if(N){if(this.browser.ie>6){if(J===this._cache.height){J=J+1;}}G.style.height=J+"px";}if((this._proxy&&F)||!this._proxy){if(this._wrap!=this.get("element")){this.get("element").style.height=J+"px";}}}this._cache.height=J;}if(O){this._cache.width=O;if(!I){N=true;if(this._proxy&&F){if(!this.get("setSize")){N=false;}}if(N){G.style.width=O+"px";}if((this._proxy&&F)||!this._proxy){if(this._wrap!=this.get("element")){this.get("element").style.width=O+"px"; -}}}}if(I){if(YAHOO.util.Anim){var D=new YAHOO.util.Anim(G,{height:{to:this._cache.height},width:{to:this._cache.width}},this.get("animateDuration"),this.get("animateEasing"));if(this._positioned){if(P){D.attributes.top={to:parseInt(P,10)};}if(H){D.attributes.left={to:parseInt(H,10)};}}if(this._wrap!=this.get("element")){D.onTween.subscribe(function(){this.get("element").style.height=G.style.height;this.get("element").style.width=G.style.width;},this,true);}D.onComplete.subscribe(function(){this.set("height",J);this.set("width",O);this.fireEvent("resize",{ev:"resize",target:this,height:J,width:O,top:P,left:H});},this,true);D.animate();}}else{if(this._proxy&&!F){this.fireEvent("proxyResize",{ev:"proxyresize",target:this,height:J,width:O,top:P,left:H});}else{this.fireEvent("resize",{ev:"resize",target:this,height:J,width:O,top:P,left:H});}}return this;},_handle_for_br:function(F){var G=this._setWidth(F.e);var D=this._setHeight(F.e);this.resize(F.e,(D+1),G,0,0);},_handle_for_bl:function(G){var H=this._setWidth(G.e,true);var F=this._setHeight(G.e);var D=(H-this._cache.width);this.resize(G.e,F,H,0,D);},_handle_for_tl:function(G){var I=this._setWidth(G.e,true);var F=this._setHeight(G.e,true);var H=(F-this._cache.height);var D=(I-this._cache.width);this.resize(G.e,F,I,H,D);},_handle_for_tr:function(F){var H=this._setWidth(F.e);var D=this._setHeight(F.e,true);var G=(D-this._cache.height);this.resize(F.e,D,H,G,0);},_handle_for_r:function(D){this._dds.r.setYConstraint(0,0);var F=this._setWidth(D.e);this.resize(D.e,0,F,0,0);},_handle_for_l:function(F){this._dds.l.setYConstraint(0,0);var G=this._setWidth(F.e,true);var D=(G-this._cache.width);this.resize(F.e,0,G,0,D);},_handle_for_b:function(F){this._dds.b.setXConstraint(0,0);var D=this._setHeight(F.e);this.resize(F.e,D,0,0,0);},_handle_for_t:function(F){this._dds.t.setXConstraint(0,0);var D=this._setHeight(F.e,true);var G=(D-this._cache.height);this.resize(F.e,D,0,G,0);},_setWidth:function(H,J){var I=this._cache.xy[0],G=this._cache.width,D=A.getPageX(H),F=(D-I);if(J){F=(I-D)+parseInt(this.get("width"),10);}F=this._snapTick(F,this.get("yTicks"));F=this._checkWidth(F);return F;},_checkWidth:function(D){if(this.get("minWidth")){if(D<=this.get("minWidth")){D=this.get("minWidth");}}if(this.get("maxWidth")){if(D>=this.get("maxWidth")){D=this.get("maxWidth");}}return D;},_checkHeight:function(D){if(this.get("minHeight")){if(D<=this.get("minHeight")){D=this.get("minHeight");}}if(this.get("maxHeight")){if(D>=this.get("maxHeight")){D=this.get("maxHeight");}}return D;},_setHeight:function(G,I){var H=this._cache.xy[1],F=this._cache.height,J=A.getPageY(G),D=(J-H);if(I){D=(H-J)+parseInt(this.get("height"),10);}D=this._snapTick(D,this.get("xTicks"));D=this._checkHeight(D);return D;},_snapTick:function(G,F){if(!G||!F){return G;}var H=G;var D=G%F;if(D>0){if(D>(F/2)){H=G+(F-D);}else{H=G-D;}}return H;},init:function(F,D){this._cache={xy:[],height:0,width:0,top:0,left:0,offsetHeight:0,offsetWidth:0,start:{height:0,width:0,top:0,left:0}};B.superclass.init.call(this,F,D);this.set("setSize",this.get("setSize"));if(D.height){this.set("height",parseInt(D.height,10));}if(D.width){this.set("width",parseInt(D.width,10));}var G=F;if(!C.isString(G)){G=E.generateId(G);}B._instances[G]=this;this._active=false;this._createWrap();this._createProxy();this._createHandles();},getProxyEl:function(){return this._proxy;},getWrapEl:function(){return this._wrap;},getStatusEl:function(){return this._status;},getActiveHandleEl:function(){return this._handles[this._currentHandle];},isActive:function(){return((this._active)?true:false);},initAttributes:function(D){B.superclass.initAttributes.call(this,D);this.setAttributeConfig("setSize",{value:((D.setSize===false)?false:true),validator:YAHOO.lang.isBoolean});this.setAttributeConfig("wrap",{writeOnce:true,validator:YAHOO.lang.isBoolean,value:D.wrap||false});this.setAttributeConfig("handles",{writeOnce:true,value:D.handles||["r","b","br"],validator:function(F){if(C.isString(F)&&F.toLowerCase()=="all"){F=["t","b","r","l","bl","br","tl","tr"];}if(!C.isArray(F)){F=F.replace(/, /g,",");F=F.split(",");}this._configs.handles.value=F;}});this.setAttributeConfig("width",{value:D.width||parseInt(this.getStyle("width"),10),validator:YAHOO.lang.isNumber,method:function(F){F=parseInt(F,10);if(F>0){if(this.get("setSize")){this.setStyle("width",F+"px");}this._cache.width=F;this._configs.width.value=F;}}});this.setAttributeConfig("height",{value:D.height||parseInt(this.getStyle("height"),10),validator:YAHOO.lang.isNumber,method:function(F){F=parseInt(F,10);if(F>0){if(this.get("setSize")){this.setStyle("height",F+"px");}this._cache.height=F;this._configs.height.value=F;}}});this.setAttributeConfig("minWidth",{value:D.minWidth||15,validator:YAHOO.lang.isNumber});this.setAttributeConfig("minHeight",{value:D.minHeight||15,validator:YAHOO.lang.isNumber});this.setAttributeConfig("maxWidth",{value:D.maxWidth||10000,validator:YAHOO.lang.isNumber});this.setAttributeConfig("maxHeight",{value:D.maxHeight||10000,validator:YAHOO.lang.isNumber});this.setAttributeConfig("minY",{value:D.minY||false});this.setAttributeConfig("minX",{value:D.minX||false});this.setAttributeConfig("maxY",{value:D.maxY||false});this.setAttributeConfig("maxX",{value:D.maxX||false});this.setAttributeConfig("animate",{value:D.animate||false,validator:function(G){var F=true;if(!YAHOO.util.Anim){F=false;}return F;}});this.setAttributeConfig("animateEasing",{value:D.animateEasing||function(){var G=false;try{G=YAHOO.util.Easing.easeOut;}catch(F){}return G;}()});this.setAttributeConfig("animateDuration",{value:D.animateDuration||0.5});this.setAttributeConfig("proxy",{value:D.proxy||false,validator:YAHOO.lang.isBoolean});this.setAttributeConfig("ratio",{value:D.ratio||false,validator:YAHOO.lang.isBoolean});this.setAttributeConfig("ghost",{value:D.ghost||false,validator:YAHOO.lang.isBoolean});this.setAttributeConfig("draggable",{value:D.draggable||false,validator:YAHOO.lang.isBoolean,method:function(F){if(F&&this._wrap){this._setupDragDrop(); -}else{if(this.dd){E.removeClass(this._wrap,this.CSS_DRAG);this.dd.unreg();}}}});this.setAttributeConfig("hover",{value:D.hover||false,validator:YAHOO.lang.isBoolean});this.setAttributeConfig("hiddenHandles",{value:D.hiddenHandles||false,validator:YAHOO.lang.isBoolean});this.setAttributeConfig("knobHandles",{value:D.knobHandles||false,validator:YAHOO.lang.isBoolean});this.setAttributeConfig("xTicks",{value:D.xTicks||false});this.setAttributeConfig("yTicks",{value:D.yTicks||false});this.setAttributeConfig("status",{value:D.status||false,validator:YAHOO.lang.isBoolean});this.setAttributeConfig("autoRatio",{value:D.autoRatio||false,validator:YAHOO.lang.isBoolean});},destroy:function(){for(var F in this._handles){if(C.hasOwnProperty(this._handles,F)){A.purgeElement(this._handles[F]);this._handles[F].parentNode.removeChild(this._handles[F]);}}if(this._proxy){this._proxy.parentNode.removeChild(this._proxy);}if(this.dd){this.dd.unreg();E.removeClass(this._wrap,this.CSS_DRAG);}if(this._wrap!=this.get("element")){this.setStyle("position","");this.setStyle("top","");this.setStyle("left","");this._wrap.parentNode.replaceChild(this.get("element"),this._wrap);}this.removeClass(this.CSS_RESIZE);delete YAHOO.util.Resize._instances[this.get("id")];for(var D in this){if(C.hasOwnProperty(this,D)){this[D]=null;delete this[D];}}},toString:function(){if(this.get){return"Resize (#"+this.get("id")+")";}return"Resize Utility";}});YAHOO.util.Resize=B;})();YAHOO.register("resize",YAHOO.util.Resize,{version:"2.5.0",build:"895"}); \ No newline at end of file diff --git a/lib/yui/resize/resize-beta.js b/lib/yui/resize/resize-beta.js deleted file mode 100644 index ac6f8790de..0000000000 --- a/lib/yui/resize/resize-beta.js +++ /dev/null @@ -1,1578 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -/** - * @description
Makes an element resizable
- * @namespace YAHOO.util - * @requires yahoo, dom, dragdrop, element, event - * @optional animation - * @module resize - * @beta - */ -(function() { -var D = YAHOO.util.Dom, - Event = YAHOO.util.Event, - Lang = YAHOO.lang; - - /** - * @constructor - * @class Resize - * @extends YAHOO.util.Element - * @description
Makes an element resizable
- * @param {String/HTMLElement} el The element to make resizable. - * @param {Object} attrs Object liternal containing configuration parameters. - */ - - var Resize = function(el, config) { - var oConfig = { - element: el, - attributes: config || {} - }; - - Resize.superclass.constructor.call(this, oConfig.element, oConfig.attributes); - }; - - /** - * @private - * @static - * @property _instances - * @description Internal hash table for all resize instances - * @type Object - */ - Resize._instances = {}; - /** - * @static - * @method getResizeById - * @description Get's a resize object by the HTML id of the element associated with the Resize object. - * @return {Object} The Resize Object - */ - Resize.getResizeById = function(id) { - if (Resize._instances[id]) { - return Resize._instances[id]; - } - return false; - }; - - YAHOO.extend(Resize, YAHOO.util.Element, { - /** - * @private - * @property CSS_RESIZE - * @description Base CSS class name - * @type String - */ - CSS_RESIZE: 'yui-resize', - /** - * @private - * @property CSS_DRAG - * @description Class name added when dragging is enabled - * @type String - */ - CSS_DRAG: 'yui-draggable', - /** - * @private - * @property CSS_HOVER - * @description Class name used for hover only handles - * @type String - */ - CSS_HOVER: 'yui-resize-hover', - /** - * @private - * @property CSS_PROXY - * @description Class name given to the proxy element - * @type String - */ - CSS_PROXY: 'yui-resize-proxy', - /** - * @private - * @property CSS_WRAP - * @description Class name given to the wrap element - * @type String - */ - CSS_WRAP: 'yui-resize-wrap', - /** - * @private - * @property CSS_KNOB - * @description Class name used to make the knob style handles - * @type String - */ - CSS_KNOB: 'yui-resize-knob', - /** - * @private - * @property CSS_HIDDEN - * @description Class name given to the wrap element to make all handles hidden - * @type String - */ - CSS_HIDDEN: 'yui-resize-hidden', - /** - * @private - * @property CSS_HANDLE - * @description Class name given to all handles, used as a base for single handle names as well.. Handle "t" will get this.CSS_HANDLE + '-t' as well as this.CSS_HANDLE - * @type String - */ - CSS_HANDLE: 'yui-resize-handle', - /** - * @private - * @property CSS_STATUS - * @description Class name given to the status element - * @type String - */ - CSS_STATUS: 'yui-resize-status', - /** - * @private - * @property CSS_GHOST - * @description Class name given to the wrap element when the ghost property is active - * @type String - */ - CSS_GHOST: 'yui-resize-ghost', - /** - * @private - * @property CSS_RESIZING - * @description Class name given to the wrap element when a resize action is taking place. - * @type String - */ - CSS_RESIZING: 'yui-resize-resizing', - /** - * @private - * @property _resizeEvent - * @description The mouse event used to resize with - * @type Event - */ - _resizeEvent: null, - /** - * @private - * @property dd - * @description The YAHOO.util.DragDrop instance used if draggable is true - * @type Object - */ - dd: null, - /** - * @private - * @property browser - * @description A copy of the YAHOO.env.ua property - * @type Object - */ - browser: YAHOO.env.ua, - /** - * @private - * @property _positioned - * @description A flag to show if the element is absolutely positioned - * @type Boolean - */ - _positioned: null, - /** - * @private - * @property _dds - * @description An Object containing references to all of the YAHOO.util.DragDrop instances used for the resize handles - * @type Object - */ - _dds: null, - /** - * @private - * @property _wrap - * @description The HTML reference of the element wrapper - * @type HTMLElement - */ - _wrap: null, - /** - * @private - * @property _proxy - * @description The HTML reference of the element proxy - * @type HTMLElement - */ - _proxy: null, - /** - * @private - * @property _handles - * @description An object containing references to all of the resize handles. - * @type Object - */ - _handles: null, - /** - * @private - * @property _currentHandle - * @description The string identifier of the currently active handle. e.g. 'r', 'br', 'tl' - * @type String - */ - _currentHandle: null, - /** - * @private - * @property _currentDD - * @description A link to the currently active DD object - * @type Object - */ - _currentDD: null, - /** - * @private - * @property _cache - * @description An lookup table containing key information for the element being resized. e.g. height, width, x position, y position, etc.. - * @type Object - */ - _cache: null, - /** - * @private - * @property _active - * @description Flag to show if the resize is active. Used for events. - * @type Boolean - */ - _active: null, - /** - * @private - * @method _createProxy - * @description Creates the proxy element if the proxy config is true - */ - _createProxy: function() { - if (this.get('proxy')) { - this._proxy = document.createElement('div'); - this._proxy.className = this.CSS_PROXY; - this._proxy.style.height = this.get('element').clientHeight + 'px'; - this._proxy.style.width = this.get('element').clientWidth + 'px'; - this._wrap.parentNode.appendChild(this._proxy); - } else { - this.set('animate', false); - } - }, - /** - * @private - * @method _createWrap - * @description Creates the wrap element if the wrap config is true. It will auto wrap the following element types: img, textarea, input, iframe, select - */ - _createWrap: function() { - this._positioned = false; - //Force wrap for elements that can't have children - switch (this.get('element').tagName.toLowerCase()) { - case 'img': - case 'textarea': - case 'input': - case 'iframe': - case 'select': - this.set('wrap', true); - break; - } - if (this.get('wrap')) { - this._wrap = document.createElement('div'); - this._wrap.id = this.get('element').id + '_wrap'; - this._wrap.className = this.CSS_WRAP; - D.setStyle(this._wrap, 'width', this.get('width')); - D.setStyle(this._wrap, 'height', this.get('height')); - D.setStyle(this._wrap, 'z-index', this.getStyle('z-index')); - this.setStyle('z-index', 0); - var pos = D.getStyle(this.get('element'), 'position'); - D.setStyle(this._wrap, 'position', ((pos == 'static') ? 'relative' : pos)); - D.setStyle(this._wrap, 'top', D.getStyle(this.get('element'), 'top')); - D.setStyle(this._wrap, 'left', D.getStyle(this.get('element'), 'left')); - if (D.getStyle(this.get('element'), 'position') == 'absolute') { - this._positioned = true; - D.setStyle(this.get('element'), 'position', 'relative'); - D.setStyle(this.get('element'), 'top', '0'); - D.setStyle(this.get('element'), 'left', '0'); - } - var par = this.get('element').parentNode; - par.replaceChild(this._wrap, this.get('element')); - this._wrap.appendChild(this.get('element')); - } else { - this._wrap = this.get('element'); - if (D.getStyle(this._wrap, 'position') == 'absolute') { - this._positioned = true; - } - } - if (this.get('draggable')) { - this._setupDragDrop(); - } - if (this.get('hover')) { - D.addClass(this._wrap, this.CSS_HOVER); - } - if (this.get('knobHandles')) { - D.addClass(this._wrap, this.CSS_KNOB); - } - if (this.get('hiddenHandles')) { - D.addClass(this._wrap, this.CSS_HIDDEN); - } - D.addClass(this._wrap, this.CSS_RESIZE); - }, - /** - * @private - * @method _setupDragDrop - * @description Setup the YAHOO.util.DragDrop instance on the element - */ - _setupDragDrop: function() { - D.addClass(this._wrap, this.CSS_DRAG); - this.dd = new YAHOO.util.DD(this._wrap, this.get('id') + '-resize', { dragOnly: true }); - this.dd.on('dragEvent', function() { - this.fireEvent('dragEvent', arguments); - }, this, true); - }, - /** - * @private - * @method _createHandles - * @description Creates the handles as specified in the config - */ - _createHandles: function() { - this._handles = {}; - this._dds = {}; - var h = this.get('handles'); - for (var i = 0; i < h.length; i++) { - this._handles[h[i]] = document.createElement('div'); - this._handles[h[i]].id = D.generateId(this._handles[h[i]]); - this._handles[h[i]].className = this.CSS_HANDLE + ' ' + this.CSS_HANDLE + '-' + h[i]; - var k = document.createElement('div'); - k.className = this.CSS_HANDLE + '-inner-' + h[i]; - this._handles[h[i]].appendChild(k); - this._wrap.appendChild(this._handles[h[i]]); - Event.on(this._handles[h[i]], 'mouseover', this._handleMouseOver, this, true); - Event.on(this._handles[h[i]], 'mouseout', this._handleMouseOut, this, true); - this._dds[h[i]] = new YAHOO.util.DragDrop(this._handles[h[i]], this.get('id') + '-handle-' + h); - this._dds[h[i]].setPadding(15, 15, 15, 15); - this._dds[h[i]].on('startDragEvent', this._handleStartDrag, this._dds[h[i]], this); - this._dds[h[i]].on('mouseDownEvent', this._handleMouseDown, this._dds[h[i]], this); - } - this._status = document.createElement('span'); - this._status.className = this.CSS_STATUS; - document.body.insertBefore(this._status, document.body.firstChild); - }, - /** - * @private - * @method _ieSelectFix - * @description The function we use as the onselectstart handler when we start a drag in Internet Explorer - */ - _ieSelectFix: function() { - return false; - }, - /** - * @private - * @property _ieSelectBack - * @description We will hold a copy of the current "onselectstart" method on this property, and reset it after we are done using it. - */ - _ieSelectBack: null, - /** - * @private - * @method _setAutoRatio - * @param {Event} ev A mouse event. - * @description This method checks to see if the "autoRatio" config is set. If it is, we will check to see if the "Shift Key" is pressed. If so, we will set the config ratio to true. - */ - _setAutoRatio: function(ev) { - if (this.get('autoRatio')) { - if (ev && ev.shiftKey) { - //Shift Pressed - this.set('ratio', true); - } else { - this.set('ratio', this._configs.ratio._initialConfig.value); - } - } - }, - /** - * @private - * @method _handleMouseDown - * @param {Event} ev A mouse event. - * @description This method preps the autoRatio on MouseDown. - */ - _handleMouseDown: function(ev) { - if (D.getStyle(this._wrap, 'position') == 'absolute') { - this._positioned = true; - } - if (ev) { - this._setAutoRatio(ev); - } - if (this.browser.ie) { - this._ieSelectBack = document.body.onselectstart; - document.body.onselectstart = this._ieSelectFix; - } - }, - /** - * @private - * @method _handleMouseOver - * @param {Event} ev A mouse event. - * @description Adds CSS class names to the handles - */ - _handleMouseOver: function(ev) { - //Internet Explorer needs this - D.removeClass(this._wrap, this.CSS_RESIZE); - if (this.get('hover')) { - D.removeClass(this._wrap, this.CSS_HOVER); - } - var tar = Event.getTarget(ev); - if (!D.hasClass(tar, this.CSS_HANDLE)) { - tar = tar.parentNode; - } - if (D.hasClass(tar, this.CSS_HANDLE) && !this._active) { - D.addClass(tar, this.CSS_HANDLE + '-active'); - for (var i in this._handles) { - if (Lang.hasOwnProperty(this._handles, i)) { - if (this._handles[i] == tar) { - D.addClass(tar, this.CSS_HANDLE + '-' + i + '-active'); - break; - } - } - } - } - - //Internet Explorer needs this - D.addClass(this._wrap, this.CSS_RESIZE); - }, - /** - * @private - * @method _handleMouseOut - * @param {Event} ev A mouse event. - * @description Removes CSS class names to the handles - */ - _handleMouseOut: function(ev) { - //Internet Explorer needs this - D.removeClass(this._wrap, this.CSS_RESIZE); - if (this.get('hover') && !this._active) { - D.addClass(this._wrap, this.CSS_HOVER); - } - var tar = Event.getTarget(ev); - if (!D.hasClass(tar, this.CSS_HANDLE)) { - tar = tar.parentNode; - } - if (D.hasClass(tar, this.CSS_HANDLE) && !this._active) { - D.removeClass(tar, this.CSS_HANDLE + '-active'); - for (var i in this._handles) { - if (Lang.hasOwnProperty(this._handles, i)) { - if (this._handles[i] == tar) { - D.removeClass(tar, this.CSS_HANDLE + '-' + i + '-active'); - break; - } - } - } - } - //Internet Explorer needs this - D.addClass(this._wrap, this.CSS_RESIZE); - }, - /** - * @private - * @method _handleStartDrag - * @param {Object} args The args passed from the CustomEvent. - * @param {Object} dd The YAHOO.util.DragDrop object we are working with. - * @description Resizes the proxy, sets up the YAHOO.util.DragDrop handlers, updates the status div and preps the cache - */ - _handleStartDrag: function(args, dd) { - var tar = dd.getDragEl(); - if (D.hasClass(tar, this.CSS_HANDLE)) { - if (D.getStyle(this._wrap, 'position') == 'absolute') { - this._positioned = true; - } - this._active = true; - this._currentDD = dd; - if (this._proxy) { - this._proxy.style.visibility = 'visible'; - this._proxy.style.zIndex = '1000'; - this._proxy.style.height = this.get('element').clientHeight + 'px'; - this._proxy.style.width = this.get('element').clientWidth + 'px'; - } - - for (var i in this._handles) { - if (Lang.hasOwnProperty(this._handles, i)) { - if (this._handles[i] == tar) { - this._currentHandle = i; - var handle = '_handle_for_' + i; - D.addClass(tar, this.CSS_HANDLE + '-' + i + '-active'); - dd.on('dragEvent', this[handle], this, true); - dd.on('mouseUpEvent', this._handleMouseUp, this, true); - break; - } - } - } - - - D.addClass(tar, this.CSS_HANDLE + '-active'); - - if (this.get('proxy')) { - var xy = D.getXY(this.get('element')); - D.setXY(this._proxy, xy); - if (this.get('ghost')) { - this.addClass(this.CSS_GHOST); - } - } - D.addClass(this._wrap, this.CSS_RESIZING); - this._setCache(); - this._updateStatus(this._cache.height, this._cache.width, this._cache.top, this._cache.left); - this.fireEvent('startResize', { type: 'startresize', target: this}); - } - }, - /** - * @private - * @method _setCache - * @description Sets up the this._cache hash table. - */ - _setCache: function() { - this._cache.xy = D.getXY(this._wrap); - D.setXY(this._wrap, this._cache.xy); - this._cache.height = this.get('clientHeight'); - this._cache.width = this.get('clientWidth'); - this._cache.start.height = this._cache.height; - this._cache.start.width = this._cache.width; - this._cache.start.top = this._cache.xy[1]; - this._cache.start.left = this._cache.xy[0]; - this._cache.top = this._cache.xy[1]; - this._cache.left = this._cache.xy[0]; - }, - /** - * @private - * @method _handleMouseUp - * @param {Event} ev A mouse event. - * @description Cleans up listeners, hides proxy element and removes class names. - */ - _handleMouseUp: function(ev) { - this._active = false; - - var handle = '_handle_for_' + this._currentHandle; - this._currentDD.unsubscribe('dragEvent', this[handle], this, true); - this._currentDD.unsubscribe('mouseUpEvent', this._handleMouseUp, this, true); - - D.removeClass(this._handles[this._currentHandle], this.CSS_HANDLE + '-' + this._currentHandle + '-active'); - D.removeClass(this._handles[this._currentHandle], this.CSS_HANDLE + '-active'); - - this._currentHandle = null; - if (!this.get('animate')) { - if (this.get('setSize')) { - this.set('height', this._cache.height); - this.set('width', this._cache.width); - } else { - this.set('height', this._cache.height, true); - this.set('width', this._cache.width, true); - } - } - - if (this._proxy) { - this._proxy.style.visibility = 'hidden'; - this._proxy.style.zIndex = '-1'; - if (this.get('setSize')) { - this.resize(ev, this._cache.height, this._cache.width, this._cache.top, this._cache.left, true); - } else { - this.fireEvent('resize', { ev: 'resize', target: this, height: this._cache.height, width: this._cache.width, top: this._cache.top, left: this._cache.left }); - } - - if (this.get('ghost')) { - this.removeClass(this.CSS_GHOST); - } - } - - D.removeClass(this._wrap, this.CSS_RESIZING); - if (this.get('hover')) { - D.addClass(this._wrap, this.CSS_HOVER); - } - if (this._status) { - D.setStyle(this._status, 'display', 'none'); - } - if (this.browser.ie) { - document.body.onselectstart = this._ieSelectBack; - } - for (var i in this._handles) { - if (Lang.hasOwnProperty(this._handles, i)) { - D.removeClass(this._handles[i], this.CSS_HANDLE + '-active'); - } - } - if (this.get('hover') && !this._active) { - D.addClass(this._wrap, this.CSS_HOVER); - } - this._resizeEvent = null; - }, - /** - * @private - * @method _setRatio - * @param {Number} h The height offset. - * @param {Number} w The with offset. - * @param {Number} t The top offset. - * @param {Number} l The left offset. - * @description Using the Height, Width, Top & Left, it recalcuates them based on the original element size. - * @return {Array} The new Height, Width, Top & Left settings - */ - _setRatio: function(h, w, t, l) { - var oh = h, ow = w; - if (this.get('ratio')) { - var orgH = this._cache.height, - orgW = this._cache.width, - nh = parseInt(this.get('height'), 10), - nw = parseInt(this.get('width'), 10), - maxH = this.get('maxHeight'), - minH = this.get('minHeight'), - maxW = this.get('maxWidth'), - minW = this.get('minWidth'); - - switch (this._currentHandle) { - case 'l': - h = nh * (w / nw); - h = Math.min(Math.max(minH, h), maxH); - w = nw * (h / nh); - t = (this._cache.start.top - (-((nh - h) / 2))); - l = (this._cache.start.left - (-((nw - w)))); - break; - case 'r': - h = nh * (w / nw); - h = Math.min(Math.max(minH, h), maxH); - w = nw * (h / nh); - t = (this._cache.start.top - (-((nh - h) / 2))); - break; - case 't': - w = nw * (h / nh); - h = nh * (w / nw); - l = (this._cache.start.left - (-((nw - w) / 2))); - t = (this._cache.start.top - (-((nh - h)))); - break; - case 'b': - w = nw * (h / nh); - h = nh * (w / nw); - l = (this._cache.start.left - (-((nw - w) / 2))); - break; - case 'bl': - h = nh * (w / nw); - w = nw * (h / nh); - l = (this._cache.start.left - (-((nw - w)))); - break; - case 'br': - h = nh * (w / nw); - w = nw * (h / nh); - break; - case 'tl': - h = nh * (w / nw); - w = nw * (h / nh); - l = (this._cache.start.left - (-((nw - w)))); - t = (this._cache.start.top - (-((nh - h)))); - break; - case 'tr': - h = nh * (w / nw); - w = nw * (h / nh); - l = (this._cache.start.left); - t = (this._cache.start.top - (-((nh - h)))); - break; - } - oh = this._checkHeight(h); - ow = this._checkWidth(w); - if ((oh != h) || (ow != w)) { - t = 0; - l = 0; - } - } - return [oh, ow, t, l]; - }, - /** - * @private - * @method _updateStatus - * @param {Number} h The new height setting. - * @param {Number} w The new width setting. - * @param {Number} t The new top setting. - * @param {Number} l The new left setting. - * @description Using the Height, Width, Top & Left, it updates the status element with the elements sizes. - */ - _updateStatus: function(h, w, t, l) { - if (this._resizeEvent && (!Lang.isString(this._resizeEvent))) { - if (this.get('status')) { - D.setStyle(this._status, 'display', 'inline'); - } - h = ((h === 0) ? this._cache.start.height : h); - w = ((w === 0) ? this._cache.start.width : w); - var h1 = parseInt(this.get('height'), 10), - w1 = parseInt(this.get('width'), 10); - - if (isNaN(h1)) { - h1 = parseInt(h, 10); - } - if (isNaN(w1)) { - w1 = parseInt(w, 10); - } - var diffH = (parseInt(h, 10) - h1); - var diffW = (parseInt(w, 10) - w1); - this._cache.offsetHeight = diffH; - this._cache.offsetWidth = diffW; - this._status.innerHTML = '' + parseInt(h, 10) + ' x ' + parseInt(w, 10) + '' + ((diffH > 0) ? '+' : '') + diffH + ' x ' + ((diffW > 0) ? '+' : '') + diffW + ''; - D.setXY(this._status, [Event.getPageX(this._resizeEvent) + 12, Event.getPageY(this._resizeEvent) + 12]); - } - }, - /** - * @method reset - * @description Resets the element to is start state. - * @return {YAHOO.util.Resize} The Resize instance - */ - reset: function() { - this.resize(null, this._cache.start.height, this._cache.start.width, this._cache.start.top, this._cache.start.left, true); - return this; - }, - /** - * @method resize - * @param {Event} ev The mouse event. - * @param {Number} h The new height setting. - * @param {Number} w The new width setting. - * @param {Number} t The new top setting. - * @param {Number} l The new left setting. - * @param {Boolean} force Resize the element (used for proxy resize). - * @description Resizes the element, wrapper or proxy based on the data from the handlers. - * @return {YAHOO.util.Resize} The Resize instance - */ - resize: function(ev, h, w, t, l, force) { - this._resizeEvent = ev; - var el = this._wrap, anim = this.get('animate'), set = true; - if (this._proxy && !force) { - el = this._proxy; - anim = false; - } - this._setAutoRatio(ev); - if (this._positioned) { - if (this._proxy) { - t = this._cache.top - t; - l = this._cache.left - l; - } - } - - var ratio = this._setRatio(h, w, t, l); - h = parseInt(ratio[0], 10); - w = parseInt(ratio[1], 10); - t = parseInt(ratio[2], 10); - l = parseInt(ratio[3], 10); - - if (t == 0) { - //No Offset, get from cache - t = D.getY(el); - } - if (l == 0) { - //No Offset, get from cache - l = D.getX(el); - } - - this._updateStatus(h, w, t, l); - - - if (this._positioned) { - if (this._proxy && force) { - if (!anim) { - el.style.top = this._proxy.style.top; - el.style.left = this._proxy.style.left; - } else { - t = this._proxy.style.top; - l = this._proxy.style.left; - } - } else { - if (!this.get('ratio') && !this._proxy) { - t = this._cache.top + -(t); - l = this._cache.left + -(l); - } - if (t) { - if (this.get('minY')) { - if (t < this.get('minY')) { - t = this.get('minY'); - } - } - if (this.get('maxY')) { - if ((t + h) > this.get('maxY')) { - t = (this.get('maxY') - h); - } - } - } - if (l) { - if (this.get('minX')) { - if (l < this.get('minX')) { - l = this.get('minX'); - } - } - if (this.get('maxX')) { - if ((l + w) > this.get('maxX')) { - l = (this.get('maxX') - w); - } - } - } - } - } - var beforeReturn = this.fireEvent('beforeResize', { ev: 'beforeResize', target: this, height: h, width: w, top: t, left: l }); - if (beforeReturn === false) { - return false; - } - if (this._positioned) { - if (this._proxy && force) { - //Do nothing - } else { - if (t) { - D.setY(el, t); - this._cache.top = t; - } - if (l) { - D.setX(el, l); - this._cache.left = l; - } - } - } - if (h) { - if (!anim) { - set = true; - if (this._proxy && force) { - if (!this.get('setSize')) { - set = false; - } - } - if (set) { - if (this.browser.ie > 6) { - if (h === this._cache.height) { - h = h + 1; - } - } - el.style.height = h + 'px'; - } - if ((this._proxy && force) || !this._proxy) { - if (this._wrap != this.get('element')) { - this.get('element').style.height = h + 'px'; - } - } - } - this._cache.height = h; - } - if (w) { - this._cache.width = w; - if (!anim) { - set = true; - if (this._proxy && force) { - if (!this.get('setSize')) { - set = false; - } - } - if (set) { - el.style.width = w + 'px'; - } - if ((this._proxy && force) || !this._proxy) { - if (this._wrap != this.get('element')) { - this.get('element').style.width = w + 'px'; - } - } - } - } - if (anim) { - if (YAHOO.util.Anim) { - var _anim = new YAHOO.util.Anim(el, { - height: { - to: this._cache.height - }, - width: { - to: this._cache.width - } - }, this.get('animateDuration'), this.get('animateEasing')); - if (this._positioned) { - if (t) { - _anim.attributes.top = { - to: parseInt(t, 10) - }; - } - if (l) { - _anim.attributes.left = { - to: parseInt(l, 10) - }; - } - } - - if (this._wrap != this.get('element')) { - _anim.onTween.subscribe(function() { - this.get('element').style.height = el.style.height; - this.get('element').style.width = el.style.width; - }, this, true); - } - - _anim.onComplete.subscribe(function() { - this.set('height', h); - this.set('width', w); - this.fireEvent('resize', { ev: 'resize', target: this, height: h, width: w, top: t, left: l }); - }, this, true); - _anim.animate(); - - } - } else { - if (this._proxy && !force) { - this.fireEvent('proxyResize', { ev: 'proxyresize', target: this, height: h, width: w, top: t, left: l }); - } else { - this.fireEvent('resize', { ev: 'resize', target: this, height: h, width: w, top: t, left: l }); - } - } - return this; - }, - /** - * @private - * @method _handle_for_br - * @param {Object} args The arguments from the CustomEvent. - * @description Handles the sizes for the Bottom Right handle. - */ - _handle_for_br: function(args) { - var newW = this._setWidth(args.e); - var newH = this._setHeight(args.e); - this.resize(args.e, (newH + 1), newW, 0, 0); - }, - /** - * @private - * @method _handle_for_bl - * @param {Object} args The arguments from the CustomEvent. - * @description Handles the sizes for the Bottom Left handle. - */ - _handle_for_bl: function(args) { - var newW = this._setWidth(args.e, true); - var newH = this._setHeight(args.e); - var l = (newW - this._cache.width); - this.resize(args.e, newH, newW, 0, l); - }, - /** - * @private - * @method _handle_for_tl - * @param {Object} args The arguments from the CustomEvent. - * @description Handles the sizes for the Top Left handle. - */ - _handle_for_tl: function(args) { - var newW = this._setWidth(args.e, true); - var newH = this._setHeight(args.e, true); - var t = (newH - this._cache.height); - var l = (newW - this._cache.width); - this.resize(args.e, newH, newW, t, l); - }, - /** - * @private - * @method _handle_for_tr - * @param {Object} args The arguments from the CustomEvent. - * @description Handles the sizes for the Top Right handle. - */ - _handle_for_tr: function(args) { - var newW = this._setWidth(args.e); - var newH = this._setHeight(args.e, true); - var t = (newH - this._cache.height); - this.resize(args.e, newH, newW, t, 0); - }, - /** - * @private - * @method _handle_for_r - * @param {Object} args The arguments from the CustomEvent. - * @description Handles the sizes for the Right handle. - */ - _handle_for_r: function(args) { - this._dds.r.setYConstraint(0,0); - var newW = this._setWidth(args.e); - this.resize(args.e, 0, newW, 0, 0); - }, - /** - * @private - * @method _handle_for_l - * @param {Object} args The arguments from the CustomEvent. - * @description Handles the sizes for the Left handle. - */ - _handle_for_l: function(args) { - this._dds.l.setYConstraint(0,0); - var newW = this._setWidth(args.e, true); - var l = (newW - this._cache.width); - this.resize(args.e, 0, newW, 0, l); - }, - /** - * @private - * @method _handle_for_b - * @param {Object} args The arguments from the CustomEvent. - * @description Handles the sizes for the Bottom handle. - */ - _handle_for_b: function(args) { - this._dds.b.setXConstraint(0,0); - var newH = this._setHeight(args.e); - this.resize(args.e, newH, 0, 0, 0); - }, - /** - * @private - * @method _handle_for_t - * @param {Object} args The arguments from the CustomEvent. - * @description Handles the sizes for the Top handle. - */ - _handle_for_t: function(args) { - this._dds.t.setXConstraint(0,0); - var newH = this._setHeight(args.e, true); - var t = (newH - this._cache.height); - this.resize(args.e, newH, 0, t, 0); - }, - /** - * @private - * @method _setWidth - * @param {Event} ev The mouse event. - * @param {Boolean} flip Argument to determine the direction of the movement. - * @description Calculates the width based on the mouse event. - * @return {Number} The new value - */ - _setWidth: function(ev, flip) { - var xy = this._cache.xy[0], - w = this._cache.width, - x = Event.getPageX(ev), - nw = (x - xy); - - if (flip) { - nw = (xy - x) + parseInt(this.get('width'), 10); - } - - nw = this._snapTick(nw, this.get('yTicks')); - nw = this._checkWidth(nw); - return nw; - }, - /** - * @private - * @method _checkWidth - * @param {Number} w The width to check. - * @description Checks the value passed against the maxWidth and minWidth. - * @return {Number} the new value - */ - _checkWidth: function(w) { - if (this.get('minWidth')) { - if (w <= this.get('minWidth')) { - w = this.get('minWidth'); - } - } - if (this.get('maxWidth')) { - if (w >= this.get('maxWidth')) { - w = this.get('maxWidth'); - } - } - return w; - }, - /** - * @private - * @method _checkHeight - * @param {Number} h The height to check. - * @description Checks the value passed against the maxHeight and minHeight. - * @return {Number} The new value - */ - _checkHeight: function(h) { - if (this.get('minHeight')) { - if (h <= this.get('minHeight')) { - h = this.get('minHeight'); - } - } - if (this.get('maxHeight')) { - if (h >= this.get('maxHeight')) { - h = this.get('maxHeight'); - } - } - return h; - }, - /** - * @private - * @method _setHeight - * @param {Event} ev The mouse event. - * @param {Boolean} flip Argument to determine the direction of the movement. - * @description Calculated the height based on the mouse event. - * @return {Number} The new value - */ - _setHeight: function(ev, flip) { - var xy = this._cache.xy[1], - h = this._cache.height, - y = Event.getPageY(ev), - nh = (y - xy); - - if (flip) { - nh = (xy - y) + parseInt(this.get('height'), 10); - } - nh = this._snapTick(nh, this.get('xTicks')); - nh = this._checkHeight(nh); - - return nh; - }, - /** - * @private - * @method _snapTick - * @param {Number} size The size to tick against. - * @param {Number} pix The tick pixels. - * @description Adjusts the number based on the ticks used. - * @return {Number} the new snapped position - */ - _snapTick: function(size, pix) { - if (!size || !pix) { - return size; - } - var _s = size; - var _x = size % pix; - if (_x > 0) { - if (_x > (pix / 2)) { - _s = size + (pix - _x); - } else { - _s = size - _x; - } - } - return _s; - }, - /** - * @private - * @method init - * @description The Resize class's initialization method - */ - init: function(p_oElement, p_oAttributes) { - this._cache = { - xy: [], - height: 0, - width: 0, - top: 0, - left: 0, - offsetHeight: 0, - offsetWidth: 0, - start: { - height: 0, - width: 0, - top: 0, - left: 0 - } - }; - - Resize.superclass.init.call(this, p_oElement, p_oAttributes); - - this.set('setSize', this.get('setSize')); - - if (p_oAttributes.height) { - this.set('height', parseInt(p_oAttributes.height, 10)); - } - if (p_oAttributes.width) { - this.set('width', parseInt(p_oAttributes.width, 10)); - } - - var id = p_oElement; - if (!Lang.isString(id)) { - id = D.generateId(id); - } - Resize._instances[id] = this; - - this._active = false; - - this._createWrap(); - this._createProxy(); - this._createHandles(); - - }, - /** - * @method getProxyEl - * @description Get the HTML reference for the proxy, returns null if no proxy. - * @return {HTMLElement} The proxy element - */ - getProxyEl: function() { - return this._proxy; - }, - /** - * @method getWrapEl - * @description Get the HTML reference for the wrap element, returns the current element if not wrapped. - * @return {HTMLElement} The wrap element - */ - getWrapEl: function() { - return this._wrap; - }, - /** - * @method getStatusEl - * @description Get the HTML reference for the status element. - * @return {HTMLElement} The status element - */ - getStatusEl: function() { - return this._status; - }, - /** - * @method getActiveHandleEl - * @description Get the HTML reference for the currently active resize handle. - * @return {HTMLElement} The handle element that is active - */ - getActiveHandleEl: function() { - return this._handles[this._currentHandle]; - }, - /** - * @method isActive - * @description Returns true or false if a resize operation is currently active on the element. - * @return {Boolean} - */ - isActive: function() { - return ((this._active) ? true : false); - }, - /** - * @private - * @method initAttributes - * @description Initializes all of the configuration attributes used to create a resizable element. - * @param {Object} attr Object literal specifying a set of - * configuration attributes used to create the utility. - */ - initAttributes: function(attr) { - Resize.superclass.initAttributes.call(this, attr); - - /** - * @attribute setSize - * @description Set the size of the resized element, if set to false the element will not be auto resized, - * the resize event will contain the dimensions so the end user can resize it on their own. - * This setting will only work with proxy set to true and animate set to false. - * @type Boolean - */ - this.setAttributeConfig('setSize', { - value: ((attr.setSize === false) ? false : true), - validator: YAHOO.lang.isBoolean - }); - - /** - * @attribute wrap - * @description Should we wrap the element - * @type Boolean - */ - this.setAttributeConfig('wrap', { - writeOnce: true, - validator: YAHOO.lang.isBoolean, - value: attr.wrap || false - }); - - /** - * @attribute handles - * @description The handles to use (any combination of): 't', 'b', 'r', 'l', 'bl', 'br', 'tl', 'tr'. Defaults to: ['r', 'b', 'br']. - * Can use a shortcut of All. Note: 8 way resizing should be done on an element that is absolutely positioned. - * @type Array - */ - this.setAttributeConfig('handles', { - writeOnce: true, - value: attr.handles || ['r', 'b', 'br'], - validator: function(handles) { - if (Lang.isString(handles) && handles.toLowerCase() == 'all') { - handles = ['t', 'b', 'r', 'l', 'bl', 'br', 'tl', 'tr']; - } - if (!Lang.isArray(handles)) { - handles = handles.replace(/, /g, ','); - handles = handles.split(','); - } - this._configs.handles.value = handles; - } - }); - - /** - * @attribute width - * @description The width of the element - * @type Number - */ - this.setAttributeConfig('width', { - value: attr.width || parseInt(this.getStyle('width'), 10), - validator: YAHOO.lang.isNumber, - method: function(width) { - width = parseInt(width, 10); - if (width > 0) { - if (this.get('setSize')) { - this.setStyle('width', width + 'px'); - } - this._cache.width = width; - this._configs.width.value = width; - } - } - }); - - /** - * @attribute height - * @description The height of the element - * @type Number - */ - this.setAttributeConfig('height', { - value: attr.height || parseInt(this.getStyle('height'), 10), - validator: YAHOO.lang.isNumber, - method: function(height) { - height = parseInt(height, 10); - if (height > 0) { - if (this.get('setSize')) { - this.setStyle('height', height + 'px'); - } - this._cache.height = height; - this._configs.height.value = height; - } - } - }); - - /** - * @attribute minWidth - * @description The minimum width of the element - * @type Number - */ - this.setAttributeConfig('minWidth', { - value: attr.minWidth || 15, - validator: YAHOO.lang.isNumber - }); - - /** - * @attribute minHeight - * @description The minimum height of the element - * @type Number - */ - this.setAttributeConfig('minHeight', { - value: attr.minHeight || 15, - validator: YAHOO.lang.isNumber - }); - - /** - * @attribute maxWidth - * @description The maximum width of the element - * @type Number - */ - this.setAttributeConfig('maxWidth', { - value: attr.maxWidth || 10000, - validator: YAHOO.lang.isNumber - }); - - /** - * @attribute maxHeight - * @description The maximum height of the element - * @type Number - */ - this.setAttributeConfig('maxHeight', { - value: attr.maxHeight || 10000, - validator: YAHOO.lang.isNumber - }); - - /** - * @attribute minY - * @description The minimum y coord of the element - * @type Number - */ - this.setAttributeConfig('minY', { - value: attr.minY || false - }); - - /** - * @attribute minX - * @description The minimum x coord of the element - * @type Number - */ - this.setAttributeConfig('minX', { - value: attr.minX || false - }); - /** - * @attribute maxY - * @description The max y coord of the element - * @type Number - */ - this.setAttributeConfig('maxY', { - value: attr.maxY || false - }); - - /** - * @attribute maxX - * @description The max x coord of the element - * @type Number - */ - this.setAttributeConfig('maxX', { - value: attr.maxX || false - }); - - /** - * @attribute animate - * @description Should be use animation to resize the element (can only be used if we use proxy). - * @type Boolean - */ - this.setAttributeConfig('animate', { - value: attr.animate || false, - validator: function(value) { - var ret = true; - if (!YAHOO.util.Anim) { - ret = false; - } - return ret; - } - }); - - /** - * @attribute animateEasing - * @description The Easing to apply to the animation. - * @type Object - */ - this.setAttributeConfig('animateEasing', { - value: attr.animateEasing || function() { - var easing = false; - try { - easing = YAHOO.util.Easing.easeOut; - } catch (e) {} - return easing; - }() - }); - - /** - * @attribute animateDuration - * @description The Duration to apply to the animation. - * @type Number - */ - this.setAttributeConfig('animateDuration', { - value: attr.animateDuration || 0.5 - }); - - /** - * @attribute proxy - * @description Resize a proxy element instead of the real element. - * @type Boolean - */ - this.setAttributeConfig('proxy', { - value: attr.proxy || false, - validator: YAHOO.lang.isBoolean - }); - - /** - * @attribute ratio - * @description Maintain the element's ratio when resizing. - * @type Boolean - */ - this.setAttributeConfig('ratio', { - value: attr.ratio || false, - validator: YAHOO.lang.isBoolean - }); - - /** - * @attribute ghost - * @description Apply an opacity filter to the element being resized (only works with proxy). - * @type Boolean - */ - this.setAttributeConfig('ghost', { - value: attr.ghost || false, - validator: YAHOO.lang.isBoolean - }); - - /** - * @attribute draggable - * @description A convienence method to make the element draggable - * @type Boolean - */ - this.setAttributeConfig('draggable', { - value: attr.draggable || false, - validator: YAHOO.lang.isBoolean, - method: function(dd) { - if (dd && this._wrap) { - this._setupDragDrop(); - } else { - if (this.dd) { - D.removeClass(this._wrap, this.CSS_DRAG); - this.dd.unreg(); - } - } - } - }); - - /** - * @attribute hover - * @description Only show the handles when they are being moused over. - * @type Boolean - */ - this.setAttributeConfig('hover', { - value: attr.hover || false, - validator: YAHOO.lang.isBoolean - }); - - /** - * @attribute hiddenHandles - * @description Don't show the handles, just use the cursor to the user. - * @type Boolean - */ - this.setAttributeConfig('hiddenHandles', { - value: attr.hiddenHandles || false, - validator: YAHOO.lang.isBoolean - }); - - /** - * @attribute knobHandles - * @description Use the smaller handles, instead if the full size handles. - * @type Boolean - */ - this.setAttributeConfig('knobHandles', { - value: attr.knobHandles || false, - validator: YAHOO.lang.isBoolean - }); - - /** - * @attribute xTicks - * @description The number of x ticks to span the resize to. - * @type Number or False - */ - this.setAttributeConfig('xTicks', { - value: attr.xTicks || false - }); - - /** - * @attribute yTicks - * @description The number of y ticks to span the resize to. - * @type Number or False - */ - this.setAttributeConfig('yTicks', { - value: attr.yTicks || false - }); - - /** - * @attribute status - * @description Show the status (new size) of the resize. - * @type Boolean - */ - this.setAttributeConfig('status', { - value: attr.status || false, - validator: YAHOO.lang.isBoolean - }); - - /** - * @attribute autoRatio - * @description Using the shift key during a resize will toggle the ratio config. - * @type Boolean - */ - this.setAttributeConfig('autoRatio', { - value: attr.autoRatio || false, - validator: YAHOO.lang.isBoolean - }); - - }, - /** - * @method destroy - * @description Destroys the resize object and all of it's elements & listeners. - */ - destroy: function() { - for (var h in this._handles) { - if (Lang.hasOwnProperty(this._handles, h)) { - Event.purgeElement(this._handles[h]); - this._handles[h].parentNode.removeChild(this._handles[h]); - } - } - if (this._proxy) { - this._proxy.parentNode.removeChild(this._proxy); - } - if (this.dd) { - this.dd.unreg(); - D.removeClass(this._wrap, this.CSS_DRAG); - } - if (this._wrap != this.get('element')) { - this.setStyle('position', ''); - this.setStyle('top', ''); - this.setStyle('left', ''); - this._wrap.parentNode.replaceChild(this.get('element'), this._wrap); - } - this.removeClass(this.CSS_RESIZE); - - delete YAHOO.util.Resize._instances[this.get('id')]; - //Brutal Object Destroy - for (var i in this) { - if (Lang.hasOwnProperty(this, i)) { - this[i] = null; - delete this[i]; - } - } - }, - /** - * @method toString - * @description Returns a string representing the Resize Object. - * @return {String} - */ - toString: function() { - if (this.get) { - return 'Resize (#' + this.get('id') + ')'; - } - return 'Resize Utility'; - } - }); - - YAHOO.util.Resize = Resize; - -/** -* @event dragEvent -* @description Fires when the YAHOO.util.DragDrop dragEvent is fired for the config option draggable. -* @type YAHOO.util.CustomEvent -*/ -/** -* @event startResize -* @description Fires when when a resize action is started. -* @type YAHOO.util.CustomEvent -*/ -/** -* @event resize -* @description Fires on every element resize (only fires once when used with proxy config setting). -* @type YAHOO.util.CustomEvent -*/ -/** -* @event beforeResize -* @description Fires before every element resize after the size calculations, returning false will stop the resize. -* @type YAHOO.util.CustomEvent -*/ -/** -* @event proxyResize -* @description Fires on every proxy resize (only fires when used with proxy config setting). -* @type YAHOO.util.CustomEvent -*/ - -})(); - -YAHOO.register("resize", YAHOO.util.Resize, {version: "2.5.0", build: "895"}); diff --git a/lib/yui/selector/README b/lib/yui/selector/README deleted file mode 100644 index 3603e21c6b..0000000000 --- a/lib/yui/selector/README +++ /dev/null @@ -1,11 +0,0 @@ -YUI Library - Selector - Release Notes - -2.5.0 - - * query() now returns single node (not array) when firstOnly is true - * filter() now works with ID input - * pseudos and attributes correctly handle spaces - -2.4.0 - - * Beta release diff --git a/lib/yui/selector/selector-beta-debug.js b/lib/yui/selector/selector-beta-debug.js deleted file mode 100644 index 32b86c4a57..0000000000 --- a/lib/yui/selector/selector-beta-debug.js +++ /dev/null @@ -1,668 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -/** - * The selector module provides helper methods allowing CSS3 Selectors to be used with DOM elements. - * @module selector - * @title Selector Utility - * @namespace YAHOO.util - * @requires yahoo, dom - */ - -(function() { -/** - * Provides helper methods for collecting and filtering DOM elements. - * @namespace YAHOO.util - * @class Selector - * @static - */ -var Selector = function() {}; - -var Y = YAHOO.util; - -var X = { - BEGIN: '^', - END: '$', - OR: '|', - SP: '\\s+' -}; - -X.BEGIN_SPACE = '(?:' + X.BEGIN + X.OR + X.SP +')'; -X.END_SPACE = '(?:' + X.SP + X.OR + X.END + ')'; -X.NTH_CHILD = '^(?:([-]?\\d*)(n){1}|(odd|even)$)*([-+]?\\d*)$'; - -Selector.prototype = { - /** - * Default document for use queries - * @property document - * @type object - * @default window.document - */ - document: window.document, - /** - * Mapping of attributes to aliases, normally to work around HTMLAttributes - * that conflict with JS reserved words. - * @property attrAliases - * @type object - */ - attrAliases: { - 'for': 'htmlFor' - }, - - /** - * Mapping of shorthand tokens to corresponding attribute selector - * @property shorthand - * @type object - */ - shorthand: { - //'(?:(?:[^\\)\\]\\s*>+~,]+)(?:-?[_a-z]+[-\\w]))+#(-?[_a-z]+[-\\w]*)': '[id=$1]', - '\\#(-?[_a-z]+[-\\w]*)': '[id=$1]', - '\\.(-?[_a-z]+[-\\w]*)': '[class~=$1]' - }, - - /** - * List of operators and corresponding boolean functions. - * These functions are passed the attribute and the current node's value of the attribute. - * @property operators - * @type object - */ - operators: { - '=': function(attr, val) { return attr === val; }, // Equality - '!=': function(attr, val) { return attr !== val; }, // Inequality - '~=': function(attr, val) { // Match one of space seperated words - var s = ' '; - return (s + attr + s).indexOf((s + val + s)) > -1; - }, - '|=': function(attr, val) { return getRegExp(X.BEGIN + val + '[-]?').test(attr); }, // Match start with value followed by optional hyphen - '^=': function(attr, val) { return attr.indexOf(val) === 0; }, // Match starts with value - '$=': function(attr, val) { return attr.lastIndexOf(val) === attr.length - val.length; }, // Match ends with value - '*=': function(attr, val) { return attr.indexOf(val) > -1; }, // Match contains value as substring - '': function(attr, val) { return attr; } // Just test for existence of attribute - }, - - /** - * List of pseudo-classes and corresponding boolean functions. - * These functions are called with the current node, and any value that was parsed with the pseudo regex. - * @property pseudos - * @type object - */ - pseudos: { - 'root': function(node) { - return node === node.ownerDocument.documentElement; - }, - - 'nth-child': function(node, val) { - return getNth(node, val); - }, - - 'nth-last-child': function(node, val) { - return getNth(node, val, null, true); - }, - - 'nth-of-type': function(node, val) { - return getNth(node, val, node.tagName); - }, - - 'nth-last-of-type': function(node, val) { - return getNth(node, val, node.tagName, true); - }, - - 'first-child': function(node) { - return getChildren(node.parentNode)[0] === node; - }, - - 'last-child': function(node) { - var children = getChildren(node.parentNode); - return children[children.length - 1] === node; - }, - - 'first-of-type': function(node, val) { - return getChildren(node.parentNode, node.tagName.toLowerCase())[0]; - }, - - 'last-of-type': function(node, val) { - var children = getChildren(node.parentNode, node.tagName.toLowerCase()); - return children[children.length - 1]; - }, - - 'only-child': function(node) { - var children = getChildren(node.parentNode); - return children.length === 1 && children[0] === node; - }, - - 'only-of-type': function(node) { - return getChildren(node.parentNode, node.tagName.toLowerCase()).length === 1; - }, - - 'empty': function(node) { - return node.childNodes.length === 0; - }, - - 'not': function(node, simple) { - return !Selector.test(node, simple); - }, - - 'contains': function(node, str) { - var text = node.innerText || node.textContent || ''; - return text.indexOf(str) > -1; - }, - 'checked': function(node) { - return node.checked === true; - } - }, - - /** - * Test if the supplied node matches the supplied selector. - * @method test - * - * @param {HTMLElement | String} node An id or node reference to the HTMLElement being tested. - * @param {string} selector The CSS Selector to test the node against. - * @return{boolean} Whether or not the node matches the selector. - * @static - - */ - test: function(node, selector) { - node = Selector.document.getElementById(node) || node; - var groups = selector ? selector.split(',') : []; - if (groups.length) { - for (var i = 0, len = groups.length; i < len; ++i) { - if ( rTestNode(node, groups[i]) ) { // passes if ANY group matches - return true; - } - } - return false; - } - return rTestNode(node, selector); - }, - - /** - * Filters a set of nodes based on a given CSS selector. - * @method filter - * - * @param {array} A set of nodes/ids to filter. - * @param {string} selector The selector used to test each node. - * @return{array} An array of nodes from the supplied array that match the given selector. - * @static - */ - filter: function(arr, selector) { - if (!arr || !selector) { - YAHOO.log('filter: invalid input, returning array as is', 'warn', 'Selector'); - } - var node, - nodes = arr, - result = [], - tokens = tokenize(selector); - - if (!nodes.item) { // if not HTMLCollection, handle arrays of ids and/or nodes - YAHOO.log('filter: scanning input for HTMLElements/IDs', 'info', 'Selector'); - for (var i = 0, len = arr.length; i < len; ++i) { - if (!arr[i].tagName) { // tagName limits to HTMLElements - node = Selector.document.getElementById(arr[i]); - if (node) { // skip IDs that return null - nodes[nodes.length] = node; - } else { - YAHOO.log('filter: skipping invalid node', 'warn', 'Selector'); - } - } - } - } - result = rFilter(nodes, tokenize(selector)[0]); - clearParentCache(); - YAHOO.log('filter: returning:' + result.length, 'info', 'Selector'); - return result; - }, - - /** - * Retrieves a set of nodes based on a given CSS selector. - * @method query - * - * @param {string} selector The CSS Selector to test the node against. - * @param {HTMLElement | String} root optional An id or HTMLElement to start the query from. Defaults to Selector.document. - * @param {Boolean} firstOnly optional Whether or not to return only the first match. - * @return {Array} An array of nodes that match the given selector. - * @static - */ - query: function(selector, root, firstOnly) { - var result = query(selector, root, firstOnly); - YAHOO.log('query: returning ' + result.length + ' nodes', 'info', 'Selector'); - return result; - } -}; - -var query = function(selector, root, firstOnly, deDupe) { - if (!selector) { - return []; // no nodes for you - } - var result = []; - var groups = selector.split(','); - - if (groups.length > 1) { - for (var i = 0, len = groups.length; i < len; ++i) { - result = result.concat( arguments.callee(groups[i], root, firstOnly, true) ); - } - clearFoundCache(); - return result; - } - - if (root && !root.tagName) { - root = Selector.document.getElementById(root); - if (!root) { - YAHOO.log('invalid root node provided', 'warn', 'Selector'); - return []; - } - } - - root = root || Selector.document; - var tokens = tokenize(selector); - var idToken = tokens[getIdTokenIndex(tokens)], - nodes = [], - node, - id, - token = tokens.pop() || {}; - - if (idToken) { - id = getId(idToken.attributes); - } - - // if no root alternate root is specified use id shortcut - if (id) { - if (id === token.id) { // only one target - nodes = [Selector.document.getElementById(id)] || root; - } else { // reset root to id node if passes - node = Selector.document.getElementById(id); - if (root === Selector.document || contains(node, root)) { - if ( node && rTestNode(node, null, idToken) ) { - root = node; // start from here - } - } else { - return []; - } - } - } - - if (root && !nodes.length) { - nodes = root.getElementsByTagName(token.tag); - } - - if (nodes.length) { - result = rFilter(nodes, token, firstOnly, deDupe); - } - clearParentCache(); - return result; -}; - -var contains = function() { - if (document.documentElement.contains && !YAHOO.env.ua.webkit < 422) { // IE & Opera, Safari < 3 contains is broken - return function(needle, haystack) { - return haystack.contains(needle); - }; - } else if ( document.documentElement.compareDocumentPosition ) { // gecko - return function(needle, haystack) { - return !!(haystack.compareDocumentPosition(needle) & 16); - }; - } else { // Safari < 3 - return function(needle, haystack) { - var parent = needle.parentNode; - while (parent) { - if (needle === parent) { - return true; - } - parent = parent.parentNode; - } - return false; - }; - } -}(); - -var rFilter = function(nodes, token, firstOnly, deDupe) { - var result = []; - - for (var i = 0, len = nodes.length; i < len; ++i) { - if (!rTestNode(nodes[i], 0, token) || (deDupe && nodes[i]._found) ) { - continue; - } - - if (firstOnly) { - return nodes[i]; - } - if (deDupe) { - nodes[i]._found = true; - foundCache[foundCache.length] = nodes[i]; - } - - result[result.length] = nodes[i]; - } - - return result; -}; - -var rTestNode = function(node, selector, token) { - token = token || tokenize(selector).pop() || {}; - - if (!node || node._found || (token.tag != '*' && node.tagName.toLowerCase() != token.tag)) { - return false; // tag match failed - } - - var ops = Selector.operators, - ps = Selector.pseudos, - attr = token.attributes, - pseudos = token.pseudos, - prev = token.previous; - - if (attr.length) { - for (var i = 0, len = attr.length; i < len; ++i) { - if (ops[attr[i][1]] && - !ops[attr[i][1]](node.getAttribute(attr[i][0], 2), - attr[i][2])) { - return false; - } - } - } - - if (pseudos.length) { - for (i = 0, len = pseudos.length; i < len; ++i) { - if (ps[pseudos[i][0]] && - !ps[pseudos[i][0]](node, pseudos[i][1])) { - return false; - } - } - } - if (prev) { - if (prev.combinator !== ',') { - return combinators[prev.combinator](node, token); - } - } - return true; - -}; - -var foundCache = []; -var parentCache = []; -var regexCache = {}; - -var clearFoundCache = function() { - YAHOO.log('getBySelector: clearing found cache of ' + foundCache.length + ' elements'); - for (var i = 0, len = foundCache.length; i < len; ++i) { - try { // IE no like delete - delete foundCache[i]._found; - } catch(e) { - foundCache[i].removeAttribute('_found'); - } - } - foundCache = []; - YAHOO.log('getBySelector: done clearing foundCache'); -}; - -var clearParentCache = function() { - if (!document.documentElement.children) { // caching children lookups for gecko - return function() { - for (var i = 0, len = parentCache.length; i < len; ++i) { - delete parentCache[i]._children; - } - parentCache = []; - }; - } else return function() {}; // do nothing -}(); - -var getRegExp = function(str, flags) { - flags = flags || ''; - if (!regexCache[str + flags]) { - regexCache[str + flags] = new RegExp(str, flags); - } - return regexCache[str + flags]; -}; - -var combinators = { - ' ': function(node, token) { - node = node.parentNode; - while (node && node.tagName) { - if (rTestNode(node, null, token.previous)) { - return true; - } - node = node.parentNode; - } - return false; - }, - - '>': function(node, token) { - return rTestNode(node.parentNode, null, token.previous); - }, - '+': function(node, token) { - var sib = node.previousSibling; - while (sib && sib.nodeType !== 1) { - sib = sib.previousSibling; - } - - if (sib && rTestNode(sib, null, token.previous)) { - return true; - } - return false; - }, - - '~': function(node, token) { - var sib = node.previousSibling; - while (sib) { - if (sib.nodeType === 1 && rTestNode(sib, null, token.previous)) { - return true; - } - sib = sib.previousSibling; - } - - return false; - } -}; - -var getChildren = function() { - if (document.documentElement.children) { // document for capability test - return function(node, tag) { - return (tag) ? node.children.tags(tag) : node.children || []; - }; - } else { - return function(node, tag) { - if (node._children) { - return node._children; - } - var children = [], - childNodes = node.childNodes; - - for (var i = 0, len = childNodes.length; i < len; ++i) { - if (childNodes[i].tagName) { - if (!tag || childNodes[i].tagName.toLowerCase() === tag) { - children[children.length] = childNodes[i]; - } - } - } - node._children = children; - parentCache[parentCache.length] = node; - return children; - }; - } -}(); - -/* - an+b = get every _a_th node starting at the _b_th - 0n+b = no repeat ("0" and "n" may both be omitted (together) , e.g. "0n+1" or "1", not "0+1"), return only the _b_th element - 1n+b = get every element starting from b ("1" may may be omitted, e.g. "1n+0" or "n+0" or "n") - an+0 = get every _a_th element, "0" may be omitted -*/ -var getNth = function(node, expr, tag, reverse) { - if (tag) tag = tag.toLowerCase(); - var re = regexCache[X.NTH_CHILD] = regexCache[X.NTH_CHILD] || new RegExp(X.NTH_CHILD); - re.test(expr); - var a = parseInt(RegExp.$1, 10), // include every _a_ elements (zero means no repeat, just first _a_) - n = RegExp.$2, // "n" - oddeven = RegExp.$3, // "odd" or "even" - b = parseInt(RegExp.$4, 10) || 0, // start scan from element _b_ - result = []; - - var siblings = getChildren(node.parentNode, tag); - - if (oddeven) { - a = 2; // always every other - op = '+'; - n = 'n'; - b = (oddeven === 'odd') ? 1 : 0; - } else if ( isNaN(a) ) { - a = (n) ? 1 : 0; // start from the first or no repeat - } - - if (a === 0) { // just the first - if (reverse) { - b = siblings.length - b + 1; - } - - if (siblings[b - 1] === node) { - return true; - } else { - return false; - } - - } else if (a < 0) { - reverse = !!reverse; - a = Math.abs(a); - } - - if (!reverse) { - for (var i = b - 1, len = siblings.length; i < len; i += a) { - if ( i >= 0 && siblings[i] === node ) { - return true; - } - } - } else { - for (var i = siblings.length - b, len = siblings.length; i >= 0; i -= a) { - if ( i < len && siblings[i] === node ) { - return true; - } - } - } - return false; -}; - -var getId = function(attr) { - for (var i = 0, len = attr.length; i < len; ++i) { - if (attr[i][0] == 'id' && attr[i][1] === '=') { - return attr[i][2]; - } - } -}; - -var getIdTokenIndex = function(tokens) { - for (var i = 0, len = tokens.length; i < len; ++i) { - if (getId(tokens[i].attributes)) { - return i; - } - } - return -1; -}; - -var patterns = { - tag: /^((?:-?[_a-z]+[\w-]*)|\*)/i, - attributes: /^\[([a-z]+\w*)+([~\|\^\$\*!=]=?)?['"]?([^\]]*)['"]?\]*/i, - pseudos: /^:([-\w]+)(?:$['"]?(.+)['"]?$)*/i, - combinator: /^\s*([>+~]|\s)\s*/ -}; - -/** - Break selector into token units per simple selector. - Combinator is attached to left-hand selector. - */ -var tokenize = function(selector) { - var token = {}, // one token per simple selector (left selector holds combinator) - tokens = [], // array of tokens - id, // unique id for the simple selector (if found) - found = false, // whether or not any matches were found this pass - match; // the regex match - - selector = replaceShorthand(selector); // convert ID and CLASS shortcuts to attributes - - /* - Search for selector patterns, store, and strip them from the selector string - until no patterns match (invalid selector) or we run out of chars. - - Multiple attributes and pseudos are allowed, in any order. - for example: - 'form:first-child[type=button]:not(button)[lang|=en]' - */ - do { - found = false; // reset after full pass - for (var re in patterns) { - if (re != 'tag' && re != 'combinator') { // only one allowed - token[re] = token[re] || []; - } - if (match = patterns[re].exec(selector)) { // note assignment - found = true; - if (re != 'tag' && re != 'combinator') { // only one allowed - //token[re] = token[re] || []; - - // capture ID for fast path to element - if (re === 'attributes' && match[1] === 'id') { - token.id = match[3]; - } - - token[re].push(match.slice(1)); - } else { // single selector (tag, combinator) - token[re] = match[1]; - } - selector = selector.replace(match[0], ''); // strip current match from selector - if (re === 'combinator' || !selector.length) { // next token or done - token.attributes = fixAttributes(token.attributes); - token.pseudos = token.pseudos || []; - token.tag = token.tag || '*'; - tokens.push(token); - - token = { // prep next token - previous: token - }; - } - } - } - } while (found); - - return tokens; -}; - -var fixAttributes = function(attr) { - var aliases = Selector.attrAliases; - attr = attr || []; - for (var i = 0, len = attr.length; i < len; ++i) { - if (aliases[attr[i][0]]) { // convert reserved words, etc - attr[i][0] = aliases[attr[i][0]]; - } - if (!attr[i][1]) { // use exists operator - attr[i][1] = ''; - } - } - return attr; -}; - -var replaceShorthand = function(selector) { - var shorthand = Selector.shorthand; - var attrs = selector.match(patterns.attributes); // pull attributes to avoid false pos on "." and "#" - if (attrs) { - selector = selector.replace(patterns.attributes, 'REPLACED_ATTRIBUTE'); - } - for (var re in shorthand) { - selector = selector.replace(getRegExp(re, 'gi'), shorthand[re]); - } - - if (attrs) { - for (var i = 0, len = attrs.length; i < len; ++i) { - selector = selector.replace('REPLACED_ATTRIBUTE', attrs[i]); - } - } - return selector; -}; - -if (YAHOO.env.ua.ie) { // rewrite class for IE (others use getAttribute('class') - Selector.prototype.attrAliases['class'] = 'className'; -} - -Selector = new Selector(); -Selector.TOKENS = X; -Selector.patterns = patterns; -Y.Selector = Selector; -})(); -YAHOO.register("selector", YAHOO.util.Selector, {version: "2.5.0", build: "895"}); diff --git a/lib/yui/selector/selector-beta-min.js b/lib/yui/selector/selector-beta-min.js deleted file mode 100644 index 1fbd7def5e..0000000000 --- a/lib/yui/selector/selector-beta-min.js +++ /dev/null @@ -1,8 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -(function(){var U=function(){};var E=YAHOO.util;var F={BEGIN:"^",END:"$",OR:"|",SP:"\\s+"};F.BEGIN_SPACE="(?:"+F.BEGIN+F.OR+F.SP+")";F.END_SPACE="(?:"+F.SP+F.OR+F.END+")";F.NTH_CHILD="^(?:([-]?\\d*)(n){1}|(odd|even)$)*([-+]?\\d*)$";U.prototype={document:window.document,attrAliases:{"for":"htmlFor"},shorthand:{"\\#(-?[_a-z]+[-\\w]*)":"[id=$1]","\\.(-?[_a-z]+[-\\w]*)":"[class~=$1]"},operators:{"=":function(W,X){return W===X;},"!=":function(W,X){return W!==X;},"~=":function(W,Y){var X=" ";return(X+W+X).indexOf((X+Y+X))>-1;},"|=":function(W,X){return H(F.BEGIN+X+"[-]?").test(W);},"^=":function(W,X){return W.indexOf(X)===0;},"$=":function(W,X){return W.lastIndexOf(X)===W.length-X.length;},"*=":function(W,X){return W.indexOf(X)>-1;},"":function(W,X){return W;}},pseudos:{"root":function(W){return W===W.ownerDocument.documentElement;},"nth-child":function(W,X){return S(W,X);},"nth-last-child":function(W,X){return S(W,X,null,true);},"nth-of-type":function(W,X){return S(W,X,W.tagName);},"nth-last-of-type":function(W,X){return S(W,X,W.tagName,true);},"first-child":function(W){return G(W.parentNode)[0]===W;},"last-child":function(X){var W=G(X.parentNode);return W[W.length-1]===X;},"first-of-type":function(W,X){return G(W.parentNode,W.tagName.toLowerCase())[0];},"last-of-type":function(X,Y){var W=G(X.parentNode,X.tagName.toLowerCase());return W[W.length-1];},"only-child":function(X){var W=G(X.parentNode);return W.length===1&&W[0]===X;},"only-of-type":function(W){return G(W.parentNode,W.tagName.toLowerCase()).length===1;},"empty":function(W){return W.childNodes.length===0;},"not":function(W,X){return !U.test(W,X);},"contains":function(W,Y){var X=W.innerText||W.textContent||"";return X.indexOf(Y)>-1;},"checked":function(W){return W.checked===true;}},test:function(a,Y){a=U.document.getElementById(a)||a;var X=Y?Y.split(","):[];if(X.length){for(var Z=0,W=X.length;Z1){for(var d=0,e=Y.length;d":function(X,W){return V(X.parentNode,null,W.previous);},"+":function(Y,X){var W=Y.previousSibling;while(W&&W.nodeType!==1){W=W.previousSibling;}if(W&&V(W,null,X.previous)){return true;}return false;},"~":function(Y,X){var W=Y.previousSibling;while(W){if(W.nodeType===1&&V(W,null,X.previous)){return true;}W=W.previousSibling;}return false;}};var G=function(){if(document.documentElement.children){return function(X,W){return(W)?X.children.tags(W):X.children||[];};}else{return function(a,X){if(a._children){return a._children;}var Z=[],b=a.childNodes;for(var Y=0,W=b.length;Y=0&&f[Y]===X){return true;}}}else{for(var Y=f.length-e,Z=f.length;Y>=0;Y-=g){if(Y+~]|\s)\s*/}; -var C=function(W){var Y={},b=[],c,a=false,X;W=A(W);do{a=false;for(var Z in D){if(Z!="tag"&&Z!="combinator"){Y[Z]=Y[Z]||[];}if(X=D[Z].exec(W)){a=true;if(Z!="tag"&&Z!="combinator"){if(Z==="attributes"&&X[1]==="id"){Y.id=X[3];}Y[Z].push(X.slice(1));}else{Y[Z]=X[1];}W=W.replace(X[0],"");if(Z==="combinator"||!W.length){Y.attributes=K(Y.attributes);Y.pseudos=Y.pseudos||[];Y.tag=Y.tag||"*";b.push(Y);Y={previous:Y};}}}}while(a);return b;};var K=function(X){var Y=U.attrAliases;X=X||[];for(var Z=0,W=X.length;Z+~,]+)(?:-?[_a-z]+[-\\w]))+#(-?[_a-z]+[-\\w]*)': '[id=$1]', - '\\#(-?[_a-z]+[-\\w]*)': '[id=$1]', - '\\.(-?[_a-z]+[-\\w]*)': '[class~=$1]' - }, - - /** - * List of operators and corresponding boolean functions. - * These functions are passed the attribute and the current node's value of the attribute. - * @property operators - * @type object - */ - operators: { - '=': function(attr, val) { return attr === val; }, // Equality - '!=': function(attr, val) { return attr !== val; }, // Inequality - '~=': function(attr, val) { // Match one of space seperated words - var s = ' '; - return (s + attr + s).indexOf((s + val + s)) > -1; - }, - '|=': function(attr, val) { return getRegExp(X.BEGIN + val + '[-]?').test(attr); }, // Match start with value followed by optional hyphen - '^=': function(attr, val) { return attr.indexOf(val) === 0; }, // Match starts with value - '$=': function(attr, val) { return attr.lastIndexOf(val) === attr.length - val.length; }, // Match ends with value - '*=': function(attr, val) { return attr.indexOf(val) > -1; }, // Match contains value as substring - '': function(attr, val) { return attr; } // Just test for existence of attribute - }, - - /** - * List of pseudo-classes and corresponding boolean functions. - * These functions are called with the current node, and any value that was parsed with the pseudo regex. - * @property pseudos - * @type object - */ - pseudos: { - 'root': function(node) { - return node === node.ownerDocument.documentElement; - }, - - 'nth-child': function(node, val) { - return getNth(node, val); - }, - - 'nth-last-child': function(node, val) { - return getNth(node, val, null, true); - }, - - 'nth-of-type': function(node, val) { - return getNth(node, val, node.tagName); - }, - - 'nth-last-of-type': function(node, val) { - return getNth(node, val, node.tagName, true); - }, - - 'first-child': function(node) { - return getChildren(node.parentNode)[0] === node; - }, - - 'last-child': function(node) { - var children = getChildren(node.parentNode); - return children[children.length - 1] === node; - }, - - 'first-of-type': function(node, val) { - return getChildren(node.parentNode, node.tagName.toLowerCase())[0]; - }, - - 'last-of-type': function(node, val) { - var children = getChildren(node.parentNode, node.tagName.toLowerCase()); - return children[children.length - 1]; - }, - - 'only-child': function(node) { - var children = getChildren(node.parentNode); - return children.length === 1 && children[0] === node; - }, - - 'only-of-type': function(node) { - return getChildren(node.parentNode, node.tagName.toLowerCase()).length === 1; - }, - - 'empty': function(node) { - return node.childNodes.length === 0; - }, - - 'not': function(node, simple) { - return !Selector.test(node, simple); - }, - - 'contains': function(node, str) { - var text = node.innerText || node.textContent || ''; - return text.indexOf(str) > -1; - }, - 'checked': function(node) { - return node.checked === true; - } - }, - - /** - * Test if the supplied node matches the supplied selector. - * @method test - * - * @param {HTMLElement | String} node An id or node reference to the HTMLElement being tested. - * @param {string} selector The CSS Selector to test the node against. - * @return{boolean} Whether or not the node matches the selector. - * @static - - */ - test: function(node, selector) { - node = Selector.document.getElementById(node) || node; - var groups = selector ? selector.split(',') : []; - if (groups.length) { - for (var i = 0, len = groups.length; i < len; ++i) { - if ( rTestNode(node, groups[i]) ) { // passes if ANY group matches - return true; - } - } - return false; - } - return rTestNode(node, selector); - }, - - /** - * Filters a set of nodes based on a given CSS selector. - * @method filter - * - * @param {array} A set of nodes/ids to filter. - * @param {string} selector The selector used to test each node. - * @return{array} An array of nodes from the supplied array that match the given selector. - * @static - */ - filter: function(arr, selector) { - if (!arr || !selector) { - } - var node, - nodes = arr, - result = [], - tokens = tokenize(selector); - - if (!nodes.item) { // if not HTMLCollection, handle arrays of ids and/or nodes - for (var i = 0, len = arr.length; i < len; ++i) { - if (!arr[i].tagName) { // tagName limits to HTMLElements - node = Selector.document.getElementById(arr[i]); - if (node) { // skip IDs that return null - nodes[nodes.length] = node; - } else { - } - } - } - } - result = rFilter(nodes, tokenize(selector)[0]); - clearParentCache(); - return result; - }, - - /** - * Retrieves a set of nodes based on a given CSS selector. - * @method query - * - * @param {string} selector The CSS Selector to test the node against. - * @param {HTMLElement | String} root optional An id or HTMLElement to start the query from. Defaults to Selector.document. - * @param {Boolean} firstOnly optional Whether or not to return only the first match. - * @return {Array} An array of nodes that match the given selector. - * @static - */ - query: function(selector, root, firstOnly) { - var result = query(selector, root, firstOnly); - return result; - } -}; - -var query = function(selector, root, firstOnly, deDupe) { - if (!selector) { - return []; // no nodes for you - } - var result = []; - var groups = selector.split(','); - - if (groups.length > 1) { - for (var i = 0, len = groups.length; i < len; ++i) { - result = result.concat( arguments.callee(groups[i], root, firstOnly, true) ); - } - clearFoundCache(); - return result; - } - - if (root && !root.tagName) { - root = Selector.document.getElementById(root); - if (!root) { - return []; - } - } - - root = root || Selector.document; - var tokens = tokenize(selector); - var idToken = tokens[getIdTokenIndex(tokens)], - nodes = [], - node, - id, - token = tokens.pop() || {}; - - if (idToken) { - id = getId(idToken.attributes); - } - - // if no root alternate root is specified use id shortcut - if (id) { - if (id === token.id) { // only one target - nodes = [Selector.document.getElementById(id)] || root; - } else { // reset root to id node if passes - node = Selector.document.getElementById(id); - if (root === Selector.document || contains(node, root)) { - if ( node && rTestNode(node, null, idToken) ) { - root = node; // start from here - } - } else { - return []; - } - } - } - - if (root && !nodes.length) { - nodes = root.getElementsByTagName(token.tag); - } - - if (nodes.length) { - result = rFilter(nodes, token, firstOnly, deDupe); - } - clearParentCache(); - return result; -}; - -var contains = function() { - if (document.documentElement.contains && !YAHOO.env.ua.webkit < 422) { // IE & Opera, Safari < 3 contains is broken - return function(needle, haystack) { - return haystack.contains(needle); - }; - } else if ( document.documentElement.compareDocumentPosition ) { // gecko - return function(needle, haystack) { - return !!(haystack.compareDocumentPosition(needle) & 16); - }; - } else { // Safari < 3 - return function(needle, haystack) { - var parent = needle.parentNode; - while (parent) { - if (needle === parent) { - return true; - } - parent = parent.parentNode; - } - return false; - }; - } -}(); - -var rFilter = function(nodes, token, firstOnly, deDupe) { - var result = []; - - for (var i = 0, len = nodes.length; i < len; ++i) { - if (!rTestNode(nodes[i], 0, token) || (deDupe && nodes[i]._found) ) { - continue; - } - - if (firstOnly) { - return nodes[i]; - } - if (deDupe) { - nodes[i]._found = true; - foundCache[foundCache.length] = nodes[i]; - } - - result[result.length] = nodes[i]; - } - - return result; -}; - -var rTestNode = function(node, selector, token) { - token = token || tokenize(selector).pop() || {}; - - if (!node || node._found || (token.tag != '*' && node.tagName.toLowerCase() != token.tag)) { - return false; // tag match failed - } - - var ops = Selector.operators, - ps = Selector.pseudos, - attr = token.attributes, - pseudos = token.pseudos, - prev = token.previous; - - if (attr.length) { - for (var i = 0, len = attr.length; i < len; ++i) { - if (ops[attr[i][1]] && - !ops[attr[i][1]](node.getAttribute(attr[i][0], 2), - attr[i][2])) { - return false; - } - } - } - - if (pseudos.length) { - for (i = 0, len = pseudos.length; i < len; ++i) { - if (ps[pseudos[i][0]] && - !ps[pseudos[i][0]](node, pseudos[i][1])) { - return false; - } - } - } - if (prev) { - if (prev.combinator !== ',') { - return combinators[prev.combinator](node, token); - } - } - return true; - -}; - -var foundCache = []; -var parentCache = []; -var regexCache = {}; - -var clearFoundCache = function() { - for (var i = 0, len = foundCache.length; i < len; ++i) { - try { // IE no like delete - delete foundCache[i]._found; - } catch(e) { - foundCache[i].removeAttribute('_found'); - } - } - foundCache = []; -}; - -var clearParentCache = function() { - if (!document.documentElement.children) { // caching children lookups for gecko - return function() { - for (var i = 0, len = parentCache.length; i < len; ++i) { - delete parentCache[i]._children; - } - parentCache = []; - }; - } else return function() {}; // do nothing -}(); - -var getRegExp = function(str, flags) { - flags = flags || ''; - if (!regexCache[str + flags]) { - regexCache[str + flags] = new RegExp(str, flags); - } - return regexCache[str + flags]; -}; - -var combinators = { - ' ': function(node, token) { - node = node.parentNode; - while (node && node.tagName) { - if (rTestNode(node, null, token.previous)) { - return true; - } - node = node.parentNode; - } - return false; - }, - - '>': function(node, token) { - return rTestNode(node.parentNode, null, token.previous); - }, - '+': function(node, token) { - var sib = node.previousSibling; - while (sib && sib.nodeType !== 1) { - sib = sib.previousSibling; - } - - if (sib && rTestNode(sib, null, token.previous)) { - return true; - } - return false; - }, - - '~': function(node, token) { - var sib = node.previousSibling; - while (sib) { - if (sib.nodeType === 1 && rTestNode(sib, null, token.previous)) { - return true; - } - sib = sib.previousSibling; - } - - return false; - } -}; - -var getChildren = function() { - if (document.documentElement.children) { // document for capability test - return function(node, tag) { - return (tag) ? node.children.tags(tag) : node.children || []; - }; - } else { - return function(node, tag) { - if (node._children) { - return node._children; - } - var children = [], - childNodes = node.childNodes; - - for (var i = 0, len = childNodes.length; i < len; ++i) { - if (childNodes[i].tagName) { - if (!tag || childNodes[i].tagName.toLowerCase() === tag) { - children[children.length] = childNodes[i]; - } - } - } - node._children = children; - parentCache[parentCache.length] = node; - return children; - }; - } -}(); - -/* - an+b = get every _a_th node starting at the _b_th - 0n+b = no repeat ("0" and "n" may both be omitted (together) , e.g. "0n+1" or "1", not "0+1"), return only the _b_th element - 1n+b = get every element starting from b ("1" may may be omitted, e.g. "1n+0" or "n+0" or "n") - an+0 = get every _a_th element, "0" may be omitted -*/ -var getNth = function(node, expr, tag, reverse) { - if (tag) tag = tag.toLowerCase(); - var re = regexCache[X.NTH_CHILD] = regexCache[X.NTH_CHILD] || new RegExp(X.NTH_CHILD); - re.test(expr); - var a = parseInt(RegExp.$1, 10), // include every _a_ elements (zero means no repeat, just first _a_) - n = RegExp.$2, // "n" - oddeven = RegExp.$3, // "odd" or "even" - b = parseInt(RegExp.$4, 10) || 0, // start scan from element _b_ - result = []; - - var siblings = getChildren(node.parentNode, tag); - - if (oddeven) { - a = 2; // always every other - op = '+'; - n = 'n'; - b = (oddeven === 'odd') ? 1 : 0; - } else if ( isNaN(a) ) { - a = (n) ? 1 : 0; // start from the first or no repeat - } - - if (a === 0) { // just the first - if (reverse) { - b = siblings.length - b + 1; - } - - if (siblings[b - 1] === node) { - return true; - } else { - return false; - } - - } else if (a < 0) { - reverse = !!reverse; - a = Math.abs(a); - } - - if (!reverse) { - for (var i = b - 1, len = siblings.length; i < len; i += a) { - if ( i >= 0 && siblings[i] === node ) { - return true; - } - } - } else { - for (var i = siblings.length - b, len = siblings.length; i >= 0; i -= a) { - if ( i < len && siblings[i] === node ) { - return true; - } - } - } - return false; -}; - -var getId = function(attr) { - for (var i = 0, len = attr.length; i < len; ++i) { - if (attr[i][0] == 'id' && attr[i][1] === '=') { - return attr[i][2]; - } - } -}; - -var getIdTokenIndex = function(tokens) { - for (var i = 0, len = tokens.length; i < len; ++i) { - if (getId(tokens[i].attributes)) { - return i; - } - } - return -1; -}; - -var patterns = { - tag: /^((?:-?[_a-z]+[\w-]*)|\*)/i, - attributes: /^\[([a-z]+\w*)+([~\|\^\$\*!=]=?)?['"]?([^\]]*)['"]?\]*/i, - pseudos: /^:([-\w]+)(?:$['"]?(.+)['"]?$)*/i, - combinator: /^\s*([>+~]|\s)\s*/ -}; - -/** - Break selector into token units per simple selector. - Combinator is attached to left-hand selector. - */ -var tokenize = function(selector) { - var token = {}, // one token per simple selector (left selector holds combinator) - tokens = [], // array of tokens - id, // unique id for the simple selector (if found) - found = false, // whether or not any matches were found this pass - match; // the regex match - - selector = replaceShorthand(selector); // convert ID and CLASS shortcuts to attributes - - /* - Search for selector patterns, store, and strip them from the selector string - until no patterns match (invalid selector) or we run out of chars. - - Multiple attributes and pseudos are allowed, in any order. - for example: - 'form:first-child[type=button]:not(button)[lang|=en]' - */ - do { - found = false; // reset after full pass - for (var re in patterns) { - if (re != 'tag' && re != 'combinator') { // only one allowed - token[re] = token[re] || []; - } - if (match = patterns[re].exec(selector)) { // note assignment - found = true; - if (re != 'tag' && re != 'combinator') { // only one allowed - //token[re] = token[re] || []; - - // capture ID for fast path to element - if (re === 'attributes' && match[1] === 'id') { - token.id = match[3]; - } - - token[re].push(match.slice(1)); - } else { // single selector (tag, combinator) - token[re] = match[1]; - } - selector = selector.replace(match[0], ''); // strip current match from selector - if (re === 'combinator' || !selector.length) { // next token or done - token.attributes = fixAttributes(token.attributes); - token.pseudos = token.pseudos || []; - token.tag = token.tag || '*'; - tokens.push(token); - - token = { // prep next token - previous: token - }; - } - } - } - } while (found); - - return tokens; -}; - -var fixAttributes = function(attr) { - var aliases = Selector.attrAliases; - attr = attr || []; - for (var i = 0, len = attr.length; i < len; ++i) { - if (aliases[attr[i][0]]) { // convert reserved words, etc - attr[i][0] = aliases[attr[i][0]]; - } - if (!attr[i][1]) { // use exists operator - attr[i][1] = ''; - } - } - return attr; -}; - -var replaceShorthand = function(selector) { - var shorthand = Selector.shorthand; - var attrs = selector.match(patterns.attributes); // pull attributes to avoid false pos on "." and "#" - if (attrs) { - selector = selector.replace(patterns.attributes, 'REPLACED_ATTRIBUTE'); - } - for (var re in shorthand) { - selector = selector.replace(getRegExp(re, 'gi'), shorthand[re]); - } - - if (attrs) { - for (var i = 0, len = attrs.length; i < len; ++i) { - selector = selector.replace('REPLACED_ATTRIBUTE', attrs[i]); - } - } - return selector; -}; - -if (YAHOO.env.ua.ie) { // rewrite class for IE (others use getAttribute('class') - Selector.prototype.attrAliases['class'] = 'className'; -} - -Selector = new Selector(); -Selector.TOKENS = X; -Selector.patterns = patterns; -Y.Selector = Selector; -})(); -YAHOO.register("selector", YAHOO.util.Selector, {version: "2.5.0", build: "895"}); diff --git a/lib/yui/slider/README b/lib/yui/slider/README deleted file mode 100755 index 3fd03b1153..0000000000 --- a/lib/yui/slider/README +++ /dev/null @@ -1,100 +0,0 @@ -Slider - Release Notes - -2.5.0 - * Slider onDrag now calls fireEvents, so bg mousedown, drag, mouseup fires change events - * Slider uses new dragOnly=true property added in dragdrop - * Introduced DualSlider - -2.4.0 - * No change - -2.3.1 - - * getValue will return the last value or 0 rather than NaN if the control - is display:none. - - * The slider will not fire slideStart/change/slideEnd events during its - initial setup unless setValue was called prior to initialization. - - * slideStart/slideEnd now fire consistently among the various methods of - changing the slider value (setValue, bg click, thumb drag). A bg click - and drag continuation will result in two start/end events. - - * Added a silent flag to setValue and setRegionValue to silence all of the - events during that operation. - -2.3.0 - * Added valueChangeSource, which specifies whether the last value change - was the result of user interaction with the control, or a result of a - programmatic update (setValue) - -2.2.2 - * No change - -2.2.1 - * No change - -2.2.0 - * Added the missing "force" parameter to the signature for setRegionValue - * Deprecated the moveComplete flag - -0.12.2 - * No change - -0.12.1 - - * Removed unnecessary getXY calls that were contributing to slower performance - in FireFox when the slider was deeply nested in the DOM. - -0.12.0 - - * Added "slideStart", "slideEnd", and "change" custom events. The abstract - methods these will eventually replace still work. - - * The default animation duration is 0.2 seconds (reduced from 0.4 seconds), - and is configurable via the animationDuration property. - - * Keyboard navigation is now built in. The background needs a tabindex for - keyboard nav to work. Keyboard nav can be disabled by setting enableKeys - to false. The number of pixels the slider moves when the arrow keys - are pressed is controlled by keyIncrement, and defaults to 20. Note, - Safari support limited to background element types that support focus - in that browser. http://bugs.webkit.org/show_bug.cgi?id=7138 - - * Fixed broken doctype in examples/index.html - - * Catching an unhandled script exception in FF that could occur when - attempting to focus the slider background while a text field without - autocomplete="false" has focus - -0.11.3 - - * No change - -0.11.0 - - * When the thumb is clicked and dragged, the click position delta is properly - applied. - - * The slider background can be disabled by setting backgroundEnabled to false. - - * Added SliderThumb->clearTicks - - * Incorporated updated drag and drop performance improvements - -0.10.0 - - * Drag and drop's autoscroll feature is now turned off by default - in the slider. - - * The slider no longer sets its initial value upon initialization - - * RGB slider example fixed for IE7. - - * Updated to work with the onAvailable feature in Drag and Drop. - - * Updated the basic slider example page to make the control more - accessible to non-FF1.5 browsers. - - * Split the examples into separate pages - diff --git a/lib/yui/slider/slider-debug.js b/lib/yui/slider/slider-debug.js deleted file mode 100755 index 622abbe3e4..0000000000 --- a/lib/yui/slider/slider-debug.js +++ /dev/null @@ -1,1940 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -/** - * The Slider component is a UI control that enables the user to adjust - * values in a finite range along one or two axes. Typically, the Slider - * control is used in a web application as a rich, visual replacement - * for an input box that takes a number as input. The Slider control can - * also easily accommodate a second dimension, providing x,y output for - * a selection point chosen from a rectangular region. - * - * @module slider - * @title Slider Widget - * @namespace YAHOO.widget - * @requires yahoo,dom,dragdrop,event - * @optional animation - */ - -/** - * A DragDrop implementation that can be used as a background for a - * slider. It takes a reference to the thumb instance - * so it can delegate some of the events to it. The goal is to make the - * thumb jump to the location on the background when the background is - * clicked. - * - * @class Slider - * @extends YAHOO.util.DragDrop - * @uses YAHOO.util.EventProvider - * @constructor - * @param {String} id The id of the element linked to this instance - * @param {String} sGroup The group of related DragDrop items - * @param {SliderThumb} oThumb The thumb for this slider - * @param {String} sType The type of slider (horiz, vert, region) - */ -YAHOO.widget.Slider = function(sElementId, sGroup, oThumb, sType) { - - YAHOO.widget.Slider.ANIM_AVAIL = - (!YAHOO.lang.isUndefined(YAHOO.util.Anim)); - - if (sElementId) { - this.init(sElementId, sGroup, true); - this.initSlider(sType); - this.initThumb(oThumb); - } -}; - -/** - * Factory method for creating a horizontal slider - * @method YAHOO.widget.Slider.getHorizSlider - * @static - * @param {String} sBGElId the id of the slider's background element - * @param {String} sHandleElId the id of the thumb element - * @param {int} iLeft the number of pixels the element can move left - * @param {int} iRight the number of pixels the element can move right - * @param {int} iTickSize optional parameter for specifying that the element - * should move a certain number pixels at a time. - * @return {Slider} a horizontal slider control - */ -YAHOO.widget.Slider.getHorizSlider = - function (sBGElId, sHandleElId, iLeft, iRight, iTickSize) { - return new YAHOO.widget.Slider(sBGElId, sBGElId, - new YAHOO.widget.SliderThumb(sHandleElId, sBGElId, - iLeft, iRight, 0, 0, iTickSize), "horiz"); -}; - -/** - * Factory method for creating a vertical slider - * @method YAHOO.widget.Slider.getVertSlider - * @static - * @param {String} sBGElId the id of the slider's background element - * @param {String} sHandleElId the id of the thumb element - * @param {int} iUp the number of pixels the element can move up - * @param {int} iDown the number of pixels the element can move down - * @param {int} iTickSize optional parameter for specifying that the element - * should move a certain number pixels at a time. - * @return {Slider} a vertical slider control - */ -YAHOO.widget.Slider.getVertSlider = - function (sBGElId, sHandleElId, iUp, iDown, iTickSize) { - return new YAHOO.widget.Slider(sBGElId, sBGElId, - new YAHOO.widget.SliderThumb(sHandleElId, sBGElId, 0, 0, - iUp, iDown, iTickSize), "vert"); -}; - -/** - * Factory method for creating a slider region like the one in the color - * picker example - * @method YAHOO.widget.Slider.getSliderRegion - * @static - * @param {String} sBGElId the id of the slider's background element - * @param {String} sHandleElId the id of the thumb element - * @param {int} iLeft the number of pixels the element can move left - * @param {int} iRight the number of pixels the element can move right - * @param {int} iUp the number of pixels the element can move up - * @param {int} iDown the number of pixels the element can move down - * @param {int} iTickSize optional parameter for specifying that the element - * should move a certain number pixels at a time. - * @return {Slider} a slider region control - */ -YAHOO.widget.Slider.getSliderRegion = - function (sBGElId, sHandleElId, iLeft, iRight, iUp, iDown, iTickSize) { - return new YAHOO.widget.Slider(sBGElId, sBGElId, - new YAHOO.widget.SliderThumb(sHandleElId, sBGElId, iLeft, iRight, - iUp, iDown, iTickSize), "region"); -}; - -/** - * By default, animation is available if the animation utility is detected. - * @property YAHOO.widget.Slider.ANIM_AVAIL - * @static - * @type boolean - */ -YAHOO.widget.Slider.ANIM_AVAIL = false; - -YAHOO.extend(YAHOO.widget.Slider, YAHOO.util.DragDrop, { - - /** - * Override the default setting of dragOnly to true. - * @property dragOnly - * @type boolean - * @default true - */ - dragOnly : true, - - /** - * Initializes the slider. Executed in the constructor - * @method initSlider - * @param {string} sType the type of slider (horiz, vert, region) - */ - initSlider: function(sType) { - - /** - * The type of the slider (horiz, vert, region) - * @property type - * @type string - */ - this.type = sType; - - //this.removeInvalidHandleType("A"); - - this.logger = new YAHOO.widget.LogWriter(this.toString()); - - /** - * Event the fires when the value of the control changes. If - * the control is animated the event will fire every point - * along the way. - * @event change - * @param {int} newOffset|x the new offset for normal sliders, or the new - * x offset for region sliders - * @param {int} y the number of pixels the thumb has moved on the y axis - * (region sliders only) - */ - this.createEvent("change", this); - - /** - * Event that fires at the beginning of a slider thumb move. - * @event slideStart - */ - this.createEvent("slideStart", this); - - /** - * Event that fires at the end of a slider thumb move - * @event slideEnd - */ - this.createEvent("slideEnd", this); - - /** - * Overrides the isTarget property in YAHOO.util.DragDrop - * @property isTarget - * @private - */ - this.isTarget = false; - - /** - * Flag that determines if the thumb will animate when moved - * @property animate - * @type boolean - */ - this.animate = YAHOO.widget.Slider.ANIM_AVAIL; - - /** - * Set to false to disable a background click thumb move - * @property backgroundEnabled - * @type boolean - */ - this.backgroundEnabled = true; - - /** - * Adjustment factor for tick animation, the more ticks, the - * faster the animation (by default) - * @property tickPause - * @type int - */ - this.tickPause = 40; - - /** - * Enables the arrow, home and end keys, defaults to true. - * @property enableKeys - * @type boolean - */ - this.enableKeys = true; - - /** - * Specifies the number of pixels the arrow keys will move the slider. - * Default is 20. - * @property keyIncrement - * @type int - */ - this.keyIncrement = 20; - - /** - * moveComplete is set to true when the slider has moved to its final - * destination. For animated slider, this value can be checked in - * the onChange handler to make it possible to execute logic only - * when the move is complete rather than at all points along the way. - * Deprecated because this flag is only useful when the background is - * clicked and the slider is animated. If the user drags the thumb, - * the flag is updated when the drag is over ... the final onDrag event - * fires before the mouseup the ends the drag, so the implementer will - * never see it. - * - * @property moveComplete - * @type Boolean - * @deprecated use the slideEnd event instead - */ - this.moveComplete = true; - - /** - * If animation is configured, specifies the length of the animation - * in seconds. - * @property animationDuration - * @type int - * @default 0.2 - */ - this.animationDuration = 0.2; - - /** - * Constant for valueChangeSource, indicating that the user clicked or - * dragged the slider to change the value. - * @property SOURCE_UI_EVENT - * @final - * @default 1 - */ - this.SOURCE_UI_EVENT = 1; - - /** - * Constant for valueChangeSource, indicating that the value was altered - * by a programmatic call to setValue/setRegionValue. - * @property SOURCE_SET_VALUE - * @final - * @default 2 - */ - this.SOURCE_SET_VALUE = 2; - - /** - * When the slider value changes, this property is set to identify where - * the update came from. This will be either 1, meaning the slider was - * clicked or dragged, or 2, meaning that it was set via a setValue() call. - * This can be used within event handlers to apply some of the logic only - * when dealing with one source or another. - * @property valueChangeSource - * @type int - * @since 2.3.0 - */ - this.valueChangeSource = 0; - - /** - * Indicates whether or not events will be supressed for the current - * slide operation - * @property _silent - * @type boolean - * @private - */ - this._silent = false; - - /** - * Saved offset used to protect against NaN problems when slider is - * set to display:none - * @property lastOffset - * @type [int, int] - */ - this.lastOffset = [0,0]; - }, - - /** - * Initializes the slider's thumb. Executed in the constructor. - * @method initThumb - * @param {YAHOO.widget.SliderThumb} t the slider thumb - */ - initThumb: function(t) { - - var self = this; - - /** - * A YAHOO.widget.SliderThumb instance that we will use to - * reposition the thumb when the background is clicked - * @property thumb - * @type YAHOO.widget.SliderThumb - */ - this.thumb = t; - t.cacheBetweenDrags = true; - - // add handler for the handle onchange event - //t.onChange = function() { - //self.handleThumbChange(); - //}; - - if (t._isHoriz && t.xTicks && t.xTicks.length) { - this.tickPause = Math.round(360 / t.xTicks.length); - } else if (t.yTicks && t.yTicks.length) { - this.tickPause = Math.round(360 / t.yTicks.length); - } - - this.logger.log("tickPause: " + this.tickPause); - - // delegate thumb methods - t.onAvailable = function() { - return self.setStartSliderState(); - }; - t.onMouseDown = function () { - return self.focus(); - }; - t.startDrag = function() { - self._slideStart(); - }; - t.onDrag = function() { - self.fireEvents(true); - }; - t.onMouseUp = function() { - self.thumbMouseUp(); - }; - - }, - - /** - * Executed when the slider element is available - * @method onAvailable - */ - onAvailable: function() { - var Event = YAHOO.util.Event; - Event.on(this.id, "keydown", this.handleKeyDown, this, true); - Event.on(this.id, "keypress", this.handleKeyPress, this, true); - }, - - /** - * Executed when a keypress event happens with the control focused. - * Prevents the default behavior for navigation keys. The actual - * logic for moving the slider thumb in response to a key event - * happens in handleKeyDown. - * @param {Event} e the keypress event - */ - handleKeyPress: function(e) { - if (this.enableKeys) { - var Event = YAHOO.util.Event; - var kc = Event.getCharCode(e); - switch (kc) { - case 0x25: // left - case 0x26: // up - case 0x27: // right - case 0x28: // down - case 0x24: // home - case 0x23: // end - Event.preventDefault(e); - break; - default: - } - } - }, - - /** - * Executed when a keydown event happens with the control focused. - * Updates the slider value and display when the keypress is an - * arrow key, home, or end as long as enableKeys is set to true. - * @param {Event} e the keydown event - */ - handleKeyDown: function(e) { - if (this.enableKeys) { - var Event = YAHOO.util.Event; - - var kc = Event.getCharCode(e), t=this.thumb; - var h=this.getXValue(),v=this.getYValue(); - - var horiz = false; - var changeValue = true; - switch (kc) { - - // left - case 0x25: h -= this.keyIncrement; break; - - // up - case 0x26: v -= this.keyIncrement; break; - - // right - case 0x27: h += this.keyIncrement; break; - - // down - case 0x28: v += this.keyIncrement; break; - - // home - case 0x24: h = t.leftConstraint; - v = t.topConstraint; - break; - - // end - case 0x23: h = t.rightConstraint; - v = t.bottomConstraint; - break; - - default: changeValue = false; - } - - if (changeValue) { - if (t._isRegion) { - this.setRegionValue(h, v, true); - } else { - var newVal = (t._isHoriz) ? h : v; - this.setValue(newVal, true); - } - Event.stopEvent(e); - } - - } - }, - - /** - * Initialization that sets up the value offsets once the elements are ready - * @method setStartSliderState - */ - setStartSliderState: function() { - - this.logger.log("Fixing state"); - - this.setThumbCenterPoint(); - - /** - * The basline position of the background element, used - * to determine if the background has moved since the last - * operation. - * @property baselinePos - * @type [int, int] - */ - this.baselinePos = YAHOO.util.Dom.getXY(this.getEl()); - - this.thumb.startOffset = this.thumb.getOffsetFromParent(this.baselinePos); - - if (this.thumb._isRegion) { - if (this.deferredSetRegionValue) { - this.setRegionValue.apply(this, this.deferredSetRegionValue, true); - this.deferredSetRegionValue = null; - } else { - this.setRegionValue(0, 0, true, true, true); - } - } else { - if (this.deferredSetValue) { - this.setValue.apply(this, this.deferredSetValue, true); - this.deferredSetValue = null; - } else { - this.setValue(0, true, true, true); - } - } - }, - - /** - * When the thumb is available, we cache the centerpoint of the element so - * we can position the element correctly when the background is clicked - * @method setThumbCenterPoint - */ - setThumbCenterPoint: function() { - - var el = this.thumb.getEl(); - - if (el) { - /** - * The center of the slider element is stored so we can - * place it in the correct position when the background is clicked. - * @property thumbCenterPoint - * @type {"x": int, "y": int} - */ - this.thumbCenterPoint = { - x: parseInt(el.offsetWidth/2, 10), - y: parseInt(el.offsetHeight/2, 10) - }; - } - - }, - - /** - * Locks the slider, overrides YAHOO.util.DragDrop - * @method lock - */ - lock: function() { - this.logger.log("locking"); - this.thumb.lock(); - this.locked = true; - }, - - /** - * Unlocks the slider, overrides YAHOO.util.DragDrop - * @method unlock - */ - unlock: function() { - this.logger.log("unlocking"); - this.thumb.unlock(); - this.locked = false; - }, - - /** - * Handles mouseup event on the thumb - * @method thumbMouseUp - * @private - */ - thumbMouseUp: function() { - this.logger.log("thumb mouseup"); - if (!this.isLocked() && !this.moveComplete) { - this.endMove(); - } - - }, - - onMouseUp: function() { - this.logger.log("bg mouseup"); - if (!this.isLocked() && !this.moveComplete) { - this.endMove(); - } - }, - - /** - * Returns a reference to this slider's thumb - * @method getThumb - * @return {SliderThumb} this slider's thumb - */ - getThumb: function() { - return this.thumb; - }, - - /** - * Try to focus the element when clicked so we can add - * accessibility features - * @method focus - * @private - */ - focus: function() { - this.logger.log("focus"); - this.valueChangeSource = this.SOURCE_UI_EVENT; - - // Focus the background element if possible - var el = this.getEl(); - - if (el.focus) { - try { - el.focus(); - } catch(e) { - // Prevent permission denied unhandled exception in FF that can - // happen when setting focus while another element is handling - // the blur. @TODO this is still writing to the error log - // (unhandled error) in FF1.5 with strict error checking on. - } - } - - this.verifyOffset(); - - if (this.isLocked()) { - return false; - } else { - this._slideStart(); - return true; - } - }, - - /** - * Event that fires when the value of the slider has changed - * @method onChange - * @param {int} firstOffset the number of pixels the thumb has moved - * from its start position. Normal horizontal and vertical sliders will only - * have the firstOffset. Regions will have both, the first is the horizontal - * offset, the second the vertical. - * @param {int} secondOffset the y offset for region sliders - * @deprecated use instance.subscribe("change") instead - */ - onChange: function (firstOffset, secondOffset) { - /* override me */ - this.logger.log("onChange: " + firstOffset + ", " + secondOffset); - }, - - /** - * Event that fires when the at the beginning of the slider thumb move - * @method onSlideStart - * @deprecated use instance.subscribe("slideStart") instead - */ - onSlideStart: function () { - /* override me */ - this.logger.log("onSlideStart"); - }, - - /** - * Event that fires at the end of a slider thumb move - * @method onSliderEnd - * @deprecated use instance.subscribe("slideEnd") instead - */ - onSlideEnd: function () { - /* override me */ - this.logger.log("onSlideEnd"); - }, - - /** - * Returns the slider's thumb offset from the start position - * @method getValue - * @return {int} the current value - */ - getValue: function () { - return this.thumb.getValue(); - }, - - /** - * Returns the slider's thumb X offset from the start position - * @method getXValue - * @return {int} the current horizontal offset - */ - getXValue: function () { - return this.thumb.getXValue(); - }, - - /** - * Returns the slider's thumb Y offset from the start position - * @method getYValue - * @return {int} the current vertical offset - */ - getYValue: function () { - return this.thumb.getYValue(); - }, - - /** - * Internal handler for the slider thumb's onChange event - * @method handleThumbChange - * @private - */ - handleThumbChange: function () { - /* - var t = this.thumb; - if (t._isRegion) { - - if (!this._silent) { - t.onChange(t.getXValue(), t.getYValue()); - this.fireEvent("change", { x: t.getXValue(), y: t.getYValue() } ); - } - } else { - if (!this._silent) { - t.onChange(t.getValue()); - this.fireEvent("change", t.getValue()); - } - } - */ - - }, - - /** - * Provides a way to set the value of the slider in code. - * @method setValue - * @param {int} newOffset the number of pixels the thumb should be - * positioned away from the initial start point - * @param {boolean} skipAnim set to true to disable the animation - * for this move action (but not others). - * @param {boolean} force ignore the locked setting and set value anyway - * @param {boolean} silent when true, do not fire events - * @return {boolean} true if the move was performed, false if it failed - */ - setValue: function(newOffset, skipAnim, force, silent) { - this.logger.log("setValue " + newOffset); - - this._silent = silent; - this.valueChangeSource = this.SOURCE_SET_VALUE; - - if (!this.thumb.available) { - this.logger.log("defer setValue until after onAvailble"); - this.deferredSetValue = arguments; - return false; - } - - if (this.isLocked() && !force) { - this.logger.log("Can't set the value, the control is locked"); - return false; - } - - if ( isNaN(newOffset) ) { - this.logger.log("setValue, Illegal argument: " + newOffset); - return false; - } - - var t = this.thumb; - t.lastOffset = [newOffset, newOffset]; - var newX, newY; - this.verifyOffset(true); - if (t._isRegion) { - return false; - } else if (t._isHoriz) { - this._slideStart(); - // this.fireEvent("slideStart"); - newX = t.initPageX + newOffset + this.thumbCenterPoint.x; - this.moveThumb(newX, t.initPageY, skipAnim); - } else { - this._slideStart(); - // this.fireEvent("slideStart"); - newY = t.initPageY + newOffset + this.thumbCenterPoint.y; - this.moveThumb(t.initPageX, newY, skipAnim); - } - - return true; - }, - - /** - * Provides a way to set the value of the region slider in code. - * @method setRegionValue - * @param {int} newOffset the number of pixels the thumb should be - * positioned away from the initial start point (x axis for region) - * @param {int} newOffset2 the number of pixels the thumb should be - * positioned away from the initial start point (y axis for region) - * @param {boolean} skipAnim set to true to disable the animation - * for this move action (but not others). - * @param {boolean} force ignore the locked setting and set value anyway - * @param {boolean} silent when true, do not fire events - * @return {boolean} true if the move was performed, false if it failed - */ - setRegionValue: function(newOffset, newOffset2, skipAnim, force, silent) { - - this._silent = silent; - - this.valueChangeSource = this.SOURCE_SET_VALUE; - - if (!this.thumb.available) { - this.logger.log("defer setRegionValue until after onAvailble"); - this.deferredSetRegionValue = arguments; - return false; - } - - if (this.isLocked() && !force) { - this.logger.log("Can't set the value, the control is locked"); - return false; - } - - if ( isNaN(newOffset) ) { - this.logger.log("setRegionValue, Illegal argument: " + newOffset); - return false; - } - - var t = this.thumb; - t.lastOffset = [newOffset, newOffset2]; - this.verifyOffset(true); - if (t._isRegion) { - this._slideStart(); - var newX = t.initPageX + newOffset + this.thumbCenterPoint.x; - var newY = t.initPageY + newOffset2 + this.thumbCenterPoint.y; - this.moveThumb(newX, newY, skipAnim); - return true; - } - - return false; - - }, - - /** - * Checks the background position element position. If it has moved from the - * baseline position, the constraints for the thumb are reset - * @param checkPos {boolean} check the position instead of using cached value - * @method verifyOffset - * @return {boolean} True if the offset is the same as the baseline. - */ - verifyOffset: function(checkPos) { - - var newPos = YAHOO.util.Dom.getXY(this.getEl()); - //var newPos = [this.initPageX, this.initPageY]; - - if (newPos) { - - this.logger.log("newPos: " + newPos); - - if (newPos[0] != this.baselinePos[0] || newPos[1] != this.baselinePos[1]) { - this.logger.log("background moved, resetting constraints"); - this.thumb.resetConstraints(); - this.baselinePos = newPos; - return false; - } - } - - return true; - }, - - /** - * Move the associated slider moved to a timeout to try to get around the - * mousedown stealing moz does when I move the slider element between the - * cursor and the background during the mouseup event - * @method moveThumb - * @param {int} x the X coordinate of the click - * @param {int} y the Y coordinate of the click - * @param {boolean} skipAnim don't animate if the move happend onDrag - * @param {boolean} midMove set to true if this is not terminating - * the slider movement - * @private - */ - moveThumb: function(x, y, skipAnim, midMove) { - - // this.logger.log("move thumb", "warn"); - - var t = this.thumb; - var self = this; - - if (!t.available) { - this.logger.log("thumb is not available yet, aborting move"); - return; - } - - this.logger.log("move thumb, x: " + x + ", y: " + y); - - // this.verifyOffset(); - - t.setDelta(this.thumbCenterPoint.x, this.thumbCenterPoint.y); - - var _p = t.getTargetCoord(x, y); - var p = [_p.x, _p.y]; - - this._slideStart(); - - if (this.animate && YAHOO.widget.Slider.ANIM_AVAIL && t._graduated && !skipAnim) { - this.logger.log("graduated"); - // this.thumb._animating = true; - this.lock(); - - // cache the current thumb pos - this.curCoord = YAHOO.util.Dom.getXY(this.thumb.getEl()); - - setTimeout( function() { self.moveOneTick(p); }, this.tickPause ); - - } else if (this.animate && YAHOO.widget.Slider.ANIM_AVAIL && !skipAnim) { - this.logger.log("animating to " + p); - - // this.thumb._animating = true; - this.lock(); - - var oAnim = new YAHOO.util.Motion( - t.id, { points: { to: p } }, - this.animationDuration, - YAHOO.util.Easing.easeOut ); - - oAnim.onComplete.subscribe( function() { - - self.endMove(); - } ); - oAnim.animate(); - } else { - t.setDragElPos(x, y); - // this.fireEvents(); - if (!midMove) { - this.endMove(); - } - } - }, - - _slideStart: function() { - if (!this._sliding) { - if (!this._silent) { - this.onSlideStart(); - this.fireEvent("slideStart"); - } - this._sliding = true; - } - }, - - _slideEnd: function() { - - if (this._sliding && this.moveComplete) { - if (!this._silent) { - this.onSlideEnd(); - this.fireEvent("slideEnd"); - } - this._sliding = false; - this._silent = false; - this.moveComplete = false; - } - }, - - /** - * Move the slider one tick mark towards its final coordinate. Used - * for the animation when tick marks are defined - * @method moveOneTick - * @param {int[]} the destination coordinate - * @private - */ - moveOneTick: function(finalCoord) { - - var t = this.thumb, tmp; - - - // redundant call to getXY since we set the position most of time prior - // to getting here. Moved to this.curCoord - //var curCoord = YAHOO.util.Dom.getXY(t.getEl()); - - // alignElWithMouse caches position in lastPageX, lastPageY .. doesn't work - //var curCoord = [this.lastPageX, this.lastPageY]; - - // var thresh = Math.min(t.tickSize + (Math.floor(t.tickSize/2)), 10); - // var thresh = 10; - // var thresh = t.tickSize + (Math.floor(t.tickSize/2)); - - var nextCoord = null; - - if (t._isRegion) { - nextCoord = this._getNextX(this.curCoord, finalCoord); - var tmpX = (nextCoord) ? nextCoord[0] : this.curCoord[0]; - nextCoord = this._getNextY([tmpX, this.curCoord[1]], finalCoord); - - } else if (t._isHoriz) { - nextCoord = this._getNextX(this.curCoord, finalCoord); - } else { - nextCoord = this._getNextY(this.curCoord, finalCoord); - } - - this.logger.log("moveOneTick: " + - " finalCoord: " + finalCoord + - " this.curCoord: " + this.curCoord + - " nextCoord: " + nextCoord); - - if (nextCoord) { - - // cache the position - this.curCoord = nextCoord; - - // move to the next coord - // YAHOO.util.Dom.setXY(t.getEl(), nextCoord); - - // var el = t.getEl(); - // YAHOO.util.Dom.setStyle(el, "left", (nextCoord[0] + this.thumb.deltaSetXY[0]) + "px"); - // YAHOO.util.Dom.setStyle(el, "top", (nextCoord[1] + this.thumb.deltaSetXY[1]) + "px"); - - this.thumb.alignElWithMouse(t.getEl(), nextCoord[0], nextCoord[1]); - - // check if we are in the final position, if not make a recursive call - if (!(nextCoord[0] == finalCoord[0] && nextCoord[1] == finalCoord[1])) { - var self = this; - setTimeout(function() { self.moveOneTick(finalCoord); }, - this.tickPause); - } else { - this.endMove(); - } - } else { - this.endMove(); - } - - //this.tickPause = Math.round(this.tickPause/2); - }, - - /** - * Returns the next X tick value based on the current coord and the target coord. - * @method _getNextX - * @private - */ - _getNextX: function(curCoord, finalCoord) { - this.logger.log("getNextX: " + curCoord + ", " + finalCoord); - var t = this.thumb; - var thresh; - var tmp = []; - var nextCoord = null; - if (curCoord[0] > finalCoord[0]) { - thresh = t.tickSize - this.thumbCenterPoint.x; - tmp = t.getTargetCoord( curCoord[0] - thresh, curCoord[1] ); - nextCoord = [tmp.x, tmp.y]; - } else if (curCoord[0] < finalCoord[0]) { - thresh = t.tickSize + this.thumbCenterPoint.x; - tmp = t.getTargetCoord( curCoord[0] + thresh, curCoord[1] ); - nextCoord = [tmp.x, tmp.y]; - } else { - // equal, do nothing - } - - return nextCoord; - }, - - /** - * Returns the next Y tick value based on the current coord and the target coord. - * @method _getNextY - * @private - */ - _getNextY: function(curCoord, finalCoord) { - var t = this.thumb; - var thresh; - var tmp = []; - var nextCoord = null; - - if (curCoord[1] > finalCoord[1]) { - thresh = t.tickSize - this.thumbCenterPoint.y; - tmp = t.getTargetCoord( curCoord[0], curCoord[1] - thresh ); - nextCoord = [tmp.x, tmp.y]; - } else if (curCoord[1] < finalCoord[1]) { - thresh = t.tickSize + this.thumbCenterPoint.y; - tmp = t.getTargetCoord( curCoord[0], curCoord[1] + thresh ); - nextCoord = [tmp.x, tmp.y]; - } else { - // equal, do nothing - } - - return nextCoord; - }, - - /** - * Resets the constraints before moving the thumb. - * @method b4MouseDown - * @private - */ - b4MouseDown: function(e) { - this.thumb.autoOffset(); - this.thumb.resetConstraints(); - }, - - - /** - * Handles the mousedown event for the slider background - * @method onMouseDown - * @private - */ - onMouseDown: function(e) { - // this.resetConstraints(true); - // this.thumb.resetConstraints(true); - - if (! this.isLocked() && this.backgroundEnabled) { - var x = YAHOO.util.Event.getPageX(e); - var y = YAHOO.util.Event.getPageY(e); - this.logger.log("bg mousedown: " + x + "," + y); - - this.focus(); - this.moveThumb(x, y); - } - - }, - - /** - * Handles the onDrag event for the slider background - * @method onDrag - * @private - */ - onDrag: function(e) { - if (! this.isLocked()) { - var x = YAHOO.util.Event.getPageX(e); - var y = YAHOO.util.Event.getPageY(e); - this.moveThumb(x, y, true, true); - this.fireEvents(); - } - }, - - /** - * Fired when the slider movement ends - * @method endMove - * @private - */ - endMove: function () { - // this._animating = false; - this.unlock(); - this.moveComplete = true; - this.fireEvents(); - }, - - /** - * Fires the change event if the value has been changed. Ignored if we are in - * the middle of an animation as the event will fire when the animation is - * complete - * @method fireEvents - * @param {boolean} thumbEvent set to true if this event is fired from an event - * that occurred on the thumb. If it is, the state of the - * thumb dd object should be correct. Otherwise, the event - * originated on the background, so the thumb state needs to - * be refreshed before proceeding. - * @private - */ - fireEvents: function (thumbEvent) { - - var t = this.thumb; - // this.logger.log("FireEvents: " + t._isRegion); - - if (!thumbEvent) { - t.cachePosition(); - } - - if (! this.isLocked()) { - if (t._isRegion) { - this.logger.log("region"); - var newX = t.getXValue(); - var newY = t.getYValue(); - - if (newX != this.previousX || newY != this.previousY) { - // this.logger.log("Firing onchange"); - if (!this._silent) { - this.onChange(newX, newY); - this.fireEvent("change", { x: newX, y: newY }); - } - } - - this.previousX = newX; - this.previousY = newY; - - } else { - var newVal = t.getValue(); - if (newVal != this.previousVal) { - this.logger.log("Firing onchange: " + newVal); - if (!this._silent) { - this.onChange( newVal ); - this.fireEvent("change", newVal); - } - } - this.previousVal = newVal; - } - - this._slideEnd(); - - } - }, - - /** - * Slider toString - * @method toString - * @return {string} string representation of the instance - */ - toString: function () { - return ("Slider (" + this.type +") " + this.id); - } - -}); - -YAHOO.augment(YAHOO.widget.Slider, YAHOO.util.EventProvider); - -/** - * A drag and drop implementation to be used as the thumb of a slider. - * @class SliderThumb - * @extends YAHOO.util.DD - * @constructor - * @param {String} id the id of the slider html element - * @param {String} sGroup the group of related DragDrop items - * @param {int} iLeft the number of pixels the element can move left - * @param {int} iRight the number of pixels the element can move right - * @param {int} iUp the number of pixels the element can move up - * @param {int} iDown the number of pixels the element can move down - * @param {int} iTickSize optional parameter for specifying that the element - * should move a certain number pixels at a time. - */ -YAHOO.widget.SliderThumb = function(id, sGroup, iLeft, iRight, iUp, iDown, iTickSize) { - - if (id) { - //this.init(id, sGroup); - YAHOO.widget.SliderThumb.superclass.constructor.call(this, id, sGroup); - - /** - * The id of the thumbs parent HTML element (the slider background - * element). - * @property parentElId - * @type string - */ - this.parentElId = sGroup; - } - - - //this.removeInvalidHandleType("A"); - - this.logger = new YAHOO.widget.LogWriter(this.toString()); - - /** - * Overrides the isTarget property in YAHOO.util.DragDrop - * @property isTarget - * @private - */ - this.isTarget = false; - - /** - * The tick size for this slider - * @property tickSize - * @type int - * @private - */ - this.tickSize = iTickSize; - - /** - * Informs the drag and drop util that the offsets should remain when - * resetting the constraints. This preserves the slider value when - * the constraints are reset - * @property maintainOffset - * @type boolean - * @private - */ - this.maintainOffset = true; - - this.initSlider(iLeft, iRight, iUp, iDown, iTickSize); - - /** - * Turns off the autoscroll feature in drag and drop - * @property scroll - * @private - */ - this.scroll = false; - -}; - -YAHOO.extend(YAHOO.widget.SliderThumb, YAHOO.util.DD, { - - /** - * The (X and Y) difference between the thumb location and its parent - * (the slider background) when the control is instantiated. - * @property startOffset - * @type [int, int] - */ - startOffset: null, - - /** - * Override the default setting of dragOnly to true. - * @property dragOnly - * @type boolean - * @default true - */ - dragOnly : true, - - /** - * Flag used to figure out if this is a horizontal or vertical slider - * @property _isHoriz - * @type boolean - * @private - */ - _isHoriz: false, - - /** - * Cache the last value so we can check for change - * @property _prevVal - * @type int - * @private - */ - _prevVal: 0, - - /** - * The slider is _graduated if there is a tick interval defined - * @property _graduated - * @type boolean - * @private - */ - _graduated: false, - - - /** - * Returns the difference between the location of the thumb and its parent. - * @method getOffsetFromParent - * @param {[int, int]} parentPos Optionally accepts the position of the parent - * @type [int, int] - */ - getOffsetFromParent0: function(parentPos) { - var myPos = YAHOO.util.Dom.getXY(this.getEl()); - var ppos = parentPos || YAHOO.util.Dom.getXY(this.parentElId); - - return [ (myPos[0] - ppos[0]), (myPos[1] - ppos[1]) ]; - }, - - getOffsetFromParent: function(parentPos) { - - var el = this.getEl(), newOffset; - - if (!this.deltaOffset) { - - var myPos = YAHOO.util.Dom.getXY(el); - var ppos = parentPos || YAHOO.util.Dom.getXY(this.parentElId); - - newOffset = [ (myPos[0] - ppos[0]), (myPos[1] - ppos[1]) ]; - - var l = parseInt( YAHOO.util.Dom.getStyle(el, "left"), 10 ); - var t = parseInt( YAHOO.util.Dom.getStyle(el, "top" ), 10 ); - - var deltaX = l - newOffset[0]; - var deltaY = t - newOffset[1]; - - if (isNaN(deltaX) || isNaN(deltaY)) { - this.logger.log("element does not have a position style def yet"); - } else { - this.deltaOffset = [deltaX, deltaY]; - } - - } else { - var newLeft = parseInt( YAHOO.util.Dom.getStyle(el, "left"), 10 ); - var newTop = parseInt( YAHOO.util.Dom.getStyle(el, "top" ), 10 ); - - newOffset = [newLeft + this.deltaOffset[0], newTop + this.deltaOffset[1]]; - } - - return newOffset; - - //return [ (myPos[0] - ppos[0]), (myPos[1] - ppos[1]) ]; - }, - - /** - * Set up the slider, must be called in the constructor of all subclasses - * @method initSlider - * @param {int} iLeft the number of pixels the element can move left - * @param {int} iRight the number of pixels the element can move right - * @param {int} iUp the number of pixels the element can move up - * @param {int} iDown the number of pixels the element can move down - * @param {int} iTickSize the width of the tick interval. - */ - initSlider: function (iLeft, iRight, iUp, iDown, iTickSize) { - - - //document these. new for 0.12.1 - this.initLeft = iLeft; - this.initRight = iRight; - this.initUp = iUp; - this.initDown = iDown; - - this.setXConstraint(iLeft, iRight, iTickSize); - this.setYConstraint(iUp, iDown, iTickSize); - - if (iTickSize && iTickSize > 1) { - this._graduated = true; - } - - this._isHoriz = (iLeft || iRight); - this._isVert = (iUp || iDown); - this._isRegion = (this._isHoriz && this._isVert); - - }, - - /** - * Clear's the slider's ticks - * @method clearTicks - */ - clearTicks: function () { - YAHOO.widget.SliderThumb.superclass.clearTicks.call(this); - this.tickSize = 0; - this._graduated = false; - }, - - - /** - * Gets the current offset from the element's start position in - * pixels. - * @method getValue - * @return {int} the number of pixels (positive or negative) the - * slider has moved from the start position. - */ - getValue: function () { - return (this._isHoriz) ? this.getXValue() : this.getYValue(); - //this.logger.log("getVal: " + val); - }, - - /** - * Gets the current X offset from the element's start position in - * pixels. - * @method getXValue - * @return {int} the number of pixels (positive or negative) the - * slider has moved horizontally from the start position. - */ - getXValue: function () { - if (!this.available) { - return 0; - } - var newOffset = this.getOffsetFromParent(); - if (YAHOO.lang.isNumber(newOffset[0])) { - this.lastOffset = newOffset; - return (newOffset[0] - this.startOffset[0]); - } else { - this.logger.log("can't get offset, using old value: " + - this.lastOffset[0]); - return (this.lastOffset[0] - this.startOffset[0]); - } - }, - - /** - * Gets the current Y offset from the element's start position in - * pixels. - * @method getYValue - * @return {int} the number of pixels (positive or negative) the - * slider has moved vertically from the start position. - */ - getYValue: function () { - if (!this.available) { - return 0; - } - var newOffset = this.getOffsetFromParent(); - if (YAHOO.lang.isNumber(newOffset[1])) { - this.lastOffset = newOffset; - return (newOffset[1] - this.startOffset[1]); - } else { - this.logger.log("can't get offset, using old value: " + - this.lastOffset[1]); - return (this.lastOffset[1] - this.startOffset[1]); - } - }, - - /** - * Thumb toString - * @method toString - * @return {string} string representation of the instance - */ - toString: function () { - return "SliderThumb " + this.id; - }, - - /** - * The onchange event for the handle/thumb is delegated to the YAHOO.widget.Slider - * instance it belongs to. - * @method onChange - * @private - */ - onChange: function (x, y) { - } - -}); - -/** - * A slider with two thumbs, one that represents the min value and - * the other the max. Actually a composition of two sliders, both with - * the same background. The constraints for each slider are adjusted - * dynamically so that the min value of the max slider is equal or greater - * to the current value of the min slider, and the max value of the min - * slider is the current value of the max slider. - * Constructor assumes both thumbs are positioned absolutely at the 0 mark on - * the background. - * - * @namespace YAHOO.widget - * @class DualSlider - * @uses YAHOO.util.EventProvider - * @constructor - * @param {Slider} minSlider The Slider instance used for the min value thumb - * @param {Slider} maxSlider The Slider instance used for the max value thumb - * @param {int} range The number of pixels the thumbs may move within - * @param {Array} initVals (optional) [min,max] Initial thumb placement - */ -YAHOO.widget.DualSlider = function(minSlider, maxSlider, range, initVals) { - - var self = this, - lang = YAHOO.lang; - - /** - * A slider instance that keeps track of the lower value of the range. - * read only - * @property minSlider - * @type Slider - */ - this.minSlider = minSlider; - - /** - * A slider instance that keeps track of the upper value of the range. - * read only - * @property maxSlider - * @type Slider - */ - this.maxSlider = maxSlider; - - /** - * The currently active slider (min or max). read only - * @property activeSlider - * @type Slider - */ - this.activeSlider = minSlider; - - /** - * Is the DualSlider oriented horizontally or vertically? - * read only - * @property isHoriz - * @type boolean - */ - this.isHoriz = minSlider.thumb._isHoriz; - - // Validate initial values - initVals = YAHOO.lang.isArray(initVals) ? initVals : [0,range]; - initVals[0] = Math.min(Math.max(parseInt(initVals[0],10)|0,0),range); - initVals[1] = Math.max(Math.min(parseInt(initVals[1],10)|0,range),0); - // Swap initVals if min > max - if (initVals[0] > initVals[1]) { - initVals.splice(0,2,initVals[1],initVals[0]); - } - - var ready = { min : false, max : false }; - - this.minSlider.thumb.onAvailable = function () { - minSlider.setStartSliderState(); - ready.min = true; - if (ready.max) { - minSlider.setValue(initVals[0],true,true,true); - maxSlider.setValue(initVals[1],true,true,true); - self.updateValue(true); - self.fireEvent('ready',self); - } - }; - this.maxSlider.thumb.onAvailable = function () { - maxSlider.setStartSliderState(); - ready.max = true; - if (ready.min) { - minSlider.setValue(initVals[0],true,true,true); - maxSlider.setValue(initVals[1],true,true,true); - self.updateValue(true); - self.fireEvent('ready',self); - } - }; - - // dispatch mousedowns to the active slider - minSlider.onMouseDown = function(e) { - self._handleMouseDown(e); - }; - - // we can safely ignore a mousedown on one of the sliders since - // they share a background - maxSlider.onMouseDown = function(e) { - YAHOO.util.Event.stopEvent(e); - }; - - // Fix the drag behavior so that only the active slider - // follows the drag - minSlider.onDrag = - maxSlider.onDrag = function(e) { - self._handleDrag(e); - }; - - // The core events for each slider are handled so we can expose a single - // event for when the event happens on either slider - minSlider.subscribe("change", this._handleMinChange, minSlider, this); - minSlider.subscribe("slideStart", this._handleSlideStart, minSlider, this); - minSlider.subscribe("slideEnd", this._handleSlideEnd, minSlider, this); - - maxSlider.subscribe("change", this._handleMaxChange, maxSlider, this); - maxSlider.subscribe("slideStart", this._handleSlideStart, maxSlider, this); - maxSlider.subscribe("slideEnd", this._handleSlideEnd, maxSlider, this); - - /** - * Event that fires when the slider is finished setting up - * @event ready - * @param {DualSlider} dualslider the DualSlider instance - */ - this.createEvent("ready", this); - - /** - * Event that fires when either the min or max value changes - * @event change - * @param {DualSlider} dualslider the DualSlider instance - */ - this.createEvent("change", this); - - /** - * Event that fires when one of the thumbs begins to move - * @event slideStart - * @param {Slider} activeSlider the moving slider - */ - this.createEvent("slideStart", this); - - /** - * Event that fires when one of the thumbs finishes moving - * @event slideEnd - * @param {Slider} activeSlider the moving slider - */ - this.createEvent("slideEnd", this); -}; - -YAHOO.widget.DualSlider.prototype = { - - /** - * The current value of the min thumb. read only. - * @property minVal - * @type int - */ - minVal : -1, - - /** - * The current value of the max thumb. read only. - * @property maxVal - * @type int - */ - maxVal : -1, - - /** - * Pixel distance to maintain between thumbs. - * @property minRange - * @type int - * @default 0 - */ - minRange : 0, - - /** - * Executed when one of the sliders fires the slideStart event - * @method _handleSlideStart - * @private - */ - _handleSlideStart: function(data, slider) { - this.fireEvent("slideStart", slider); - }, - - /** - * Executed when one of the sliders fires the slideEnd event - * @method _handleSlideEnd - * @private - */ - _handleSlideEnd: function(data, slider) { - this.fireEvent("slideEnd", slider); - }, - - /** - * Overrides the onDrag method for both sliders - * @method _handleDrag - * @private - */ - _handleDrag: function(e) { - YAHOO.widget.Slider.prototype.onDrag.call(this.activeSlider, e); - }, - - /** - * Executed when the min slider fires the change event - * @method _handleMinChange - * @private - */ - _handleMinChange: function() { - this.activeSlider = this.minSlider; - this.updateValue(); - }, - - /** - * Executed when the max slider fires the change event - * @method _handleMaxChange - * @private - */ - _handleMaxChange: function() { - this.activeSlider = this.maxSlider; - this.updateValue(); - }, - - /** - * Sets the min and max thumbs to new values. - * @method setValues - * @param min {int} Pixel offset to assign to the min thumb - * @param max {int} Pixel offset to assign to the max thumb - * @param skipAnim {boolean} (optional) Set to true to skip thumb animation. - * Default false - * @param force {boolean} (optional) ignore the locked setting and set - * value anyway. Default false - * @param silent {boolean} (optional) Set to true to skip firing change - * events. Default false - */ - setValues : function (min, max, skipAnim, force, silent) { - var mins = this.minSlider, - maxs = this.maxSlider, - mint = mins.thumb, - maxt = maxs.thumb, - self = this, - done = { min : false, max : false }; - - // Clear constraints to prevent animated thumbs from prematurely - // stopping when hitting a constraint that's moving with the other - // thumb. - if (mint._isHoriz) { - mint.setXConstraint(mint.leftConstraint,maxt.rightConstraint,mint.tickSize); - maxt.setXConstraint(mint.leftConstraint,maxt.rightConstraint,maxt.tickSize); - } else { - mint.setYConstraint(mint.topConstraint,maxt.bottomConstraint,mint.tickSize); - maxt.setYConstraint(mint.topConstraint,maxt.bottomConstraint,maxt.tickSize); - } - - // Set up one-time slideEnd callbacks to call updateValue when both - // thumbs have been set - this._oneTimeCallback(mins,'slideEnd',function () { - done.min = true; - if (done.max) { - self.updateValue(silent); - // Clean the slider's slideEnd events on a timeout since this - // will be executed from inside the event's fire - setTimeout(function () { - self._cleanEvent(mins,'slideEnd'); - self._cleanEvent(maxs,'slideEnd'); - },0); - } - }); - - this._oneTimeCallback(maxs,'slideEnd',function () { - done.max = true; - if (done.min) { - self.updateValue(silent); - // Clean both sliders' slideEnd events on a timeout since this - // will be executed from inside one of the event's fire - setTimeout(function () { - self._cleanEvent(mins,'slideEnd'); - self._cleanEvent(maxs,'slideEnd'); - },0); - } - }); - - mins.setValue(min,skipAnim,force,silent); - maxs.setValue(max,skipAnim,force,silent); - }, - - /** - * Set the min thumb position to a new value. - * @method setMinValue - * @param min {int} Pixel offset for min thumb - * @param skipAnim {boolean} (optional) Set to true to skip thumb animation. - * Default false - * @param force {boolean} (optional) ignore the locked setting and set - * value anyway. Default false - * @param silent {boolean} (optional) Set to true to skip firing change - * events. Default false - */ - setMinValue : function (min, skipAnim, force, silent) { - var mins = this.minSlider; - - this.activeSlider = mins; - - // Use a one-time event callback to delay the updateValue call - // until after the slide operation is done - var self = this; - this._oneTimeCallback(mins,'slideEnd',function () { - self.updateValue(silent); - // Clean the slideEnd event on a timeout since this - // will be executed from inside the event's fire - setTimeout(function () { self._cleanEvent(mins,'slideEnd'); }, 0); - }); - - mins.setValue(min, skipAnim, force, silent); - }, - - /** - * Set the max thumb position to a new value. - * @method setMaxValue - * @param max {int} Pixel offset for max thumb - * @param skipAnim {boolean} (optional) Set to true to skip thumb animation. - * Default false - * @param force {boolean} (optional) ignore the locked setting and set - * value anyway. Default false - * @param silent {boolean} (optional) Set to true to skip firing change - * events. Default false - */ - setMaxValue : function (max, skipAnim, force, silent) { - var maxs = this.maxSlider; - - this.activeSlider = maxs; - - // Use a one-time event callback to delay the updateValue call - // until after the slide operation is done - var self = this; - this._oneTimeCallback(maxs,'slideEnd',function () { - self.updateValue(silent); - // Clean the slideEnd event on a timeout since this - // will be executed from inside the event's fire - setTimeout(function () { self._cleanEvent(maxs,'slideEnd'); }, 0); - }); - - maxs.setValue(max, skipAnim, force, silent); - }, - - /** - * Executed when one of the sliders is moved - * @method updateValue - * @param silent {boolean} (optional) Set to true to skip firing change - * events. Default false - * @private - */ - updateValue: function(silent) { - var min = this.minSlider.getValue(), - max = this.maxSlider.getValue(), - changed = false; - - if (min != this.minVal || max != this.maxVal) { - changed = true; - - var mint = this.minSlider.thumb; - var maxt = this.maxSlider.thumb; - - var thumbInnerWidth = this.minSlider.thumbCenterPoint.x + - this.maxSlider.thumbCenterPoint.x; - - // Establish barriers within the respective other thumb's edge, less - // the minRange. Limit to the Slider's range in the case of - // negative minRanges. - var minConstraint = Math.max(max-thumbInnerWidth-this.minRange,0); - var maxConstraint = Math.min(-min-thumbInnerWidth-this.minRange,0); - - if (this.isHoriz) { - minConstraint = Math.min(minConstraint,maxt.rightConstraint); - - mint.setXConstraint(mint.leftConstraint,minConstraint, mint.tickSize); - - maxt.setXConstraint(maxConstraint,maxt.rightConstraint, maxt.tickSize); - } else { - minConstraint = Math.min(minConstraint,maxt.bottomConstraint); - mint.setYConstraint(mint.leftConstraint,minConstraint, mint.tickSize); - - maxt.setYConstraint(maxConstraint,maxt.bottomConstraint, maxt.tickSize); - } - } - - this.minVal = min; - this.maxVal = max; - - if (changed && !silent) { - this.fireEvent("change", this); - } - }, - - /** - * A background click will move the slider thumb nearest to the click. - * Override if you need different behavior. - * @method selectActiveSlider - * @param e {Event} the mousedown event - * @private - */ - selectActiveSlider: function(e) { - var min = this.minSlider.getValue(), - max = this.maxSlider.getValue(), - d; - - if (this.isHoriz) { - d = YAHOO.util.Event.getPageX(e) - this.minSlider.initPageX - - this.minSlider.thumbCenterPoint.x; - } else { - d = YAHOO.util.Event.getPageY(e) - this.minSlider.initPageY - - this.minSlider.thumbCenterPoint.y; - } - - // Below the minSlider thumb. Move the minSlider thumb - if (d < min) { - this.activeSlider = this.minSlider; - // Above the maxSlider thumb. Move the maxSlider thumb - } else if (d > max) { - this.activeSlider = this.maxSlider; - // Split the difference between thumbs - } else { - this.activeSlider = d*2 > max+min ? this.maxSlider : this.minSlider; - } - }, - - /** - * Overrides the onMouseDown for both slider, only moving the active slider - * @method handleMouseDown - * @private - */ - _handleMouseDown: function(e) { - this.selectActiveSlider(e); - YAHOO.widget.Slider.prototype.onMouseDown.call(this.activeSlider, e); - }, - - /** - * Schedule an event callback that will execute once, then unsubscribe - * itself. - * @method _oneTimeCallback - * @param o {EventProvider} Object to attach the event to - * @param evt {string} Name of the event - * @param fn {Function} function to execute once - * @private - */ - _oneTimeCallback : function (o,evt,fn) { - o.subscribe(evt,function () { - // Unsubscribe myself - o.unsubscribe(evt,arguments.callee); - // Pass the event handler arguments to the one time callback - fn.apply({},[].slice.apply(arguments)); - }); - }, - - /** - * Clean up the slideEnd event subscribers array, since each one-time - * callback will be replaced in the event's subscribers property with - * null. This will cause memory bloat and loss of performance. - * @method _cleanEvent - * @param o {EventProvider} object housing the CustomEvent - * @param evt {string} name of the CustomEvent - * @private - */ - _cleanEvent : function (o,evt) { - if (o.__yui_events && o.events[evt]) { - var ce, i, len; - for (i = o.__yui_events.length; i >= 0; --i) { - if (o.__yui_events[i].type === evt) { - ce = o.__yui_events[i]; - break; - } - } - if (ce) { - var subs = ce.subscribers, - newSubs = [], - j = 0; - for (i = 0, len = subs.length; i < len; ++i) { - if (subs[i]) { - newSubs[j++] = subs[i]; - } - } - ce.subscribers = newSubs; - } - } - } - -}; - -YAHOO.augment(YAHOO.widget.DualSlider, YAHOO.util.EventProvider); - - -/** - * Factory method for creating a horizontal dual-thumb slider - * @for YAHOO.widget.Slider - * @method YAHOO.widget.Slider.getHorizDualSlider - * @static - * @param {String} bg the id of the slider's background element - * @param {String} minthumb the id of the min thumb - * @param {String} maxthumb the id of the thumb thumb - * @param {int} range the number of pixels the thumbs can move within - * @param {int} iTickSize (optional) the element should move this many pixels - * at a time - * @param {Array} initVals (optional) [min,max] Initial thumb placement - * @return {DualSlider} a horizontal dual-thumb slider control - */ -YAHOO.widget.Slider.getHorizDualSlider = - function (bg, minthumb, maxthumb, range, iTickSize, initVals) { - var mint, maxt; - var YW = YAHOO.widget, Slider = YW.Slider, Thumb = YW.SliderThumb; - - mint = new Thumb(minthumb, bg, 0, range, 0, 0, iTickSize); - maxt = new Thumb(maxthumb, bg, 0, range, 0, 0, iTickSize); - - return new YW.DualSlider(new Slider(bg, bg, mint, "horiz"), new Slider(bg, bg, maxt, "horiz"), range, initVals); -}; - -/** - * Factory method for creating a vertical dual-thumb slider. - * @for YAHOO.widget.Slider - * @method YAHOO.widget.Slider.getVertDualSlider - * @static - * @param {String} bg the id of the slider's background element - * @param {String} minthumb the id of the min thumb - * @param {String} maxthumb the id of the thumb thumb - * @param {int} range the number of pixels the thumbs can move within - * @param {int} iTickSize (optional) the element should move this many pixels - * at a time - * @param {Array} initVals (optional) [min,max] Initial thumb placement - * @return {DualSlider} a vertical dual-thumb slider control - */ -YAHOO.widget.Slider.getVertDualSlider = - function (bg, minthumb, maxthumb, range, iTickSize, initVals) { - var mint, maxt; - var YW = YAHOO.widget, Slider = YW.Slider, Thumb = YW.SliderThumb; - - mint = new Thumb(minthumb, bg, 0, 0, 0, range, iTickSize); - maxt = new Thumb(maxthumb, bg, 0, 0, 0, range, iTickSize); - - return new YW.DualSlider(new Slider(bg, bg, mint, "vert"), new Slider(bg, bg, maxt, "vert"), range, initVals); -}; -YAHOO.register("slider", YAHOO.widget.Slider, {version: "2.5.0", build: "895"}); diff --git a/lib/yui/slider/slider-min.js b/lib/yui/slider/slider-min.js deleted file mode 100755 index 5700a2fd88..0000000000 --- a/lib/yui/slider/slider-min.js +++ /dev/null @@ -1,9 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -YAHOO.widget.Slider=function(C,A,B,D){YAHOO.widget.Slider.ANIM_AVAIL=(!YAHOO.lang.isUndefined(YAHOO.util.Anim));if(C){this.init(C,A,true);this.initSlider(D);this.initThumb(B);}};YAHOO.widget.Slider.getHorizSlider=function(B,C,E,D,A){return new YAHOO.widget.Slider(B,B,new YAHOO.widget.SliderThumb(C,B,E,D,0,0,A),"horiz");};YAHOO.widget.Slider.getVertSlider=function(C,D,A,E,B){return new YAHOO.widget.Slider(C,C,new YAHOO.widget.SliderThumb(D,C,0,0,A,E,B),"vert");};YAHOO.widget.Slider.getSliderRegion=function(C,D,F,E,A,G,B){return new YAHOO.widget.Slider(C,C,new YAHOO.widget.SliderThumb(D,C,F,E,A,G,B),"region");};YAHOO.widget.Slider.ANIM_AVAIL=false;YAHOO.extend(YAHOO.widget.Slider,YAHOO.util.DragDrop,{dragOnly:true,initSlider:function(A){this.type=A;this.createEvent("change",this);this.createEvent("slideStart",this);this.createEvent("slideEnd",this);this.isTarget=false;this.animate=YAHOO.widget.Slider.ANIM_AVAIL;this.backgroundEnabled=true;this.tickPause=40;this.enableKeys=true;this.keyIncrement=20;this.moveComplete=true;this.animationDuration=0.2;this.SOURCE_UI_EVENT=1;this.SOURCE_SET_VALUE=2;this.valueChangeSource=0;this._silent=false;this.lastOffset=[0,0];},initThumb:function(B){var A=this;this.thumb=B;B.cacheBetweenDrags=true;if(B._isHoriz&&B.xTicks&&B.xTicks.length){this.tickPause=Math.round(360/B.xTicks.length);}else{if(B.yTicks&&B.yTicks.length){this.tickPause=Math.round(360/B.yTicks.length);}}B.onAvailable=function(){return A.setStartSliderState();};B.onMouseDown=function(){return A.focus();};B.startDrag=function(){A._slideStart();};B.onDrag=function(){A.fireEvents(true);};B.onMouseUp=function(){A.thumbMouseUp();};},onAvailable:function(){var A=YAHOO.util.Event;A.on(this.id,"keydown",this.handleKeyDown,this,true);A.on(this.id,"keypress",this.handleKeyPress,this,true);},handleKeyPress:function(C){if(this.enableKeys){var A=YAHOO.util.Event;var B=A.getCharCode(C);switch(B){case 37:case 38:case 39:case 40:case 36:case 35:A.preventDefault(C);break;default:}}},handleKeyDown:function(E){if(this.enableKeys){var G=YAHOO.util.Event;var C=G.getCharCode(E),I=this.thumb;var B=this.getXValue(),F=this.getYValue();var H=false;var D=true;switch(C){case 37:B-=this.keyIncrement;break;case 38:F-=this.keyIncrement;break;case 39:B+=this.keyIncrement;break;case 40:F+=this.keyIncrement;break;case 36:B=I.leftConstraint;F=I.topConstraint;break;case 35:B=I.rightConstraint;F=I.bottomConstraint;break;default:D=false;}if(D){if(I._isRegion){this.setRegionValue(B,F,true);}else{var A=(I._isHoriz)?B:F;this.setValue(A,true);}G.stopEvent(E);}}},setStartSliderState:function(){this.setThumbCenterPoint();this.baselinePos=YAHOO.util.Dom.getXY(this.getEl());this.thumb.startOffset=this.thumb.getOffsetFromParent(this.baselinePos);if(this.thumb._isRegion){if(this.deferredSetRegionValue){this.setRegionValue.apply(this,this.deferredSetRegionValue,true);this.deferredSetRegionValue=null;}else{this.setRegionValue(0,0,true,true,true);}}else{if(this.deferredSetValue){this.setValue.apply(this,this.deferredSetValue,true);this.deferredSetValue=null;}else{this.setValue(0,true,true,true);}}},setThumbCenterPoint:function(){var A=this.thumb.getEl();if(A){this.thumbCenterPoint={x:parseInt(A.offsetWidth/2,10),y:parseInt(A.offsetHeight/2,10)};}},lock:function(){this.thumb.lock();this.locked=true;},unlock:function(){this.thumb.unlock();this.locked=false;},thumbMouseUp:function(){if(!this.isLocked()&&!this.moveComplete){this.endMove();}},onMouseUp:function(){if(!this.isLocked()&&!this.moveComplete){this.endMove();}},getThumb:function(){return this.thumb;},focus:function(){this.valueChangeSource=this.SOURCE_UI_EVENT;var A=this.getEl();if(A.focus){try{A.focus();}catch(B){}}this.verifyOffset();if(this.isLocked()){return false;}else{this._slideStart();return true;}},onChange:function(A,B){},onSlideStart:function(){},onSlideEnd:function(){},getValue:function(){return this.thumb.getValue();},getXValue:function(){return this.thumb.getXValue();},getYValue:function(){return this.thumb.getYValue();},handleThumbChange:function(){},setValue:function(G,C,D,A){this._silent=A;this.valueChangeSource=this.SOURCE_SET_VALUE;if(!this.thumb.available){this.deferredSetValue=arguments;return false;}if(this.isLocked()&&!D){return false;}if(isNaN(G)){return false;}var B=this.thumb;B.lastOffset=[G,G];var F,E;this.verifyOffset(true);if(B._isRegion){return false;}else{if(B._isHoriz){this._slideStart();F=B.initPageX+G+this.thumbCenterPoint.x;this.moveThumb(F,B.initPageY,C);}else{this._slideStart();E=B.initPageY+G+this.thumbCenterPoint.y;this.moveThumb(B.initPageX,E,C);}}return true;},setRegionValue:function(H,A,D,E,B){this._silent=B;this.valueChangeSource=this.SOURCE_SET_VALUE;if(!this.thumb.available){this.deferredSetRegionValue=arguments;return false;}if(this.isLocked()&&!E){return false;}if(isNaN(H)){return false;}var C=this.thumb;C.lastOffset=[H,A];this.verifyOffset(true);if(C._isRegion){this._slideStart();var G=C.initPageX+H+this.thumbCenterPoint.x;var F=C.initPageY+A+this.thumbCenterPoint.y;this.moveThumb(G,F,D);return true;}return false;},verifyOffset:function(B){var A=YAHOO.util.Dom.getXY(this.getEl());if(A){if(A[0]!=this.baselinePos[0]||A[1]!=this.baselinePos[1]){this.thumb.resetConstraints();this.baselinePos=A;return false;}}return true;},moveThumb:function(G,F,E,D){var H=this.thumb;var I=this;if(!H.available){return ;}H.setDelta(this.thumbCenterPoint.x,this.thumbCenterPoint.y);var B=H.getTargetCoord(G,F);var C=[B.x,B.y];this._slideStart();if(this.animate&&YAHOO.widget.Slider.ANIM_AVAIL&&H._graduated&&!E){this.lock();this.curCoord=YAHOO.util.Dom.getXY(this.thumb.getEl());setTimeout(function(){I.moveOneTick(C);},this.tickPause);}else{if(this.animate&&YAHOO.widget.Slider.ANIM_AVAIL&&!E){this.lock();var A=new YAHOO.util.Motion(H.id,{points:{to:C}},this.animationDuration,YAHOO.util.Easing.easeOut);A.onComplete.subscribe(function(){I.endMove();});A.animate();}else{H.setDragElPos(G,F);if(!D){this.endMove();}}}},_slideStart:function(){if(!this._sliding){if(!this._silent){this.onSlideStart(); -this.fireEvent("slideStart");}this._sliding=true;}},_slideEnd:function(){if(this._sliding&&this.moveComplete){if(!this._silent){this.onSlideEnd();this.fireEvent("slideEnd");}this._sliding=false;this._silent=false;this.moveComplete=false;}},moveOneTick:function(B){var E=this.thumb,D;var F=null;if(E._isRegion){F=this._getNextX(this.curCoord,B);var A=(F)?F[0]:this.curCoord[0];F=this._getNextY([A,this.curCoord[1]],B);}else{if(E._isHoriz){F=this._getNextX(this.curCoord,B);}else{F=this._getNextY(this.curCoord,B);}}if(F){this.curCoord=F;this.thumb.alignElWithMouse(E.getEl(),F[0],F[1]);if(!(F[0]==B[0]&&F[1]==B[1])){var C=this;setTimeout(function(){C.moveOneTick(B);},this.tickPause);}else{this.endMove();}}else{this.endMove();}},_getNextX:function(A,B){var D=this.thumb;var F;var C=[];var E=null;if(A[0]>B[0]){F=D.tickSize-this.thumbCenterPoint.x;C=D.getTargetCoord(A[0]-F,A[1]);E=[C.x,C.y];}else{if(A[0]B[1]){F=D.tickSize-this.thumbCenterPoint.y;C=D.getTargetCoord(A[0],A[1]-F);E=[C.x,C.y];}else{if(A[1]1){this._graduated=true;}this._isHoriz=(D||C);this._isVert=(A||E);this._isRegion=(this._isHoriz&&this._isVert);},clearTicks:function(){YAHOO.widget.SliderThumb.superclass.clearTicks.call(this);this.tickSize=0;this._graduated=false;},getValue:function(){return(this._isHoriz)?this.getXValue():this.getYValue();},getXValue:function(){if(!this.available){return 0;}var A=this.getOffsetFromParent();if(YAHOO.lang.isNumber(A[0])){this.lastOffset=A;return(A[0]-this.startOffset[0]);}else{return(this.lastOffset[0]-this.startOffset[0]);}},getYValue:function(){if(!this.available){return 0;}var A=this.getOffsetFromParent();if(YAHOO.lang.isNumber(A[1])){this.lastOffset=A;return(A[1]-this.startOffset[1]);}else{return(this.lastOffset[1]-this.startOffset[1]);}},toString:function(){return"SliderThumb "+this.id;},onChange:function(A,B){}});YAHOO.widget.DualSlider=function(E,B,D,A){var C=this,G=YAHOO.lang;this.minSlider=E;this.maxSlider=B;this.activeSlider=E;this.isHoriz=E.thumb._isHoriz;A=YAHOO.lang.isArray(A)?A:[0,D];A[0]=Math.min(Math.max(parseInt(A[0],10)|0,0),D);A[1]=Math.max(Math.min(parseInt(A[1],10)|0,D),0);if(A[0]>A[1]){A.splice(0,2,A[1],A[0]);}var F={min:false,max:false};this.minSlider.thumb.onAvailable=function(){E.setStartSliderState();F.min=true;if(F.max){E.setValue(A[0],true,true,true);B.setValue(A[1],true,true,true);C.updateValue(true);C.fireEvent("ready",C);}};this.maxSlider.thumb.onAvailable=function(){B.setStartSliderState();F.max=true;if(F.min){E.setValue(A[0],true,true,true);B.setValue(A[1],true,true,true);C.updateValue(true);C.fireEvent("ready",C);}};E.onMouseDown=function(H){C._handleMouseDown(H);};B.onMouseDown=function(H){YAHOO.util.Event.stopEvent(H);};E.onDrag=B.onDrag=function(H){C._handleDrag(H);};E.subscribe("change",this._handleMinChange,E,this);E.subscribe("slideStart",this._handleSlideStart,E,this);E.subscribe("slideEnd",this._handleSlideEnd,E,this);B.subscribe("change",this._handleMaxChange,B,this);B.subscribe("slideStart",this._handleSlideStart,B,this);B.subscribe("slideEnd",this._handleSlideEnd,B,this);this.createEvent("ready",this);this.createEvent("change",this);this.createEvent("slideStart",this);this.createEvent("slideEnd",this);};YAHOO.widget.DualSlider.prototype={minVal:-1,maxVal:-1,minRange:0,_handleSlideStart:function(B,A){this.fireEvent("slideStart",A);},_handleSlideEnd:function(B,A){this.fireEvent("slideEnd",A);},_handleDrag:function(A){YAHOO.widget.Slider.prototype.onDrag.call(this.activeSlider,A); -},_handleMinChange:function(){this.activeSlider=this.minSlider;this.updateValue();},_handleMaxChange:function(){this.activeSlider=this.maxSlider;this.updateValue();},setValues:function(E,H,F,B,G){var C=this.minSlider,J=this.maxSlider,A=C.thumb,I=J.thumb,K=this,D={min:false,max:false};if(A._isHoriz){A.setXConstraint(A.leftConstraint,I.rightConstraint,A.tickSize);I.setXConstraint(A.leftConstraint,I.rightConstraint,I.tickSize);}else{A.setYConstraint(A.topConstraint,I.bottomConstraint,A.tickSize);I.setYConstraint(A.topConstraint,I.bottomConstraint,I.tickSize);}this._oneTimeCallback(C,"slideEnd",function(){D.min=true;if(D.max){K.updateValue(G);setTimeout(function(){K._cleanEvent(C,"slideEnd");K._cleanEvent(J,"slideEnd");},0);}});this._oneTimeCallback(J,"slideEnd",function(){D.max=true;if(D.min){K.updateValue(G);setTimeout(function(){K._cleanEvent(C,"slideEnd");K._cleanEvent(J,"slideEnd");},0);}});C.setValue(E,F,B,G);J.setValue(H,F,B,G);},setMinValue:function(C,E,F,B){var D=this.minSlider;this.activeSlider=D;var A=this;this._oneTimeCallback(D,"slideEnd",function(){A.updateValue(B);setTimeout(function(){A._cleanEvent(D,"slideEnd");},0);});D.setValue(C,E,F,B);},setMaxValue:function(A,E,F,C){var D=this.maxSlider;this.activeSlider=D;var B=this;this._oneTimeCallback(D,"slideEnd",function(){B.updateValue(C);setTimeout(function(){B._cleanEvent(D,"slideEnd");},0);});D.setValue(A,E,F,C);},updateValue:function(F){var B=this.minSlider.getValue(),G=this.maxSlider.getValue(),C=false;if(B!=this.minVal||G!=this.maxVal){C=true;var A=this.minSlider.thumb;var I=this.maxSlider.thumb;var D=this.minSlider.thumbCenterPoint.x+this.maxSlider.thumbCenterPoint.x;var E=Math.max(G-D-this.minRange,0);var H=Math.min(-B-D-this.minRange,0);if(this.isHoriz){E=Math.min(E,I.rightConstraint);A.setXConstraint(A.leftConstraint,E,A.tickSize);I.setXConstraint(H,I.rightConstraint,I.tickSize);}else{E=Math.min(E,I.bottomConstraint);A.setYConstraint(A.leftConstraint,E,A.tickSize);I.setYConstraint(H,I.bottomConstraint,I.tickSize);}}this.minVal=B;this.maxVal=G;if(C&&!F){this.fireEvent("change",this);}},selectActiveSlider:function(C){var B=this.minSlider.getValue(),A=this.maxSlider.getValue(),D;if(this.isHoriz){D=YAHOO.util.Event.getPageX(C)-this.minSlider.initPageX-this.minSlider.thumbCenterPoint.x;}else{D=YAHOO.util.Event.getPageY(C)-this.minSlider.initPageY-this.minSlider.thumbCenterPoint.y;}if(DA){this.activeSlider=this.maxSlider;}else{this.activeSlider=D*2>A+B?this.maxSlider:this.minSlider;}}},_handleMouseDown:function(A){this.selectActiveSlider(A);YAHOO.widget.Slider.prototype.onMouseDown.call(this.activeSlider,A);},_oneTimeCallback:function(C,A,B){C.subscribe(A,function(){C.unsubscribe(A,arguments.callee);B.apply({},[].slice.apply(arguments));});},_cleanEvent:function(H,B){if(H.__yui_events&&H.events[B]){var G,F,A;for(F=H.__yui_events.length;F>=0;--F){if(H.__yui_events[F].type===B){G=H.__yui_events[F];break;}}if(G){var E=G.subscribers,C=[],D=0;for(F=0,A=E.length;F finalCoord[0]) { - thresh = t.tickSize - this.thumbCenterPoint.x; - tmp = t.getTargetCoord( curCoord[0] - thresh, curCoord[1] ); - nextCoord = [tmp.x, tmp.y]; - } else if (curCoord[0] < finalCoord[0]) { - thresh = t.tickSize + this.thumbCenterPoint.x; - tmp = t.getTargetCoord( curCoord[0] + thresh, curCoord[1] ); - nextCoord = [tmp.x, tmp.y]; - } else { - // equal, do nothing - } - - return nextCoord; - }, - - /** - * Returns the next Y tick value based on the current coord and the target coord. - * @method _getNextY - * @private - */ - _getNextY: function(curCoord, finalCoord) { - var t = this.thumb; - var thresh; - var tmp = []; - var nextCoord = null; - - if (curCoord[1] > finalCoord[1]) { - thresh = t.tickSize - this.thumbCenterPoint.y; - tmp = t.getTargetCoord( curCoord[0], curCoord[1] - thresh ); - nextCoord = [tmp.x, tmp.y]; - } else if (curCoord[1] < finalCoord[1]) { - thresh = t.tickSize + this.thumbCenterPoint.y; - tmp = t.getTargetCoord( curCoord[0], curCoord[1] + thresh ); - nextCoord = [tmp.x, tmp.y]; - } else { - // equal, do nothing - } - - return nextCoord; - }, - - /** - * Resets the constraints before moving the thumb. - * @method b4MouseDown - * @private - */ - b4MouseDown: function(e) { - this.thumb.autoOffset(); - this.thumb.resetConstraints(); - }, - - - /** - * Handles the mousedown event for the slider background - * @method onMouseDown - * @private - */ - onMouseDown: function(e) { - // this.resetConstraints(true); - // this.thumb.resetConstraints(true); - - if (! this.isLocked() && this.backgroundEnabled) { - var x = YAHOO.util.Event.getPageX(e); - var y = YAHOO.util.Event.getPageY(e); - - this.focus(); - this.moveThumb(x, y); - } - - }, - - /** - * Handles the onDrag event for the slider background - * @method onDrag - * @private - */ - onDrag: function(e) { - if (! this.isLocked()) { - var x = YAHOO.util.Event.getPageX(e); - var y = YAHOO.util.Event.getPageY(e); - this.moveThumb(x, y, true, true); - this.fireEvents(); - } - }, - - /** - * Fired when the slider movement ends - * @method endMove - * @private - */ - endMove: function () { - // this._animating = false; - this.unlock(); - this.moveComplete = true; - this.fireEvents(); - }, - - /** - * Fires the change event if the value has been changed. Ignored if we are in - * the middle of an animation as the event will fire when the animation is - * complete - * @method fireEvents - * @param {boolean} thumbEvent set to true if this event is fired from an event - * that occurred on the thumb. If it is, the state of the - * thumb dd object should be correct. Otherwise, the event - * originated on the background, so the thumb state needs to - * be refreshed before proceeding. - * @private - */ - fireEvents: function (thumbEvent) { - - var t = this.thumb; - - if (!thumbEvent) { - t.cachePosition(); - } - - if (! this.isLocked()) { - if (t._isRegion) { - var newX = t.getXValue(); - var newY = t.getYValue(); - - if (newX != this.previousX || newY != this.previousY) { - if (!this._silent) { - this.onChange(newX, newY); - this.fireEvent("change", { x: newX, y: newY }); - } - } - - this.previousX = newX; - this.previousY = newY; - - } else { - var newVal = t.getValue(); - if (newVal != this.previousVal) { - if (!this._silent) { - this.onChange( newVal ); - this.fireEvent("change", newVal); - } - } - this.previousVal = newVal; - } - - this._slideEnd(); - - } - }, - - /** - * Slider toString - * @method toString - * @return {string} string representation of the instance - */ - toString: function () { - return ("Slider (" + this.type +") " + this.id); - } - -}); - -YAHOO.augment(YAHOO.widget.Slider, YAHOO.util.EventProvider); - -/** - * A drag and drop implementation to be used as the thumb of a slider. - * @class SliderThumb - * @extends YAHOO.util.DD - * @constructor - * @param {String} id the id of the slider html element - * @param {String} sGroup the group of related DragDrop items - * @param {int} iLeft the number of pixels the element can move left - * @param {int} iRight the number of pixels the element can move right - * @param {int} iUp the number of pixels the element can move up - * @param {int} iDown the number of pixels the element can move down - * @param {int} iTickSize optional parameter for specifying that the element - * should move a certain number pixels at a time. - */ -YAHOO.widget.SliderThumb = function(id, sGroup, iLeft, iRight, iUp, iDown, iTickSize) { - - if (id) { - //this.init(id, sGroup); - YAHOO.widget.SliderThumb.superclass.constructor.call(this, id, sGroup); - - /** - * The id of the thumbs parent HTML element (the slider background - * element). - * @property parentElId - * @type string - */ - this.parentElId = sGroup; - } - - - //this.removeInvalidHandleType("A"); - - - /** - * Overrides the isTarget property in YAHOO.util.DragDrop - * @property isTarget - * @private - */ - this.isTarget = false; - - /** - * The tick size for this slider - * @property tickSize - * @type int - * @private - */ - this.tickSize = iTickSize; - - /** - * Informs the drag and drop util that the offsets should remain when - * resetting the constraints. This preserves the slider value when - * the constraints are reset - * @property maintainOffset - * @type boolean - * @private - */ - this.maintainOffset = true; - - this.initSlider(iLeft, iRight, iUp, iDown, iTickSize); - - /** - * Turns off the autoscroll feature in drag and drop - * @property scroll - * @private - */ - this.scroll = false; - -}; - -YAHOO.extend(YAHOO.widget.SliderThumb, YAHOO.util.DD, { - - /** - * The (X and Y) difference between the thumb location and its parent - * (the slider background) when the control is instantiated. - * @property startOffset - * @type [int, int] - */ - startOffset: null, - - /** - * Override the default setting of dragOnly to true. - * @property dragOnly - * @type boolean - * @default true - */ - dragOnly : true, - - /** - * Flag used to figure out if this is a horizontal or vertical slider - * @property _isHoriz - * @type boolean - * @private - */ - _isHoriz: false, - - /** - * Cache the last value so we can check for change - * @property _prevVal - * @type int - * @private - */ - _prevVal: 0, - - /** - * The slider is _graduated if there is a tick interval defined - * @property _graduated - * @type boolean - * @private - */ - _graduated: false, - - - /** - * Returns the difference between the location of the thumb and its parent. - * @method getOffsetFromParent - * @param {[int, int]} parentPos Optionally accepts the position of the parent - * @type [int, int] - */ - getOffsetFromParent0: function(parentPos) { - var myPos = YAHOO.util.Dom.getXY(this.getEl()); - var ppos = parentPos || YAHOO.util.Dom.getXY(this.parentElId); - - return [ (myPos[0] - ppos[0]), (myPos[1] - ppos[1]) ]; - }, - - getOffsetFromParent: function(parentPos) { - - var el = this.getEl(), newOffset; - - if (!this.deltaOffset) { - - var myPos = YAHOO.util.Dom.getXY(el); - var ppos = parentPos || YAHOO.util.Dom.getXY(this.parentElId); - - newOffset = [ (myPos[0] - ppos[0]), (myPos[1] - ppos[1]) ]; - - var l = parseInt( YAHOO.util.Dom.getStyle(el, "left"), 10 ); - var t = parseInt( YAHOO.util.Dom.getStyle(el, "top" ), 10 ); - - var deltaX = l - newOffset[0]; - var deltaY = t - newOffset[1]; - - if (isNaN(deltaX) || isNaN(deltaY)) { - } else { - this.deltaOffset = [deltaX, deltaY]; - } - - } else { - var newLeft = parseInt( YAHOO.util.Dom.getStyle(el, "left"), 10 ); - var newTop = parseInt( YAHOO.util.Dom.getStyle(el, "top" ), 10 ); - - newOffset = [newLeft + this.deltaOffset[0], newTop + this.deltaOffset[1]]; - } - - return newOffset; - - //return [ (myPos[0] - ppos[0]), (myPos[1] - ppos[1]) ]; - }, - - /** - * Set up the slider, must be called in the constructor of all subclasses - * @method initSlider - * @param {int} iLeft the number of pixels the element can move left - * @param {int} iRight the number of pixels the element can move right - * @param {int} iUp the number of pixels the element can move up - * @param {int} iDown the number of pixels the element can move down - * @param {int} iTickSize the width of the tick interval. - */ - initSlider: function (iLeft, iRight, iUp, iDown, iTickSize) { - - - //document these. new for 0.12.1 - this.initLeft = iLeft; - this.initRight = iRight; - this.initUp = iUp; - this.initDown = iDown; - - this.setXConstraint(iLeft, iRight, iTickSize); - this.setYConstraint(iUp, iDown, iTickSize); - - if (iTickSize && iTickSize > 1) { - this._graduated = true; - } - - this._isHoriz = (iLeft || iRight); - this._isVert = (iUp || iDown); - this._isRegion = (this._isHoriz && this._isVert); - - }, - - /** - * Clear's the slider's ticks - * @method clearTicks - */ - clearTicks: function () { - YAHOO.widget.SliderThumb.superclass.clearTicks.call(this); - this.tickSize = 0; - this._graduated = false; - }, - - - /** - * Gets the current offset from the element's start position in - * pixels. - * @method getValue - * @return {int} the number of pixels (positive or negative) the - * slider has moved from the start position. - */ - getValue: function () { - return (this._isHoriz) ? this.getXValue() : this.getYValue(); - }, - - /** - * Gets the current X offset from the element's start position in - * pixels. - * @method getXValue - * @return {int} the number of pixels (positive or negative) the - * slider has moved horizontally from the start position. - */ - getXValue: function () { - if (!this.available) { - return 0; - } - var newOffset = this.getOffsetFromParent(); - if (YAHOO.lang.isNumber(newOffset[0])) { - this.lastOffset = newOffset; - return (newOffset[0] - this.startOffset[0]); - } else { - return (this.lastOffset[0] - this.startOffset[0]); - } - }, - - /** - * Gets the current Y offset from the element's start position in - * pixels. - * @method getYValue - * @return {int} the number of pixels (positive or negative) the - * slider has moved vertically from the start position. - */ - getYValue: function () { - if (!this.available) { - return 0; - } - var newOffset = this.getOffsetFromParent(); - if (YAHOO.lang.isNumber(newOffset[1])) { - this.lastOffset = newOffset; - return (newOffset[1] - this.startOffset[1]); - } else { - return (this.lastOffset[1] - this.startOffset[1]); - } - }, - - /** - * Thumb toString - * @method toString - * @return {string} string representation of the instance - */ - toString: function () { - return "SliderThumb " + this.id; - }, - - /** - * The onchange event for the handle/thumb is delegated to the YAHOO.widget.Slider - * instance it belongs to. - * @method onChange - * @private - */ - onChange: function (x, y) { - } - -}); - -/** - * A slider with two thumbs, one that represents the min value and - * the other the max. Actually a composition of two sliders, both with - * the same background. The constraints for each slider are adjusted - * dynamically so that the min value of the max slider is equal or greater - * to the current value of the min slider, and the max value of the min - * slider is the current value of the max slider. - * Constructor assumes both thumbs are positioned absolutely at the 0 mark on - * the background. - * - * @namespace YAHOO.widget - * @class DualSlider - * @uses YAHOO.util.EventProvider - * @constructor - * @param {Slider} minSlider The Slider instance used for the min value thumb - * @param {Slider} maxSlider The Slider instance used for the max value thumb - * @param {int} range The number of pixels the thumbs may move within - * @param {Array} initVals (optional) [min,max] Initial thumb placement - */ -YAHOO.widget.DualSlider = function(minSlider, maxSlider, range, initVals) { - - var self = this, - lang = YAHOO.lang; - - /** - * A slider instance that keeps track of the lower value of the range. - * read only - * @property minSlider - * @type Slider - */ - this.minSlider = minSlider; - - /** - * A slider instance that keeps track of the upper value of the range. - * read only - * @property maxSlider - * @type Slider - */ - this.maxSlider = maxSlider; - - /** - * The currently active slider (min or max). read only - * @property activeSlider - * @type Slider - */ - this.activeSlider = minSlider; - - /** - * Is the DualSlider oriented horizontally or vertically? - * read only - * @property isHoriz - * @type boolean - */ - this.isHoriz = minSlider.thumb._isHoriz; - - // Validate initial values - initVals = YAHOO.lang.isArray(initVals) ? initVals : [0,range]; - initVals[0] = Math.min(Math.max(parseInt(initVals[0],10)|0,0),range); - initVals[1] = Math.max(Math.min(parseInt(initVals[1],10)|0,range),0); - // Swap initVals if min > max - if (initVals[0] > initVals[1]) { - initVals.splice(0,2,initVals[1],initVals[0]); - } - - var ready = { min : false, max : false }; - - this.minSlider.thumb.onAvailable = function () { - minSlider.setStartSliderState(); - ready.min = true; - if (ready.max) { - minSlider.setValue(initVals[0],true,true,true); - maxSlider.setValue(initVals[1],true,true,true); - self.updateValue(true); - self.fireEvent('ready',self); - } - }; - this.maxSlider.thumb.onAvailable = function () { - maxSlider.setStartSliderState(); - ready.max = true; - if (ready.min) { - minSlider.setValue(initVals[0],true,true,true); - maxSlider.setValue(initVals[1],true,true,true); - self.updateValue(true); - self.fireEvent('ready',self); - } - }; - - // dispatch mousedowns to the active slider - minSlider.onMouseDown = function(e) { - self._handleMouseDown(e); - }; - - // we can safely ignore a mousedown on one of the sliders since - // they share a background - maxSlider.onMouseDown = function(e) { - YAHOO.util.Event.stopEvent(e); - }; - - // Fix the drag behavior so that only the active slider - // follows the drag - minSlider.onDrag = - maxSlider.onDrag = function(e) { - self._handleDrag(e); - }; - - // The core events for each slider are handled so we can expose a single - // event for when the event happens on either slider - minSlider.subscribe("change", this._handleMinChange, minSlider, this); - minSlider.subscribe("slideStart", this._handleSlideStart, minSlider, this); - minSlider.subscribe("slideEnd", this._handleSlideEnd, minSlider, this); - - maxSlider.subscribe("change", this._handleMaxChange, maxSlider, this); - maxSlider.subscribe("slideStart", this._handleSlideStart, maxSlider, this); - maxSlider.subscribe("slideEnd", this._handleSlideEnd, maxSlider, this); - - /** - * Event that fires when the slider is finished setting up - * @event ready - * @param {DualSlider} dualslider the DualSlider instance - */ - this.createEvent("ready", this); - - /** - * Event that fires when either the min or max value changes - * @event change - * @param {DualSlider} dualslider the DualSlider instance - */ - this.createEvent("change", this); - - /** - * Event that fires when one of the thumbs begins to move - * @event slideStart - * @param {Slider} activeSlider the moving slider - */ - this.createEvent("slideStart", this); - - /** - * Event that fires when one of the thumbs finishes moving - * @event slideEnd - * @param {Slider} activeSlider the moving slider - */ - this.createEvent("slideEnd", this); -}; - -YAHOO.widget.DualSlider.prototype = { - - /** - * The current value of the min thumb. read only. - * @property minVal - * @type int - */ - minVal : -1, - - /** - * The current value of the max thumb. read only. - * @property maxVal - * @type int - */ - maxVal : -1, - - /** - * Pixel distance to maintain between thumbs. - * @property minRange - * @type int - * @default 0 - */ - minRange : 0, - - /** - * Executed when one of the sliders fires the slideStart event - * @method _handleSlideStart - * @private - */ - _handleSlideStart: function(data, slider) { - this.fireEvent("slideStart", slider); - }, - - /** - * Executed when one of the sliders fires the slideEnd event - * @method _handleSlideEnd - * @private - */ - _handleSlideEnd: function(data, slider) { - this.fireEvent("slideEnd", slider); - }, - - /** - * Overrides the onDrag method for both sliders - * @method _handleDrag - * @private - */ - _handleDrag: function(e) { - YAHOO.widget.Slider.prototype.onDrag.call(this.activeSlider, e); - }, - - /** - * Executed when the min slider fires the change event - * @method _handleMinChange - * @private - */ - _handleMinChange: function() { - this.activeSlider = this.minSlider; - this.updateValue(); - }, - - /** - * Executed when the max slider fires the change event - * @method _handleMaxChange - * @private - */ - _handleMaxChange: function() { - this.activeSlider = this.maxSlider; - this.updateValue(); - }, - - /** - * Sets the min and max thumbs to new values. - * @method setValues - * @param min {int} Pixel offset to assign to the min thumb - * @param max {int} Pixel offset to assign to the max thumb - * @param skipAnim {boolean} (optional) Set to true to skip thumb animation. - * Default false - * @param force {boolean} (optional) ignore the locked setting and set - * value anyway. Default false - * @param silent {boolean} (optional) Set to true to skip firing change - * events. Default false - */ - setValues : function (min, max, skipAnim, force, silent) { - var mins = this.minSlider, - maxs = this.maxSlider, - mint = mins.thumb, - maxt = maxs.thumb, - self = this, - done = { min : false, max : false }; - - // Clear constraints to prevent animated thumbs from prematurely - // stopping when hitting a constraint that's moving with the other - // thumb. - if (mint._isHoriz) { - mint.setXConstraint(mint.leftConstraint,maxt.rightConstraint,mint.tickSize); - maxt.setXConstraint(mint.leftConstraint,maxt.rightConstraint,maxt.tickSize); - } else { - mint.setYConstraint(mint.topConstraint,maxt.bottomConstraint,mint.tickSize); - maxt.setYConstraint(mint.topConstraint,maxt.bottomConstraint,maxt.tickSize); - } - - // Set up one-time slideEnd callbacks to call updateValue when both - // thumbs have been set - this._oneTimeCallback(mins,'slideEnd',function () { - done.min = true; - if (done.max) { - self.updateValue(silent); - // Clean the slider's slideEnd events on a timeout since this - // will be executed from inside the event's fire - setTimeout(function () { - self._cleanEvent(mins,'slideEnd'); - self._cleanEvent(maxs,'slideEnd'); - },0); - } - }); - - this._oneTimeCallback(maxs,'slideEnd',function () { - done.max = true; - if (done.min) { - self.updateValue(silent); - // Clean both sliders' slideEnd events on a timeout since this - // will be executed from inside one of the event's fire - setTimeout(function () { - self._cleanEvent(mins,'slideEnd'); - self._cleanEvent(maxs,'slideEnd'); - },0); - } - }); - - mins.setValue(min,skipAnim,force,silent); - maxs.setValue(max,skipAnim,force,silent); - }, - - /** - * Set the min thumb position to a new value. - * @method setMinValue - * @param min {int} Pixel offset for min thumb - * @param skipAnim {boolean} (optional) Set to true to skip thumb animation. - * Default false - * @param force {boolean} (optional) ignore the locked setting and set - * value anyway. Default false - * @param silent {boolean} (optional) Set to true to skip firing change - * events. Default false - */ - setMinValue : function (min, skipAnim, force, silent) { - var mins = this.minSlider; - - this.activeSlider = mins; - - // Use a one-time event callback to delay the updateValue call - // until after the slide operation is done - var self = this; - this._oneTimeCallback(mins,'slideEnd',function () { - self.updateValue(silent); - // Clean the slideEnd event on a timeout since this - // will be executed from inside the event's fire - setTimeout(function () { self._cleanEvent(mins,'slideEnd'); }, 0); - }); - - mins.setValue(min, skipAnim, force, silent); - }, - - /** - * Set the max thumb position to a new value. - * @method setMaxValue - * @param max {int} Pixel offset for max thumb - * @param skipAnim {boolean} (optional) Set to true to skip thumb animation. - * Default false - * @param force {boolean} (optional) ignore the locked setting and set - * value anyway. Default false - * @param silent {boolean} (optional) Set to true to skip firing change - * events. Default false - */ - setMaxValue : function (max, skipAnim, force, silent) { - var maxs = this.maxSlider; - - this.activeSlider = maxs; - - // Use a one-time event callback to delay the updateValue call - // until after the slide operation is done - var self = this; - this._oneTimeCallback(maxs,'slideEnd',function () { - self.updateValue(silent); - // Clean the slideEnd event on a timeout since this - // will be executed from inside the event's fire - setTimeout(function () { self._cleanEvent(maxs,'slideEnd'); }, 0); - }); - - maxs.setValue(max, skipAnim, force, silent); - }, - - /** - * Executed when one of the sliders is moved - * @method updateValue - * @param silent {boolean} (optional) Set to true to skip firing change - * events. Default false - * @private - */ - updateValue: function(silent) { - var min = this.minSlider.getValue(), - max = this.maxSlider.getValue(), - changed = false; - - if (min != this.minVal || max != this.maxVal) { - changed = true; - - var mint = this.minSlider.thumb; - var maxt = this.maxSlider.thumb; - - var thumbInnerWidth = this.minSlider.thumbCenterPoint.x + - this.maxSlider.thumbCenterPoint.x; - - // Establish barriers within the respective other thumb's edge, less - // the minRange. Limit to the Slider's range in the case of - // negative minRanges. - var minConstraint = Math.max(max-thumbInnerWidth-this.minRange,0); - var maxConstraint = Math.min(-min-thumbInnerWidth-this.minRange,0); - - if (this.isHoriz) { - minConstraint = Math.min(minConstraint,maxt.rightConstraint); - - mint.setXConstraint(mint.leftConstraint,minConstraint, mint.tickSize); - - maxt.setXConstraint(maxConstraint,maxt.rightConstraint, maxt.tickSize); - } else { - minConstraint = Math.min(minConstraint,maxt.bottomConstraint); - mint.setYConstraint(mint.leftConstraint,minConstraint, mint.tickSize); - - maxt.setYConstraint(maxConstraint,maxt.bottomConstraint, maxt.tickSize); - } - } - - this.minVal = min; - this.maxVal = max; - - if (changed && !silent) { - this.fireEvent("change", this); - } - }, - - /** - * A background click will move the slider thumb nearest to the click. - * Override if you need different behavior. - * @method selectActiveSlider - * @param e {Event} the mousedown event - * @private - */ - selectActiveSlider: function(e) { - var min = this.minSlider.getValue(), - max = this.maxSlider.getValue(), - d; - - if (this.isHoriz) { - d = YAHOO.util.Event.getPageX(e) - this.minSlider.initPageX - - this.minSlider.thumbCenterPoint.x; - } else { - d = YAHOO.util.Event.getPageY(e) - this.minSlider.initPageY - - this.minSlider.thumbCenterPoint.y; - } - - // Below the minSlider thumb. Move the minSlider thumb - if (d < min) { - this.activeSlider = this.minSlider; - // Above the maxSlider thumb. Move the maxSlider thumb - } else if (d > max) { - this.activeSlider = this.maxSlider; - // Split the difference between thumbs - } else { - this.activeSlider = d*2 > max+min ? this.maxSlider : this.minSlider; - } - }, - - /** - * Overrides the onMouseDown for both slider, only moving the active slider - * @method handleMouseDown - * @private - */ - _handleMouseDown: function(e) { - this.selectActiveSlider(e); - YAHOO.widget.Slider.prototype.onMouseDown.call(this.activeSlider, e); - }, - - /** - * Schedule an event callback that will execute once, then unsubscribe - * itself. - * @method _oneTimeCallback - * @param o {EventProvider} Object to attach the event to - * @param evt {string} Name of the event - * @param fn {Function} function to execute once - * @private - */ - _oneTimeCallback : function (o,evt,fn) { - o.subscribe(evt,function () { - // Unsubscribe myself - o.unsubscribe(evt,arguments.callee); - // Pass the event handler arguments to the one time callback - fn.apply({},[].slice.apply(arguments)); - }); - }, - - /** - * Clean up the slideEnd event subscribers array, since each one-time - * callback will be replaced in the event's subscribers property with - * null. This will cause memory bloat and loss of performance. - * @method _cleanEvent - * @param o {EventProvider} object housing the CustomEvent - * @param evt {string} name of the CustomEvent - * @private - */ - _cleanEvent : function (o,evt) { - if (o.__yui_events && o.events[evt]) { - var ce, i, len; - for (i = o.__yui_events.length; i >= 0; --i) { - if (o.__yui_events[i].type === evt) { - ce = o.__yui_events[i]; - break; - } - } - if (ce) { - var subs = ce.subscribers, - newSubs = [], - j = 0; - for (i = 0, len = subs.length; i < len; ++i) { - if (subs[i]) { - newSubs[j++] = subs[i]; - } - } - ce.subscribers = newSubs; - } - } - } - -}; - -YAHOO.augment(YAHOO.widget.DualSlider, YAHOO.util.EventProvider); - - -/** - * Factory method for creating a horizontal dual-thumb slider - * @for YAHOO.widget.Slider - * @method YAHOO.widget.Slider.getHorizDualSlider - * @static - * @param {String} bg the id of the slider's background element - * @param {String} minthumb the id of the min thumb - * @param {String} maxthumb the id of the thumb thumb - * @param {int} range the number of pixels the thumbs can move within - * @param {int} iTickSize (optional) the element should move this many pixels - * at a time - * @param {Array} initVals (optional) [min,max] Initial thumb placement - * @return {DualSlider} a horizontal dual-thumb slider control - */ -YAHOO.widget.Slider.getHorizDualSlider = - function (bg, minthumb, maxthumb, range, iTickSize, initVals) { - var mint, maxt; - var YW = YAHOO.widget, Slider = YW.Slider, Thumb = YW.SliderThumb; - - mint = new Thumb(minthumb, bg, 0, range, 0, 0, iTickSize); - maxt = new Thumb(maxthumb, bg, 0, range, 0, 0, iTickSize); - - return new YW.DualSlider(new Slider(bg, bg, mint, "horiz"), new Slider(bg, bg, maxt, "horiz"), range, initVals); -}; - -/** - * Factory method for creating a vertical dual-thumb slider. - * @for YAHOO.widget.Slider - * @method YAHOO.widget.Slider.getVertDualSlider - * @static - * @param {String} bg the id of the slider's background element - * @param {String} minthumb the id of the min thumb - * @param {String} maxthumb the id of the thumb thumb - * @param {int} range the number of pixels the thumbs can move within - * @param {int} iTickSize (optional) the element should move this many pixels - * at a time - * @param {Array} initVals (optional) [min,max] Initial thumb placement - * @return {DualSlider} a vertical dual-thumb slider control - */ -YAHOO.widget.Slider.getVertDualSlider = - function (bg, minthumb, maxthumb, range, iTickSize, initVals) { - var mint, maxt; - var YW = YAHOO.widget, Slider = YW.Slider, Thumb = YW.SliderThumb; - - mint = new Thumb(minthumb, bg, 0, 0, 0, range, iTickSize); - maxt = new Thumb(maxthumb, bg, 0, 0, 0, range, iTickSize); - - return new YW.DualSlider(new Slider(bg, bg, mint, "vert"), new Slider(bg, bg, maxt, "vert"), range, initVals); -}; -YAHOO.register("slider", YAHOO.widget.Slider, {version: "2.5.0", build: "895"}); diff --git a/lib/yui/treeview/assets/skins/sam/treeview-loading.gif b/lib/yui/treeview/assets/skins/sam/treeview-loading.gif deleted file mode 100755 index 0bbf3bc0c0..0000000000 Binary files a/lib/yui/treeview/assets/skins/sam/treeview-loading.gif and /dev/null differ diff --git a/lib/yui/treeview/assets/skins/sam/treeview-skin.css b/lib/yui/treeview/assets/skins/sam/treeview-skin.css deleted file mode 100755 index 854c39c01c..0000000000 --- a/lib/yui/treeview/assets/skins/sam/treeview-skin.css +++ /dev/null @@ -1,104 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -/* first or middle sibling, no children */ -.ygtvtn { - width:18px; height:22px; - background: url(treeview-sprite.gif) 0 -5600px no-repeat; -} - -/* first or middle sibling, collapsable */ -.ygtvtm { - width:18px; height:22px; - cursor:pointer ; - background: url(treeview-sprite.gif) 0 -4000px no-repeat; -} - -/* first or middle sibling, collapsable, hover */ -.ygtvtmh { - width:18px; height:22px; - cursor:pointer ; - background: url(treeview-sprite.gif) 0 -4800px no-repeat; -} - -/* first or middle sibling, expandable */ -.ygtvtp { - width:18px; height:22px; - cursor:pointer ; - background: url(treeview-sprite.gif) 0 -6400px no-repeat; -} - -/* first or middle sibling, expandable, hover */ -.ygtvtph { - width:18px; height:22px; - cursor:pointer ; - background: url(treeview-sprite.gif) 0 -7200px no-repeat; -} - -/* last sibling, no children */ -.ygtvln { - width:18px; height:22px; - background: url(treeview-sprite.gif) 0 -1600px no-repeat; -} - -/* Last sibling, collapsable */ -.ygtvlm { - width:18px; height:22px; - cursor:pointer ; - background: url(treeview-sprite.gif) 0 0px no-repeat; -} - -/* Last sibling, collapsable, hover */ -.ygtvlmh { - width:18px; height:22px; - cursor:pointer ; - background: url(treeview-sprite.gif) 0 -800px no-repeat; -} - -/* Last sibling, expandable */ -.ygtvlp { - width:18px; height:22px; - cursor:pointer ; - background: url(treeview-sprite.gif) 0 -2400px no-repeat; -} - -/* Last sibling, expandable, hover */ -.ygtvlph { - width:18px; height:22px; cursor:pointer ; - background: url(treeview-sprite.gif) 0 -3200px no-repeat; -} - -/* Loading icon */ -.ygtvloading { - width:18px; height:22px; - background: url(treeview-loading.gif) 0 0 no-repeat; -} - -/* the style for the empty cells that are used for rendering the depth - * of the node */ -.ygtvdepthcell { - width:18px; height:22px; - background: url(treeview-sprite.gif) 0 -8000px no-repeat; -} - -.ygtvblankdepthcell { width:18px; height:22px; } - -/* the style of the div around each node */ -.ygtvitem { } - -/* the style of the div around each node's collection of children */ -.ygtvchildren { - *zoom: 1; -} - -/* the style of the text label in ygTextNode */ -.ygtvlabel, .ygtvlabel:link, .ygtvlabel:visited, .ygtvlabel:hover { - margin-left:2px; - text-decoration: none; - background-color: white; -} - -.ygtvspacer { height: 22px; width: 12px; } diff --git a/lib/yui/treeview/assets/skins/sam/treeview-sprite.gif b/lib/yui/treeview/assets/skins/sam/treeview-sprite.gif deleted file mode 100755 index a04eff6af4..0000000000 Binary files a/lib/yui/treeview/assets/skins/sam/treeview-sprite.gif and /dev/null differ diff --git a/lib/yui/treeview/assets/skins/sam/treeview.css b/lib/yui/treeview/assets/skins/sam/treeview.css deleted file mode 100755 index 447c4a5e88..0000000000 --- a/lib/yui/treeview/assets/skins/sam/treeview.css +++ /dev/null @@ -1,7 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -.ygtvtn{width:18px;height:22px;background:url(treeview-sprite.gif) 0 -5600px no-repeat;}.ygtvtm{width:18px;height:22px;cursor:pointer;background:url(treeview-sprite.gif) 0 -4000px no-repeat;}.ygtvtmh{width:18px;height:22px;cursor:pointer;background:url(treeview-sprite.gif) 0 -4800px no-repeat;}.ygtvtp{width:18px;height:22px;cursor:pointer;background:url(treeview-sprite.gif) 0 -6400px no-repeat;}.ygtvtph{width:18px;height:22px;cursor:pointer;background:url(treeview-sprite.gif) 0 -7200px no-repeat;}.ygtvln{width:18px;height:22px;background:url(treeview-sprite.gif) 0 -1600px no-repeat;}.ygtvlm{width:18px;height:22px;cursor:pointer;background:url(treeview-sprite.gif) 0 0px no-repeat;}.ygtvlmh{width:18px;height:22px;cursor:pointer;background:url(treeview-sprite.gif) 0 -800px no-repeat;}.ygtvlp{width:18px;height:22px;cursor:pointer;background:url(treeview-sprite.gif) 0 -2400px no-repeat;}.ygtvlph{width:18px;height:22px;cursor:pointer;background:url(treeview-sprite.gif) 0 -3200px no-repeat;}.ygtvloading{width:18px;height:22px;background:url(treeview-loading.gif) 0 0 no-repeat;}.ygtvdepthcell{width:18px;height:22px;background:url(treeview-sprite.gif) 0 -8000px no-repeat;}.ygtvblankdepthcell{width:18px;height:22px;}.ygtvitem{}.ygtvchildren{*zoom:1;}.ygtvlabel,.ygtvlabel:link,.ygtvlabel:visited,.ygtvlabel:hover{margin-left:2px;text-decoration:none;background-color:white;}.ygtvspacer{height:22px;width:12px;} diff --git a/lib/yui/treeview/assets/sprite-menu.gif b/lib/yui/treeview/assets/sprite-menu.gif deleted file mode 100644 index 261ed91701..0000000000 Binary files a/lib/yui/treeview/assets/sprite-menu.gif and /dev/null differ diff --git a/lib/yui/treeview/assets/sprite-orig.gif b/lib/yui/treeview/assets/sprite-orig.gif deleted file mode 100755 index fdf6fcf33e..0000000000 Binary files a/lib/yui/treeview/assets/sprite-orig.gif and /dev/null differ diff --git a/lib/yui/treeview/assets/treeview-core.css b/lib/yui/treeview/assets/treeview-core.css deleted file mode 100755 index a6742cc627..0000000000 --- a/lib/yui/treeview/assets/treeview-core.css +++ /dev/null @@ -1,6 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ diff --git a/lib/yui/treeview/assets/treeview-loading.gif b/lib/yui/treeview/assets/treeview-loading.gif deleted file mode 100755 index 0bbf3bc0c0..0000000000 Binary files a/lib/yui/treeview/assets/treeview-loading.gif and /dev/null differ diff --git a/lib/yui/treeview/assets/treeview-menu.css b/lib/yui/treeview/assets/treeview-menu.css deleted file mode 100644 index 96e597d367..0000000000 --- a/lib/yui/treeview/assets/treeview-menu.css +++ /dev/null @@ -1,105 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -/* first or middle sibling, no children */ -.ygtvtn { - width:1em; height:20px; background:none -} - -/* first or middle sibling, collapsable */ -.ygtvtm { - width:1em; height:20px; - cursor:pointer ; - background: url(sprite-menu.gif) -8px 2px no-repeat; -} - -/* first or middle sibling, collapsable, hover */ -.ygtvtmh { - width:1em; height:20px; - cursor:pointer ; - background: url(sprite-menu.gif) -8px -77px no-repeat; -} - -/* first or middle sibling, expandable */ -.ygtvtp { - width:1em; height:20px; - cursor:pointer ; - background: url(sprite-menu.gif) -8px -315px no-repeat; -} - -/* first or middle sibling, expandable, hover */ -.ygtvtph { - width:1em; height:20px; - cursor:pointer ; - background: url(sprite-menu.gif) -8px -395px no-repeat; -} - -/* last sibling, no children */ -.ygtvln { - width:1em; height:20px; background:none -} - -/* Last sibling, collapsable */ -.ygtvlm { - width:1em; height:20px; - cursor:pointer ; - background: url(sprite-menu.gif) -8px 2px no-repeat; -} - -/* Last sibling, collapsable, hover */ -.ygtvlmh { - width:1em; height:20px; - cursor:pointer ; - background: url(sprite-menu.gif) -8px -77px no-repeat; -} - -/* Last sibling, expandable */ -.ygtvlp { - width:1em; height:20px; - cursor:pointer ; - background: url(sprite-menu.gif) -8px -315px no-repeat; -} - -/* Last sibling, expandable, hover */ -.ygtvlph { - width:1em; height:20px; cursor:pointer ; - background: url(sprite-menu.gif) -8px -395px no-repeat; -} - -/* Loading icon */ -.ygtvloading { - width:1em; height:20px; - background: url(treeview-loading.gif) 0 0 no-repeat; -} - -/* the style for the empty cells that are used for rendering the depth - * of the node */ -.ygtvdepthcell { width:1em; height:20px; background:none} - -.ygtvblankdepthcell { width:1em; height:20px; } - -/* the style of the div around each node */ -.ygtvitem { border: 0px solid grey; } - -/* the style of the div around each node's collection of children */ -.ygtvchildren { } -* html .ygtvchildren { height:2%; } - -.ygtvitem table{ - margin-bottom:0; -} -.ygtvitem td { - border:none;padding:0; -} - -/* the style of the text label in ygTextNode */ -.ygtvlabel, .ygtvlabel:link, .ygtvlabel:visited, .ygtvlabel:hover { - margin-left:2px; - text-decoration: none; - background-color: white; /* workaround for IE font smoothing bug */ -} - -.ygtvspacer { height: 20px; width: 12px; width: 1em; } diff --git a/lib/yui/treeview/assets/treeview.css b/lib/yui/treeview/assets/treeview.css deleted file mode 100755 index 9463550812..0000000000 --- a/lib/yui/treeview/assets/treeview.css +++ /dev/null @@ -1,112 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -/* first or middle sibling, no children */ - -.ygtvtn { - width:18px; height:22px; - background: url(sprite-orig.gif) 0 -5600px no-repeat; -} - -/* first or middle sibling, collapsable */ -.ygtvtm { - width:18px; height:22px; - cursor:pointer ; - background: url(sprite-orig.gif) 0 -4000px no-repeat; -} - -/* first or middle sibling, collapsable, hover */ -.ygtvtmh { - width:18px; height:22px; - cursor:pointer ; - background: url(sprite-orig.gif) 0 -4800px no-repeat; -} - -/* first or middle sibling, expandable */ -.ygtvtp { - width:18px; height:22px; - cursor:pointer ; - background: url(sprite-orig.gif) 0 -6400px no-repeat; -} - -/* first or middle sibling, expandable, hover */ -.ygtvtph { - width:18px; height:22px; - cursor:pointer ; - background: url(sprite-orig.gif) 0 -7200px no-repeat; -} - -/* last sibling, no children */ -.ygtvln { - width:18px; height:22px; - background: url(sprite-orig.gif) 0 -1600px no-repeat; -} - -/* Last sibling, collapsable */ -.ygtvlm { - width:18px; height:22px; - cursor:pointer ; - background: url(sprite-orig.gif) 0 0px no-repeat; -} - -/* Last sibling, collapsable, hover */ -.ygtvlmh { - width:18px; height:22px; - cursor:pointer ; - background: url(sprite-orig.gif) 0 -800px no-repeat; -} - -/* Last sibling, expandable */ -.ygtvlp { - width:18px; height:22px; - cursor:pointer ; - background: url(sprite-orig.gif) 0 -2400px no-repeat; -} - -/* Last sibling, expandable, hover */ -.ygtvlph { - width:18px; height:22px; cursor:pointer ; - background: url(sprite-orig.gif) 0 -3200px no-repeat; -} - -/* Loading icon */ -.ygtvloading { - width:18px; height:22px; - background: url(treeview-loading.gif) 0 0 no-repeat; -} - -/* the style for the empty cells that are used for rendering the depth - * of the node */ -.ygtvdepthcell { - width:18px; height:22px; - background: url(sprite-orig.gif) 0 -8000px no-repeat; -} - -.ygtvblankdepthcell { width:18px; height:22px; } - -/* the style of the div around each node */ -.ygtvitem { } - - -.ygtvitem table{ - margin-bottom:0; -} -.ygtvitem td { - border:none;padding:0; -} - -/* the style of the div around each node's collection of children */ -.ygtvchildren { } -* html .ygtvchildren { height:2%; } - -/* the style of the text label in ygTextNode */ -.ygtvlabel, .ygtvlabel:link, .ygtvlabel:visited, .ygtvlabel:hover { - margin-left:2px; - text-decoration: none; - background-color: white; /* workaround for IE font smoothing bug */ -} - -.ygtvspacer { height: 22px; width: 12px; } diff --git a/lib/yui/yuitest/README b/lib/yui/yuitest/README deleted file mode 100755 index 19e8d09b16..0000000000 --- a/lib/yui/yuitest/README +++ /dev/null @@ -1,21 +0,0 @@ -YUI Library - YUITest - Release Notes - -2.3.0 - - * Beta release - -2.3.1 - - * No changes - -2.4.0 - - * Changed test running from synchronous to asynchronous. - * Added wait() and resume() methods to TestRunner to allow testing of asynchronous features. - -2.50 - - * Updated test results format to include ignored tests, result types, and names. - * Introduced test result formats in JSON and XML. - * Introduced TestReporter object. - * Removed beta tag. \ No newline at end of file diff --git a/lib/yui/yuitest/yuitest-beta-debug.js b/lib/yui/yuitest/yuitest-beta-debug.js deleted file mode 100755 index ad114842e9..0000000000 --- a/lib/yui/yuitest/yuitest-beta-debug.js +++ /dev/null @@ -1,3268 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -YAHOO.namespace("tool"); - -//----------------------------------------------------------------------------- -// TestCase object -//----------------------------------------------------------------------------- - -/** - * Test case containing various tests to run. - * @param template An object containing any number of test methods, other methods, - * an optional name, and anything else the test case needs. - * @class TestCase - * @namespace YAHOO.tool - * @constructor - */ -YAHOO.tool.TestCase = function (template /*:Object*/) { - - /** - * Special rules for the test case. Possible subobjects - * are fail, for tests that should fail, and error, for - * tests that should throw an error. - */ - this._should /*:Object*/ = {}; - - //copy over all properties from the template to this object - for (var prop in template) { - this[prop] = template[prop]; - } - - //check for a valid name - if (!YAHOO.lang.isString(this.name)){ - /** - * Name for the test case. - */ - this.name /*:String*/ = YAHOO.util.Dom.generateId(null, "testCase"); - } - -}; - - -YAHOO.tool.TestCase.prototype = { - - /** - * Resumes a paused test and runs the given function. - * @param {Function} segment (Optional) The function to run. - * If omitted, the test automatically passes. - * @return {Void} - * @method resume - */ - resume : function (segment /*:Function*/) /*:Void*/ { - YAHOO.tool.TestRunner.resume(segment); - }, - - /** - * Causes the test case to wait a specified amount of time and then - * continue executing the given code. - * @param {Function} segment (Optional) The function to run after the delay. - * If omitted, the TestRunner will wait until resume() is called. - * @param {int} delay (Optional) The number of milliseconds to wait before running - * the function. If omitted, defaults to zero. - * @return {Void} - * @method wait - */ - wait : function (segment /*:Function*/, delay /*:int*/) /*:Void*/{ - throw new YAHOO.tool.TestCase.Wait(segment, delay); - }, - - //------------------------------------------------------------------------- - // Stub Methods - //------------------------------------------------------------------------- - - /** - * Function to run before each test is executed. - * @return {Void} - * @method setUp - */ - setUp : function () /*:Void*/ { - }, - - /** - * Function to run after each test is executed. - * @return {Void} - * @method tearDown - */ - tearDown: function () /*:Void*/ { - } -}; - -/** - * Represents a stoppage in test execution to wait for an amount of time before - * continuing. - * @param {Function} segment A function to run when the wait is over. - * @param {int} delay The number of milliseconds to wait before running the code. - * @class Wait - * @namespace YAHOO.tool.TestCase - * @constructor - * - */ -YAHOO.tool.TestCase.Wait = function (segment /*:Function*/, delay /*:int*/) { - - /** - * The segment of code to run when the wait is over. - * @type Function - * @property segment - */ - this.segment /*:Function*/ = (YAHOO.lang.isFunction(segment) ? segment : null); - - /** - * The delay before running the segment of code. - * @type int - * @property delay - */ - this.delay /*:int*/ = (YAHOO.lang.isNumber(delay) ? delay : 0); - -}; - -YAHOO.namespace("tool"); - - -//----------------------------------------------------------------------------- -// TestSuite object -//----------------------------------------------------------------------------- - -/** - * A test suite that can contain a collection of TestCase and TestSuite objects. - * @param {String||Object} data The name of the test suite or an object containing - * a name property as well as setUp and tearDown methods. - * @namespace YAHOO.tool - * @class TestSuite - * @constructor - */ -YAHOO.tool.TestSuite = function (data /*:String||Object*/) { - - /** - * The name of the test suite. - * @type String - * @property name - */ - this.name /*:String*/ = ""; - - /** - * Array of test suites and - * @private - */ - this.items /*:Array*/ = []; - - //initialize the properties - if (YAHOO.lang.isString(data)){ - this.name = data; - } else if (YAHOO.lang.isObject(data)){ - YAHOO.lang.augmentObject(this, data, true); - } - - //double-check name - if (this.name === ""){ - this.name = YAHOO.util.Dom.generateId(null, "testSuite"); - } - -}; - -YAHOO.tool.TestSuite.prototype = { - - /** - * Adds a test suite or test case to the test suite. - * @param {YAHOO.tool.TestSuite||YAHOO.tool.TestCase} testObject The test suite or test case to add. - * @return {Void} - * @method add - */ - add : function (testObject /*:YAHOO.tool.TestSuite*/) /*:Void*/ { - if (testObject instanceof YAHOO.tool.TestSuite || testObject instanceof YAHOO.tool.TestCase) { - this.items.push(testObject); - } - }, - - //------------------------------------------------------------------------- - // Stub Methods - //------------------------------------------------------------------------- - - /** - * Function to run before each test is executed. - * @return {Void} - * @method setUp - */ - setUp : function () /*:Void*/ { - }, - - /** - * Function to run after each test is executed. - * @return {Void} - * @method tearDown - */ - tearDown: function () /*:Void*/ { - } - -}; - -YAHOO.namespace("tool"); - -/** - * The YUI test tool - * @module yuitest - * @namespace YAHOO.tool - * @requires yahoo,dom,event,logger - */ - - -//----------------------------------------------------------------------------- -// TestRunner object -//----------------------------------------------------------------------------- - -/** - * Runs test suites and test cases, providing events to allowing for the - * interpretation of test results. - * @namespace YAHOO.tool - * @class TestRunner - * @static - */ -YAHOO.tool.TestRunner = (function(){ - - /** - * A node in the test tree structure. May represent a TestSuite, TestCase, or - * test function. - * @param {Variant} testObject A TestSuite, TestCase, or the name of a test function. - * @class TestNode - * @constructor - * @private - */ - function TestNode(testObject /*:Variant*/){ - - /** - * The TestSuite, TestCase, or test function represented by this node. - * @type Variant - * @property testObject - */ - this.testObject = testObject; - - /** - * Pointer to this node's first child. - * @type TestNode - * @property firstChild - */ - this.firstChild /*:TestNode*/ = null; - - /** - * Pointer to this node's last child. - * @type TestNode - * @property lastChild - */ - this.lastChild = null; - - /** - * Pointer to this node's parent. - * @type TestNode - * @property parent - */ - this.parent = null; - - /** - * Pointer to this node's next sibling. - * @type TestNode - * @property next - */ - this.next = null; - - /** - * Test results for this test object. - * @type object - * @property results - */ - this.results /*:Object*/ = { - passed : 0, - failed : 0, - total : 0, - ignored : 0 - }; - - //initialize results - if (testObject instanceof YAHOO.tool.TestSuite){ - this.results.type = "testsuite"; - this.results.name = testObject.name; - } else if (testObject instanceof YAHOO.tool.TestCase){ - this.results.type = "testcase"; - this.results.name = testObject.name; - } - - } - - TestNode.prototype = { - - /** - * Appends a new test object (TestSuite, TestCase, or test function name) as a child - * of this node. - * @param {Variant} testObject A TestSuite, TestCase, or the name of a test function. - * @return {Void} - */ - appendChild : function (testObject /*:Variant*/) /*:Void*/{ - var node = new TestNode(testObject); - if (this.firstChild === null){ - this.firstChild = this.lastChild = node; - } else { - this.lastChild.next = node; - this.lastChild = node; - } - node.parent = this; - return node; - } - }; - - function TestRunner(){ - - //inherit from EventProvider - TestRunner.superclass.constructor.apply(this,arguments); - - /** - * Suite on which to attach all TestSuites and TestCases to be run. - * @type YAHOO.tool.TestSuite - * @property masterSuite - * @private - */ - this.masterSuite /*:YAHOO.tool.TestSuite*/ = new YAHOO.tool.TestSuite("YUI Test Results"); - - /** - * Pointer to the current node in the test tree. - * @type TestNode - * @private - * @property _cur - */ - this._cur = null; - - /** - * Pointer to the root node in the test tree. - * @type TestNode - * @private - * @property _root - */ - this._root = null; - - //create events - var events /*:Array*/ = [ - this.TEST_CASE_BEGIN_EVENT, - this.TEST_CASE_COMPLETE_EVENT, - this.TEST_SUITE_BEGIN_EVENT, - this.TEST_SUITE_COMPLETE_EVENT, - this.TEST_PASS_EVENT, - this.TEST_FAIL_EVENT, - this.TEST_IGNORE_EVENT, - this.COMPLETE_EVENT, - this.BEGIN_EVENT - ]; - for (var i=0; i < events.length; i++){ - this.createEvent(events[i], { scope: this }); - } - - } - - YAHOO.lang.extend(TestRunner, YAHOO.util.EventProvider, { - - //------------------------------------------------------------------------- - // Constants - //------------------------------------------------------------------------- - - /** - * Fires when a test case is opened but before the first - * test is executed. - * @event testcasebegin - */ - TEST_CASE_BEGIN_EVENT /*:String*/ : "testcasebegin", - - /** - * Fires when all tests in a test case have been executed. - * @event testcasecomplete - */ - TEST_CASE_COMPLETE_EVENT /*:String*/ : "testcasecomplete", - - /** - * Fires when a test suite is opened but before the first - * test is executed. - * @event testsuitebegin - */ - TEST_SUITE_BEGIN_EVENT /*:String*/ : "testsuitebegin", - - /** - * Fires when all test cases in a test suite have been - * completed. - * @event testsuitecomplete - */ - TEST_SUITE_COMPLETE_EVENT /*:String*/ : "testsuitecomplete", - - /** - * Fires when a test has passed. - * @event pass - */ - TEST_PASS_EVENT /*:String*/ : "pass", - - /** - * Fires when a test has failed. - * @event fail - */ - TEST_FAIL_EVENT /*:String*/ : "fail", - - /** - * Fires when a test has been ignored. - * @event ignore - */ - TEST_IGNORE_EVENT /*:String*/ : "ignore", - - /** - * Fires when all test suites and test cases have been completed. - * @event complete - */ - COMPLETE_EVENT /*:String*/ : "complete", - - /** - * Fires when the run() method is called. - * @event begin - */ - BEGIN_EVENT /*:String*/ : "begin", - - //------------------------------------------------------------------------- - // Test Tree-Related Methods - //------------------------------------------------------------------------- - - /** - * Adds a test case to the test tree as a child of the specified node. - * @param {TestNode} parentNode The node to add the test case to as a child. - * @param {YAHOO.tool.TestCase} testCase The test case to add. - * @return {Void} - * @static - * @private - * @method _addTestCaseToTestTree - */ - _addTestCaseToTestTree : function (parentNode /*:TestNode*/, testCase /*:YAHOO.tool.TestCase*/) /*:Void*/{ - - //add the test suite - var node = parentNode.appendChild(testCase); - - //iterate over the items in the test case - for (var prop in testCase){ - if (prop.indexOf("test") === 0 && YAHOO.lang.isFunction(testCase[prop])){ - node.appendChild(prop); - } - } - - }, - - /** - * Adds a test suite to the test tree as a child of the specified node. - * @param {TestNode} parentNode The node to add the test suite to as a child. - * @param {YAHOO.tool.TestSuite} testSuite The test suite to add. - * @return {Void} - * @static - * @private - * @method _addTestSuiteToTestTree - */ - _addTestSuiteToTestTree : function (parentNode /*:TestNode*/, testSuite /*:YAHOO.tool.TestSuite*/) /*:Void*/ { - - //add the test suite - var node = parentNode.appendChild(testSuite); - - //iterate over the items in the master suite - for (var i=0; i < testSuite.items.length; i++){ - if (testSuite.items[i] instanceof YAHOO.tool.TestSuite) { - this._addTestSuiteToTestTree(node, testSuite.items[i]); - } else if (testSuite.items[i] instanceof YAHOO.tool.TestCase) { - this._addTestCaseToTestTree(node, testSuite.items[i]); - } - } - }, - - /** - * Builds the test tree based on items in the master suite. The tree is a hierarchical - * representation of the test suites, test cases, and test functions. The resulting tree - * is stored in _root and the pointer _cur is set to the root initially. - * @return {Void} - * @static - * @private - * @method _buildTestTree - */ - _buildTestTree : function () /*:Void*/ { - - this._root = new TestNode(this.masterSuite); - this._cur = this._root; - - //iterate over the items in the master suite - for (var i=0; i < this.masterSuite.items.length; i++){ - if (this.masterSuite.items[i] instanceof YAHOO.tool.TestSuite) { - this._addTestSuiteToTestTree(this._root, this.masterSuite.items[i]); - } else if (this.masterSuite.items[i] instanceof YAHOO.tool.TestCase) { - this._addTestCaseToTestTree(this._root, this.masterSuite.items[i]); - } - } - - }, - - //------------------------------------------------------------------------- - // Private Methods - //------------------------------------------------------------------------- - - /** - * Handles the completion of a test object's tests. Tallies test results - * from one level up to the next. - * @param {TestNode} node The TestNode representing the test object. - * @return {Void} - * @method _handleTestObjectComplete - * @private - */ - _handleTestObjectComplete : function (node /*:TestNode*/) /*:Void*/ { - if (YAHOO.lang.isObject(node.testObject)){ - node.parent.results.passed += node.results.passed; - node.parent.results.failed += node.results.failed; - node.parent.results.total += node.results.total; - node.parent.results.ignored += node.results.ignored; - node.parent.results[node.testObject.name] = node.results; - - if (node.testObject instanceof YAHOO.tool.TestSuite){ - node.testObject.tearDown(); - this.fireEvent(this.TEST_SUITE_COMPLETE_EVENT, { testSuite: node.testObject, results: node.results}); - } else if (node.testObject instanceof YAHOO.tool.TestCase){ - this.fireEvent(this.TEST_CASE_COMPLETE_EVENT, { testCase: node.testObject, results: node.results}); - } - } - }, - - //------------------------------------------------------------------------- - // Navigation Methods - //------------------------------------------------------------------------- - - /** - * Retrieves the next node in the test tree. - * @return {TestNode} The next node in the test tree or null if the end is reached. - * @private - * @static - * @method _next - */ - _next : function () /*:TestNode*/ { - - if (this._cur.firstChild) { - this._cur = this._cur.firstChild; - } else if (this._cur.next) { - this._cur = this._cur.next; - } else { - while (this._cur && !this._cur.next && this._cur !== this._root){ - this._handleTestObjectComplete(this._cur); - this._cur = this._cur.parent; - } - - if (this._cur == this._root){ - this._cur.results.type = "report"; - this._cur.results.timestamp = (new Date()).toLocaleString(); - this.fireEvent(this.COMPLETE_EVENT, { results: this._cur.results}); - this._cur = null; - } else { - this._handleTestObjectComplete(this._cur); - this._cur = this._cur.next; - } - } - - return this._cur; - }, - - /** - * Runs a test case or test suite, returning the results. - * @param {YAHOO.tool.TestCase|YAHOO.tool.TestSuite} testObject The test case or test suite to run. - * @return {Object} Results of the execution with properties passed, failed, and total. - * @private - * @method _run - * @static - */ - _run : function () /*:Void*/ { - - //flag to indicate if the TestRunner should wait before continuing - var shouldWait /*:Boolean*/ = false; - - //get the next test node - var node = this._next(); - - if (node !== null) { - var testObject = node.testObject; - - //figure out what to do - if (YAHOO.lang.isObject(testObject)){ - if (testObject instanceof YAHOO.tool.TestSuite){ - this.fireEvent(this.TEST_SUITE_BEGIN_EVENT, { testSuite: testObject }); - testObject.setUp(); - } else if (testObject instanceof YAHOO.tool.TestCase){ - this.fireEvent(this.TEST_CASE_BEGIN_EVENT, { testCase: testObject }); - } - - //some environments don't support setTimeout - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._run(); - }, 0); - } else { - this._run(); - } - } else { - this._runTest(node); - } - - } - }, - - _resumeTest : function (segment /*:Function*/) /*:Void*/ { - - //get relevant information - var node /*:TestNode*/ = this._cur; - var testName /*:String*/ = node.testObject; - var testCase /*:YAHOO.tool.TestCase*/ = node.parent.testObject; - - //get the "should" test cases - var shouldFail /*:Object*/ = (testCase._should.fail || {})[testName]; - var shouldError /*:Object*/ = (testCase._should.error || {})[testName]; - - //variable to hold whether or not the test failed - var failed /*:Boolean*/ = false; - var error /*:Error*/ = null; - - //try the test - try { - - //run the test - segment.apply(testCase); - - //if it should fail, and it got here, then it's a fail because it didn't - if (shouldFail){ - error = new YAHOO.util.ShouldFail(); - failed = true; - } else if (shouldError){ - error = new YAHOO.util.ShouldError(); - failed = true; - } - - } catch (thrown /*:Error*/){ - if (thrown instanceof YAHOO.util.AssertionError) { - if (!shouldFail){ - error = thrown; - failed = true; - } - } else if (thrown instanceof YAHOO.tool.TestCase.Wait){ - - if (YAHOO.lang.isFunction(thrown.segment)){ - if (YAHOO.lang.isNumber(thrown.delay)){ - - //some environments don't support setTimeout - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._resumeTest(thrown.segment); - }, thrown.delay); - } else { - throw new Error("Asynchronous tests not supported in this environment."); - } - } - } - - return; - - } else { - //first check to see if it should error - if (!shouldError) { - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } else { - //check to see what type of data we have - if (YAHOO.lang.isString(shouldError)){ - - //if it's a string, check the error message - if (thrown.message != shouldError){ - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } - } else if (YAHOO.lang.isFunction(shouldError)){ - - //if it's a function, see if the error is an instance of it - if (!(thrown instanceof shouldError)){ - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } - - } else if (YAHOO.lang.isObject(shouldError)){ - - //if it's an object, check the instance and message - if (!(thrown instanceof shouldError.constructor) || - thrown.message != shouldError.message){ - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } - - } - - } - } - - } - - //fireEvent appropriate event - if (failed) { - this.fireEvent(this.TEST_FAIL_EVENT, { testCase: testCase, testName: testName, error: error }); - } else { - this.fireEvent(this.TEST_PASS_EVENT, { testCase: testCase, testName: testName }); - } - - //run the tear down - testCase.tearDown(); - - //update results - node.parent.results[testName] = { - result: failed ? "fail" : "pass", - message: error ? error.getMessage() : "Test passed", - type: "test", - name: testName - }; - - if (failed){ - node.parent.results.failed++; - } else { - node.parent.results.passed++; - } - node.parent.results.total++; - - //set timeout not supported in all environments - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._run(); - }, 0); - } else { - this._run(); - } - - }, - - /** - * Runs a single test based on the data provided in the node. - * @param {TestNode} node The TestNode representing the test to run. - * @return {Void} - * @static - * @private - * @name _runTest - */ - _runTest : function (node /*:TestNode*/) /*:Void*/ { - - //get relevant information - var testName /*:String*/ = node.testObject; - var testCase /*:YAHOO.tool.TestCase*/ = node.parent.testObject; - var test /*:Function*/ = testCase[testName]; - - //get the "should" test cases - var shouldIgnore /*:Object*/ = (testCase._should.ignore || {})[testName]; - - //figure out if the test should be ignored or not - if (shouldIgnore){ - - //update results - node.parent.results[testName] = { - result: "ignore", - message: "Test ignored", - type: "test", - name: testName - }; - - node.parent.results.ignored++; - node.parent.results.total++; - - this.fireEvent(this.TEST_IGNORE_EVENT, { testCase: testCase, testName: testName }); - - //some environments don't support setTimeout - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._run(); - }, 0); - } else { - this._run(); - } - - } else { - - //run the setup - testCase.setUp(); - - //now call the body of the test - this._resumeTest(test); - } - - }, - - //------------------------------------------------------------------------- - // Protected Methods - //------------------------------------------------------------------------- - - /* - * Fires events for the TestRunner. This overrides the default fireEvent() - * method from EventProvider to add the type property to the data that is - * passed through on each event call. - * @param {String} type The type of event to fire. - * @param {Object} data (Optional) Data for the event. - * @method fireEvent - * @static - * @protected - */ - fireEvent : function (type /*:String*/, data /*:Object*/) /*:Void*/ { - data = data || {}; - data.type = type; - TestRunner.superclass.fireEvent.call(this, type, data); - }, - - //------------------------------------------------------------------------- - // Public Methods - //------------------------------------------------------------------------- - - /** - * Adds a test suite or test case to the list of test objects to run. - * @param testObject Either a TestCase or a TestSuite that should be run. - * @return {Void} - * @method add - * @static - */ - add : function (testObject /*:Object*/) /*:Void*/ { - this.masterSuite.add(testObject); - }, - - /** - * Removes all test objects from the runner. - * @return {Void} - * @method clear - * @static - */ - clear : function () /*:Void*/ { - this.masterSuite.items = []; - }, - - /** - * Resumes the TestRunner after wait() was called. - * @param {Function} segment The function to run as the rest - * of the haulted test. - * @return {Void} - * @method resume - * @static - */ - resume : function (segment /*:Function*/) /*:Void*/ { - this._resumeTest(segment || function(){}); - }, - - /** - * Runs the test suite. - * @return {Void} - * @method run - * @static - */ - run : function (testObject /*:Object*/) /*:Void*/ { - - //pointer to runner to avoid scope issues - var runner = YAHOO.tool.TestRunner; - - //build the test tree - runner._buildTestTree(); - - //fire the begin event - runner.fireEvent(runner.BEGIN_EVENT); - - //begin the testing - runner._run(); - } - }); - - return new TestRunner(); - -})(); - -YAHOO.namespace("util"); - -//----------------------------------------------------------------------------- -// Assert object -//----------------------------------------------------------------------------- - -/** - * The Assert object provides functions to test JavaScript values against - * known and expected results. Whenever a comparison (assertion) fails, - * an error is thrown. - * - * @namespace YAHOO.util - * @class Assert - * @static - */ -YAHOO.util.Assert = { - - //------------------------------------------------------------------------- - // Generic Assertion Methods - //------------------------------------------------------------------------- - - /** - * Forces an assertion error to occur. - * @param {String} message (Optional) The message to display with the failure. - * @method fail - * @static - */ - fail : function (message /*:String*/) /*:Void*/ { - throw new YAHOO.util.AssertionError(message || "Test force-failed."); - }, - - //------------------------------------------------------------------------- - // Equality Assertion Methods - //------------------------------------------------------------------------- - - /** - * Asserts that a value is equal to another. This uses the double equals sign - * so type cohersion may occur. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areEqual - * @static - */ - areEqual : function (expected /*:Object*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (expected != actual) { - throw new YAHOO.util.ComparisonFailure(message || "Values should be equal.", expected, actual); - } - }, - - /** - * Asserts that a value is not equal to another. This uses the double equals sign - * so type cohersion may occur. - * @param {Object} unexpected The unexpected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areNotEqual - * @static - */ - areNotEqual : function (unexpected /*:Object*/, actual /*:Object*/, - message /*:String*/) /*:Void*/ { - if (unexpected == actual) { - throw new YAHOO.util.UnexpectedValue(message || "Values should not be equal.", unexpected); - } - }, - - /** - * Asserts that a value is not the same as another. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} unexpected The unexpected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areNotSame - * @static - */ - areNotSame : function (unexpected /*:Object*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (unexpected === actual) { - throw new YAHOO.util.UnexpectedValue(message || "Values should not be the same.", unexpected); - } - }, - - /** - * Asserts that a value is the same as another. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areSame - * @static - */ - areSame : function (expected /*:Object*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (expected !== actual) { - throw new YAHOO.util.ComparisonFailure(message || "Values should be the same.", expected, actual); - } - }, - - //------------------------------------------------------------------------- - // Boolean Assertion Methods - //------------------------------------------------------------------------- - - /** - * Asserts that a value is false. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isFalse - * @static - */ - isFalse : function (actual /*:Boolean*/, message /*:String*/) { - if (false !== actual) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be false.", false, actual); - } - }, - - /** - * Asserts that a value is true. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isTrue - * @static - */ - isTrue : function (actual /*:Boolean*/, message /*:String*/) /*:Void*/ { - if (true !== actual) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be true.", true, actual); - } - - }, - - //------------------------------------------------------------------------- - // Special Value Assertion Methods - //------------------------------------------------------------------------- - - /** - * Asserts that a value is not a number. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNaN - * @static - */ - isNaN : function (actual /*:Object*/, message /*:String*/) /*:Void*/{ - if (!isNaN(actual)){ - throw new YAHOO.util.ComparisonFailure(message || "Value should be NaN.", NaN, actual); - } - }, - - /** - * Asserts that a value is not the special NaN value. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotNaN - * @static - */ - isNotNaN : function (actual /*:Object*/, message /*:String*/) /*:Void*/{ - if (isNaN(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Values should not be NaN.", NaN); - } - }, - - /** - * Asserts that a value is not null. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotNull - * @static - */ - isNotNull : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (YAHOO.lang.isNull(actual)) { - throw new YAHOO.util.UnexpectedValue(message || "Values should not be null.", null); - } - }, - - /** - * Asserts that a value is not undefined. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotUndefined - * @static - */ - isNotUndefined : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (YAHOO.lang.isUndefined(actual)) { - throw new YAHOO.util.UnexpectedValue(message || "Value should not be undefined.", undefined); - } - }, - - /** - * Asserts that a value is null. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNull - * @static - */ - isNull : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isNull(actual)) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be null.", null, actual); - } - }, - - /** - * Asserts that a value is undefined. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isUndefined - * @static - */ - isUndefined : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isUndefined(actual)) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be undefined.", undefined, actual); - } - }, - - //-------------------------------------------------------------------------- - // Instance Assertion Methods - //-------------------------------------------------------------------------- - - /** - * Asserts that a value is an array. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isArray - * @static - */ - isArray : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isArray(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be an array.", actual); - } - }, - - /** - * Asserts that a value is a Boolean. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isBoolean - * @static - */ - isBoolean : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isBoolean(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a Boolean.", actual); - } - }, - - /** - * Asserts that a value is a function. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isFunction - * @static - */ - isFunction : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isFunction(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a function.", actual); - } - }, - - /** - * Asserts that a value is an instance of a particular object. This may return - * incorrect results when comparing objects from one frame to constructors in - * another frame. For best results, don't use in a cross-frame manner. - * @param {Function} expected The function that the object should be an instance of. - * @param {Object} actual The object to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isInstanceOf - * @static - */ - isInstanceOf : function (expected /*:Function*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!(actual instanceof expected)){ - throw new YAHOO.util.ComparisonFailure(message || "Value isn't an instance of expected type.", expected, actual); - } - }, - - /** - * Asserts that a value is a number. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNumber - * @static - */ - isNumber : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isNumber(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a number.", actual); - } - }, - - /** - * Asserts that a value is an object. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isObject - * @static - */ - isObject : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isObject(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be an object.", actual); - } - }, - - /** - * Asserts that a value is a string. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isString - * @static - */ - isString : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isString(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a string.", actual); - } - }, - - /** - * Asserts that a value is of a particular type. - * @param {String} expectedType The expected type of the variable. - * @param {Object} actualValue The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isTypeOf - * @static - */ - isTypeOf : function (expectedType /*:String*/, actualValue /*:Object*/, message /*:String*/) /*:Void*/{ - if (typeof actualValue != expectedType){ - throw new YAHOO.util.ComparisonFailure(message || "Value should be of type " + expected + ".", expected, typeof actual); - } - } -}; - -//----------------------------------------------------------------------------- -// Assertion errors -//----------------------------------------------------------------------------- - -/** - * AssertionError is thrown whenever an assertion fails. It provides methods - * to more easily get at error information and also provides a base class - * from which more specific assertion errors can be derived. - * - * @param {String} message The message to display when the error occurs. - * @namespace YAHOO.util - * @class AssertionError - * @extends Error - * @constructor - */ -YAHOO.util.AssertionError = function (message /*:String*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message); - - /* - * Error message. Must be duplicated to ensure browser receives it. - * @type String - * @property message - */ - this.message /*:String*/ = message; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "AssertionError"; -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.AssertionError, Error, { - - /** - * Returns a fully formatted error for an assertion failure. This should - * be overridden by all subclasses to provide specific information. - * @method getMessage - * @return {String} A string describing the error. - */ - getMessage : function () /*:String*/ { - return this.message; - }, - - /** - * Returns a string representation of the error. - * @method toString - * @return {String} A string representation of the error. - */ - toString : function () /*:String*/ { - return this.name + ": " + this.getMessage(); - }, - - /** - * Returns a primitive value version of the error. Same as toString(). - * @method valueOf - * @return {String} A primitive value version of the error. - */ - valueOf : function () /*:String*/ { - return this.toString(); - } - -}); - -/** - * ComparisonFailure is subclass of AssertionError that is thrown whenever - * a comparison between two values fails. It provides mechanisms to retrieve - * both the expected and actual value. - * - * @param {String} message The message to display when the error occurs. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value that caused the assertion to fail. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class ComparisonFailure - * @constructor - */ -YAHOO.util.ComparisonFailure = function (message /*:String*/, expected /*:Object*/, actual /*:Object*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message); - - /** - * The expected value. - * @type Object - * @property expected - */ - this.expected /*:Object*/ = expected; - - /** - * The actual value. - * @type Object - * @property actual - */ - this.actual /*:Object*/ = actual; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "ComparisonFailure"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.ComparisonFailure, YAHOO.util.AssertionError, { - - /** - * Returns a fully formatted error for an assertion failure. This message - * provides information about the expected and actual values. - * @method toString - * @return {String} A string describing the error. - */ - getMessage : function () /*:String*/ { - return this.message + "\nExpected: " + this.expected + " (" + (typeof this.expected) + ")" + - "\nActual:" + this.actual + " (" + (typeof this.actual) + ")"; - } - -}); - -/** - * UnexpectedValue is subclass of AssertionError that is thrown whenever - * a value was unexpected in its scope. This typically means that a test - * was performed to determine that a value was *not* equal to a certain - * value. - * - * @param {String} message The message to display when the error occurs. - * @param {Object} unexpected The unexpected value. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class UnexpectedValue - * @constructor - */ -YAHOO.util.UnexpectedValue = function (message /*:String*/, unexpected /*:Object*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message); - - /** - * The unexpected value. - * @type Object - * @property unexpected - */ - this.unexpected /*:Object*/ = unexpected; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "UnexpectedValue"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.UnexpectedValue, YAHOO.util.AssertionError, { - - /** - * Returns a fully formatted error for an assertion failure. The message - * contains information about the unexpected value that was encountered. - * @method getMessage - * @return {String} A string describing the error. - */ - getMessage : function () /*:String*/ { - return this.message + "\nUnexpected: " + this.unexpected + " (" + (typeof this.unexpected) + ") "; - } - -}); - -/** - * ShouldFail is subclass of AssertionError that is thrown whenever - * a test was expected to fail but did not. - * - * @param {String} message The message to display when the error occurs. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class ShouldFail - * @constructor - */ -YAHOO.util.ShouldFail = function (message /*:String*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message || "This test should fail but didn't."); - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "ShouldFail"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.ShouldFail, YAHOO.util.AssertionError); - -/** - * ShouldError is subclass of AssertionError that is thrown whenever - * a test is expected to throw an error but doesn't. - * - * @param {String} message The message to display when the error occurs. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class ShouldError - * @constructor - */ -YAHOO.util.ShouldError = function (message /*:String*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message || "This test should have thrown an error but didn't."); - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "ShouldError"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.ShouldError, YAHOO.util.AssertionError); - -/** - * UnexpectedError is subclass of AssertionError that is thrown whenever - * an error occurs within the course of a test and the test was not expected - * to throw an error. - * - * @param {Error} cause The unexpected error that caused this error to be - * thrown. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class UnexpectedError - * @constructor - */ -YAHOO.util.UnexpectedError = function (cause /*:Object*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, "Unexpected error: " + cause.message); - - /** - * The unexpected error that occurred. - * @type Error - * @property cause - */ - this.cause /*:Error*/ = cause; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "UnexpectedError"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.UnexpectedError, YAHOO.util.AssertionError); - -//----------------------------------------------------------------------------- -// ArrayAssert object -//----------------------------------------------------------------------------- - -/** - * The ArrayAssert object provides functions to test JavaScript array objects - * for a variety of cases. - * - * @namespace YAHOO.util - * @class ArrayAssert - * @static - */ - -YAHOO.util.ArrayAssert = { - - /** - * Asserts that a value is present in an array. This uses the triple equals - * sign so no type cohersion may occur. - * @param {Object} needle The value that is expected in the array. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method contains - * @static - */ - contains : function (needle /*:Object*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (haystack[i] === needle) { - found = true; - } - } - - if (!found){ - YAHOO.util.Assert.fail(message || "Value (" + needle + ") not found in array."); - } - }, - - /** - * Asserts that a set of values are present in an array. This uses the triple equals - * sign so no type cohersion may occur. For this assertion to pass, all values must - * be found. - * @param {Object[]} needles An array of values that are expected in the array. - * @param {Array} haystack An array of values to check. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method containsItems - * @static - */ - containsItems : function (needles /*:Object[]*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - //begin checking values - for (var i=0; i < needles.length; i++){ - this.contains(needles[i], haystack, message); - } - - if (!found){ - YAHOO.util.Assert.fail(message || "Value not found in array."); - } - }, - - /** - * Asserts that a value matching some condition is present in an array. This uses - * a function to determine a match. - * @param {Function} matcher A function that returns true if the items matches or false if not. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method containsMatch - * @static - */ - containsMatch : function (matcher /*:Function*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - //check for valid matcher - if (typeof matcher != "function"){ - throw new TypeError("ArrayAssert.containsMatch(): First argument must be a function."); - } - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (matcher(haystack[i])) { - found = true; - } - } - - if (!found){ - YAHOO.util.Assert.fail(message || "No match found in array."); - } - }, - - /** - * Asserts that a value is not present in an array. This uses the triple equals - * sign so no type cohersion may occur. - * @param {Object} needle The value that is expected in the array. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method doesNotContain - * @static - */ - doesNotContain : function (needle /*:Object*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (haystack[i] === needle) { - found = true; - } - } - - if (found){ - YAHOO.util.Assert.fail(message || "Value found in array."); - } - }, - - /** - * Asserts that a set of values are not present in an array. This uses the triple equals - * sign so no type cohersion may occur. For this assertion to pass, all values must - * not be found. - * @param {Object[]} needles An array of values that are not expected in the array. - * @param {Array} haystack An array of values to check. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method doesNotContainItems - * @static - */ - doesNotContainItems : function (needles /*:Object[]*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - for (var i=0; i < needles.length; i++){ - this.doesNotContain(needles[i], haystack, message); - } - - }, - - /** - * Asserts that no values matching a condition are present in an array. This uses - * a function to determine a match. - * @param {Function} matcher A function that returns true if the items matches or false if not. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method doesNotContainMatch - * @static - */ - doesNotContainMatch : function (matcher /*:Function*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - //check for valid matcher - if (typeof matcher != "function"){ - throw new TypeError("ArrayAssert.doesNotContainMatch(): First argument must be a function."); - } - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (matcher(haystack[i])) { - found = true; - } - } - - if (found){ - YAHOO.util.Assert.fail(message || "Value found in array."); - } - }, - - /** - * Asserts that the given value is contained in an array at the specified index. - * This uses the triple equals sign so no type cohersion will occur. - * @param {Object} needle The value to look for. - * @param {Array} haystack The array to search in. - * @param {int} index The index at which the value should exist. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method indexOf - * @static - */ - indexOf : function (needle /*:Object*/, haystack /*:Array*/, index /*:int*/, message /*:String*/) /*:Void*/ { - - //try to find the value in the array - for (var i=0; i < haystack.length; i++){ - if (haystack[i] === needle){ - YAHOO.util.Assert.areEqual(index, i, message || "Value exists at index " + i + " but should be at index " + index + "."); - return; - } - } - - //if it makes it here, it wasn't found at all - YAHOO.util.Assert.fail(message || "Value doesn't exist in array."); - }, - - /** - * Asserts that the values in an array are equal, and in the same position, - * as values in another array. This uses the double equals sign - * so type cohersion may occur. Note that the array objects themselves - * need not be the same for this test to pass. - * @param {Array} expected An array of the expected values. - * @param {Array} actual Any array of the actual values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method itemsAreEqual - * @static - */ - itemsAreEqual : function (expected /*:Array*/, actual /*:Array*/, - message /*:String*/) /*:Void*/ { - - //one may be longer than the other, so get the maximum length - var len /*:int*/ = Math.max(expected.length, actual.length); - - //begin checking values - for (var i=0; i < len; i++){ - YAHOO.util.Assert.areEqual(expected[i], actual[i], message || - "Values in position " + i + " are not equal."); - } - }, - - /** - * Asserts that the values in an array are equivalent, and in the same position, - * as values in another array. This uses a function to determine if the values - * are equivalent. Note that the array objects themselves - * need not be the same for this test to pass. - * @param {Array} expected An array of the expected values. - * @param {Array} actual Any array of the actual values. - * @param {Function} comparator A function that returns true if the values are equivalent - * or false if not. - * @param {String} message (Optional) The message to display if the assertion fails. - * @return {Void} - * @method itemsAreEquivalent - * @static - */ - itemsAreEquivalent : function (expected /*:Array*/, actual /*:Array*/, - comparator /*:Function*/, message /*:String*/) /*:Void*/ { - - //make sure the comparator is valid - if (typeof comparator != "function"){ - throw new TypeError("ArrayAssert.itemsAreEquivalent(): Third argument must be a function."); - } - - //one may be longer than the other, so get the maximum length - var len /*:int*/ = Math.max(expected.length, actual.length); - - //begin checking values - for (var i=0; i < len; i++){ - if (!comparator(expected[i], actual[i])){ - throw new YAHOO.util.ComparisonFailure(message || "Values in position " + i + " are not equivalent.", expected[i], actual[i]); - } - } - }, - - /** - * Asserts that an array is empty. - * @param {Array} actual The array to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isEmpty - * @static - */ - isEmpty : function (actual /*:Array*/, message /*:String*/) /*:Void*/ { - if (actual.length > 0){ - YAHOO.util.Assert.fail(message || "Array should be empty."); - } - }, - - /** - * Asserts that an array is not empty. - * @param {Array} actual The array to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotEmpty - * @static - */ - isNotEmpty : function (actual /*:Array*/, message /*:String*/) /*:Void*/ { - if (actual.length === 0){ - YAHOO.util.Assert.fail(message || "Array should not be empty."); - } - }, - - /** - * Asserts that the values in an array are the same, and in the same position, - * as values in another array. This uses the triple equals sign - * so no type cohersion will occur. Note that the array objects themselves - * need not be the same for this test to pass. - * @param {Array} expected An array of the expected values. - * @param {Array} actual Any array of the actual values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method itemsAreSame - * @static - */ - itemsAreSame : function (expected /*:Array*/, actual /*:Array*/, - message /*:String*/) /*:Void*/ { - - //one may be longer than the other, so get the maximum length - var len /*:int*/ = Math.max(expected.length, actual.length); - - //begin checking values - for (var i=0; i < len; i++){ - YAHOO.util.Assert.areSame(expected[i], actual[i], - message || "Values in position " + i + " are not the same."); - } - }, - - /** - * Asserts that the given value is contained in an array at the specified index, - * starting from the back of the array. - * This uses the triple equals sign so no type cohersion will occur. - * @param {Object} needle The value to look for. - * @param {Array} haystack The array to search in. - * @param {int} index The index at which the value should exist. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method lastIndexOf - * @static - */ - lastIndexOf : function (needle /*:Object*/, haystack /*:Array*/, index /*:int*/, message /*:String*/) /*:Void*/ { - - //try to find the value in the array - for (var i=haystack.length; i >= 0; i--){ - if (haystack[i] === needle){ - YAHOO.util.Assert.areEqual(index, i, message || "Value exists at index " + i + " but should be at index " + index + "."); - return; - } - } - - //if it makes it here, it wasn't found at all - YAHOO.util.Assert.fail(message || "Value doesn't exist in array."); - } - -}; - -YAHOO.namespace("util"); - - -//----------------------------------------------------------------------------- -// ObjectAssert object -//----------------------------------------------------------------------------- - -/** - * The ObjectAssert object provides functions to test JavaScript objects - * for a variety of cases. - * - * @namespace YAHOO.util - * @class ObjectAssert - * @static - */ -YAHOO.util.ObjectAssert = { - - /** - * Asserts that all properties in the object exist in another object. - * @param {Object} expected An object with the expected properties. - * @param {Object} actual An object with the actual properties. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method propertiesAreEqual - * @static - */ - propertiesAreEqual : function (expected /*:Object*/, actual /*:Object*/, - message /*:String*/) /*:Void*/ { - - //get all properties in the object - var properties /*:Array*/ = []; - for (var property in expected){ - properties.push(property); - } - - //see if the properties are in the expected object - for (var i=0; i < properties.length; i++){ - YAHOO.util.Assert.isNotUndefined(actual[properties[i]], message || - "Property'" + properties[i] + "' expected."); - } - - }, - - /** - * Asserts that an object has a property with the given name. - * @param {String} propertyName The name of the property to test. - * @param {Object} object The object to search. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method hasProperty - * @static - */ - hasProperty : function (propertyName /*:String*/, object /*:Object*/, message /*:String*/) /*:Void*/ { - if (YAHOO.lang.isUndefined(object[propertyName])){ - YAHOO.util.Assert.fail(message || - "Property " + propertyName + " not found on object."); - } - }, - - /** - * Asserts that a property with the given name exists on an object instance (not on its prototype). - * @param {String} propertyName The name of the property to test. - * @param {Object} object The object to search. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method hasProperty - * @static - */ - hasOwnProperty : function (propertyName /*:String*/, object /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.hasOwnProperty(object, propertyName)){ - YAHOO.util.Assert.fail(message || - "Property " + propertyName + " not found on object instance."); - } - } -}; - -//----------------------------------------------------------------------------- -// DateAssert object -//----------------------------------------------------------------------------- - -/** - * The DateAssert object provides functions to test JavaScript Date objects - * for a variety of cases. - * - * @namespace YAHOO.util - * @class DateAssert - * @static - */ - -YAHOO.util.DateAssert = { - - /** - * Asserts that a date's month, day, and year are equal to another date's. - * @param {Date} expected The expected date. - * @param {Date} actual The actual date to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areEqual - * @static - */ - datesAreEqual : function (expected /*:Date*/, actual /*:Date*/, message /*:String*/){ - if (expected instanceof Date && actual instanceof Date){ - YAHOO.util.Assert.areEqual(expected.getFullYear(), actual.getFullYear(), message || "Years should be equal."); - YAHOO.util.Assert.areEqual(expected.getMonth(), actual.getMonth(), message || "Months should be equal."); - YAHOO.util.Assert.areEqual(expected.getDate(), actual.getDate(), message || "Day of month should be equal."); - } else { - throw new TypeError("DateAssert.datesAreEqual(): Expected and actual values must be Date objects."); - } - }, - - /** - * Asserts that a date's hour, minutes, and seconds are equal to another date's. - * @param {Date} expected The expected date. - * @param {Date} actual The actual date to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areEqual - * @static - */ - timesAreEqual : function (expected /*:Date*/, actual /*:Date*/, message /*:String*/){ - if (expected instanceof Date && actual instanceof Date){ - YAHOO.util.Assert.areEqual(expected.getHours(), actual.getHours(), message || "Hours should be equal."); - YAHOO.util.Assert.areEqual(expected.getMinutes(), actual.getMinutes(), message || "Minutes should be equal."); - YAHOO.util.Assert.areEqual(expected.getSeconds(), actual.getSeconds(), message || "Seconds should be equal."); - } else { - throw new TypeError("DateAssert.timesAreEqual(): Expected and actual values must be Date objects."); - } - } - -}; - -YAHOO.namespace("util"); - -/** - * The UserAction object provides functions that simulate events occurring in - * the browser. Since these are simulated events, they do not behave exactly - * as regular, user-initiated events do, but can be used to test simple - * user interactions safely. - * - * @namespace YAHOO.util - * @class UserAction - * @static - */ -YAHOO.util.UserAction = { - - //-------------------------------------------------------------------------- - // Generic event methods - //-------------------------------------------------------------------------- - - /** - * Simulates a key event using the given event information to populate - * the generated event object. This method does browser-equalizing - * calculations to account for differences in the DOM and IE event models - * as well as different browser quirks. Note: keydown causes Safari 2.x to - * crash. - * @method simulateKeyEvent - * @private - * @static - * @param {HTMLElement} target The target of the given event. - * @param {String} type The type of event to fire. This can be any one of - * the following: keyup, keydown, and keypress. - * @param {Boolean} bubbles (Optional) Indicates if the event can be - * bubbled up. DOM Level 3 specifies that all key events bubble by - * default. The default is true. - * @param {Boolean} cancelable (Optional) Indicates if the event can be - * canceled using preventDefault(). DOM Level 3 specifies that all - * key events can be cancelled. The default - * is true. - * @param {Window} view (Optional) The view containing the target. This is - * typically the window object. The default is window. - * @param {Boolean} ctrlKey (Optional) Indicates if one of the CTRL keys - * is pressed while the event is firing. The default is false. - * @param {Boolean} altKey (Optional) Indicates if one of the ALT keys - * is pressed while the event is firing. The default is false. - * @param {Boolean} shiftKey (Optional) Indicates if one of the SHIFT keys - * is pressed while the event is firing. The default is false. - * @param {Boolean} metaKey (Optional) Indicates if one of the META keys - * is pressed while the event is firing. The default is false. - * @param {int} keyCode (Optional) The code for the key that is in use. - * The default is 0. - * @param {int} charCode (Optional) The Unicode code for the character - * associated with the key being used. The default is 0. - */ - simulateKeyEvent : function (target /*:HTMLElement*/, type /*:String*/, - bubbles /*:Boolean*/, cancelable /*:Boolean*/, - view /*:Window*/, - ctrlKey /*:Boolean*/, altKey /*:Boolean*/, - shiftKey /*:Boolean*/, metaKey /*:Boolean*/, - keyCode /*:int*/, charCode /*:int*/) /*:Void*/ - { - //check target - target = YAHOO.util.Dom.get(target); - if (!target){ - throw new Error("simulateKeyEvent(): Invalid target."); - } - - //check event type - if (YAHOO.lang.isString(type)){ - type = type.toLowerCase(); - switch(type){ - case "keyup": - case "keydown": - case "keypress": - break; - case "textevent": //DOM Level 3 - type = "keypress"; - break; - // @TODO was the fallthrough intentional, if so throw error - default: - throw new Error("simulateKeyEvent(): Event type '" + type + "' not supported."); - } - } else { - throw new Error("simulateKeyEvent(): Event type must be a string."); - } - - //setup default values - if (!YAHOO.lang.isBoolean(bubbles)){ - bubbles = true; //all key events bubble - } - if (!YAHOO.lang.isBoolean(cancelable)){ - cancelable = true; //all key events can be cancelled - } - if (!YAHOO.lang.isObject(view)){ - view = window; //view is typically window - } - if (!YAHOO.lang.isBoolean(ctrlKey)){ - ctrlKey = false; - } - if (!YAHOO.lang.isBoolean(altKey)){ - altKey = false; - } - if (!YAHOO.lang.isBoolean(shiftKey)){ - shiftKey = false; - } - if (!YAHOO.lang.isBoolean(metaKey)){ - metaKey = false; - } - if (!YAHOO.lang.isNumber(keyCode)){ - keyCode = 0; - } - if (!YAHOO.lang.isNumber(charCode)){ - charCode = 0; - } - - //try to create a mouse event - var customEvent /*:MouseEvent*/ = null; - - //check for DOM-compliant browsers first - if (YAHOO.lang.isFunction(document.createEvent)){ - - try { - - //try to create key event - customEvent = document.createEvent("KeyEvents"); - - /* - * Interesting problem: Firefox implemented a non-standard - * version of initKeyEvent() based on DOM Level 2 specs. - * Key event was removed from DOM Level 2 and re-introduced - * in DOM Level 3 with a different interface. Firefox is the - * only browser with any implementation of Key Events, so for - * now, assume it's Firefox if the above line doesn't error. - */ - //TODO: Decipher between Firefox's implementation and a correct one. - customEvent.initKeyEvent(type, bubbles, cancelable, view, ctrlKey, - altKey, shiftKey, metaKey, keyCode, charCode); - - } catch (ex /*:Error*/){ - - /* - * If it got here, that means key events aren't officially supported. - * Safari/WebKit is a real problem now. WebKit 522 won't let you - * set keyCode, charCode, or other properties if you use a - * UIEvent, so we first must try to create a generic event. The - * fun part is that this will throw an error on Safari 2.x. The - * end result is that we need another try...catch statement just to - * deal with this mess. - */ - try { - - //try to create generic event - will fail in Safari 2.x - customEvent = document.createEvent("Events"); - - } catch (uierror /*:Error*/){ - - //the above failed, so create a UIEvent for Safari 2.x - customEvent = document.createEvent("UIEvents"); - - } finally { - - customEvent.initEvent(type, bubbles, cancelable); - - //initialize - customEvent.view = view; - customEvent.altKey = altKey; - customEvent.ctrlKey = ctrlKey; - customEvent.shiftKey = shiftKey; - customEvent.metaKey = metaKey; - customEvent.keyCode = keyCode; - customEvent.charCode = charCode; - - } - - } - - //fire the event - target.dispatchEvent(customEvent); - - } else if (YAHOO.lang.isObject(document.createEventObject)){ //IE - - //create an IE event object - customEvent = document.createEventObject(); - - //assign available properties - customEvent.bubbles = bubbles; - customEvent.cancelable = cancelable; - customEvent.view = view; - customEvent.ctrlKey = ctrlKey; - customEvent.altKey = altKey; - customEvent.shiftKey = shiftKey; - customEvent.metaKey = metaKey; - - /* - * IE doesn't support charCode explicitly. CharCode should - * take precedence over any keyCode value for accurate - * representation. - */ - customEvent.keyCode = (charCode > 0) ? charCode : keyCode; - - //fire the event - target.fireEvent("on" + type, customEvent); - - } else { - throw new Error("simulateKeyEvent(): No event simulation framework present."); - } - }, - - /** - * Simulates a mouse event using the given event information to populate - * the generated event object. This method does browser-equalizing - * calculations to account for differences in the DOM and IE event models - * as well as different browser quirks. - * @method simulateMouseEvent - * @private - * @static - * @param {HTMLElement} target The target of the given event. - * @param {String} type The type of event to fire. This can be any one of - * the following: click, dblclick, mousedown, mouseup, mouseout, - * mouseover, and mousemove. - * @param {Boolean} bubbles (Optional) Indicates if the event can be - * bubbled up. DOM Level 2 specifies that all mouse events bubble by - * default. The default is true. - * @param {Boolean} cancelable (Optional) Indicates if the event can be - * canceled using preventDefault(). DOM Level 2 specifies that all - * mouse events except mousemove can be cancelled. The default - * is true for all events except mousemove, for which the default - * is false. - * @param {Window} view (Optional) The view containing the target. This is - * typically the window object. The default is window. - * @param {int} detail (Optional) The number of times the mouse button has - * been used. The default value is 1. - * @param {int} screenX (Optional) The x-coordinate on the screen at which - * point the event occured. The default is 0. - * @param {int} screenY (Optional) The y-coordinate on the screen at which - * point the event occured. The default is 0. - * @param {int} clientX (Optional) The x-coordinate on the client at which - * point the event occured. The default is 0. - * @param {int} clientY (Optional) The y-coordinate on the client at which - * point the event occured. The default is 0. - * @param {Boolean} ctrlKey (Optional) Indicates if one of the CTRL keys - * is pressed while the event is firing. The default is false. - * @param {Boolean} altKey (Optional) Indicates if one of the ALT keys - * is pressed while the event is firing. The default is false. - * @param {Boolean} shiftKey (Optional) Indicates if one of the SHIFT keys - * is pressed while the event is firing. The default is false. - * @param {Boolean} metaKey (Optional) Indicates if one of the META keys - * is pressed while the event is firing. The default is false. - * @param {int} button (Optional) The button being pressed while the event - * is executing. The value should be 0 for the primary mouse button - * (typically the left button), 1 for the terciary mouse button - * (typically the middle button), and 2 for the secondary mouse button - * (typically the right button). The default is 0. - * @param {HTMLElement} relatedTarget (Optional) For mouseout events, - * this is the element that the mouse has moved to. For mouseover - * events, this is the element that the mouse has moved from. This - * argument is ignored for all other events. The default is null. - */ - simulateMouseEvent : function (target /*:HTMLElement*/, type /*:String*/, - bubbles /*:Boolean*/, cancelable /*:Boolean*/, - view /*:Window*/, detail /*:int*/, - screenX /*:int*/, screenY /*:int*/, - clientX /*:int*/, clientY /*:int*/, - ctrlKey /*:Boolean*/, altKey /*:Boolean*/, - shiftKey /*:Boolean*/, metaKey /*:Boolean*/, - button /*:int*/, relatedTarget /*:HTMLElement*/) /*:Void*/ - { - - //check target - target = YAHOO.util.Dom.get(target); - if (!target){ - throw new Error("simulateMouseEvent(): Invalid target."); - } - - //check event type - if (YAHOO.lang.isString(type)){ - type = type.toLowerCase(); - switch(type){ - case "mouseover": - case "mouseout": - case "mousedown": - case "mouseup": - case "click": - case "dblclick": - case "mousemove": - break; - default: - throw new Error("simulateMouseEvent(): Event type '" + type + "' not supported."); - } - } else { - throw new Error("simulateMouseEvent(): Event type must be a string."); - } - - //setup default values - if (!YAHOO.lang.isBoolean(bubbles)){ - bubbles = true; //all mouse events bubble - } - if (!YAHOO.lang.isBoolean(cancelable)){ - cancelable = (type != "mousemove"); //mousemove is the only one that can't be cancelled - } - if (!YAHOO.lang.isObject(view)){ - view = window; //view is typically window - } - if (!YAHOO.lang.isNumber(detail)){ - detail = 1; //number of mouse clicks must be at least one - } - if (!YAHOO.lang.isNumber(screenX)){ - screenX = 0; - } - if (!YAHOO.lang.isNumber(screenY)){ - screenY = 0; - } - if (!YAHOO.lang.isNumber(clientX)){ - clientX = 0; - } - if (!YAHOO.lang.isNumber(clientY)){ - clientY = 0; - } - if (!YAHOO.lang.isBoolean(ctrlKey)){ - ctrlKey = false; - } - if (!YAHOO.lang.isBoolean(altKey)){ - altKey = false; - } - if (!YAHOO.lang.isBoolean(shiftKey)){ - shiftKey = false; - } - if (!YAHOO.lang.isBoolean(metaKey)){ - metaKey = false; - } - if (!YAHOO.lang.isNumber(button)){ - button = 0; - } - - //try to create a mouse event - var customEvent /*:MouseEvent*/ = null; - - //check for DOM-compliant browsers first - if (YAHOO.lang.isFunction(document.createEvent)){ - - customEvent = document.createEvent("MouseEvents"); - - //Safari 2.x (WebKit 418) still doesn't implement initMouseEvent() - if (customEvent.initMouseEvent){ - customEvent.initMouseEvent(type, bubbles, cancelable, view, detail, - screenX, screenY, clientX, clientY, - ctrlKey, altKey, shiftKey, metaKey, - button, relatedTarget); - } else { //Safari - - //the closest thing available in Safari 2.x is UIEvents - customEvent = document.createEvent("UIEvents"); - customEvent.initEvent(type, bubbles, cancelable); - customEvent.view = view; - customEvent.detail = detail; - customEvent.screenX = screenX; - customEvent.screenY = screenY; - customEvent.clientX = clientX; - customEvent.clientY = clientY; - customEvent.ctrlKey = ctrlKey; - customEvent.altKey = altKey; - customEvent.metaKey = metaKey; - customEvent.shiftKey = shiftKey; - customEvent.button = button; - customEvent.relatedTarget = relatedTarget; - } - - /* - * Check to see if relatedTarget has been assigned. Firefox - * versions less than 2.0 don't allow it to be assigned via - * initMouseEvent() and the property is readonly after event - * creation, so in order to keep YAHOO.util.getRelatedTarget() - * working, assign to the IE proprietary toElement property - * for mouseout event and fromElement property for mouseover - * event. - */ - if (relatedTarget && !customEvent.relatedTarget){ - if (type == "mouseout"){ - customEvent.toElement = relatedTarget; - } else if (type == "mouseover"){ - customEvent.fromElement = relatedTarget; - } - } - - //fire the event - target.dispatchEvent(customEvent); - - } else if (YAHOO.lang.isObject(document.createEventObject)){ //IE - - //create an IE event object - customEvent = document.createEventObject(); - - //assign available properties - customEvent.bubbles = bubbles; - customEvent.cancelable = cancelable; - customEvent.view = view; - customEvent.detail = detail; - customEvent.screenX = screenX; - customEvent.screenY = screenY; - customEvent.clientX = clientX; - customEvent.clientY = clientY; - customEvent.ctrlKey = ctrlKey; - customEvent.altKey = altKey; - customEvent.metaKey = metaKey; - customEvent.shiftKey = shiftKey; - - //fix button property for IE's wacky implementation - switch(button){ - case 0: - customEvent.button = 1; - break; - case 1: - customEvent.button = 4; - break; - case 2: - //leave as is - break; - default: - customEvent.button = 0; - } - - /* - * Have to use relatedTarget because IE won't allow assignment - * to toElement or fromElement on generic events. This keeps - * YAHOO.util.customEvent.getRelatedTarget() functional. - */ - customEvent.relatedTarget = relatedTarget; - - //fire the event - target.fireEvent("on" + type, customEvent); - - } else { - throw new Error("simulateMouseEvent(): No event simulation framework present."); - } - }, - - //-------------------------------------------------------------------------- - // Mouse events - //-------------------------------------------------------------------------- - - /** - * Simulates a mouse event on a particular element. - * @param {HTMLElement} target The element to click on. - * @param {String} type The type of event to fire. This can be any one of - * the following: click, dblclick, mousedown, mouseup, mouseout, - * mouseover, and mousemove. - * @param {Object} options Additional event options (use DOM standard names). - * @method mouseEvent - * @static - */ - fireMouseEvent : function (target /*:HTMLElement*/, type /*:String*/, - options /*:Object*/) /*:Void*/ - { - options = options || {}; - this.simulateMouseEvent(target, type, options.bubbles, - options.cancelable, options.view, options.detail, options.screenX, - options.screenY, options.clientX, options.clientY, options.ctrlKey, - options.altKey, options.shiftKey, options.metaKey, options.button, - options.relatedTarget); - }, - - /** - * Simulates a click on a particular element. - * @param {HTMLElement} target The element to click on. - * @param {Object} options Additional event options (use DOM standard names). - * @method click - * @static - */ - click : function (target /*:HTMLElement*/, options /*:Object*/) /*:Void*/ { - this.fireMouseEvent(target, "click", options); - }, - - /** - * Simulates a double click on a particular element. - * @param {HTMLElement} target The element to double click on. - * @param {Object} options Additional event options (use DOM standard names). - * @method dblclick - * @static - */ - dblclick : function (target /*:HTMLElement*/, options /*:Object*/) /*:Void*/ { - this.fireMouseEvent( target, "dblclick", options); - }, - - /** - * Simulates a mousedown on a particular element. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method mousedown - * @static - */ - mousedown : function (target /*:HTMLElement*/, options /*Object*/) /*:Void*/ { - this.fireMouseEvent(target, "mousedown", options); - }, - - /** - * Simulates a mousemove on a particular element. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method mousemove - * @static - */ - mousemove : function (target /*:HTMLElement*/, options /*Object*/) /*:Void*/ { - this.fireMouseEvent(target, "mousemove", options); - }, - - /** - * Simulates a mouseout event on a particular element. Use "relatedTarget" - * on the options object to specify where the mouse moved to. - * Quirks: Firefox less than 2.0 doesn't set relatedTarget properly, so - * toElement is assigned in its place. IE doesn't allow toElement to be - * be assigned, so relatedTarget is assigned in its place. Both of these - * concessions allow YAHOO.util.Event.getRelatedTarget() to work correctly - * in both browsers. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method mouseout - * @static - */ - mouseout : function (target /*:HTMLElement*/, options /*Object*/) /*:Void*/ { - this.fireMouseEvent(target, "mouseout", options); - }, - - /** - * Simulates a mouseover event on a particular element. Use "relatedTarget" - * on the options object to specify where the mouse moved from. - * Quirks: Firefox less than 2.0 doesn't set relatedTarget properly, so - * fromElement is assigned in its place. IE doesn't allow fromElement to be - * be assigned, so relatedTarget is assigned in its place. Both of these - * concessions allow YAHOO.util.Event.getRelatedTarget() to work correctly - * in both browsers. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method mouseover - * @static - */ - mouseover : function (target /*:HTMLElement*/, options /*Object*/) /*:Void*/ { - this.fireMouseEvent(target, "mouseover", options); - }, - - /** - * Simulates a mouseup on a particular element. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method mouseup - * @static - */ - mouseup : function (target /*:HTMLElement*/, options /*Object*/) /*:Void*/ { - this.fireMouseEvent(target, "mouseup", options); - }, - - //-------------------------------------------------------------------------- - // Key events - //-------------------------------------------------------------------------- - - /** - * Fires an event that normally would be fired by the keyboard (keyup, - * keydown, keypress). Make sure to specify either keyCode or charCode as - * an option. - * @private - * @param {String} type The type of event ("keyup", "keydown" or "keypress"). - * @param {HTMLElement} target The target of the event. - * @param {Object} options Options for the event. Either keyCode or charCode - * are required. - * @method fireKeyEvent - * @static - */ - fireKeyEvent : function (type /*:String*/, target /*:HTMLElement*/, - options /*:Object*/) /*:Void*/ - { - options = options || {}; - this.simulateKeyEvent(target, type, options.bubbles, - options.cancelable, options.view, options.ctrlKey, - options.altKey, options.shiftKey, options.metaKey, - options.keyCode, options.charCode); - }, - - /** - * Simulates a keydown event on a particular element. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method keydown - * @static - */ - keydown : function (target /*:HTMLElement*/, options /*:Object*/) /*:Void*/ { - this.fireKeyEvent("keydown", target, options); - }, - - /** - * Simulates a keypress on a particular element. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method keypress - * @static - */ - keypress : function (target /*:HTMLElement*/, options /*:Object*/) /*:Void*/ { - this.fireKeyEvent("keypress", target, options); - }, - - /** - * Simulates a keyup event on a particular element. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method keyup - * @static - */ - keyup : function (target /*:HTMLElement*/, options /*Object*/) /*:Void*/ { - this.fireKeyEvent("keyup", target, options); - } - - -}; - -YAHOO.namespace("tool"); - -//----------------------------------------------------------------------------- -// TestManager object -//----------------------------------------------------------------------------- - -/** - * Runs pages containing test suite definitions. - * @namespace YAHOO.tool - * @class TestManager - * @static - */ -YAHOO.tool.TestManager = { - - /** - * Constant for the testpagebegin custom event - * @property TEST_PAGE_BEGIN_EVENT - * @static - * @type string - * @final - */ - TEST_PAGE_BEGIN_EVENT /*:String*/ : "testpagebegin", - - /** - * Constant for the testpagecomplete custom event - * @property TEST_PAGE_COMPLETE_EVENT - * @static - * @type string - * @final - */ - TEST_PAGE_COMPLETE_EVENT /*:String*/ : "testpagecomplete", - - /** - * Constant for the testmanagerbegin custom event - * @property TEST_MANAGER_BEGIN_EVENT - * @static - * @type string - * @final - */ - TEST_MANAGER_BEGIN_EVENT /*:String*/ : "testmanagerbegin", - - /** - * Constant for the testmanagercomplete custom event - * @property TEST_MANAGER_COMPLETE_EVENT - * @static - * @type string - * @final - */ - TEST_MANAGER_COMPLETE_EVENT /*:String*/ : "testmanagercomplete", - - //------------------------------------------------------------------------- - // Private Properties - //------------------------------------------------------------------------- - - - /** - * The URL of the page currently being executed. - * @type String - * @private - * @property _curPage - * @static - */ - _curPage /*:String*/ : null, - - /** - * The frame used to load and run tests. - * @type Window - * @private - * @property _frame - * @static - */ - _frame /*:Window*/ : null, - - /** - * The logger used to output results from the various tests. - * @type YAHOO.tool.TestLogger - * @private - * @property _logger - * @static - */ - _logger : null, - - /** - * The timeout ID for the next iteration through the tests. - * @type int - * @private - * @property _timeoutId - * @static - */ - _timeoutId /*:int*/ : 0, - - /** - * Array of pages to load. - * @type String[] - * @private - * @property _pages - * @static - */ - _pages /*:String[]*/ : [], - - /** - * Aggregated results - * @type Object - * @private - * @property _results - * @static - */ - _results: null, - - //------------------------------------------------------------------------- - // Private Methods - //------------------------------------------------------------------------- - - /** - * Handles TestRunner.COMPLETE_EVENT, storing the results and beginning - * the loop again. - * @param {Object} data Data about the event. - * @return {Void} - * @private - * @static - */ - _handleTestRunnerComplete : function (data /*:Object*/) /*:Void*/ { - - this.fireEvent(this.TEST_PAGE_COMPLETE_EVENT, { - page: this._curPage, - results: data.results - }); - - //save results - //this._results[this.curPage] = data.results; - - //process 'em - this._processResults(this._curPage, data.results); - - this._logger.clearTestRunner(); - - //if there's more to do, set a timeout to begin again - if (this._pages.length){ - this._timeoutId = setTimeout(function(){ - YAHOO.tool.TestManager._run(); - }, 1000); - } else { - this.fireEvent(this.TEST_MANAGER_COMPLETE_EVENT, this._results); - } - }, - - /** - * Processes the results of a test page run, outputting log messages - * for failed tests. - * @return {Void} - * @private - * @static - */ - _processResults : function (page /*:String*/, results /*:Object*/) /*:Void*/ { - - var r = this._results; - - r.passed += results.passed; - r.failed += results.failed; - r.ignored += results.ignored; - r.total += results.total; - - if (results.failed){ - r.failedPages.push(page); - } else { - r.passedPages.push(page); - } - - results.name = page; - results.type = "page"; - - r[page] = results; - }, - - /** - * Loads the next test page into the iframe. - * @return {Void} - * @static - * @private - */ - _run : function () /*:Void*/ { - - //set the current page - this._curPage = this._pages.shift(); - - this.fireEvent(this.TEST_PAGE_BEGIN_EVENT, this._curPage); - - //load the frame - destroy history in case there are other iframes that - //need testing - this._frame.location.replace(this._curPage); - - }, - - //------------------------------------------------------------------------- - // Public Methods - //------------------------------------------------------------------------- - - /** - * Signals that a test page has been loaded. This should be called from - * within the test page itself to notify the TestManager that it is ready. - * @return {Void} - * @static - */ - load : function () /*:Void*/ { - if (parent.YAHOO.tool.TestManager !== this){ - parent.YAHOO.tool.TestManager.load(); - } else { - - if (this._frame) { - //assign event handling - var TestRunner = this._frame.YAHOO.tool.TestRunner; - - this._logger.setTestRunner(TestRunner); - TestRunner.subscribe(TestRunner.COMPLETE_EVENT, this._handleTestRunnerComplete, this, true); - - //run it - TestRunner.run(); - } - } - }, - - /** - * Sets the pages to be loaded. - * @param {String[]} pages An array of URLs to load. - * @return {Void} - * @static - */ - setPages : function (pages /*:String[]*/) /*:Void*/ { - this._pages = pages; - }, - - /** - * Begins the process of running the tests. - * @return {Void} - * @static - */ - start : function () /*:Void*/ { - - if (!this._initialized) { - - /** - * Fires when loading a test page - * @event testpagebegin - * @param curPage {string} the page being loaded - * @static - */ - this.createEvent(this.TEST_PAGE_BEGIN_EVENT); - - /** - * Fires when a test page is complete - * @event testpagecomplete - * @param obj {page: string, results: object} the name of the - * page that was loaded, and the test suite results - * @static - */ - this.createEvent(this.TEST_PAGE_COMPLETE_EVENT); - - /** - * Fires when the test manager starts running all test pages - * @event testmanagerbegin - * @static - */ - this.createEvent(this.TEST_MANAGER_BEGIN_EVENT); - - /** - * Fires when the test manager finishes running all test pages. External - * test runners should subscribe to this event in order to get the - * aggregated test results. - * @event testmanagercomplete - * @param obj { pages_passed: int, pages_failed: int, tests_passed: int - * tests_failed: int, passed: string[], failed: string[], - * page_results: {} } - * @static - */ - this.createEvent(this.TEST_MANAGER_COMPLETE_EVENT); - - //create iframe if not already available - if (!this._frame){ - var frame /*:HTMLElement*/ = document.createElement("iframe"); - frame.style.visibility = "hidden"; - frame.style.position = "absolute"; - document.body.appendChild(frame); - this._frame = frame.contentWindow || frame.contentDocument.ownerWindow; - } - - //create test logger if not already available - if (!this._logger){ - this._logger = new YAHOO.tool.TestLogger(); - } - - this._initialized = true; - } - - - // reset the results cache - this._results = { - - passed: 0, - failed: 0, - ignored: 0, - total: 0, - type: "report", - name: "YUI Test Results", - failedPages:[], - passedPages:[] - /* - // number of pages that pass - pages_passed: 0, - // number of pages that fail - pages_failed: 0, - // total number of tests passed - tests_passed: 0, - // total number of tests failed - tests_failed: 0, - // array of pages that passed - passed: [], - // array of pages that failed - failed: [], - // map of full results for each page - page_results: {}*/ - }; - - this.fireEvent(this.TEST_MANAGER_BEGIN_EVENT, null); - this._run(); - - }, - - /** - * Stops the execution of tests. - * @return {Void} - * @static - */ - stop : function () /*:Void*/ { - clearTimeout(this._timeoutId); - } - -}; - -YAHOO.lang.augmentObject(YAHOO.tool.TestManager, YAHOO.util.EventProvider.prototype); - - -YAHOO.namespace("tool"); - -//----------------------------------------------------------------------------- -// TestLogger object -//----------------------------------------------------------------------------- - -/** - * Displays test execution progress and results, providing filters based on - * different key events. - * @namespace YAHOO.tool - * @class TestLogger - * @constructor - * @param {HTMLElement} element (Optional) The element to create the logger in. - * @param {Object} config (Optional) Configuration options for the logger. - */ -YAHOO.tool.TestLogger = function (element, config) { - YAHOO.tool.TestLogger.superclass.constructor.call(this, element, config); - this.init(); -}; - -YAHOO.lang.extend(YAHOO.tool.TestLogger, YAHOO.widget.LogReader, { - - footerEnabled : true, - newestOnTop : false, - - /** - * Formats message string to HTML for output to console. - * @private - * @method formatMsg - * @param oLogMsg {Object} Log message object. - * @return {String} HTML-formatted message for output to console. - */ - formatMsg : function(message /*:Object*/) { - - var category /*:String*/ = message.category; - var text /*:String*/ = this.html2Text(message.msg); - - return "
" + category.toUpperCase() + " " + text + "
"; - - }, - - //------------------------------------------------------------------------- - // Private Methods - //------------------------------------------------------------------------- - - /* - * Initializes the logger. - * @private - */ - init : function () { - - //attach to any available TestRunner - if (YAHOO.tool.TestRunner){ - this.setTestRunner(YAHOO.tool.TestRunner); - } - - //hide useless sources - this.hideSource("global"); - this.hideSource("LogReader"); - - //hide useless message categories - this.hideCategory("warn"); - this.hideCategory("window"); - this.hideCategory("time"); - - //reset the logger - this.clearConsole(); - }, - - /** - * Clears the reference to the TestRunner from previous operations. This - * unsubscribes all events and removes the object reference. - * @return {Void} - * @static - */ - clearTestRunner : function () /*:Void*/ { - if (this._runner){ - this._runner.unsubscribeAll(); - this._runner = null; - } - }, - - /** - * Sets the source test runner that the logger should monitor. - * @param {YAHOO.tool.TestRunner} testRunner The TestRunner to observe. - * @return {Void} - * @static - */ - setTestRunner : function (testRunner /*:YAHOO.tool.TestRunner*/) /*:Void*/ { - - if (this._runner){ - this.clearTestRunner(); - } - - this._runner = testRunner; - - //setup event _handlers - testRunner.subscribe(testRunner.TEST_PASS_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.TEST_FAIL_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.TEST_IGNORE_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.BEGIN_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.COMPLETE_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.TEST_SUITE_BEGIN_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.TEST_SUITE_COMPLETE_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.TEST_CASE_BEGIN_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.TEST_CASE_COMPLETE_EVENT, this._handleTestRunnerEvent, this, true); - }, - - //------------------------------------------------------------------------- - // Event Handlers - //------------------------------------------------------------------------- - - /** - * Handles all TestRunner events, outputting appropriate data into the console. - * @param {Object} data The event data object. - * @return {Void} - * @private - */ - _handleTestRunnerEvent : function (data /*:Object*/) /*:Void*/ { - - //shortcut variables - var TestRunner /*:Object*/ = YAHOO.tool.TestRunner; - - //data variables - var message /*:String*/ = ""; - var messageType /*:String*/ = ""; - - switch(data.type){ - case TestRunner.BEGIN_EVENT: - message = "Testing began at " + (new Date()).toString() + "."; - messageType = "info"; - break; - - case TestRunner.COMPLETE_EVENT: - message = "Testing completed at " + (new Date()).toString() + ".\nPassed:" + - data.results.passed + " Failed:" + data.results.failed + " Total:" + data.results.total; - messageType = "info"; - break; - - case TestRunner.TEST_FAIL_EVENT: - message = data.testName + ": " + data.error.getMessage(); - messageType = "fail"; - break; - - case TestRunner.TEST_IGNORE_EVENT: - message = data.testName + ": ignored."; - messageType = "ignore"; - break; - - case TestRunner.TEST_PASS_EVENT: - message = data.testName + ": passed."; - messageType = "pass"; - break; - - case TestRunner.TEST_SUITE_BEGIN_EVENT: - message = "Test suite \"" + data.testSuite.name + "\" started."; - messageType = "info"; - break; - - case TestRunner.TEST_SUITE_COMPLETE_EVENT: - message = "Test suite \"" + data.testSuite.name + "\" completed.\nPassed:" + - data.results.passed + " Failed:" + data.results.failed + " Total:" + data.results.total; - messageType = "info"; - break; - - case TestRunner.TEST_CASE_BEGIN_EVENT: - message = "Test case \"" + data.testCase.name + "\" started."; - messageType = "info"; - break; - - case TestRunner.TEST_CASE_COMPLETE_EVENT: - message = "Test case \"" + data.testCase.name + "\" completed.\nPassed:" + - data.results.passed + " Failed:" + data.results.failed + " Total:" + data.results.total; - messageType = "info"; - break; - default: - message = "Unexpected event " + data.type; - message = "info"; - } - - YAHOO.log(message, messageType, "TestRunner"); - } - -}); - -YAHOO.namespace("tool.TestFormat"); - -/** - * Returns test results formatted as a JSON string. Requires JSON utility. - * @param {Object} result The results object created by TestRunner. - * @return {String} An XML-formatted string of results. - * @namespace YAHOO.tool.TestFormat - * @method JSON - * @static - */ -YAHOO.tool.TestFormat.JSON = function(results /*:Object*/) /*:String*/ { - return YAHOO.lang.JSON.stringify(results); -}; - -/** - * Returns test results formatted as an XML string. - * @param {Object} result The results object created by TestRunner. - * @return {String} An XML-formatted string of results. - * @namespace YAHOO.tool.TestFormat - * @method XML - * @static - */ -YAHOO.tool.TestFormat.XML = function(results /*:Object*/) /*:String*/ { - - var l = YAHOO.lang; - var xml /*:String*/ = "<" + results.type + " name=\"" + results.name.replace(/"/g, """).replace(/'/g, "'") + "\""; - - if (results.type == "test"){ - xml += " result=\"" + results.result + "\" message=\"" + results.message + "\">"; - } else { - xml += " passed=\"" + results.passed + "\" failed=\"" + results.failed + "\" ignored=\"" + results.ignored + "\" total=\"" + results.total + "\">"; - for (var prop in results) { - if (l.hasOwnProperty(results, prop) && l.isObject(results[prop]) && !l.isArray(results[prop])){ - xml += arguments.callee(results[prop]); - } - } - } - - xml += ""; - - return xml; - -}; - -YAHOO.namespace("tool"); - -/** - * An object capable of sending test results to a server. - * @param {String} url The URL to submit the results to. - * @param {Function} format (Optiona) A function that outputs the results in a specific format. - * Default is YAHOO.tool.TestFormat.XML. - * @constructor - * @namespace YAHOO.tool - * @class TestReporter - */ -YAHOO.tool.TestReporter = function(url /*:String*/, format /*:Function*/) { - - /** - * The URL to submit the data to. - * @type String - * @property url - */ - this.url /*:String*/ = url; - - /** - * The formatting function to call when submitting the data. - * @type Function - * @property format - */ - this.format /*:Function*/ = format || YAHOO.tool.TestFormat.XML; - - /** - * Extra fields to submit with the request. - * @type Object - * @property _fields - * @private - */ - this._fields /*:Object*/ = new Object(); - - /** - * The form element used to submit the results. - * @type HTMLFormElement - * @property _form - * @private - */ - this._form /*:HTMLElement*/ = null; - - /** - * Iframe used as a target for form submission. - * @type HTMLIFrameElement - * @property _iframe - * @private - */ - this._iframe /*:HTMLElement*/ = null; -}; - -YAHOO.tool.TestReporter.prototype = { - - //restore missing constructor - constructor: YAHOO.tool.TestReporter, - - /** - * Adds a field to the form that submits the results. - * @param {String} name The name of the field. - * @param {Variant} value The value of the field. - * @return {Void} - * @method addField - */ - addField : function (name /*:String*/, value /*:Variant*/) /*:Void*/{ - this._fields[name] = value; - }, - - /** - * Removes all previous defined fields. - * @return {Void} - * @method addField - */ - clearFields : function() /*:Void*/{ - this._fields = new Object(); - }, - - /** - * Cleans up the memory associated with the TestReporter, removing DOM elements - * that were created. - * @return {Void} - * @method destroy - */ - destroy : function() /*:Void*/ { - if (this._form){ - this._form.parentNode.removeChild(this._form); - this._form = null; - } - if (this._iframe){ - this._iframe.parentNode.removeChild(this._iframe); - this._iframe = null; - } - this._fields = null; - }, - - /** - * Sends the report to the server. - * @param {Object} results The results object created by TestRunner. - * @return {Void} - * @method report - */ - report : function(results /*:Object*/) /*:Void*/{ - - //if the form hasn't been created yet, create it - if (!this._form){ - this._form = document.createElement("form"); - this._form.method = "post"; - this._form.style.visibility = "hidden"; - this._form.style.position = "absolute"; - this._form.style.top = 0; - document.body.appendChild(this._form); - - //IE won't let you assign a name using the DOM, must do it the hacky way - if (YAHOO.env.ua.ie){ - this._iframe = document.createElement(""); - } else { - this._iframe = document.createElement("iframe"); - this._iframe.name = "yuiTestTarget"; - } - - this._iframe.src = "javascript:false"; - this._iframe.style.visibility = "hidden"; - this._iframe.style.position = "absolute"; - this._iframe.style.top = 0; - document.body.appendChild(this._iframe); - - this._form.target = "yuiTestTarget"; - } - - //set the form's action - this._form.action = this.url; - - //remove any existing fields - while(this._form.hasChildNodes()){ - this._form.removeChild(this._form.lastChild); - } - - //create default fields - this._fields.results = this.format(results); - this._fields.useragent = navigator.userAgent; - this._fields.timestamp = (new Date()).toLocaleString(); - - //add fields to the form - for (var prop in this._fields){ - if (YAHOO.lang.hasOwnProperty(this._fields, prop) && typeof this._fields[prop] != "function"){ - input = document.createElement("input"); - input.type = "hidden"; - input.name = prop; - input.value = this._fields[prop]; - this._form.appendChild(input); - } - } - - //remove default fields - delete this._fields.results; - delete this._fields.useragent; - delete this._fields.timestamp; - - if (arguments[1] !== false){ - this._form.submit(); - } - - } - -}; - -YAHOO.register("yuitest", YAHOO.tool.TestRunner, {version: "2.5.0", build: "895"}); diff --git a/lib/yui/yuitest/yuitest-beta-min.js b/lib/yui/yuitest/yuitest-beta-min.js deleted file mode 100755 index c916cc7106..0000000000 --- a/lib/yui/yuitest/yuitest-beta-min.js +++ /dev/null @@ -1,11 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -YAHOO.namespace("tool");YAHOO.tool.TestCase=function(A){this._should={};for(var B in A){this[B]=A[B];}if(!YAHOO.lang.isString(this.name)){this.name=YAHOO.util.Dom.generateId(null,"testCase");}};YAHOO.tool.TestCase.prototype={resume:function(A){YAHOO.tool.TestRunner.resume(A);},wait:function(B,A){throw new YAHOO.tool.TestCase.Wait(B,A);},setUp:function(){},tearDown:function(){}};YAHOO.tool.TestCase.Wait=function(B,A){this.segment=(YAHOO.lang.isFunction(B)?B:null);this.delay=(YAHOO.lang.isNumber(A)?A:0);};YAHOO.namespace("tool");YAHOO.tool.TestSuite=function(A){this.name="";this.items=[];if(YAHOO.lang.isString(A)){this.name=A;}else{if(YAHOO.lang.isObject(A)){YAHOO.lang.augmentObject(this,A,true);}}if(this.name===""){this.name=YAHOO.util.Dom.generateId(null,"testSuite");}};YAHOO.tool.TestSuite.prototype={add:function(A){if(A instanceof YAHOO.tool.TestSuite||A instanceof YAHOO.tool.TestCase){this.items.push(A);}},setUp:function(){},tearDown:function(){}};YAHOO.namespace("tool");YAHOO.tool.TestRunner=(function(){function B(C){this.testObject=C;this.firstChild=null;this.lastChild=null;this.parent=null;this.next=null;this.results={passed:0,failed:0,total:0,ignored:0};if(C instanceof YAHOO.tool.TestSuite){this.results.type="testsuite";this.results.name=C.name;}else{if(C instanceof YAHOO.tool.TestCase){this.results.type="testcase";this.results.name=C.name;}}}B.prototype={appendChild:function(C){var D=new B(C);if(this.firstChild===null){this.firstChild=this.lastChild=D;}else{this.lastChild.next=D;this.lastChild=D;}D.parent=this;return D;}};function A(){A.superclass.constructor.apply(this,arguments);this.masterSuite=new YAHOO.tool.TestSuite("YUI Test Results");this._cur=null;this._root=null;var D=[this.TEST_CASE_BEGIN_EVENT,this.TEST_CASE_COMPLETE_EVENT,this.TEST_SUITE_BEGIN_EVENT,this.TEST_SUITE_COMPLETE_EVENT,this.TEST_PASS_EVENT,this.TEST_FAIL_EVENT,this.TEST_IGNORE_EVENT,this.COMPLETE_EVENT,this.BEGIN_EVENT];for(var C=0;C<D.length;C++){this.createEvent(D[C],{scope:this});}}YAHOO.lang.extend(A,YAHOO.util.EventProvider,{TEST_CASE_BEGIN_EVENT:"testcasebegin",TEST_CASE_COMPLETE_EVENT:"testcasecomplete",TEST_SUITE_BEGIN_EVENT:"testsuitebegin",TEST_SUITE_COMPLETE_EVENT:"testsuitecomplete",TEST_PASS_EVENT:"pass",TEST_FAIL_EVENT:"fail",TEST_IGNORE_EVENT:"ignore",COMPLETE_EVENT:"complete",BEGIN_EVENT:"begin",_addTestCaseToTestTree:function(C,D){var E=C.appendChild(D);for(var F in D){if(F.indexOf("test")===0&&YAHOO.lang.isFunction(D[F])){E.appendChild(F);}}},_addTestSuiteToTestTree:function(C,F){var E=C.appendChild(F);for(var D=0;D<F.items.length;D++){if(F.items[D] instanceof YAHOO.tool.TestSuite){this._addTestSuiteToTestTree(E,F.items[D]);}else{if(F.items[D] instanceof YAHOO.tool.TestCase){this._addTestCaseToTestTree(E,F.items[D]);}}}},_buildTestTree:function(){this._root=new B(this.masterSuite);this._cur=this._root;for(var C=0;C<this.masterSuite.items.length;C++){if(this.masterSuite.items[C] instanceof YAHOO.tool.TestSuite){this._addTestSuiteToTestTree(this._root,this.masterSuite.items[C]);}else{if(this.masterSuite.items[C] instanceof YAHOO.tool.TestCase){this._addTestCaseToTestTree(this._root,this.masterSuite.items[C]);}}}},_handleTestObjectComplete:function(C){if(YAHOO.lang.isObject(C.testObject)){C.parent.results.passed+=C.results.passed;C.parent.results.failed+=C.results.failed;C.parent.results.total+=C.results.total;C.parent.results.ignored+=C.results.ignored;C.parent.results[C.testObject.name]=C.results;if(C.testObject instanceof YAHOO.tool.TestSuite){C.testObject.tearDown();this.fireEvent(this.TEST_SUITE_COMPLETE_EVENT,{testSuite:C.testObject,results:C.results});}else{if(C.testObject instanceof YAHOO.tool.TestCase){this.fireEvent(this.TEST_CASE_COMPLETE_EVENT,{testCase:C.testObject,results:C.results});}}}},_next:function(){if(this._cur.firstChild){this._cur=this._cur.firstChild;}else{if(this._cur.next){this._cur=this._cur.next;}else{while(this._cur&&!this._cur.next&&this._cur!==this._root){this._handleTestObjectComplete(this._cur);this._cur=this._cur.parent;}if(this._cur==this._root){this._cur.results.type="report";this._cur.results.timestamp=(new Date()).toLocaleString();this.fireEvent(this.COMPLETE_EVENT,{results:this._cur.results});this._cur=null;}else{this._handleTestObjectComplete(this._cur);this._cur=this._cur.next;}}}return this._cur;},_run:function(){var E=false;var D=this._next();if(D!==null){var C=D.testObject;if(YAHOO.lang.isObject(C)){if(C instanceof YAHOO.tool.TestSuite){this.fireEvent(this.TEST_SUITE_BEGIN_EVENT,{testSuite:C});C.setUp();}else{if(C instanceof YAHOO.tool.TestCase){this.fireEvent(this.TEST_CASE_BEGIN_EVENT,{testCase:C});}}if(typeof setTimeout!="undefined"){setTimeout(function(){YAHOO.tool.TestRunner._run();},0);}else{this._run();}}else{this._runTest(D);}}},_resumeTest:function(G){var C=this._cur;var H=C.testObject;var E=C.parent.testObject;var K=(E._should.fail||{})[H];var D=(E._should.error||{})[H];var F=false;var I=null;try{G.apply(E);if(K){I=new YAHOO.util.ShouldFail();F=true;}else{if(D){I=new YAHOO.util.ShouldError();F=true;}}}catch(J){if(J instanceof YAHOO.util.AssertionError){if(!K){I=J;F=true;}}else{if(J instanceof YAHOO.tool.TestCase.Wait){if(YAHOO.lang.isFunction(J.segment)){if(YAHOO.lang.isNumber(J.delay)){if(typeof setTimeout!="undefined"){setTimeout(function(){YAHOO.tool.TestRunner._resumeTest(J.segment);},J.delay);}else{throw new Error("Asynchronous tests not supported in this environment.");}}}return ;}else{if(!D){I=new YAHOO.util.UnexpectedError(J);F=true;}else{if(YAHOO.lang.isString(D)){if(J.message!=D){I=new YAHOO.util.UnexpectedError(J);F=true;}}else{if(YAHOO.lang.isFunction(D)){if(!(J instanceof D)){I=new YAHOO.util.UnexpectedError(J);F=true;}}else{if(YAHOO.lang.isObject(D)){if(!(J instanceof D.constructor)||J.message!=D.message){I=new YAHOO.util.UnexpectedError(J);F=true;}}}}}}}}if(F){this.fireEvent(this.TEST_FAIL_EVENT,{testCase:E,testName:H,error:I});}else{this.fireEvent(this.TEST_PASS_EVENT,{testCase:E,testName:H});}E.tearDown();C.parent.results[H]={result:F?"fail":"pass",message:I?I.getMessage():"Test passed",type:"test",name:H}; -if(F){C.parent.results.failed++;}else{C.parent.results.passed++;}C.parent.results.total++;if(typeof setTimeout!="undefined"){setTimeout(function(){YAHOO.tool.TestRunner._run();},0);}else{this._run();}},_runTest:function(F){var C=F.testObject;var D=F.parent.testObject;var G=D[C];var E=(D._should.ignore||{})[C];if(E){F.parent.results[C]={result:"ignore",message:"Test ignored",type:"test",name:C};F.parent.results.ignored++;F.parent.results.total++;this.fireEvent(this.TEST_IGNORE_EVENT,{testCase:D,testName:C});if(typeof setTimeout!="undefined"){setTimeout(function(){YAHOO.tool.TestRunner._run();},0);}else{this._run();}}else{D.setUp();this._resumeTest(G);}},fireEvent:function(C,D){D=D||{};D.type=C;A.superclass.fireEvent.call(this,C,D);},add:function(C){this.masterSuite.add(C);},clear:function(){this.masterSuite.items=[];},resume:function(C){this._resumeTest(C||function(){});},run:function(C){var D=YAHOO.tool.TestRunner;D._buildTestTree();D.fireEvent(D.BEGIN_EVENT);D._run();}});return new A();})();YAHOO.namespace("util");YAHOO.util.Assert={fail:function(A){throw new YAHOO.util.AssertionError(A||"Test force-failed.");},areEqual:function(B,C,A){if(B!=C){throw new YAHOO.util.ComparisonFailure(A||"Values should be equal.",B,C);}},areNotEqual:function(A,C,B){if(A==C){throw new YAHOO.util.UnexpectedValue(B||"Values should not be equal.",A);}},areNotSame:function(A,C,B){if(A===C){throw new YAHOO.util.UnexpectedValue(B||"Values should not be the same.",A);}},areSame:function(B,C,A){if(B!==C){throw new YAHOO.util.ComparisonFailure(A||"Values should be the same.",B,C);}},isFalse:function(B,A){if(false!==B){throw new YAHOO.util.ComparisonFailure(A||"Value should be false.",false,B);}},isTrue:function(B,A){if(true!==B){throw new YAHOO.util.ComparisonFailure(A||"Value should be true.",true,B);}},isNaN:function(B,A){if(!isNaN(B)){throw new YAHOO.util.ComparisonFailure(A||"Value should be NaN.",NaN,B);}},isNotNaN:function(B,A){if(isNaN(B)){throw new YAHOO.util.UnexpectedValue(A||"Values should not be NaN.",NaN);}},isNotNull:function(B,A){if(YAHOO.lang.isNull(B)){throw new YAHOO.util.UnexpectedValue(A||"Values should not be null.",null);}},isNotUndefined:function(B,A){if(YAHOO.lang.isUndefined(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should not be undefined.",undefined);}},isNull:function(B,A){if(!YAHOO.lang.isNull(B)){throw new YAHOO.util.ComparisonFailure(A||"Value should be null.",null,B);}},isUndefined:function(B,A){if(!YAHOO.lang.isUndefined(B)){throw new YAHOO.util.ComparisonFailure(A||"Value should be undefined.",undefined,B);}},isArray:function(B,A){if(!YAHOO.lang.isArray(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should be an array.",B);}},isBoolean:function(B,A){if(!YAHOO.lang.isBoolean(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should be a Boolean.",B);}},isFunction:function(B,A){if(!YAHOO.lang.isFunction(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should be a function.",B);}},isInstanceOf:function(B,C,A){if(!(C instanceof B)){throw new YAHOO.util.ComparisonFailure(A||"Value isn't an instance of expected type.",B,C);}},isNumber:function(B,A){if(!YAHOO.lang.isNumber(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should be a number.",B);}},isObject:function(B,A){if(!YAHOO.lang.isObject(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should be an object.",B);}},isString:function(B,A){if(!YAHOO.lang.isString(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should be a string.",B);}},isTypeOf:function(A,C,B){if(typeof C!=A){throw new YAHOO.util.ComparisonFailure(B||"Value should be of type "+expected+".",expected,typeof actual);}}};YAHOO.util.AssertionError=function(A){arguments.callee.superclass.constructor.call(this,A);this.message=A;this.name="AssertionError";};YAHOO.lang.extend(YAHOO.util.AssertionError,Error,{getMessage:function(){return this.message;},toString:function(){return this.name+": "+this.getMessage();},valueOf:function(){return this.toString();}});YAHOO.util.ComparisonFailure=function(B,A,C){arguments.callee.superclass.constructor.call(this,B);this.expected=A;this.actual=C;this.name="ComparisonFailure";};YAHOO.lang.extend(YAHOO.util.ComparisonFailure,YAHOO.util.AssertionError,{getMessage:function(){return this.message+"\nExpected: "+this.expected+" ("+(typeof this.expected)+")\nActual:"+this.actual+" ("+(typeof this.actual)+")";}});YAHOO.util.UnexpectedValue=function(B,A){arguments.callee.superclass.constructor.call(this,B);this.unexpected=A;this.name="UnexpectedValue";};YAHOO.lang.extend(YAHOO.util.UnexpectedValue,YAHOO.util.AssertionError,{getMessage:function(){return this.message+"\nUnexpected: "+this.unexpected+" ("+(typeof this.unexpected)+") ";}});YAHOO.util.ShouldFail=function(A){arguments.callee.superclass.constructor.call(this,A||"This test should fail but didn't.");this.name="ShouldFail";};YAHOO.lang.extend(YAHOO.util.ShouldFail,YAHOO.util.AssertionError);YAHOO.util.ShouldError=function(A){arguments.callee.superclass.constructor.call(this,A||"This test should have thrown an error but didn't.");this.name="ShouldError";};YAHOO.lang.extend(YAHOO.util.ShouldError,YAHOO.util.AssertionError);YAHOO.util.UnexpectedError=function(A){arguments.callee.superclass.constructor.call(this,"Unexpected error: "+A.message);this.cause=A;this.name="UnexpectedError";};YAHOO.lang.extend(YAHOO.util.UnexpectedError,YAHOO.util.AssertionError);YAHOO.util.ArrayAssert={contains:function(E,D,B){var C=false;for(var A=0;A<D.length&&!C;A++){if(D[A]===E){C=true;}}if(!C){YAHOO.util.Assert.fail(B||"Value ("+E+") not found in array.");}},containsItems:function(C,D,B){for(var A=0;A<C.length;A++){this.contains(C[A],D,B);}if(!found){YAHOO.util.Assert.fail(B||"Value not found in array.");}},containsMatch:function(E,D,B){if(typeof E!="function"){throw new TypeError("ArrayAssert.containsMatch(): First argument must be a function.");}var C=false;for(var A=0;A<D.length&&!C;A++){if(E(D[A])){C=true;}}if(!C){YAHOO.util.Assert.fail(B||"No match found in array.");}},doesNotContain:function(E,D,B){var C=false; -for(var A=0;A<D.length&&!C;A++){if(D[A]===E){C=true;}}if(C){YAHOO.util.Assert.fail(B||"Value found in array.");}},doesNotContainItems:function(C,D,B){for(var A=0;A<C.length;A++){this.doesNotContain(C[A],D,B);}},doesNotContainMatch:function(E,D,B){if(typeof E!="function"){throw new TypeError("ArrayAssert.doesNotContainMatch(): First argument must be a function.");}var C=false;for(var A=0;A<D.length&&!C;A++){if(E(D[A])){C=true;}}if(C){YAHOO.util.Assert.fail(B||"Value found in array.");}},indexOf:function(E,D,A,C){for(var B=0;B<D.length;B++){if(D[B]===E){YAHOO.util.Assert.areEqual(A,B,C||"Value exists at index "+B+" but should be at index "+A+".");return ;}}YAHOO.util.Assert.fail(C||"Value doesn't exist in array.");},itemsAreEqual:function(D,E,C){var A=Math.max(D.length,E.length);for(var B=0;B<A;B++){YAHOO.util.Assert.areEqual(D[B],E[B],C||"Values in position "+B+" are not equal.");}},itemsAreEquivalent:function(E,F,B,D){if(typeof B!="function"){throw new TypeError("ArrayAssert.itemsAreEquivalent(): Third argument must be a function.");}var A=Math.max(E.length,F.length);for(var C=0;C<A;C++){if(!B(E[C],F[C])){throw new YAHOO.util.ComparisonFailure(D||"Values in position "+C+" are not equivalent.",E[C],F[C]);}}},isEmpty:function(B,A){if(B.length>0){YAHOO.util.Assert.fail(A||"Array should be empty.");}},isNotEmpty:function(B,A){if(B.length===0){YAHOO.util.Assert.fail(A||"Array should not be empty.");}},itemsAreSame:function(D,E,C){var A=Math.max(D.length,E.length);for(var B=0;B<A;B++){YAHOO.util.Assert.areSame(D[B],E[B],C||"Values in position "+B+" are not the same.");}},lastIndexOf:function(E,D,A,C){for(var B=D.length;B>=0;B--){if(D[B]===E){YAHOO.util.Assert.areEqual(A,B,C||"Value exists at index "+B+" but should be at index "+A+".");return ;}}YAHOO.util.Assert.fail(C||"Value doesn't exist in array.");}};YAHOO.namespace("util");YAHOO.util.ObjectAssert={propertiesAreEqual:function(D,F,C){var B=[];for(var E in D){B.push(E);}for(var A=0;A<B.length;A++){YAHOO.util.Assert.isNotUndefined(F[B[A]],C||"Property'"+B[A]+"' expected.");}},hasProperty:function(A,B,C){if(YAHOO.lang.isUndefined(B[A])){YAHOO.util.Assert.fail(C||"Property "+A+" not found on object.");}},hasOwnProperty:function(A,B,C){if(!YAHOO.lang.hasOwnProperty(B,A)){YAHOO.util.Assert.fail(C||"Property "+A+" not found on object instance.");}}};YAHOO.util.DateAssert={datesAreEqual:function(B,C,A){if(B instanceof Date&&C instanceof Date){YAHOO.util.Assert.areEqual(B.getFullYear(),C.getFullYear(),A||"Years should be equal.");YAHOO.util.Assert.areEqual(B.getMonth(),C.getMonth(),A||"Months should be equal.");YAHOO.util.Assert.areEqual(B.getDate(),C.getDate(),A||"Day of month should be equal.");}else{throw new TypeError("DateAssert.datesAreEqual(): Expected and actual values must be Date objects.");}},timesAreEqual:function(B,C,A){if(B instanceof Date&&C instanceof Date){YAHOO.util.Assert.areEqual(B.getHours(),C.getHours(),A||"Hours should be equal.");YAHOO.util.Assert.areEqual(B.getMinutes(),C.getMinutes(),A||"Minutes should be equal.");YAHOO.util.Assert.areEqual(B.getSeconds(),C.getSeconds(),A||"Seconds should be equal.");}else{throw new TypeError("DateAssert.timesAreEqual(): Expected and actual values must be Date objects.");}}};YAHOO.namespace("util");YAHOO.util.UserAction={simulateKeyEvent:function(F,J,E,C,L,B,A,K,H,N,M){F=YAHOO.util.Dom.get(F);if(!F){throw new Error("simulateKeyEvent(): Invalid target.");}if(YAHOO.lang.isString(J)){J=J.toLowerCase();switch(J){case"keyup":case"keydown":case"keypress":break;case"textevent":J="keypress";break;default:throw new Error("simulateKeyEvent(): Event type '"+J+"' not supported.");}}else{throw new Error("simulateKeyEvent(): Event type must be a string.");}if(!YAHOO.lang.isBoolean(E)){E=true;}if(!YAHOO.lang.isBoolean(C)){C=true;}if(!YAHOO.lang.isObject(L)){L=window;}if(!YAHOO.lang.isBoolean(B)){B=false;}if(!YAHOO.lang.isBoolean(A)){A=false;}if(!YAHOO.lang.isBoolean(K)){K=false;}if(!YAHOO.lang.isBoolean(H)){H=false;}if(!YAHOO.lang.isNumber(N)){N=0;}if(!YAHOO.lang.isNumber(M)){M=0;}var I=null;if(YAHOO.lang.isFunction(document.createEvent)){try{I=document.createEvent("KeyEvents");I.initKeyEvent(J,E,C,L,B,A,K,H,N,M);}catch(G){try{I=document.createEvent("Events");}catch(D){I=document.createEvent("UIEvents");}finally{I.initEvent(J,E,C);I.view=L;I.altKey=A;I.ctrlKey=B;I.shiftKey=K;I.metaKey=H;I.keyCode=N;I.charCode=M;}}F.dispatchEvent(I);}else{if(YAHOO.lang.isObject(document.createEventObject)){I=document.createEventObject();I.bubbles=E;I.cancelable=C;I.view=L;I.ctrlKey=B;I.altKey=A;I.shiftKey=K;I.metaKey=H;I.keyCode=(M>0)?M:N;F.fireEvent("on"+J,I);}else{throw new Error("simulateKeyEvent(): No event simulation framework present.");}}},simulateMouseEvent:function(K,P,H,E,Q,J,G,F,D,B,C,A,O,M,I,L){K=YAHOO.util.Dom.get(K);if(!K){throw new Error("simulateMouseEvent(): Invalid target.");}if(YAHOO.lang.isString(P)){P=P.toLowerCase();switch(P){case"mouseover":case"mouseout":case"mousedown":case"mouseup":case"click":case"dblclick":case"mousemove":break;default:throw new Error("simulateMouseEvent(): Event type '"+P+"' not supported.");}}else{throw new Error("simulateMouseEvent(): Event type must be a string.");}if(!YAHOO.lang.isBoolean(H)){H=true;}if(!YAHOO.lang.isBoolean(E)){E=(P!="mousemove");}if(!YAHOO.lang.isObject(Q)){Q=window;}if(!YAHOO.lang.isNumber(J)){J=1;}if(!YAHOO.lang.isNumber(G)){G=0;}if(!YAHOO.lang.isNumber(F)){F=0;}if(!YAHOO.lang.isNumber(D)){D=0;}if(!YAHOO.lang.isNumber(B)){B=0;}if(!YAHOO.lang.isBoolean(C)){C=false;}if(!YAHOO.lang.isBoolean(A)){A=false;}if(!YAHOO.lang.isBoolean(O)){O=false;}if(!YAHOO.lang.isBoolean(M)){M=false;}if(!YAHOO.lang.isNumber(I)){I=0;}var N=null;if(YAHOO.lang.isFunction(document.createEvent)){N=document.createEvent("MouseEvents");if(N.initMouseEvent){N.initMouseEvent(P,H,E,Q,J,G,F,D,B,C,A,O,M,I,L);}else{N=document.createEvent("UIEvents");N.initEvent(P,H,E);N.view=Q;N.detail=J;N.screenX=G;N.screenY=F;N.clientX=D;N.clientY=B;N.ctrlKey=C;N.altKey=A;N.metaKey=M;N.shiftKey=O;N.button=I; -N.relatedTarget=L;}if(L&&!N.relatedTarget){if(P=="mouseout"){N.toElement=L;}else{if(P=="mouseover"){N.fromElement=L;}}}K.dispatchEvent(N);}else{if(YAHOO.lang.isObject(document.createEventObject)){N=document.createEventObject();N.bubbles=H;N.cancelable=E;N.view=Q;N.detail=J;N.screenX=G;N.screenY=F;N.clientX=D;N.clientY=B;N.ctrlKey=C;N.altKey=A;N.metaKey=M;N.shiftKey=O;switch(I){case 0:N.button=1;break;case 1:N.button=4;break;case 2:break;default:N.button=0;}N.relatedTarget=L;K.fireEvent("on"+P,N);}else{throw new Error("simulateMouseEvent(): No event simulation framework present.");}}},fireMouseEvent:function(C,B,A){A=A||{};this.simulateMouseEvent(C,B,A.bubbles,A.cancelable,A.view,A.detail,A.screenX,A.screenY,A.clientX,A.clientY,A.ctrlKey,A.altKey,A.shiftKey,A.metaKey,A.button,A.relatedTarget);},click:function(B,A){this.fireMouseEvent(B,"click",A);},dblclick:function(B,A){this.fireMouseEvent(B,"dblclick",A);},mousedown:function(B,A){this.fireMouseEvent(B,"mousedown",A);},mousemove:function(B,A){this.fireMouseEvent(B,"mousemove",A);},mouseout:function(B,A){this.fireMouseEvent(B,"mouseout",A);},mouseover:function(B,A){this.fireMouseEvent(B,"mouseover",A);},mouseup:function(B,A){this.fireMouseEvent(B,"mouseup",A);},fireKeyEvent:function(B,C,A){A=A||{};this.simulateKeyEvent(C,B,A.bubbles,A.cancelable,A.view,A.ctrlKey,A.altKey,A.shiftKey,A.metaKey,A.keyCode,A.charCode);},keydown:function(B,A){this.fireKeyEvent("keydown",B,A);},keypress:function(B,A){this.fireKeyEvent("keypress",B,A);},keyup:function(B,A){this.fireKeyEvent("keyup",B,A);}};YAHOO.namespace("tool");YAHOO.tool.TestManager={TEST_PAGE_BEGIN_EVENT:"testpagebegin",TEST_PAGE_COMPLETE_EVENT:"testpagecomplete",TEST_MANAGER_BEGIN_EVENT:"testmanagerbegin",TEST_MANAGER_COMPLETE_EVENT:"testmanagercomplete",_curPage:null,_frame:null,_logger:null,_timeoutId:0,_pages:[],_results:null,_handleTestRunnerComplete:function(A){this.fireEvent(this.TEST_PAGE_COMPLETE_EVENT,{page:this._curPage,results:A.results});this._processResults(this._curPage,A.results);this._logger.clearTestRunner();if(this._pages.length){this._timeoutId=setTimeout(function(){YAHOO.tool.TestManager._run();},1000);}else{this.fireEvent(this.TEST_MANAGER_COMPLETE_EVENT,this._results);}},_processResults:function(C,A){var B=this._results;B.passed+=A.passed;B.failed+=A.failed;B.ignored+=A.ignored;B.total+=A.total;if(A.failed){B.failedPages.push(C);}else{B.passedPages.push(C);}A.name=C;A.type="page";B[C]=A;},_run:function(){this._curPage=this._pages.shift();this.fireEvent(this.TEST_PAGE_BEGIN_EVENT,this._curPage);this._frame.location.replace(this._curPage);},load:function(){if(parent.YAHOO.tool.TestManager!==this){parent.YAHOO.tool.TestManager.load();}else{if(this._frame){var A=this._frame.YAHOO.tool.TestRunner;this._logger.setTestRunner(A);A.subscribe(A.COMPLETE_EVENT,this._handleTestRunnerComplete,this,true);A.run();}}},setPages:function(A){this._pages=A;},start:function(){if(!this._initialized){this.createEvent(this.TEST_PAGE_BEGIN_EVENT);this.createEvent(this.TEST_PAGE_COMPLETE_EVENT);this.createEvent(this.TEST_MANAGER_BEGIN_EVENT);this.createEvent(this.TEST_MANAGER_COMPLETE_EVENT);if(!this._frame){var A=document.createElement("iframe");A.style.visibility="hidden";A.style.position="absolute";document.body.appendChild(A);this._frame=A.contentWindow||A.contentDocument.ownerWindow;}if(!this._logger){this._logger=new YAHOO.tool.TestLogger();}this._initialized=true;}this._results={passed:0,failed:0,ignored:0,total:0,type:"report",name:"YUI Test Results",failedPages:[],passedPages:[]};this.fireEvent(this.TEST_MANAGER_BEGIN_EVENT,null);this._run();},stop:function(){clearTimeout(this._timeoutId);}};YAHOO.lang.augmentObject(YAHOO.tool.TestManager,YAHOO.util.EventProvider.prototype);YAHOO.namespace("tool");YAHOO.tool.TestLogger=function(B,A){YAHOO.tool.TestLogger.superclass.constructor.call(this,B,A);this.init();};YAHOO.lang.extend(YAHOO.tool.TestLogger,YAHOO.widget.LogReader,{footerEnabled:true,newestOnTop:false,formatMsg:function(B){var A=B.category;var C=this.html2Text(B.msg);return"<pre><p><span class=\""+A+"\">"+A.toUpperCase()+"</span> "+C+"</p></pre>";},init:function(){if(YAHOO.tool.TestRunner){this.setTestRunner(YAHOO.tool.TestRunner);}this.hideSource("global");this.hideSource("LogReader");this.hideCategory("warn");this.hideCategory("window");this.hideCategory("time");this.clearConsole();},clearTestRunner:function(){if(this._runner){this._runner.unsubscribeAll();this._runner=null;}},setTestRunner:function(A){if(this._runner){this.clearTestRunner();}this._runner=A;A.subscribe(A.TEST_PASS_EVENT,this._handleTestRunnerEvent,this,true);A.subscribe(A.TEST_FAIL_EVENT,this._handleTestRunnerEvent,this,true);A.subscribe(A.TEST_IGNORE_EVENT,this._handleTestRunnerEvent,this,true);A.subscribe(A.BEGIN_EVENT,this._handleTestRunnerEvent,this,true);A.subscribe(A.COMPLETE_EVENT,this._handleTestRunnerEvent,this,true);A.subscribe(A.TEST_SUITE_BEGIN_EVENT,this._handleTestRunnerEvent,this,true);A.subscribe(A.TEST_SUITE_COMPLETE_EVENT,this._handleTestRunnerEvent,this,true);A.subscribe(A.TEST_CASE_BEGIN_EVENT,this._handleTestRunnerEvent,this,true);A.subscribe(A.TEST_CASE_COMPLETE_EVENT,this._handleTestRunnerEvent,this,true);},_handleTestRunnerEvent:function(D){var A=YAHOO.tool.TestRunner;var C="";var B="";switch(D.type){case A.BEGIN_EVENT:C="Testing began at "+(new Date()).toString()+".";B="info";break;case A.COMPLETE_EVENT:C="Testing completed at "+(new Date()).toString()+".\nPassed:"+D.results.passed+" Failed:"+D.results.failed+" Total:"+D.results.total;B="info";break;case A.TEST_FAIL_EVENT:C=D.testName+": "+D.error.getMessage();B="fail";break;case A.TEST_IGNORE_EVENT:C=D.testName+": ignored.";B="ignore";break;case A.TEST_PASS_EVENT:C=D.testName+": passed.";B="pass";break;case A.TEST_SUITE_BEGIN_EVENT:C="Test suite \""+D.testSuite.name+"\" started.";B="info";break;case A.TEST_SUITE_COMPLETE_EVENT:C="Test suite \""+D.testSuite.name+"\" completed.\nPassed:"+D.results.passed+" Failed:"+D.results.failed+" Total:"+D.results.total; -B="info";break;case A.TEST_CASE_BEGIN_EVENT:C="Test case \""+D.testCase.name+"\" started.";B="info";break;case A.TEST_CASE_COMPLETE_EVENT:C="Test case \""+D.testCase.name+"\" completed.\nPassed:"+D.results.passed+" Failed:"+D.results.failed+" Total:"+D.results.total;B="info";break;default:C="Unexpected event "+D.type;C="info";}YAHOO.log(C,B,"TestRunner");}});YAHOO.namespace("tool.TestFormat");YAHOO.tool.TestFormat.JSON=function(A){return YAHOO.lang.JSON.stringify(A);};YAHOO.tool.TestFormat.XML=function(C){var A=YAHOO.lang;var B="<"+C.type+" name=\""+C.name.replace(/"/g,""").replace(/'/g,"'")+"\"";if(C.type=="test"){B+=" result=\""+C.result+"\" message=\""+C.message+"\">";}else{B+=" passed=\""+C.passed+"\" failed=\""+C.failed+"\" ignored=\""+C.ignored+"\" total=\""+C.total+"\">";for(var D in C){if(A.hasOwnProperty(C,D)&&A.isObject(C[D])&&!A.isArray(C[D])){B+=arguments.callee(C[D]);}}}B+="</"+C.type+">";return B;};YAHOO.namespace("tool");YAHOO.tool.TestReporter=function(A,B){this.url=A;this.format=B||YAHOO.tool.TestFormat.XML;this._fields=new Object();this._form=null;this._iframe=null;};YAHOO.tool.TestReporter.prototype={constructor:YAHOO.tool.TestReporter,addField:function(A,B){this._fields[A]=B;},clearFields:function(){this._fields=new Object();},destroy:function(){if(this._form){this._form.parentNode.removeChild(this._form);this._form=null;}if(this._iframe){this._iframe.parentNode.removeChild(this._iframe);this._iframe=null;}this._fields=null;},report:function(A){if(!this._form){this._form=document.createElement("form");this._form.method="post";this._form.style.visibility="hidden";this._form.style.position="absolute";this._form.style.top=0;document.body.appendChild(this._form);if(YAHOO.env.ua.ie){this._iframe=document.createElement("<iframe name=\"yuiTestTarget\" />");}else{this._iframe=document.createElement("iframe");this._iframe.name="yuiTestTarget";}this._iframe.src="javascript:false";this._iframe.style.visibility="hidden";this._iframe.style.position="absolute";this._iframe.style.top=0;document.body.appendChild(this._iframe);this._form.target="yuiTestTarget";}this._form.action=this.url;while(this._form.hasChildNodes()){this._form.removeChild(this._form.lastChild);}this._fields.results=this.format(A);this._fields.useragent=navigator.userAgent;this._fields.timestamp=(new Date()).toLocaleString();for(var B in this._fields){if(YAHOO.lang.hasOwnProperty(this._fields,B)&&typeof this._fields[B]!="function"){input=document.createElement("input");input.type="hidden";input.name=B;input.value=this._fields[B];this._form.appendChild(input);}}delete this._fields.results;delete this._fields.useragent;delete this._fields.timestamp;if(arguments[1]!==false){this._form.submit();}}};YAHOO.register("yuitest",YAHOO.tool.TestRunner,{version:"2.5.0",build:"895"}); \ No newline at end of file diff --git a/lib/yui/yuitest/yuitest-beta.js b/lib/yui/yuitest/yuitest-beta.js deleted file mode 100755 index ad114842e9..0000000000 --- a/lib/yui/yuitest/yuitest-beta.js +++ /dev/null @@ -1,3268 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -YAHOO.namespace("tool"); - -//----------------------------------------------------------------------------- -// TestCase object -//----------------------------------------------------------------------------- - -/** - * Test case containing various tests to run. - * @param template An object containing any number of test methods, other methods, - * an optional name, and anything else the test case needs. - * @class TestCase - * @namespace YAHOO.tool - * @constructor - */ -YAHOO.tool.TestCase = function (template /*:Object*/) { - - /** - * Special rules for the test case. Possible subobjects - * are fail, for tests that should fail, and error, for - * tests that should throw an error. - */ - this._should /*:Object*/ = {}; - - //copy over all properties from the template to this object - for (var prop in template) { - this[prop] = template[prop]; - } - - //check for a valid name - if (!YAHOO.lang.isString(this.name)){ - /** - * Name for the test case. - */ - this.name /*:String*/ = YAHOO.util.Dom.generateId(null, "testCase"); - } - -}; - - -YAHOO.tool.TestCase.prototype = { - - /** - * Resumes a paused test and runs the given function. - * @param {Function} segment (Optional) The function to run. - * If omitted, the test automatically passes. - * @return {Void} - * @method resume - */ - resume : function (segment /*:Function*/) /*:Void*/ { - YAHOO.tool.TestRunner.resume(segment); - }, - - /** - * Causes the test case to wait a specified amount of time and then - * continue executing the given code. - * @param {Function} segment (Optional) The function to run after the delay. - * If omitted, the TestRunner will wait until resume() is called. - * @param {int} delay (Optional) The number of milliseconds to wait before running - * the function. If omitted, defaults to zero. - * @return {Void} - * @method wait - */ - wait : function (segment /*:Function*/, delay /*:int*/) /*:Void*/{ - throw new YAHOO.tool.TestCase.Wait(segment, delay); - }, - - //------------------------------------------------------------------------- - // Stub Methods - //------------------------------------------------------------------------- - - /** - * Function to run before each test is executed. - * @return {Void} - * @method setUp - */ - setUp : function () /*:Void*/ { - }, - - /** - * Function to run after each test is executed. - * @return {Void} - * @method tearDown - */ - tearDown: function () /*:Void*/ { - } -}; - -/** - * Represents a stoppage in test execution to wait for an amount of time before - * continuing. - * @param {Function} segment A function to run when the wait is over. - * @param {int} delay The number of milliseconds to wait before running the code. - * @class Wait - * @namespace YAHOO.tool.TestCase - * @constructor - * - */ -YAHOO.tool.TestCase.Wait = function (segment /*:Function*/, delay /*:int*/) { - - /** - * The segment of code to run when the wait is over. - * @type Function - * @property segment - */ - this.segment /*:Function*/ = (YAHOO.lang.isFunction(segment) ? segment : null); - - /** - * The delay before running the segment of code. - * @type int - * @property delay - */ - this.delay /*:int*/ = (YAHOO.lang.isNumber(delay) ? delay : 0); - -}; - -YAHOO.namespace("tool"); - - -//----------------------------------------------------------------------------- -// TestSuite object -//----------------------------------------------------------------------------- - -/** - * A test suite that can contain a collection of TestCase and TestSuite objects. - * @param {String||Object} data The name of the test suite or an object containing - * a name property as well as setUp and tearDown methods. - * @namespace YAHOO.tool - * @class TestSuite - * @constructor - */ -YAHOO.tool.TestSuite = function (data /*:String||Object*/) { - - /** - * The name of the test suite. - * @type String - * @property name - */ - this.name /*:String*/ = ""; - - /** - * Array of test suites and - * @private - */ - this.items /*:Array*/ = []; - - //initialize the properties - if (YAHOO.lang.isString(data)){ - this.name = data; - } else if (YAHOO.lang.isObject(data)){ - YAHOO.lang.augmentObject(this, data, true); - } - - //double-check name - if (this.name === ""){ - this.name = YAHOO.util.Dom.generateId(null, "testSuite"); - } - -}; - -YAHOO.tool.TestSuite.prototype = { - - /** - * Adds a test suite or test case to the test suite. - * @param {YAHOO.tool.TestSuite||YAHOO.tool.TestCase} testObject The test suite or test case to add. - * @return {Void} - * @method add - */ - add : function (testObject /*:YAHOO.tool.TestSuite*/) /*:Void*/ { - if (testObject instanceof YAHOO.tool.TestSuite || testObject instanceof YAHOO.tool.TestCase) { - this.items.push(testObject); - } - }, - - //------------------------------------------------------------------------- - // Stub Methods - //------------------------------------------------------------------------- - - /** - * Function to run before each test is executed. - * @return {Void} - * @method setUp - */ - setUp : function () /*:Void*/ { - }, - - /** - * Function to run after each test is executed. - * @return {Void} - * @method tearDown - */ - tearDown: function () /*:Void*/ { - } - -}; - -YAHOO.namespace("tool"); - -/** - * The YUI test tool - * @module yuitest - * @namespace YAHOO.tool - * @requires yahoo,dom,event,logger - */ - - -//----------------------------------------------------------------------------- -// TestRunner object -//----------------------------------------------------------------------------- - -/** - * Runs test suites and test cases, providing events to allowing for the - * interpretation of test results. - * @namespace YAHOO.tool - * @class TestRunner - * @static - */ -YAHOO.tool.TestRunner = (function(){ - - /** - * A node in the test tree structure. May represent a TestSuite, TestCase, or - * test function. - * @param {Variant} testObject A TestSuite, TestCase, or the name of a test function. - * @class TestNode - * @constructor - * @private - */ - function TestNode(testObject /*:Variant*/){ - - /** - * The TestSuite, TestCase, or test function represented by this node. - * @type Variant - * @property testObject - */ - this.testObject = testObject; - - /** - * Pointer to this node's first child. - * @type TestNode - * @property firstChild - */ - this.firstChild /*:TestNode*/ = null; - - /** - * Pointer to this node's last child. - * @type TestNode - * @property lastChild - */ - this.lastChild = null; - - /** - * Pointer to this node's parent. - * @type TestNode - * @property parent - */ - this.parent = null; - - /** - * Pointer to this node's next sibling. - * @type TestNode - * @property next - */ - this.next = null; - - /** - * Test results for this test object. - * @type object - * @property results - */ - this.results /*:Object*/ = { - passed : 0, - failed : 0, - total : 0, - ignored : 0 - }; - - //initialize results - if (testObject instanceof YAHOO.tool.TestSuite){ - this.results.type = "testsuite"; - this.results.name = testObject.name; - } else if (testObject instanceof YAHOO.tool.TestCase){ - this.results.type = "testcase"; - this.results.name = testObject.name; - } - - } - - TestNode.prototype = { - - /** - * Appends a new test object (TestSuite, TestCase, or test function name) as a child - * of this node. - * @param {Variant} testObject A TestSuite, TestCase, or the name of a test function. - * @return {Void} - */ - appendChild : function (testObject /*:Variant*/) /*:Void*/{ - var node = new TestNode(testObject); - if (this.firstChild === null){ - this.firstChild = this.lastChild = node; - } else { - this.lastChild.next = node; - this.lastChild = node; - } - node.parent = this; - return node; - } - }; - - function TestRunner(){ - - //inherit from EventProvider - TestRunner.superclass.constructor.apply(this,arguments); - - /** - * Suite on which to attach all TestSuites and TestCases to be run. - * @type YAHOO.tool.TestSuite - * @property masterSuite - * @private - */ - this.masterSuite /*:YAHOO.tool.TestSuite*/ = new YAHOO.tool.TestSuite("YUI Test Results"); - - /** - * Pointer to the current node in the test tree. - * @type TestNode - * @private - * @property _cur - */ - this._cur = null; - - /** - * Pointer to the root node in the test tree. - * @type TestNode - * @private - * @property _root - */ - this._root = null; - - //create events - var events /*:Array*/ = [ - this.TEST_CASE_BEGIN_EVENT, - this.TEST_CASE_COMPLETE_EVENT, - this.TEST_SUITE_BEGIN_EVENT, - this.TEST_SUITE_COMPLETE_EVENT, - this.TEST_PASS_EVENT, - this.TEST_FAIL_EVENT, - this.TEST_IGNORE_EVENT, - this.COMPLETE_EVENT, - this.BEGIN_EVENT - ]; - for (var i=0; i < events.length; i++){ - this.createEvent(events[i], { scope: this }); - } - - } - - YAHOO.lang.extend(TestRunner, YAHOO.util.EventProvider, { - - //------------------------------------------------------------------------- - // Constants - //------------------------------------------------------------------------- - - /** - * Fires when a test case is opened but before the first - * test is executed. - * @event testcasebegin - */ - TEST_CASE_BEGIN_EVENT /*:String*/ : "testcasebegin", - - /** - * Fires when all tests in a test case have been executed. - * @event testcasecomplete - */ - TEST_CASE_COMPLETE_EVENT /*:String*/ : "testcasecomplete", - - /** - * Fires when a test suite is opened but before the first - * test is executed. - * @event testsuitebegin - */ - TEST_SUITE_BEGIN_EVENT /*:String*/ : "testsuitebegin", - - /** - * Fires when all test cases in a test suite have been - * completed. - * @event testsuitecomplete - */ - TEST_SUITE_COMPLETE_EVENT /*:String*/ : "testsuitecomplete", - - /** - * Fires when a test has passed. - * @event pass - */ - TEST_PASS_EVENT /*:String*/ : "pass", - - /** - * Fires when a test has failed. - * @event fail - */ - TEST_FAIL_EVENT /*:String*/ : "fail", - - /** - * Fires when a test has been ignored. - * @event ignore - */ - TEST_IGNORE_EVENT /*:String*/ : "ignore", - - /** - * Fires when all test suites and test cases have been completed. - * @event complete - */ - COMPLETE_EVENT /*:String*/ : "complete", - - /** - * Fires when the run() method is called. - * @event begin - */ - BEGIN_EVENT /*:String*/ : "begin", - - //------------------------------------------------------------------------- - // Test Tree-Related Methods - //------------------------------------------------------------------------- - - /** - * Adds a test case to the test tree as a child of the specified node. - * @param {TestNode} parentNode The node to add the test case to as a child. - * @param {YAHOO.tool.TestCase} testCase The test case to add. - * @return {Void} - * @static - * @private - * @method _addTestCaseToTestTree - */ - _addTestCaseToTestTree : function (parentNode /*:TestNode*/, testCase /*:YAHOO.tool.TestCase*/) /*:Void*/{ - - //add the test suite - var node = parentNode.appendChild(testCase); - - //iterate over the items in the test case - for (var prop in testCase){ - if (prop.indexOf("test") === 0 && YAHOO.lang.isFunction(testCase[prop])){ - node.appendChild(prop); - } - } - - }, - - /** - * Adds a test suite to the test tree as a child of the specified node. - * @param {TestNode} parentNode The node to add the test suite to as a child. - * @param {YAHOO.tool.TestSuite} testSuite The test suite to add. - * @return {Void} - * @static - * @private - * @method _addTestSuiteToTestTree - */ - _addTestSuiteToTestTree : function (parentNode /*:TestNode*/, testSuite /*:YAHOO.tool.TestSuite*/) /*:Void*/ { - - //add the test suite - var node = parentNode.appendChild(testSuite); - - //iterate over the items in the master suite - for (var i=0; i < testSuite.items.length; i++){ - if (testSuite.items[i] instanceof YAHOO.tool.TestSuite) { - this._addTestSuiteToTestTree(node, testSuite.items[i]); - } else if (testSuite.items[i] instanceof YAHOO.tool.TestCase) { - this._addTestCaseToTestTree(node, testSuite.items[i]); - } - } - }, - - /** - * Builds the test tree based on items in the master suite. The tree is a hierarchical - * representation of the test suites, test cases, and test functions. The resulting tree - * is stored in _root and the pointer _cur is set to the root initially. - * @return {Void} - * @static - * @private - * @method _buildTestTree - */ - _buildTestTree : function () /*:Void*/ { - - this._root = new TestNode(this.masterSuite); - this._cur = this._root; - - //iterate over the items in the master suite - for (var i=0; i < this.masterSuite.items.length; i++){ - if (this.masterSuite.items[i] instanceof YAHOO.tool.TestSuite) { - this._addTestSuiteToTestTree(this._root, this.masterSuite.items[i]); - } else if (this.masterSuite.items[i] instanceof YAHOO.tool.TestCase) { - this._addTestCaseToTestTree(this._root, this.masterSuite.items[i]); - } - } - - }, - - //------------------------------------------------------------------------- - // Private Methods - //------------------------------------------------------------------------- - - /** - * Handles the completion of a test object's tests. Tallies test results - * from one level up to the next. - * @param {TestNode} node The TestNode representing the test object. - * @return {Void} - * @method _handleTestObjectComplete - * @private - */ - _handleTestObjectComplete : function (node /*:TestNode*/) /*:Void*/ { - if (YAHOO.lang.isObject(node.testObject)){ - node.parent.results.passed += node.results.passed; - node.parent.results.failed += node.results.failed; - node.parent.results.total += node.results.total; - node.parent.results.ignored += node.results.ignored; - node.parent.results[node.testObject.name] = node.results; - - if (node.testObject instanceof YAHOO.tool.TestSuite){ - node.testObject.tearDown(); - this.fireEvent(this.TEST_SUITE_COMPLETE_EVENT, { testSuite: node.testObject, results: node.results}); - } else if (node.testObject instanceof YAHOO.tool.TestCase){ - this.fireEvent(this.TEST_CASE_COMPLETE_EVENT, { testCase: node.testObject, results: node.results}); - } - } - }, - - //------------------------------------------------------------------------- - // Navigation Methods - //------------------------------------------------------------------------- - - /** - * Retrieves the next node in the test tree. - * @return {TestNode} The next node in the test tree or null if the end is reached. - * @private - * @static - * @method _next - */ - _next : function () /*:TestNode*/ { - - if (this._cur.firstChild) { - this._cur = this._cur.firstChild; - } else if (this._cur.next) { - this._cur = this._cur.next; - } else { - while (this._cur && !this._cur.next && this._cur !== this._root){ - this._handleTestObjectComplete(this._cur); - this._cur = this._cur.parent; - } - - if (this._cur == this._root){ - this._cur.results.type = "report"; - this._cur.results.timestamp = (new Date()).toLocaleString(); - this.fireEvent(this.COMPLETE_EVENT, { results: this._cur.results}); - this._cur = null; - } else { - this._handleTestObjectComplete(this._cur); - this._cur = this._cur.next; - } - } - - return this._cur; - }, - - /** - * Runs a test case or test suite, returning the results. - * @param {YAHOO.tool.TestCase|YAHOO.tool.TestSuite} testObject The test case or test suite to run. - * @return {Object} Results of the execution with properties passed, failed, and total. - * @private - * @method _run - * @static - */ - _run : function () /*:Void*/ { - - //flag to indicate if the TestRunner should wait before continuing - var shouldWait /*:Boolean*/ = false; - - //get the next test node - var node = this._next(); - - if (node !== null) { - var testObject = node.testObject; - - //figure out what to do - if (YAHOO.lang.isObject(testObject)){ - if (testObject instanceof YAHOO.tool.TestSuite){ - this.fireEvent(this.TEST_SUITE_BEGIN_EVENT, { testSuite: testObject }); - testObject.setUp(); - } else if (testObject instanceof YAHOO.tool.TestCase){ - this.fireEvent(this.TEST_CASE_BEGIN_EVENT, { testCase: testObject }); - } - - //some environments don't support setTimeout - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._run(); - }, 0); - } else { - this._run(); - } - } else { - this._runTest(node); - } - - } - }, - - _resumeTest : function (segment /*:Function*/) /*:Void*/ { - - //get relevant information - var node /*:TestNode*/ = this._cur; - var testName /*:String*/ = node.testObject; - var testCase /*:YAHOO.tool.TestCase*/ = node.parent.testObject; - - //get the "should" test cases - var shouldFail /*:Object*/ = (testCase._should.fail || {})[testName]; - var shouldError /*:Object*/ = (testCase._should.error || {})[testName]; - - //variable to hold whether or not the test failed - var failed /*:Boolean*/ = false; - var error /*:Error*/ = null; - - //try the test - try { - - //run the test - segment.apply(testCase); - - //if it should fail, and it got here, then it's a fail because it didn't - if (shouldFail){ - error = new YAHOO.util.ShouldFail(); - failed = true; - } else if (shouldError){ - error = new YAHOO.util.ShouldError(); - failed = true; - } - - } catch (thrown /*:Error*/){ - if (thrown instanceof YAHOO.util.AssertionError) { - if (!shouldFail){ - error = thrown; - failed = true; - } - } else if (thrown instanceof YAHOO.tool.TestCase.Wait){ - - if (YAHOO.lang.isFunction(thrown.segment)){ - if (YAHOO.lang.isNumber(thrown.delay)){ - - //some environments don't support setTimeout - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._resumeTest(thrown.segment); - }, thrown.delay); - } else { - throw new Error("Asynchronous tests not supported in this environment."); - } - } - } - - return; - - } else { - //first check to see if it should error - if (!shouldError) { - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } else { - //check to see what type of data we have - if (YAHOO.lang.isString(shouldError)){ - - //if it's a string, check the error message - if (thrown.message != shouldError){ - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } - } else if (YAHOO.lang.isFunction(shouldError)){ - - //if it's a function, see if the error is an instance of it - if (!(thrown instanceof shouldError)){ - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } - - } else if (YAHOO.lang.isObject(shouldError)){ - - //if it's an object, check the instance and message - if (!(thrown instanceof shouldError.constructor) || - thrown.message != shouldError.message){ - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } - - } - - } - } - - } - - //fireEvent appropriate event - if (failed) { - this.fireEvent(this.TEST_FAIL_EVENT, { testCase: testCase, testName: testName, error: error }); - } else { - this.fireEvent(this.TEST_PASS_EVENT, { testCase: testCase, testName: testName }); - } - - //run the tear down - testCase.tearDown(); - - //update results - node.parent.results[testName] = { - result: failed ? "fail" : "pass", - message: error ? error.getMessage() : "Test passed", - type: "test", - name: testName - }; - - if (failed){ - node.parent.results.failed++; - } else { - node.parent.results.passed++; - } - node.parent.results.total++; - - //set timeout not supported in all environments - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._run(); - }, 0); - } else { - this._run(); - } - - }, - - /** - * Runs a single test based on the data provided in the node. - * @param {TestNode} node The TestNode representing the test to run. - * @return {Void} - * @static - * @private - * @name _runTest - */ - _runTest : function (node /*:TestNode*/) /*:Void*/ { - - //get relevant information - var testName /*:String*/ = node.testObject; - var testCase /*:YAHOO.tool.TestCase*/ = node.parent.testObject; - var test /*:Function*/ = testCase[testName]; - - //get the "should" test cases - var shouldIgnore /*:Object*/ = (testCase._should.ignore || {})[testName]; - - //figure out if the test should be ignored or not - if (shouldIgnore){ - - //update results - node.parent.results[testName] = { - result: "ignore", - message: "Test ignored", - type: "test", - name: testName - }; - - node.parent.results.ignored++; - node.parent.results.total++; - - this.fireEvent(this.TEST_IGNORE_EVENT, { testCase: testCase, testName: testName }); - - //some environments don't support setTimeout - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._run(); - }, 0); - } else { - this._run(); - } - - } else { - - //run the setup - testCase.setUp(); - - //now call the body of the test - this._resumeTest(test); - } - - }, - - //------------------------------------------------------------------------- - // Protected Methods - //------------------------------------------------------------------------- - - /* - * Fires events for the TestRunner. This overrides the default fireEvent() - * method from EventProvider to add the type property to the data that is - * passed through on each event call. - * @param {String} type The type of event to fire. - * @param {Object} data (Optional) Data for the event. - * @method fireEvent - * @static - * @protected - */ - fireEvent : function (type /*:String*/, data /*:Object*/) /*:Void*/ { - data = data || {}; - data.type = type; - TestRunner.superclass.fireEvent.call(this, type, data); - }, - - //------------------------------------------------------------------------- - // Public Methods - //------------------------------------------------------------------------- - - /** - * Adds a test suite or test case to the list of test objects to run. - * @param testObject Either a TestCase or a TestSuite that should be run. - * @return {Void} - * @method add - * @static - */ - add : function (testObject /*:Object*/) /*:Void*/ { - this.masterSuite.add(testObject); - }, - - /** - * Removes all test objects from the runner. - * @return {Void} - * @method clear - * @static - */ - clear : function () /*:Void*/ { - this.masterSuite.items = []; - }, - - /** - * Resumes the TestRunner after wait() was called. - * @param {Function} segment The function to run as the rest - * of the haulted test. - * @return {Void} - * @method resume - * @static - */ - resume : function (segment /*:Function*/) /*:Void*/ { - this._resumeTest(segment || function(){}); - }, - - /** - * Runs the test suite. - * @return {Void} - * @method run - * @static - */ - run : function (testObject /*:Object*/) /*:Void*/ { - - //pointer to runner to avoid scope issues - var runner = YAHOO.tool.TestRunner; - - //build the test tree - runner._buildTestTree(); - - //fire the begin event - runner.fireEvent(runner.BEGIN_EVENT); - - //begin the testing - runner._run(); - } - }); - - return new TestRunner(); - -})(); - -YAHOO.namespace("util"); - -//----------------------------------------------------------------------------- -// Assert object -//----------------------------------------------------------------------------- - -/** - * The Assert object provides functions to test JavaScript values against - * known and expected results. Whenever a comparison (assertion) fails, - * an error is thrown. - * - * @namespace YAHOO.util - * @class Assert - * @static - */ -YAHOO.util.Assert = { - - //------------------------------------------------------------------------- - // Generic Assertion Methods - //------------------------------------------------------------------------- - - /** - * Forces an assertion error to occur. - * @param {String} message (Optional) The message to display with the failure. - * @method fail - * @static - */ - fail : function (message /*:String*/) /*:Void*/ { - throw new YAHOO.util.AssertionError(message || "Test force-failed."); - }, - - //------------------------------------------------------------------------- - // Equality Assertion Methods - //------------------------------------------------------------------------- - - /** - * Asserts that a value is equal to another. This uses the double equals sign - * so type cohersion may occur. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areEqual - * @static - */ - areEqual : function (expected /*:Object*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (expected != actual) { - throw new YAHOO.util.ComparisonFailure(message || "Values should be equal.", expected, actual); - } - }, - - /** - * Asserts that a value is not equal to another. This uses the double equals sign - * so type cohersion may occur. - * @param {Object} unexpected The unexpected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areNotEqual - * @static - */ - areNotEqual : function (unexpected /*:Object*/, actual /*:Object*/, - message /*:String*/) /*:Void*/ { - if (unexpected == actual) { - throw new YAHOO.util.UnexpectedValue(message || "Values should not be equal.", unexpected); - } - }, - - /** - * Asserts that a value is not the same as another. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} unexpected The unexpected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areNotSame - * @static - */ - areNotSame : function (unexpected /*:Object*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (unexpected === actual) { - throw new YAHOO.util.UnexpectedValue(message || "Values should not be the same.", unexpected); - } - }, - - /** - * Asserts that a value is the same as another. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areSame - * @static - */ - areSame : function (expected /*:Object*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (expected !== actual) { - throw new YAHOO.util.ComparisonFailure(message || "Values should be the same.", expected, actual); - } - }, - - //------------------------------------------------------------------------- - // Boolean Assertion Methods - //------------------------------------------------------------------------- - - /** - * Asserts that a value is false. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isFalse - * @static - */ - isFalse : function (actual /*:Boolean*/, message /*:String*/) { - if (false !== actual) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be false.", false, actual); - } - }, - - /** - * Asserts that a value is true. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isTrue - * @static - */ - isTrue : function (actual /*:Boolean*/, message /*:String*/) /*:Void*/ { - if (true !== actual) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be true.", true, actual); - } - - }, - - //------------------------------------------------------------------------- - // Special Value Assertion Methods - //------------------------------------------------------------------------- - - /** - * Asserts that a value is not a number. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNaN - * @static - */ - isNaN : function (actual /*:Object*/, message /*:String*/) /*:Void*/{ - if (!isNaN(actual)){ - throw new YAHOO.util.ComparisonFailure(message || "Value should be NaN.", NaN, actual); - } - }, - - /** - * Asserts that a value is not the special NaN value. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotNaN - * @static - */ - isNotNaN : function (actual /*:Object*/, message /*:String*/) /*:Void*/{ - if (isNaN(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Values should not be NaN.", NaN); - } - }, - - /** - * Asserts that a value is not null. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotNull - * @static - */ - isNotNull : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (YAHOO.lang.isNull(actual)) { - throw new YAHOO.util.UnexpectedValue(message || "Values should not be null.", null); - } - }, - - /** - * Asserts that a value is not undefined. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotUndefined - * @static - */ - isNotUndefined : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (YAHOO.lang.isUndefined(actual)) { - throw new YAHOO.util.UnexpectedValue(message || "Value should not be undefined.", undefined); - } - }, - - /** - * Asserts that a value is null. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNull - * @static - */ - isNull : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isNull(actual)) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be null.", null, actual); - } - }, - - /** - * Asserts that a value is undefined. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isUndefined - * @static - */ - isUndefined : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isUndefined(actual)) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be undefined.", undefined, actual); - } - }, - - //-------------------------------------------------------------------------- - // Instance Assertion Methods - //-------------------------------------------------------------------------- - - /** - * Asserts that a value is an array. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isArray - * @static - */ - isArray : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isArray(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be an array.", actual); - } - }, - - /** - * Asserts that a value is a Boolean. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isBoolean - * @static - */ - isBoolean : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isBoolean(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a Boolean.", actual); - } - }, - - /** - * Asserts that a value is a function. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isFunction - * @static - */ - isFunction : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isFunction(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a function.", actual); - } - }, - - /** - * Asserts that a value is an instance of a particular object. This may return - * incorrect results when comparing objects from one frame to constructors in - * another frame. For best results, don't use in a cross-frame manner. - * @param {Function} expected The function that the object should be an instance of. - * @param {Object} actual The object to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isInstanceOf - * @static - */ - isInstanceOf : function (expected /*:Function*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!(actual instanceof expected)){ - throw new YAHOO.util.ComparisonFailure(message || "Value isn't an instance of expected type.", expected, actual); - } - }, - - /** - * Asserts that a value is a number. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNumber - * @static - */ - isNumber : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isNumber(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a number.", actual); - } - }, - - /** - * Asserts that a value is an object. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isObject - * @static - */ - isObject : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isObject(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be an object.", actual); - } - }, - - /** - * Asserts that a value is a string. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isString - * @static - */ - isString : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isString(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a string.", actual); - } - }, - - /** - * Asserts that a value is of a particular type. - * @param {String} expectedType The expected type of the variable. - * @param {Object} actualValue The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isTypeOf - * @static - */ - isTypeOf : function (expectedType /*:String*/, actualValue /*:Object*/, message /*:String*/) /*:Void*/{ - if (typeof actualValue != expectedType){ - throw new YAHOO.util.ComparisonFailure(message || "Value should be of type " + expected + ".", expected, typeof actual); - } - } -}; - -//----------------------------------------------------------------------------- -// Assertion errors -//----------------------------------------------------------------------------- - -/** - * AssertionError is thrown whenever an assertion fails. It provides methods - * to more easily get at error information and also provides a base class - * from which more specific assertion errors can be derived. - * - * @param {String} message The message to display when the error occurs. - * @namespace YAHOO.util - * @class AssertionError - * @extends Error - * @constructor - */ -YAHOO.util.AssertionError = function (message /*:String*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message); - - /* - * Error message. Must be duplicated to ensure browser receives it. - * @type String - * @property message - */ - this.message /*:String*/ = message; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "AssertionError"; -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.AssertionError, Error, { - - /** - * Returns a fully formatted error for an assertion failure. This should - * be overridden by all subclasses to provide specific information. - * @method getMessage - * @return {String} A string describing the error. - */ - getMessage : function () /*:String*/ { - return this.message; - }, - - /** - * Returns a string representation of the error. - * @method toString - * @return {String} A string representation of the error. - */ - toString : function () /*:String*/ { - return this.name + ": " + this.getMessage(); - }, - - /** - * Returns a primitive value version of the error. Same as toString(). - * @method valueOf - * @return {String} A primitive value version of the error. - */ - valueOf : function () /*:String*/ { - return this.toString(); - } - -}); - -/** - * ComparisonFailure is subclass of AssertionError that is thrown whenever - * a comparison between two values fails. It provides mechanisms to retrieve - * both the expected and actual value. - * - * @param {String} message The message to display when the error occurs. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value that caused the assertion to fail. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class ComparisonFailure - * @constructor - */ -YAHOO.util.ComparisonFailure = function (message /*:String*/, expected /*:Object*/, actual /*:Object*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message); - - /** - * The expected value. - * @type Object - * @property expected - */ - this.expected /*:Object*/ = expected; - - /** - * The actual value. - * @type Object - * @property actual - */ - this.actual /*:Object*/ = actual; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "ComparisonFailure"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.ComparisonFailure, YAHOO.util.AssertionError, { - - /** - * Returns a fully formatted error for an assertion failure. This message - * provides information about the expected and actual values. - * @method toString - * @return {String} A string describing the error. - */ - getMessage : function () /*:String*/ { - return this.message + "\nExpected: " + this.expected + " (" + (typeof this.expected) + ")" + - "\nActual:" + this.actual + " (" + (typeof this.actual) + ")"; - } - -}); - -/** - * UnexpectedValue is subclass of AssertionError that is thrown whenever - * a value was unexpected in its scope. This typically means that a test - * was performed to determine that a value was *not* equal to a certain - * value. - * - * @param {String} message The message to display when the error occurs. - * @param {Object} unexpected The unexpected value. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class UnexpectedValue - * @constructor - */ -YAHOO.util.UnexpectedValue = function (message /*:String*/, unexpected /*:Object*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message); - - /** - * The unexpected value. - * @type Object - * @property unexpected - */ - this.unexpected /*:Object*/ = unexpected; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "UnexpectedValue"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.UnexpectedValue, YAHOO.util.AssertionError, { - - /** - * Returns a fully formatted error for an assertion failure. The message - * contains information about the unexpected value that was encountered. - * @method getMessage - * @return {String} A string describing the error. - */ - getMessage : function () /*:String*/ { - return this.message + "\nUnexpected: " + this.unexpected + " (" + (typeof this.unexpected) + ") "; - } - -}); - -/** - * ShouldFail is subclass of AssertionError that is thrown whenever - * a test was expected to fail but did not. - * - * @param {String} message The message to display when the error occurs. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class ShouldFail - * @constructor - */ -YAHOO.util.ShouldFail = function (message /*:String*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message || "This test should fail but didn't."); - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "ShouldFail"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.ShouldFail, YAHOO.util.AssertionError); - -/** - * ShouldError is subclass of AssertionError that is thrown whenever - * a test is expected to throw an error but doesn't. - * - * @param {String} message The message to display when the error occurs. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class ShouldError - * @constructor - */ -YAHOO.util.ShouldError = function (message /*:String*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message || "This test should have thrown an error but didn't."); - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "ShouldError"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.ShouldError, YAHOO.util.AssertionError); - -/** - * UnexpectedError is subclass of AssertionError that is thrown whenever - * an error occurs within the course of a test and the test was not expected - * to throw an error. - * - * @param {Error} cause The unexpected error that caused this error to be - * thrown. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class UnexpectedError - * @constructor - */ -YAHOO.util.UnexpectedError = function (cause /*:Object*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, "Unexpected error: " + cause.message); - - /** - * The unexpected error that occurred. - * @type Error - * @property cause - */ - this.cause /*:Error*/ = cause; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "UnexpectedError"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.UnexpectedError, YAHOO.util.AssertionError); - -//----------------------------------------------------------------------------- -// ArrayAssert object -//----------------------------------------------------------------------------- - -/** - * The ArrayAssert object provides functions to test JavaScript array objects - * for a variety of cases. - * - * @namespace YAHOO.util - * @class ArrayAssert - * @static - */ - -YAHOO.util.ArrayAssert = { - - /** - * Asserts that a value is present in an array. This uses the triple equals - * sign so no type cohersion may occur. - * @param {Object} needle The value that is expected in the array. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method contains - * @static - */ - contains : function (needle /*:Object*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (haystack[i] === needle) { - found = true; - } - } - - if (!found){ - YAHOO.util.Assert.fail(message || "Value (" + needle + ") not found in array."); - } - }, - - /** - * Asserts that a set of values are present in an array. This uses the triple equals - * sign so no type cohersion may occur. For this assertion to pass, all values must - * be found. - * @param {Object[]} needles An array of values that are expected in the array. - * @param {Array} haystack An array of values to check. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method containsItems - * @static - */ - containsItems : function (needles /*:Object[]*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - //begin checking values - for (var i=0; i < needles.length; i++){ - this.contains(needles[i], haystack, message); - } - - if (!found){ - YAHOO.util.Assert.fail(message || "Value not found in array."); - } - }, - - /** - * Asserts that a value matching some condition is present in an array. This uses - * a function to determine a match. - * @param {Function} matcher A function that returns true if the items matches or false if not. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method containsMatch - * @static - */ - containsMatch : function (matcher /*:Function*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - //check for valid matcher - if (typeof matcher != "function"){ - throw new TypeError("ArrayAssert.containsMatch(): First argument must be a function."); - } - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (matcher(haystack[i])) { - found = true; - } - } - - if (!found){ - YAHOO.util.Assert.fail(message || "No match found in array."); - } - }, - - /** - * Asserts that a value is not present in an array. This uses the triple equals - * sign so no type cohersion may occur. - * @param {Object} needle The value that is expected in the array. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method doesNotContain - * @static - */ - doesNotContain : function (needle /*:Object*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (haystack[i] === needle) { - found = true; - } - } - - if (found){ - YAHOO.util.Assert.fail(message || "Value found in array."); - } - }, - - /** - * Asserts that a set of values are not present in an array. This uses the triple equals - * sign so no type cohersion may occur. For this assertion to pass, all values must - * not be found. - * @param {Object[]} needles An array of values that are not expected in the array. - * @param {Array} haystack An array of values to check. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method doesNotContainItems - * @static - */ - doesNotContainItems : function (needles /*:Object[]*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - for (var i=0; i < needles.length; i++){ - this.doesNotContain(needles[i], haystack, message); - } - - }, - - /** - * Asserts that no values matching a condition are present in an array. This uses - * a function to determine a match. - * @param {Function} matcher A function that returns true if the items matches or false if not. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method doesNotContainMatch - * @static - */ - doesNotContainMatch : function (matcher /*:Function*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - //check for valid matcher - if (typeof matcher != "function"){ - throw new TypeError("ArrayAssert.doesNotContainMatch(): First argument must be a function."); - } - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (matcher(haystack[i])) { - found = true; - } - } - - if (found){ - YAHOO.util.Assert.fail(message || "Value found in array."); - } - }, - - /** - * Asserts that the given value is contained in an array at the specified index. - * This uses the triple equals sign so no type cohersion will occur. - * @param {Object} needle The value to look for. - * @param {Array} haystack The array to search in. - * @param {int} index The index at which the value should exist. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method indexOf - * @static - */ - indexOf : function (needle /*:Object*/, haystack /*:Array*/, index /*:int*/, message /*:String*/) /*:Void*/ { - - //try to find the value in the array - for (var i=0; i < haystack.length; i++){ - if (haystack[i] === needle){ - YAHOO.util.Assert.areEqual(index, i, message || "Value exists at index " + i + " but should be at index " + index + "."); - return; - } - } - - //if it makes it here, it wasn't found at all - YAHOO.util.Assert.fail(message || "Value doesn't exist in array."); - }, - - /** - * Asserts that the values in an array are equal, and in the same position, - * as values in another array. This uses the double equals sign - * so type cohersion may occur. Note that the array objects themselves - * need not be the same for this test to pass. - * @param {Array} expected An array of the expected values. - * @param {Array} actual Any array of the actual values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method itemsAreEqual - * @static - */ - itemsAreEqual : function (expected /*:Array*/, actual /*:Array*/, - message /*:String*/) /*:Void*/ { - - //one may be longer than the other, so get the maximum length - var len /*:int*/ = Math.max(expected.length, actual.length); - - //begin checking values - for (var i=0; i < len; i++){ - YAHOO.util.Assert.areEqual(expected[i], actual[i], message || - "Values in position " + i + " are not equal."); - } - }, - - /** - * Asserts that the values in an array are equivalent, and in the same position, - * as values in another array. This uses a function to determine if the values - * are equivalent. Note that the array objects themselves - * need not be the same for this test to pass. - * @param {Array} expected An array of the expected values. - * @param {Array} actual Any array of the actual values. - * @param {Function} comparator A function that returns true if the values are equivalent - * or false if not. - * @param {String} message (Optional) The message to display if the assertion fails. - * @return {Void} - * @method itemsAreEquivalent - * @static - */ - itemsAreEquivalent : function (expected /*:Array*/, actual /*:Array*/, - comparator /*:Function*/, message /*:String*/) /*:Void*/ { - - //make sure the comparator is valid - if (typeof comparator != "function"){ - throw new TypeError("ArrayAssert.itemsAreEquivalent(): Third argument must be a function."); - } - - //one may be longer than the other, so get the maximum length - var len /*:int*/ = Math.max(expected.length, actual.length); - - //begin checking values - for (var i=0; i < len; i++){ - if (!comparator(expected[i], actual[i])){ - throw new YAHOO.util.ComparisonFailure(message || "Values in position " + i + " are not equivalent.", expected[i], actual[i]); - } - } - }, - - /** - * Asserts that an array is empty. - * @param {Array} actual The array to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isEmpty - * @static - */ - isEmpty : function (actual /*:Array*/, message /*:String*/) /*:Void*/ { - if (actual.length > 0){ - YAHOO.util.Assert.fail(message || "Array should be empty."); - } - }, - - /** - * Asserts that an array is not empty. - * @param {Array} actual The array to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotEmpty - * @static - */ - isNotEmpty : function (actual /*:Array*/, message /*:String*/) /*:Void*/ { - if (actual.length === 0){ - YAHOO.util.Assert.fail(message || "Array should not be empty."); - } - }, - - /** - * Asserts that the values in an array are the same, and in the same position, - * as values in another array. This uses the triple equals sign - * so no type cohersion will occur. Note that the array objects themselves - * need not be the same for this test to pass. - * @param {Array} expected An array of the expected values. - * @param {Array} actual Any array of the actual values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method itemsAreSame - * @static - */ - itemsAreSame : function (expected /*:Array*/, actual /*:Array*/, - message /*:String*/) /*:Void*/ { - - //one may be longer than the other, so get the maximum length - var len /*:int*/ = Math.max(expected.length, actual.length); - - //begin checking values - for (var i=0; i < len; i++){ - YAHOO.util.Assert.areSame(expected[i], actual[i], - message || "Values in position " + i + " are not the same."); - } - }, - - /** - * Asserts that the given value is contained in an array at the specified index, - * starting from the back of the array. - * This uses the triple equals sign so no type cohersion will occur. - * @param {Object} needle The value to look for. - * @param {Array} haystack The array to search in. - * @param {int} index The index at which the value should exist. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method lastIndexOf - * @static - */ - lastIndexOf : function (needle /*:Object*/, haystack /*:Array*/, index /*:int*/, message /*:String*/) /*:Void*/ { - - //try to find the value in the array - for (var i=haystack.length; i >= 0; i--){ - if (haystack[i] === needle){ - YAHOO.util.Assert.areEqual(index, i, message || "Value exists at index " + i + " but should be at index " + index + "."); - return; - } - } - - //if it makes it here, it wasn't found at all - YAHOO.util.Assert.fail(message || "Value doesn't exist in array."); - } - -}; - -YAHOO.namespace("util"); - - -//----------------------------------------------------------------------------- -// ObjectAssert object -//----------------------------------------------------------------------------- - -/** - * The ObjectAssert object provides functions to test JavaScript objects - * for a variety of cases. - * - * @namespace YAHOO.util - * @class ObjectAssert - * @static - */ -YAHOO.util.ObjectAssert = { - - /** - * Asserts that all properties in the object exist in another object. - * @param {Object} expected An object with the expected properties. - * @param {Object} actual An object with the actual properties. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method propertiesAreEqual - * @static - */ - propertiesAreEqual : function (expected /*:Object*/, actual /*:Object*/, - message /*:String*/) /*:Void*/ { - - //get all properties in the object - var properties /*:Array*/ = []; - for (var property in expected){ - properties.push(property); - } - - //see if the properties are in the expected object - for (var i=0; i < properties.length; i++){ - YAHOO.util.Assert.isNotUndefined(actual[properties[i]], message || - "Property'" + properties[i] + "' expected."); - } - - }, - - /** - * Asserts that an object has a property with the given name. - * @param {String} propertyName The name of the property to test. - * @param {Object} object The object to search. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method hasProperty - * @static - */ - hasProperty : function (propertyName /*:String*/, object /*:Object*/, message /*:String*/) /*:Void*/ { - if (YAHOO.lang.isUndefined(object[propertyName])){ - YAHOO.util.Assert.fail(message || - "Property " + propertyName + " not found on object."); - } - }, - - /** - * Asserts that a property with the given name exists on an object instance (not on its prototype). - * @param {String} propertyName The name of the property to test. - * @param {Object} object The object to search. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method hasProperty - * @static - */ - hasOwnProperty : function (propertyName /*:String*/, object /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.hasOwnProperty(object, propertyName)){ - YAHOO.util.Assert.fail(message || - "Property " + propertyName + " not found on object instance."); - } - } -}; - -//----------------------------------------------------------------------------- -// DateAssert object -//----------------------------------------------------------------------------- - -/** - * The DateAssert object provides functions to test JavaScript Date objects - * for a variety of cases. - * - * @namespace YAHOO.util - * @class DateAssert - * @static - */ - -YAHOO.util.DateAssert = { - - /** - * Asserts that a date's month, day, and year are equal to another date's. - * @param {Date} expected The expected date. - * @param {Date} actual The actual date to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areEqual - * @static - */ - datesAreEqual : function (expected /*:Date*/, actual /*:Date*/, message /*:String*/){ - if (expected instanceof Date && actual instanceof Date){ - YAHOO.util.Assert.areEqual(expected.getFullYear(), actual.getFullYear(), message || "Years should be equal."); - YAHOO.util.Assert.areEqual(expected.getMonth(), actual.getMonth(), message || "Months should be equal."); - YAHOO.util.Assert.areEqual(expected.getDate(), actual.getDate(), message || "Day of month should be equal."); - } else { - throw new TypeError("DateAssert.datesAreEqual(): Expected and actual values must be Date objects."); - } - }, - - /** - * Asserts that a date's hour, minutes, and seconds are equal to another date's. - * @param {Date} expected The expected date. - * @param {Date} actual The actual date to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areEqual - * @static - */ - timesAreEqual : function (expected /*:Date*/, actual /*:Date*/, message /*:String*/){ - if (expected instanceof Date && actual instanceof Date){ - YAHOO.util.Assert.areEqual(expected.getHours(), actual.getHours(), message || "Hours should be equal."); - YAHOO.util.Assert.areEqual(expected.getMinutes(), actual.getMinutes(), message || "Minutes should be equal."); - YAHOO.util.Assert.areEqual(expected.getSeconds(), actual.getSeconds(), message || "Seconds should be equal."); - } else { - throw new TypeError("DateAssert.timesAreEqual(): Expected and actual values must be Date objects."); - } - } - -}; - -YAHOO.namespace("util"); - -/** - * The UserAction object provides functions that simulate events occurring in - * the browser. Since these are simulated events, they do not behave exactly - * as regular, user-initiated events do, but can be used to test simple - * user interactions safely. - * - * @namespace YAHOO.util - * @class UserAction - * @static - */ -YAHOO.util.UserAction = { - - //-------------------------------------------------------------------------- - // Generic event methods - //-------------------------------------------------------------------------- - - /** - * Simulates a key event using the given event information to populate - * the generated event object. This method does browser-equalizing - * calculations to account for differences in the DOM and IE event models - * as well as different browser quirks. Note: keydown causes Safari 2.x to - * crash. - * @method simulateKeyEvent - * @private - * @static - * @param {HTMLElement} target The target of the given event. - * @param {String} type The type of event to fire. This can be any one of - * the following: keyup, keydown, and keypress. - * @param {Boolean} bubbles (Optional) Indicates if the event can be - * bubbled up. DOM Level 3 specifies that all key events bubble by - * default. The default is true. - * @param {Boolean} cancelable (Optional) Indicates if the event can be - * canceled using preventDefault(). DOM Level 3 specifies that all - * key events can be cancelled. The default - * is true. - * @param {Window} view (Optional) The view containing the target. This is - * typically the window object. The default is window. - * @param {Boolean} ctrlKey (Optional) Indicates if one of the CTRL keys - * is pressed while the event is firing. The default is false. - * @param {Boolean} altKey (Optional) Indicates if one of the ALT keys - * is pressed while the event is firing. The default is false. - * @param {Boolean} shiftKey (Optional) Indicates if one of the SHIFT keys - * is pressed while the event is firing. The default is false. - * @param {Boolean} metaKey (Optional) Indicates if one of the META keys - * is pressed while the event is firing. The default is false. - * @param {int} keyCode (Optional) The code for the key that is in use. - * The default is 0. - * @param {int} charCode (Optional) The Unicode code for the character - * associated with the key being used. The default is 0. - */ - simulateKeyEvent : function (target /*:HTMLElement*/, type /*:String*/, - bubbles /*:Boolean*/, cancelable /*:Boolean*/, - view /*:Window*/, - ctrlKey /*:Boolean*/, altKey /*:Boolean*/, - shiftKey /*:Boolean*/, metaKey /*:Boolean*/, - keyCode /*:int*/, charCode /*:int*/) /*:Void*/ - { - //check target - target = YAHOO.util.Dom.get(target); - if (!target){ - throw new Error("simulateKeyEvent(): Invalid target."); - } - - //check event type - if (YAHOO.lang.isString(type)){ - type = type.toLowerCase(); - switch(type){ - case "keyup": - case "keydown": - case "keypress": - break; - case "textevent": //DOM Level 3 - type = "keypress"; - break; - // @TODO was the fallthrough intentional, if so throw error - default: - throw new Error("simulateKeyEvent(): Event type '" + type + "' not supported."); - } - } else { - throw new Error("simulateKeyEvent(): Event type must be a string."); - } - - //setup default values - if (!YAHOO.lang.isBoolean(bubbles)){ - bubbles = true; //all key events bubble - } - if (!YAHOO.lang.isBoolean(cancelable)){ - cancelable = true; //all key events can be cancelled - } - if (!YAHOO.lang.isObject(view)){ - view = window; //view is typically window - } - if (!YAHOO.lang.isBoolean(ctrlKey)){ - ctrlKey = false; - } - if (!YAHOO.lang.isBoolean(altKey)){ - altKey = false; - } - if (!YAHOO.lang.isBoolean(shiftKey)){ - shiftKey = false; - } - if (!YAHOO.lang.isBoolean(metaKey)){ - metaKey = false; - } - if (!YAHOO.lang.isNumber(keyCode)){ - keyCode = 0; - } - if (!YAHOO.lang.isNumber(charCode)){ - charCode = 0; - } - - //try to create a mouse event - var customEvent /*:MouseEvent*/ = null; - - //check for DOM-compliant browsers first - if (YAHOO.lang.isFunction(document.createEvent)){ - - try { - - //try to create key event - customEvent = document.createEvent("KeyEvents"); - - /* - * Interesting problem: Firefox implemented a non-standard - * version of initKeyEvent() based on DOM Level 2 specs. - * Key event was removed from DOM Level 2 and re-introduced - * in DOM Level 3 with a different interface. Firefox is the - * only browser with any implementation of Key Events, so for - * now, assume it's Firefox if the above line doesn't error. - */ - //TODO: Decipher between Firefox's implementation and a correct one. - customEvent.initKeyEvent(type, bubbles, cancelable, view, ctrlKey, - altKey, shiftKey, metaKey, keyCode, charCode); - - } catch (ex /*:Error*/){ - - /* - * If it got here, that means key events aren't officially supported. - * Safari/WebKit is a real problem now. WebKit 522 won't let you - * set keyCode, charCode, or other properties if you use a - * UIEvent, so we first must try to create a generic event. The - * fun part is that this will throw an error on Safari 2.x. The - * end result is that we need another try...catch statement just to - * deal with this mess. - */ - try { - - //try to create generic event - will fail in Safari 2.x - customEvent = document.createEvent("Events"); - - } catch (uierror /*:Error*/){ - - //the above failed, so create a UIEvent for Safari 2.x - customEvent = document.createEvent("UIEvents"); - - } finally { - - customEvent.initEvent(type, bubbles, cancelable); - - //initialize - customEvent.view = view; - customEvent.altKey = altKey; - customEvent.ctrlKey = ctrlKey; - customEvent.shiftKey = shiftKey; - customEvent.metaKey = metaKey; - customEvent.keyCode = keyCode; - customEvent.charCode = charCode; - - } - - } - - //fire the event - target.dispatchEvent(customEvent); - - } else if (YAHOO.lang.isObject(document.createEventObject)){ //IE - - //create an IE event object - customEvent = document.createEventObject(); - - //assign available properties - customEvent.bubbles = bubbles; - customEvent.cancelable = cancelable; - customEvent.view = view; - customEvent.ctrlKey = ctrlKey; - customEvent.altKey = altKey; - customEvent.shiftKey = shiftKey; - customEvent.metaKey = metaKey; - - /* - * IE doesn't support charCode explicitly. CharCode should - * take precedence over any keyCode value for accurate - * representation. - */ - customEvent.keyCode = (charCode > 0) ? charCode : keyCode; - - //fire the event - target.fireEvent("on" + type, customEvent); - - } else { - throw new Error("simulateKeyEvent(): No event simulation framework present."); - } - }, - - /** - * Simulates a mouse event using the given event information to populate - * the generated event object. This method does browser-equalizing - * calculations to account for differences in the DOM and IE event models - * as well as different browser quirks. - * @method simulateMouseEvent - * @private - * @static - * @param {HTMLElement} target The target of the given event. - * @param {String} type The type of event to fire. This can be any one of - * the following: click, dblclick, mousedown, mouseup, mouseout, - * mouseover, and mousemove. - * @param {Boolean} bubbles (Optional) Indicates if the event can be - * bubbled up. DOM Level 2 specifies that all mouse events bubble by - * default. The default is true. - * @param {Boolean} cancelable (Optional) Indicates if the event can be - * canceled using preventDefault(). DOM Level 2 specifies that all - * mouse events except mousemove can be cancelled. The default - * is true for all events except mousemove, for which the default - * is false. - * @param {Window} view (Optional) The view containing the target. This is - * typically the window object. The default is window. - * @param {int} detail (Optional) The number of times the mouse button has - * been used. The default value is 1. - * @param {int} screenX (Optional) The x-coordinate on the screen at which - * point the event occured. The default is 0. - * @param {int} screenY (Optional) The y-coordinate on the screen at which - * point the event occured. The default is 0. - * @param {int} clientX (Optional) The x-coordinate on the client at which - * point the event occured. The default is 0. - * @param {int} clientY (Optional) The y-coordinate on the client at which - * point the event occured. The default is 0. - * @param {Boolean} ctrlKey (Optional) Indicates if one of the CTRL keys - * is pressed while the event is firing. The default is false. - * @param {Boolean} altKey (Optional) Indicates if one of the ALT keys - * is pressed while the event is firing. The default is false. - * @param {Boolean} shiftKey (Optional) Indicates if one of the SHIFT keys - * is pressed while the event is firing. The default is false. - * @param {Boolean} metaKey (Optional) Indicates if one of the META keys - * is pressed while the event is firing. The default is false. - * @param {int} button (Optional) The button being pressed while the event - * is executing. The value should be 0 for the primary mouse button - * (typically the left button), 1 for the terciary mouse button - * (typically the middle button), and 2 for the secondary mouse button - * (typically the right button). The default is 0. - * @param {HTMLElement} relatedTarget (Optional) For mouseout events, - * this is the element that the mouse has moved to. For mouseover - * events, this is the element that the mouse has moved from. This - * argument is ignored for all other events. The default is null. - */ - simulateMouseEvent : function (target /*:HTMLElement*/, type /*:String*/, - bubbles /*:Boolean*/, cancelable /*:Boolean*/, - view /*:Window*/, detail /*:int*/, - screenX /*:int*/, screenY /*:int*/, - clientX /*:int*/, clientY /*:int*/, - ctrlKey /*:Boolean*/, altKey /*:Boolean*/, - shiftKey /*:Boolean*/, metaKey /*:Boolean*/, - button /*:int*/, relatedTarget /*:HTMLElement*/) /*:Void*/ - { - - //check target - target = YAHOO.util.Dom.get(target); - if (!target){ - throw new Error("simulateMouseEvent(): Invalid target."); - } - - //check event type - if (YAHOO.lang.isString(type)){ - type = type.toLowerCase(); - switch(type){ - case "mouseover": - case "mouseout": - case "mousedown": - case "mouseup": - case "click": - case "dblclick": - case "mousemove": - break; - default: - throw new Error("simulateMouseEvent(): Event type '" + type + "' not supported."); - } - } else { - throw new Error("simulateMouseEvent(): Event type must be a string."); - } - - //setup default values - if (!YAHOO.lang.isBoolean(bubbles)){ - bubbles = true; //all mouse events bubble - } - if (!YAHOO.lang.isBoolean(cancelable)){ - cancelable = (type != "mousemove"); //mousemove is the only one that can't be cancelled - } - if (!YAHOO.lang.isObject(view)){ - view = window; //view is typically window - } - if (!YAHOO.lang.isNumber(detail)){ - detail = 1; //number of mouse clicks must be at least one - } - if (!YAHOO.lang.isNumber(screenX)){ - screenX = 0; - } - if (!YAHOO.lang.isNumber(screenY)){ - screenY = 0; - } - if (!YAHOO.lang.isNumber(clientX)){ - clientX = 0; - } - if (!YAHOO.lang.isNumber(clientY)){ - clientY = 0; - } - if (!YAHOO.lang.isBoolean(ctrlKey)){ - ctrlKey = false; - } - if (!YAHOO.lang.isBoolean(altKey)){ - altKey = false; - } - if (!YAHOO.lang.isBoolean(shiftKey)){ - shiftKey = false; - } - if (!YAHOO.lang.isBoolean(metaKey)){ - metaKey = false; - } - if (!YAHOO.lang.isNumber(button)){ - button = 0; - } - - //try to create a mouse event - var customEvent /*:MouseEvent*/ = null; - - //check for DOM-compliant browsers first - if (YAHOO.lang.isFunction(document.createEvent)){ - - customEvent = document.createEvent("MouseEvents"); - - //Safari 2.x (WebKit 418) still doesn't implement initMouseEvent() - if (customEvent.initMouseEvent){ - customEvent.initMouseEvent(type, bubbles, cancelable, view, detail, - screenX, screenY, clientX, clientY, - ctrlKey, altKey, shiftKey, metaKey, - button, relatedTarget); - } else { //Safari - - //the closest thing available in Safari 2.x is UIEvents - customEvent = document.createEvent("UIEvents"); - customEvent.initEvent(type, bubbles, cancelable); - customEvent.view = view; - customEvent.detail = detail; - customEvent.screenX = screenX; - customEvent.screenY = screenY; - customEvent.clientX = clientX; - customEvent.clientY = clientY; - customEvent.ctrlKey = ctrlKey; - customEvent.altKey = altKey; - customEvent.metaKey = metaKey; - customEvent.shiftKey = shiftKey; - customEvent.button = button; - customEvent.relatedTarget = relatedTarget; - } - - /* - * Check to see if relatedTarget has been assigned. Firefox - * versions less than 2.0 don't allow it to be assigned via - * initMouseEvent() and the property is readonly after event - * creation, so in order to keep YAHOO.util.getRelatedTarget() - * working, assign to the IE proprietary toElement property - * for mouseout event and fromElement property for mouseover - * event. - */ - if (relatedTarget && !customEvent.relatedTarget){ - if (type == "mouseout"){ - customEvent.toElement = relatedTarget; - } else if (type == "mouseover"){ - customEvent.fromElement = relatedTarget; - } - } - - //fire the event - target.dispatchEvent(customEvent); - - } else if (YAHOO.lang.isObject(document.createEventObject)){ //IE - - //create an IE event object - customEvent = document.createEventObject(); - - //assign available properties - customEvent.bubbles = bubbles; - customEvent.cancelable = cancelable; - customEvent.view = view; - customEvent.detail = detail; - customEvent.screenX = screenX; - customEvent.screenY = screenY; - customEvent.clientX = clientX; - customEvent.clientY = clientY; - customEvent.ctrlKey = ctrlKey; - customEvent.altKey = altKey; - customEvent.metaKey = metaKey; - customEvent.shiftKey = shiftKey; - - //fix button property for IE's wacky implementation - switch(button){ - case 0: - customEvent.button = 1; - break; - case 1: - customEvent.button = 4; - break; - case 2: - //leave as is - break; - default: - customEvent.button = 0; - } - - /* - * Have to use relatedTarget because IE won't allow assignment - * to toElement or fromElement on generic events. This keeps - * YAHOO.util.customEvent.getRelatedTarget() functional. - */ - customEvent.relatedTarget = relatedTarget; - - //fire the event - target.fireEvent("on" + type, customEvent); - - } else { - throw new Error("simulateMouseEvent(): No event simulation framework present."); - } - }, - - //-------------------------------------------------------------------------- - // Mouse events - //-------------------------------------------------------------------------- - - /** - * Simulates a mouse event on a particular element. - * @param {HTMLElement} target The element to click on. - * @param {String} type The type of event to fire. This can be any one of - * the following: click, dblclick, mousedown, mouseup, mouseout, - * mouseover, and mousemove. - * @param {Object} options Additional event options (use DOM standard names). - * @method mouseEvent - * @static - */ - fireMouseEvent : function (target /*:HTMLElement*/, type /*:String*/, - options /*:Object*/) /*:Void*/ - { - options = options || {}; - this.simulateMouseEvent(target, type, options.bubbles, - options.cancelable, options.view, options.detail, options.screenX, - options.screenY, options.clientX, options.clientY, options.ctrlKey, - options.altKey, options.shiftKey, options.metaKey, options.button, - options.relatedTarget); - }, - - /** - * Simulates a click on a particular element. - * @param {HTMLElement} target The element to click on. - * @param {Object} options Additional event options (use DOM standard names). - * @method click - * @static - */ - click : function (target /*:HTMLElement*/, options /*:Object*/) /*:Void*/ { - this.fireMouseEvent(target, "click", options); - }, - - /** - * Simulates a double click on a particular element. - * @param {HTMLElement} target The element to double click on. - * @param {Object} options Additional event options (use DOM standard names). - * @method dblclick - * @static - */ - dblclick : function (target /*:HTMLElement*/, options /*:Object*/) /*:Void*/ { - this.fireMouseEvent( target, "dblclick", options); - }, - - /** - * Simulates a mousedown on a particular element. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method mousedown - * @static - */ - mousedown : function (target /*:HTMLElement*/, options /*Object*/) /*:Void*/ { - this.fireMouseEvent(target, "mousedown", options); - }, - - /** - * Simulates a mousemove on a particular element. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method mousemove - * @static - */ - mousemove : function (target /*:HTMLElement*/, options /*Object*/) /*:Void*/ { - this.fireMouseEvent(target, "mousemove", options); - }, - - /** - * Simulates a mouseout event on a particular element. Use "relatedTarget" - * on the options object to specify where the mouse moved to. - * Quirks: Firefox less than 2.0 doesn't set relatedTarget properly, so - * toElement is assigned in its place. IE doesn't allow toElement to be - * be assigned, so relatedTarget is assigned in its place. Both of these - * concessions allow YAHOO.util.Event.getRelatedTarget() to work correctly - * in both browsers. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method mouseout - * @static - */ - mouseout : function (target /*:HTMLElement*/, options /*Object*/) /*:Void*/ { - this.fireMouseEvent(target, "mouseout", options); - }, - - /** - * Simulates a mouseover event on a particular element. Use "relatedTarget" - * on the options object to specify where the mouse moved from. - * Quirks: Firefox less than 2.0 doesn't set relatedTarget properly, so - * fromElement is assigned in its place. IE doesn't allow fromElement to be - * be assigned, so relatedTarget is assigned in its place. Both of these - * concessions allow YAHOO.util.Event.getRelatedTarget() to work correctly - * in both browsers. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method mouseover - * @static - */ - mouseover : function (target /*:HTMLElement*/, options /*Object*/) /*:Void*/ { - this.fireMouseEvent(target, "mouseover", options); - }, - - /** - * Simulates a mouseup on a particular element. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method mouseup - * @static - */ - mouseup : function (target /*:HTMLElement*/, options /*Object*/) /*:Void*/ { - this.fireMouseEvent(target, "mouseup", options); - }, - - //-------------------------------------------------------------------------- - // Key events - //-------------------------------------------------------------------------- - - /** - * Fires an event that normally would be fired by the keyboard (keyup, - * keydown, keypress). Make sure to specify either keyCode or charCode as - * an option. - * @private - * @param {String} type The type of event ("keyup", "keydown" or "keypress"). - * @param {HTMLElement} target The target of the event. - * @param {Object} options Options for the event. Either keyCode or charCode - * are required. - * @method fireKeyEvent - * @static - */ - fireKeyEvent : function (type /*:String*/, target /*:HTMLElement*/, - options /*:Object*/) /*:Void*/ - { - options = options || {}; - this.simulateKeyEvent(target, type, options.bubbles, - options.cancelable, options.view, options.ctrlKey, - options.altKey, options.shiftKey, options.metaKey, - options.keyCode, options.charCode); - }, - - /** - * Simulates a keydown event on a particular element. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method keydown - * @static - */ - keydown : function (target /*:HTMLElement*/, options /*:Object*/) /*:Void*/ { - this.fireKeyEvent("keydown", target, options); - }, - - /** - * Simulates a keypress on a particular element. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method keypress - * @static - */ - keypress : function (target /*:HTMLElement*/, options /*:Object*/) /*:Void*/ { - this.fireKeyEvent("keypress", target, options); - }, - - /** - * Simulates a keyup event on a particular element. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method keyup - * @static - */ - keyup : function (target /*:HTMLElement*/, options /*Object*/) /*:Void*/ { - this.fireKeyEvent("keyup", target, options); - } - - -}; - -YAHOO.namespace("tool"); - -//----------------------------------------------------------------------------- -// TestManager object -//----------------------------------------------------------------------------- - -/** - * Runs pages containing test suite definitions. - * @namespace YAHOO.tool - * @class TestManager - * @static - */ -YAHOO.tool.TestManager = { - - /** - * Constant for the testpagebegin custom event - * @property TEST_PAGE_BEGIN_EVENT - * @static - * @type string - * @final - */ - TEST_PAGE_BEGIN_EVENT /*:String*/ : "testpagebegin", - - /** - * Constant for the testpagecomplete custom event - * @property TEST_PAGE_COMPLETE_EVENT - * @static - * @type string - * @final - */ - TEST_PAGE_COMPLETE_EVENT /*:String*/ : "testpagecomplete", - - /** - * Constant for the testmanagerbegin custom event - * @property TEST_MANAGER_BEGIN_EVENT - * @static - * @type string - * @final - */ - TEST_MANAGER_BEGIN_EVENT /*:String*/ : "testmanagerbegin", - - /** - * Constant for the testmanagercomplete custom event - * @property TEST_MANAGER_COMPLETE_EVENT - * @static - * @type string - * @final - */ - TEST_MANAGER_COMPLETE_EVENT /*:String*/ : "testmanagercomplete", - - //------------------------------------------------------------------------- - // Private Properties - //------------------------------------------------------------------------- - - - /** - * The URL of the page currently being executed. - * @type String - * @private - * @property _curPage - * @static - */ - _curPage /*:String*/ : null, - - /** - * The frame used to load and run tests. - * @type Window - * @private - * @property _frame - * @static - */ - _frame /*:Window*/ : null, - - /** - * The logger used to output results from the various tests. - * @type YAHOO.tool.TestLogger - * @private - * @property _logger - * @static - */ - _logger : null, - - /** - * The timeout ID for the next iteration through the tests. - * @type int - * @private - * @property _timeoutId - * @static - */ - _timeoutId /*:int*/ : 0, - - /** - * Array of pages to load. - * @type String[] - * @private - * @property _pages - * @static - */ - _pages /*:String[]*/ : [], - - /** - * Aggregated results - * @type Object - * @private - * @property _results - * @static - */ - _results: null, - - //------------------------------------------------------------------------- - // Private Methods - //------------------------------------------------------------------------- - - /** - * Handles TestRunner.COMPLETE_EVENT, storing the results and beginning - * the loop again. - * @param {Object} data Data about the event. - * @return {Void} - * @private - * @static - */ - _handleTestRunnerComplete : function (data /*:Object*/) /*:Void*/ { - - this.fireEvent(this.TEST_PAGE_COMPLETE_EVENT, { - page: this._curPage, - results: data.results - }); - - //save results - //this._results[this.curPage] = data.results; - - //process 'em - this._processResults(this._curPage, data.results); - - this._logger.clearTestRunner(); - - //if there's more to do, set a timeout to begin again - if (this._pages.length){ - this._timeoutId = setTimeout(function(){ - YAHOO.tool.TestManager._run(); - }, 1000); - } else { - this.fireEvent(this.TEST_MANAGER_COMPLETE_EVENT, this._results); - } - }, - - /** - * Processes the results of a test page run, outputting log messages - * for failed tests. - * @return {Void} - * @private - * @static - */ - _processResults : function (page /*:String*/, results /*:Object*/) /*:Void*/ { - - var r = this._results; - - r.passed += results.passed; - r.failed += results.failed; - r.ignored += results.ignored; - r.total += results.total; - - if (results.failed){ - r.failedPages.push(page); - } else { - r.passedPages.push(page); - } - - results.name = page; - results.type = "page"; - - r[page] = results; - }, - - /** - * Loads the next test page into the iframe. - * @return {Void} - * @static - * @private - */ - _run : function () /*:Void*/ { - - //set the current page - this._curPage = this._pages.shift(); - - this.fireEvent(this.TEST_PAGE_BEGIN_EVENT, this._curPage); - - //load the frame - destroy history in case there are other iframes that - //need testing - this._frame.location.replace(this._curPage); - - }, - - //------------------------------------------------------------------------- - // Public Methods - //------------------------------------------------------------------------- - - /** - * Signals that a test page has been loaded. This should be called from - * within the test page itself to notify the TestManager that it is ready. - * @return {Void} - * @static - */ - load : function () /*:Void*/ { - if (parent.YAHOO.tool.TestManager !== this){ - parent.YAHOO.tool.TestManager.load(); - } else { - - if (this._frame) { - //assign event handling - var TestRunner = this._frame.YAHOO.tool.TestRunner; - - this._logger.setTestRunner(TestRunner); - TestRunner.subscribe(TestRunner.COMPLETE_EVENT, this._handleTestRunnerComplete, this, true); - - //run it - TestRunner.run(); - } - } - }, - - /** - * Sets the pages to be loaded. - * @param {String[]} pages An array of URLs to load. - * @return {Void} - * @static - */ - setPages : function (pages /*:String[]*/) /*:Void*/ { - this._pages = pages; - }, - - /** - * Begins the process of running the tests. - * @return {Void} - * @static - */ - start : function () /*:Void*/ { - - if (!this._initialized) { - - /** - * Fires when loading a test page - * @event testpagebegin - * @param curPage {string} the page being loaded - * @static - */ - this.createEvent(this.TEST_PAGE_BEGIN_EVENT); - - /** - * Fires when a test page is complete - * @event testpagecomplete - * @param obj {page: string, results: object} the name of the - * page that was loaded, and the test suite results - * @static - */ - this.createEvent(this.TEST_PAGE_COMPLETE_EVENT); - - /** - * Fires when the test manager starts running all test pages - * @event testmanagerbegin - * @static - */ - this.createEvent(this.TEST_MANAGER_BEGIN_EVENT); - - /** - * Fires when the test manager finishes running all test pages. External - * test runners should subscribe to this event in order to get the - * aggregated test results. - * @event testmanagercomplete - * @param obj { pages_passed: int, pages_failed: int, tests_passed: int - * tests_failed: int, passed: string[], failed: string[], - * page_results: {} } - * @static - */ - this.createEvent(this.TEST_MANAGER_COMPLETE_EVENT); - - //create iframe if not already available - if (!this._frame){ - var frame /*:HTMLElement*/ = document.createElement("iframe"); - frame.style.visibility = "hidden"; - frame.style.position = "absolute"; - document.body.appendChild(frame); - this._frame = frame.contentWindow || frame.contentDocument.ownerWindow; - } - - //create test logger if not already available - if (!this._logger){ - this._logger = new YAHOO.tool.TestLogger(); - } - - this._initialized = true; - } - - - // reset the results cache - this._results = { - - passed: 0, - failed: 0, - ignored: 0, - total: 0, - type: "report", - name: "YUI Test Results", - failedPages:[], - passedPages:[] - /* - // number of pages that pass - pages_passed: 0, - // number of pages that fail - pages_failed: 0, - // total number of tests passed - tests_passed: 0, - // total number of tests failed - tests_failed: 0, - // array of pages that passed - passed: [], - // array of pages that failed - failed: [], - // map of full results for each page - page_results: {}*/ - }; - - this.fireEvent(this.TEST_MANAGER_BEGIN_EVENT, null); - this._run(); - - }, - - /** - * Stops the execution of tests. - * @return {Void} - * @static - */ - stop : function () /*:Void*/ { - clearTimeout(this._timeoutId); - } - -}; - -YAHOO.lang.augmentObject(YAHOO.tool.TestManager, YAHOO.util.EventProvider.prototype); - - -YAHOO.namespace("tool"); - -//----------------------------------------------------------------------------- -// TestLogger object -//----------------------------------------------------------------------------- - -/** - * Displays test execution progress and results, providing filters based on - * different key events. - * @namespace YAHOO.tool - * @class TestLogger - * @constructor - * @param {HTMLElement} element (Optional) The element to create the logger in. - * @param {Object} config (Optional) Configuration options for the logger. - */ -YAHOO.tool.TestLogger = function (element, config) { - YAHOO.tool.TestLogger.superclass.constructor.call(this, element, config); - this.init(); -}; - -YAHOO.lang.extend(YAHOO.tool.TestLogger, YAHOO.widget.LogReader, { - - footerEnabled : true, - newestOnTop : false, - - /** - * Formats message string to HTML for output to console. - * @private - * @method formatMsg - * @param oLogMsg {Object} Log message object. - * @return {String} HTML-formatted message for output to console. - */ - formatMsg : function(message /*:Object*/) { - - var category /*:String*/ = message.category; - var text /*:String*/ = this.html2Text(message.msg); - - return "<pre><p><span class=\"" + category + "\">" + category.toUpperCase() + "</span> " + text + "</p></pre>"; - - }, - - //------------------------------------------------------------------------- - // Private Methods - //------------------------------------------------------------------------- - - /* - * Initializes the logger. - * @private - */ - init : function () { - - //attach to any available TestRunner - if (YAHOO.tool.TestRunner){ - this.setTestRunner(YAHOO.tool.TestRunner); - } - - //hide useless sources - this.hideSource("global"); - this.hideSource("LogReader"); - - //hide useless message categories - this.hideCategory("warn"); - this.hideCategory("window"); - this.hideCategory("time"); - - //reset the logger - this.clearConsole(); - }, - - /** - * Clears the reference to the TestRunner from previous operations. This - * unsubscribes all events and removes the object reference. - * @return {Void} - * @static - */ - clearTestRunner : function () /*:Void*/ { - if (this._runner){ - this._runner.unsubscribeAll(); - this._runner = null; - } - }, - - /** - * Sets the source test runner that the logger should monitor. - * @param {YAHOO.tool.TestRunner} testRunner The TestRunner to observe. - * @return {Void} - * @static - */ - setTestRunner : function (testRunner /*:YAHOO.tool.TestRunner*/) /*:Void*/ { - - if (this._runner){ - this.clearTestRunner(); - } - - this._runner = testRunner; - - //setup event _handlers - testRunner.subscribe(testRunner.TEST_PASS_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.TEST_FAIL_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.TEST_IGNORE_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.BEGIN_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.COMPLETE_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.TEST_SUITE_BEGIN_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.TEST_SUITE_COMPLETE_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.TEST_CASE_BEGIN_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.TEST_CASE_COMPLETE_EVENT, this._handleTestRunnerEvent, this, true); - }, - - //------------------------------------------------------------------------- - // Event Handlers - //------------------------------------------------------------------------- - - /** - * Handles all TestRunner events, outputting appropriate data into the console. - * @param {Object} data The event data object. - * @return {Void} - * @private - */ - _handleTestRunnerEvent : function (data /*:Object*/) /*:Void*/ { - - //shortcut variables - var TestRunner /*:Object*/ = YAHOO.tool.TestRunner; - - //data variables - var message /*:String*/ = ""; - var messageType /*:String*/ = ""; - - switch(data.type){ - case TestRunner.BEGIN_EVENT: - message = "Testing began at " + (new Date()).toString() + "."; - messageType = "info"; - break; - - case TestRunner.COMPLETE_EVENT: - message = "Testing completed at " + (new Date()).toString() + ".\nPassed:" + - data.results.passed + " Failed:" + data.results.failed + " Total:" + data.results.total; - messageType = "info"; - break; - - case TestRunner.TEST_FAIL_EVENT: - message = data.testName + ": " + data.error.getMessage(); - messageType = "fail"; - break; - - case TestRunner.TEST_IGNORE_EVENT: - message = data.testName + ": ignored."; - messageType = "ignore"; - break; - - case TestRunner.TEST_PASS_EVENT: - message = data.testName + ": passed."; - messageType = "pass"; - break; - - case TestRunner.TEST_SUITE_BEGIN_EVENT: - message = "Test suite \"" + data.testSuite.name + "\" started."; - messageType = "info"; - break; - - case TestRunner.TEST_SUITE_COMPLETE_EVENT: - message = "Test suite \"" + data.testSuite.name + "\" completed.\nPassed:" + - data.results.passed + " Failed:" + data.results.failed + " Total:" + data.results.total; - messageType = "info"; - break; - - case TestRunner.TEST_CASE_BEGIN_EVENT: - message = "Test case \"" + data.testCase.name + "\" started."; - messageType = "info"; - break; - - case TestRunner.TEST_CASE_COMPLETE_EVENT: - message = "Test case \"" + data.testCase.name + "\" completed.\nPassed:" + - data.results.passed + " Failed:" + data.results.failed + " Total:" + data.results.total; - messageType = "info"; - break; - default: - message = "Unexpected event " + data.type; - message = "info"; - } - - YAHOO.log(message, messageType, "TestRunner"); - } - -}); - -YAHOO.namespace("tool.TestFormat"); - -/** - * Returns test results formatted as a JSON string. Requires JSON utility. - * @param {Object} result The results object created by TestRunner. - * @return {String} An XML-formatted string of results. - * @namespace YAHOO.tool.TestFormat - * @method JSON - * @static - */ -YAHOO.tool.TestFormat.JSON = function(results /*:Object*/) /*:String*/ { - return YAHOO.lang.JSON.stringify(results); -}; - -/** - * Returns test results formatted as an XML string. - * @param {Object} result The results object created by TestRunner. - * @return {String} An XML-formatted string of results. - * @namespace YAHOO.tool.TestFormat - * @method XML - * @static - */ -YAHOO.tool.TestFormat.XML = function(results /*:Object*/) /*:String*/ { - - var l = YAHOO.lang; - var xml /*:String*/ = "<" + results.type + " name=\"" + results.name.replace(/"/g, """).replace(/'/g, "'") + "\""; - - if (results.type == "test"){ - xml += " result=\"" + results.result + "\" message=\"" + results.message + "\">"; - } else { - xml += " passed=\"" + results.passed + "\" failed=\"" + results.failed + "\" ignored=\"" + results.ignored + "\" total=\"" + results.total + "\">"; - for (var prop in results) { - if (l.hasOwnProperty(results, prop) && l.isObject(results[prop]) && !l.isArray(results[prop])){ - xml += arguments.callee(results[prop]); - } - } - } - - xml += "</" + results.type + ">"; - - return xml; - -}; - -YAHOO.namespace("tool"); - -/** - * An object capable of sending test results to a server. - * @param {String} url The URL to submit the results to. - * @param {Function} format (Optiona) A function that outputs the results in a specific format. - * Default is YAHOO.tool.TestFormat.XML. - * @constructor - * @namespace YAHOO.tool - * @class TestReporter - */ -YAHOO.tool.TestReporter = function(url /*:String*/, format /*:Function*/) { - - /** - * The URL to submit the data to. - * @type String - * @property url - */ - this.url /*:String*/ = url; - - /** - * The formatting function to call when submitting the data. - * @type Function - * @property format - */ - this.format /*:Function*/ = format || YAHOO.tool.TestFormat.XML; - - /** - * Extra fields to submit with the request. - * @type Object - * @property _fields - * @private - */ - this._fields /*:Object*/ = new Object(); - - /** - * The form element used to submit the results. - * @type HTMLFormElement - * @property _form - * @private - */ - this._form /*:HTMLElement*/ = null; - - /** - * Iframe used as a target for form submission. - * @type HTMLIFrameElement - * @property _iframe - * @private - */ - this._iframe /*:HTMLElement*/ = null; -}; - -YAHOO.tool.TestReporter.prototype = { - - //restore missing constructor - constructor: YAHOO.tool.TestReporter, - - /** - * Adds a field to the form that submits the results. - * @param {String} name The name of the field. - * @param {Variant} value The value of the field. - * @return {Void} - * @method addField - */ - addField : function (name /*:String*/, value /*:Variant*/) /*:Void*/{ - this._fields[name] = value; - }, - - /** - * Removes all previous defined fields. - * @return {Void} - * @method addField - */ - clearFields : function() /*:Void*/{ - this._fields = new Object(); - }, - - /** - * Cleans up the memory associated with the TestReporter, removing DOM elements - * that were created. - * @return {Void} - * @method destroy - */ - destroy : function() /*:Void*/ { - if (this._form){ - this._form.parentNode.removeChild(this._form); - this._form = null; - } - if (this._iframe){ - this._iframe.parentNode.removeChild(this._iframe); - this._iframe = null; - } - this._fields = null; - }, - - /** - * Sends the report to the server. - * @param {Object} results The results object created by TestRunner. - * @return {Void} - * @method report - */ - report : function(results /*:Object*/) /*:Void*/{ - - //if the form hasn't been created yet, create it - if (!this._form){ - this._form = document.createElement("form"); - this._form.method = "post"; - this._form.style.visibility = "hidden"; - this._form.style.position = "absolute"; - this._form.style.top = 0; - document.body.appendChild(this._form); - - //IE won't let you assign a name using the DOM, must do it the hacky way - if (YAHOO.env.ua.ie){ - this._iframe = document.createElement("<iframe name=\"yuiTestTarget\" />"); - } else { - this._iframe = document.createElement("iframe"); - this._iframe.name = "yuiTestTarget"; - } - - this._iframe.src = "javascript:false"; - this._iframe.style.visibility = "hidden"; - this._iframe.style.position = "absolute"; - this._iframe.style.top = 0; - document.body.appendChild(this._iframe); - - this._form.target = "yuiTestTarget"; - } - - //set the form's action - this._form.action = this.url; - - //remove any existing fields - while(this._form.hasChildNodes()){ - this._form.removeChild(this._form.lastChild); - } - - //create default fields - this._fields.results = this.format(results); - this._fields.useragent = navigator.userAgent; - this._fields.timestamp = (new Date()).toLocaleString(); - - //add fields to the form - for (var prop in this._fields){ - if (YAHOO.lang.hasOwnProperty(this._fields, prop) && typeof this._fields[prop] != "function"){ - input = document.createElement("input"); - input.type = "hidden"; - input.name = prop; - input.value = this._fields[prop]; - this._form.appendChild(input); - } - } - - //remove default fields - delete this._fields.results; - delete this._fields.useragent; - delete this._fields.timestamp; - - if (arguments[1] !== false){ - this._form.submit(); - } - - } - -}; - -YAHOO.register("yuitest", YAHOO.tool.TestRunner, {version: "2.5.0", build: "895"}); diff --git a/lib/yui/yuitest/yuitest-debug.js b/lib/yui/yuitest/yuitest-debug.js deleted file mode 100644 index ad114842e9..0000000000 --- a/lib/yui/yuitest/yuitest-debug.js +++ /dev/null @@ -1,3268 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -YAHOO.namespace("tool"); - -//----------------------------------------------------------------------------- -// TestCase object -//----------------------------------------------------------------------------- - -/** - * Test case containing various tests to run. - * @param template An object containing any number of test methods, other methods, - * an optional name, and anything else the test case needs. - * @class TestCase - * @namespace YAHOO.tool - * @constructor - */ -YAHOO.tool.TestCase = function (template /*:Object*/) { - - /** - * Special rules for the test case. Possible subobjects - * are fail, for tests that should fail, and error, for - * tests that should throw an error. - */ - this._should /*:Object*/ = {}; - - //copy over all properties from the template to this object - for (var prop in template) { - this[prop] = template[prop]; - } - - //check for a valid name - if (!YAHOO.lang.isString(this.name)){ - /** - * Name for the test case. - */ - this.name /*:String*/ = YAHOO.util.Dom.generateId(null, "testCase"); - } - -}; - - -YAHOO.tool.TestCase.prototype = { - - /** - * Resumes a paused test and runs the given function. - * @param {Function} segment (Optional) The function to run. - * If omitted, the test automatically passes. - * @return {Void} - * @method resume - */ - resume : function (segment /*:Function*/) /*:Void*/ { - YAHOO.tool.TestRunner.resume(segment); - }, - - /** - * Causes the test case to wait a specified amount of time and then - * continue executing the given code. - * @param {Function} segment (Optional) The function to run after the delay. - * If omitted, the TestRunner will wait until resume() is called. - * @param {int} delay (Optional) The number of milliseconds to wait before running - * the function. If omitted, defaults to zero. - * @return {Void} - * @method wait - */ - wait : function (segment /*:Function*/, delay /*:int*/) /*:Void*/{ - throw new YAHOO.tool.TestCase.Wait(segment, delay); - }, - - //------------------------------------------------------------------------- - // Stub Methods - //------------------------------------------------------------------------- - - /** - * Function to run before each test is executed. - * @return {Void} - * @method setUp - */ - setUp : function () /*:Void*/ { - }, - - /** - * Function to run after each test is executed. - * @return {Void} - * @method tearDown - */ - tearDown: function () /*:Void*/ { - } -}; - -/** - * Represents a stoppage in test execution to wait for an amount of time before - * continuing. - * @param {Function} segment A function to run when the wait is over. - * @param {int} delay The number of milliseconds to wait before running the code. - * @class Wait - * @namespace YAHOO.tool.TestCase - * @constructor - * - */ -YAHOO.tool.TestCase.Wait = function (segment /*:Function*/, delay /*:int*/) { - - /** - * The segment of code to run when the wait is over. - * @type Function - * @property segment - */ - this.segment /*:Function*/ = (YAHOO.lang.isFunction(segment) ? segment : null); - - /** - * The delay before running the segment of code. - * @type int - * @property delay - */ - this.delay /*:int*/ = (YAHOO.lang.isNumber(delay) ? delay : 0); - -}; - -YAHOO.namespace("tool"); - - -//----------------------------------------------------------------------------- -// TestSuite object -//----------------------------------------------------------------------------- - -/** - * A test suite that can contain a collection of TestCase and TestSuite objects. - * @param {String||Object} data The name of the test suite or an object containing - * a name property as well as setUp and tearDown methods. - * @namespace YAHOO.tool - * @class TestSuite - * @constructor - */ -YAHOO.tool.TestSuite = function (data /*:String||Object*/) { - - /** - * The name of the test suite. - * @type String - * @property name - */ - this.name /*:String*/ = ""; - - /** - * Array of test suites and - * @private - */ - this.items /*:Array*/ = []; - - //initialize the properties - if (YAHOO.lang.isString(data)){ - this.name = data; - } else if (YAHOO.lang.isObject(data)){ - YAHOO.lang.augmentObject(this, data, true); - } - - //double-check name - if (this.name === ""){ - this.name = YAHOO.util.Dom.generateId(null, "testSuite"); - } - -}; - -YAHOO.tool.TestSuite.prototype = { - - /** - * Adds a test suite or test case to the test suite. - * @param {YAHOO.tool.TestSuite||YAHOO.tool.TestCase} testObject The test suite or test case to add. - * @return {Void} - * @method add - */ - add : function (testObject /*:YAHOO.tool.TestSuite*/) /*:Void*/ { - if (testObject instanceof YAHOO.tool.TestSuite || testObject instanceof YAHOO.tool.TestCase) { - this.items.push(testObject); - } - }, - - //------------------------------------------------------------------------- - // Stub Methods - //------------------------------------------------------------------------- - - /** - * Function to run before each test is executed. - * @return {Void} - * @method setUp - */ - setUp : function () /*:Void*/ { - }, - - /** - * Function to run after each test is executed. - * @return {Void} - * @method tearDown - */ - tearDown: function () /*:Void*/ { - } - -}; - -YAHOO.namespace("tool"); - -/** - * The YUI test tool - * @module yuitest - * @namespace YAHOO.tool - * @requires yahoo,dom,event,logger - */ - - -//----------------------------------------------------------------------------- -// TestRunner object -//----------------------------------------------------------------------------- - -/** - * Runs test suites and test cases, providing events to allowing for the - * interpretation of test results. - * @namespace YAHOO.tool - * @class TestRunner - * @static - */ -YAHOO.tool.TestRunner = (function(){ - - /** - * A node in the test tree structure. May represent a TestSuite, TestCase, or - * test function. - * @param {Variant} testObject A TestSuite, TestCase, or the name of a test function. - * @class TestNode - * @constructor - * @private - */ - function TestNode(testObject /*:Variant*/){ - - /** - * The TestSuite, TestCase, or test function represented by this node. - * @type Variant - * @property testObject - */ - this.testObject = testObject; - - /** - * Pointer to this node's first child. - * @type TestNode - * @property firstChild - */ - this.firstChild /*:TestNode*/ = null; - - /** - * Pointer to this node's last child. - * @type TestNode - * @property lastChild - */ - this.lastChild = null; - - /** - * Pointer to this node's parent. - * @type TestNode - * @property parent - */ - this.parent = null; - - /** - * Pointer to this node's next sibling. - * @type TestNode - * @property next - */ - this.next = null; - - /** - * Test results for this test object. - * @type object - * @property results - */ - this.results /*:Object*/ = { - passed : 0, - failed : 0, - total : 0, - ignored : 0 - }; - - //initialize results - if (testObject instanceof YAHOO.tool.TestSuite){ - this.results.type = "testsuite"; - this.results.name = testObject.name; - } else if (testObject instanceof YAHOO.tool.TestCase){ - this.results.type = "testcase"; - this.results.name = testObject.name; - } - - } - - TestNode.prototype = { - - /** - * Appends a new test object (TestSuite, TestCase, or test function name) as a child - * of this node. - * @param {Variant} testObject A TestSuite, TestCase, or the name of a test function. - * @return {Void} - */ - appendChild : function (testObject /*:Variant*/) /*:Void*/{ - var node = new TestNode(testObject); - if (this.firstChild === null){ - this.firstChild = this.lastChild = node; - } else { - this.lastChild.next = node; - this.lastChild = node; - } - node.parent = this; - return node; - } - }; - - function TestRunner(){ - - //inherit from EventProvider - TestRunner.superclass.constructor.apply(this,arguments); - - /** - * Suite on which to attach all TestSuites and TestCases to be run. - * @type YAHOO.tool.TestSuite - * @property masterSuite - * @private - */ - this.masterSuite /*:YAHOO.tool.TestSuite*/ = new YAHOO.tool.TestSuite("YUI Test Results"); - - /** - * Pointer to the current node in the test tree. - * @type TestNode - * @private - * @property _cur - */ - this._cur = null; - - /** - * Pointer to the root node in the test tree. - * @type TestNode - * @private - * @property _root - */ - this._root = null; - - //create events - var events /*:Array*/ = [ - this.TEST_CASE_BEGIN_EVENT, - this.TEST_CASE_COMPLETE_EVENT, - this.TEST_SUITE_BEGIN_EVENT, - this.TEST_SUITE_COMPLETE_EVENT, - this.TEST_PASS_EVENT, - this.TEST_FAIL_EVENT, - this.TEST_IGNORE_EVENT, - this.COMPLETE_EVENT, - this.BEGIN_EVENT - ]; - for (var i=0; i < events.length; i++){ - this.createEvent(events[i], { scope: this }); - } - - } - - YAHOO.lang.extend(TestRunner, YAHOO.util.EventProvider, { - - //------------------------------------------------------------------------- - // Constants - //------------------------------------------------------------------------- - - /** - * Fires when a test case is opened but before the first - * test is executed. - * @event testcasebegin - */ - TEST_CASE_BEGIN_EVENT /*:String*/ : "testcasebegin", - - /** - * Fires when all tests in a test case have been executed. - * @event testcasecomplete - */ - TEST_CASE_COMPLETE_EVENT /*:String*/ : "testcasecomplete", - - /** - * Fires when a test suite is opened but before the first - * test is executed. - * @event testsuitebegin - */ - TEST_SUITE_BEGIN_EVENT /*:String*/ : "testsuitebegin", - - /** - * Fires when all test cases in a test suite have been - * completed. - * @event testsuitecomplete - */ - TEST_SUITE_COMPLETE_EVENT /*:String*/ : "testsuitecomplete", - - /** - * Fires when a test has passed. - * @event pass - */ - TEST_PASS_EVENT /*:String*/ : "pass", - - /** - * Fires when a test has failed. - * @event fail - */ - TEST_FAIL_EVENT /*:String*/ : "fail", - - /** - * Fires when a test has been ignored. - * @event ignore - */ - TEST_IGNORE_EVENT /*:String*/ : "ignore", - - /** - * Fires when all test suites and test cases have been completed. - * @event complete - */ - COMPLETE_EVENT /*:String*/ : "complete", - - /** - * Fires when the run() method is called. - * @event begin - */ - BEGIN_EVENT /*:String*/ : "begin", - - //------------------------------------------------------------------------- - // Test Tree-Related Methods - //------------------------------------------------------------------------- - - /** - * Adds a test case to the test tree as a child of the specified node. - * @param {TestNode} parentNode The node to add the test case to as a child. - * @param {YAHOO.tool.TestCase} testCase The test case to add. - * @return {Void} - * @static - * @private - * @method _addTestCaseToTestTree - */ - _addTestCaseToTestTree : function (parentNode /*:TestNode*/, testCase /*:YAHOO.tool.TestCase*/) /*:Void*/{ - - //add the test suite - var node = parentNode.appendChild(testCase); - - //iterate over the items in the test case - for (var prop in testCase){ - if (prop.indexOf("test") === 0 && YAHOO.lang.isFunction(testCase[prop])){ - node.appendChild(prop); - } - } - - }, - - /** - * Adds a test suite to the test tree as a child of the specified node. - * @param {TestNode} parentNode The node to add the test suite to as a child. - * @param {YAHOO.tool.TestSuite} testSuite The test suite to add. - * @return {Void} - * @static - * @private - * @method _addTestSuiteToTestTree - */ - _addTestSuiteToTestTree : function (parentNode /*:TestNode*/, testSuite /*:YAHOO.tool.TestSuite*/) /*:Void*/ { - - //add the test suite - var node = parentNode.appendChild(testSuite); - - //iterate over the items in the master suite - for (var i=0; i < testSuite.items.length; i++){ - if (testSuite.items[i] instanceof YAHOO.tool.TestSuite) { - this._addTestSuiteToTestTree(node, testSuite.items[i]); - } else if (testSuite.items[i] instanceof YAHOO.tool.TestCase) { - this._addTestCaseToTestTree(node, testSuite.items[i]); - } - } - }, - - /** - * Builds the test tree based on items in the master suite. The tree is a hierarchical - * representation of the test suites, test cases, and test functions. The resulting tree - * is stored in _root and the pointer _cur is set to the root initially. - * @return {Void} - * @static - * @private - * @method _buildTestTree - */ - _buildTestTree : function () /*:Void*/ { - - this._root = new TestNode(this.masterSuite); - this._cur = this._root; - - //iterate over the items in the master suite - for (var i=0; i < this.masterSuite.items.length; i++){ - if (this.masterSuite.items[i] instanceof YAHOO.tool.TestSuite) { - this._addTestSuiteToTestTree(this._root, this.masterSuite.items[i]); - } else if (this.masterSuite.items[i] instanceof YAHOO.tool.TestCase) { - this._addTestCaseToTestTree(this._root, this.masterSuite.items[i]); - } - } - - }, - - //------------------------------------------------------------------------- - // Private Methods - //------------------------------------------------------------------------- - - /** - * Handles the completion of a test object's tests. Tallies test results - * from one level up to the next. - * @param {TestNode} node The TestNode representing the test object. - * @return {Void} - * @method _handleTestObjectComplete - * @private - */ - _handleTestObjectComplete : function (node /*:TestNode*/) /*:Void*/ { - if (YAHOO.lang.isObject(node.testObject)){ - node.parent.results.passed += node.results.passed; - node.parent.results.failed += node.results.failed; - node.parent.results.total += node.results.total; - node.parent.results.ignored += node.results.ignored; - node.parent.results[node.testObject.name] = node.results; - - if (node.testObject instanceof YAHOO.tool.TestSuite){ - node.testObject.tearDown(); - this.fireEvent(this.TEST_SUITE_COMPLETE_EVENT, { testSuite: node.testObject, results: node.results}); - } else if (node.testObject instanceof YAHOO.tool.TestCase){ - this.fireEvent(this.TEST_CASE_COMPLETE_EVENT, { testCase: node.testObject, results: node.results}); - } - } - }, - - //------------------------------------------------------------------------- - // Navigation Methods - //------------------------------------------------------------------------- - - /** - * Retrieves the next node in the test tree. - * @return {TestNode} The next node in the test tree or null if the end is reached. - * @private - * @static - * @method _next - */ - _next : function () /*:TestNode*/ { - - if (this._cur.firstChild) { - this._cur = this._cur.firstChild; - } else if (this._cur.next) { - this._cur = this._cur.next; - } else { - while (this._cur && !this._cur.next && this._cur !== this._root){ - this._handleTestObjectComplete(this._cur); - this._cur = this._cur.parent; - } - - if (this._cur == this._root){ - this._cur.results.type = "report"; - this._cur.results.timestamp = (new Date()).toLocaleString(); - this.fireEvent(this.COMPLETE_EVENT, { results: this._cur.results}); - this._cur = null; - } else { - this._handleTestObjectComplete(this._cur); - this._cur = this._cur.next; - } - } - - return this._cur; - }, - - /** - * Runs a test case or test suite, returning the results. - * @param {YAHOO.tool.TestCase|YAHOO.tool.TestSuite} testObject The test case or test suite to run. - * @return {Object} Results of the execution with properties passed, failed, and total. - * @private - * @method _run - * @static - */ - _run : function () /*:Void*/ { - - //flag to indicate if the TestRunner should wait before continuing - var shouldWait /*:Boolean*/ = false; - - //get the next test node - var node = this._next(); - - if (node !== null) { - var testObject = node.testObject; - - //figure out what to do - if (YAHOO.lang.isObject(testObject)){ - if (testObject instanceof YAHOO.tool.TestSuite){ - this.fireEvent(this.TEST_SUITE_BEGIN_EVENT, { testSuite: testObject }); - testObject.setUp(); - } else if (testObject instanceof YAHOO.tool.TestCase){ - this.fireEvent(this.TEST_CASE_BEGIN_EVENT, { testCase: testObject }); - } - - //some environments don't support setTimeout - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._run(); - }, 0); - } else { - this._run(); - } - } else { - this._runTest(node); - } - - } - }, - - _resumeTest : function (segment /*:Function*/) /*:Void*/ { - - //get relevant information - var node /*:TestNode*/ = this._cur; - var testName /*:String*/ = node.testObject; - var testCase /*:YAHOO.tool.TestCase*/ = node.parent.testObject; - - //get the "should" test cases - var shouldFail /*:Object*/ = (testCase._should.fail || {})[testName]; - var shouldError /*:Object*/ = (testCase._should.error || {})[testName]; - - //variable to hold whether or not the test failed - var failed /*:Boolean*/ = false; - var error /*:Error*/ = null; - - //try the test - try { - - //run the test - segment.apply(testCase); - - //if it should fail, and it got here, then it's a fail because it didn't - if (shouldFail){ - error = new YAHOO.util.ShouldFail(); - failed = true; - } else if (shouldError){ - error = new YAHOO.util.ShouldError(); - failed = true; - } - - } catch (thrown /*:Error*/){ - if (thrown instanceof YAHOO.util.AssertionError) { - if (!shouldFail){ - error = thrown; - failed = true; - } - } else if (thrown instanceof YAHOO.tool.TestCase.Wait){ - - if (YAHOO.lang.isFunction(thrown.segment)){ - if (YAHOO.lang.isNumber(thrown.delay)){ - - //some environments don't support setTimeout - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._resumeTest(thrown.segment); - }, thrown.delay); - } else { - throw new Error("Asynchronous tests not supported in this environment."); - } - } - } - - return; - - } else { - //first check to see if it should error - if (!shouldError) { - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } else { - //check to see what type of data we have - if (YAHOO.lang.isString(shouldError)){ - - //if it's a string, check the error message - if (thrown.message != shouldError){ - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } - } else if (YAHOO.lang.isFunction(shouldError)){ - - //if it's a function, see if the error is an instance of it - if (!(thrown instanceof shouldError)){ - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } - - } else if (YAHOO.lang.isObject(shouldError)){ - - //if it's an object, check the instance and message - if (!(thrown instanceof shouldError.constructor) || - thrown.message != shouldError.message){ - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } - - } - - } - } - - } - - //fireEvent appropriate event - if (failed) { - this.fireEvent(this.TEST_FAIL_EVENT, { testCase: testCase, testName: testName, error: error }); - } else { - this.fireEvent(this.TEST_PASS_EVENT, { testCase: testCase, testName: testName }); - } - - //run the tear down - testCase.tearDown(); - - //update results - node.parent.results[testName] = { - result: failed ? "fail" : "pass", - message: error ? error.getMessage() : "Test passed", - type: "test", - name: testName - }; - - if (failed){ - node.parent.results.failed++; - } else { - node.parent.results.passed++; - } - node.parent.results.total++; - - //set timeout not supported in all environments - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._run(); - }, 0); - } else { - this._run(); - } - - }, - - /** - * Runs a single test based on the data provided in the node. - * @param {TestNode} node The TestNode representing the test to run. - * @return {Void} - * @static - * @private - * @name _runTest - */ - _runTest : function (node /*:TestNode*/) /*:Void*/ { - - //get relevant information - var testName /*:String*/ = node.testObject; - var testCase /*:YAHOO.tool.TestCase*/ = node.parent.testObject; - var test /*:Function*/ = testCase[testName]; - - //get the "should" test cases - var shouldIgnore /*:Object*/ = (testCase._should.ignore || {})[testName]; - - //figure out if the test should be ignored or not - if (shouldIgnore){ - - //update results - node.parent.results[testName] = { - result: "ignore", - message: "Test ignored", - type: "test", - name: testName - }; - - node.parent.results.ignored++; - node.parent.results.total++; - - this.fireEvent(this.TEST_IGNORE_EVENT, { testCase: testCase, testName: testName }); - - //some environments don't support setTimeout - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._run(); - }, 0); - } else { - this._run(); - } - - } else { - - //run the setup - testCase.setUp(); - - //now call the body of the test - this._resumeTest(test); - } - - }, - - //------------------------------------------------------------------------- - // Protected Methods - //------------------------------------------------------------------------- - - /* - * Fires events for the TestRunner. This overrides the default fireEvent() - * method from EventProvider to add the type property to the data that is - * passed through on each event call. - * @param {String} type The type of event to fire. - * @param {Object} data (Optional) Data for the event. - * @method fireEvent - * @static - * @protected - */ - fireEvent : function (type /*:String*/, data /*:Object*/) /*:Void*/ { - data = data || {}; - data.type = type; - TestRunner.superclass.fireEvent.call(this, type, data); - }, - - //------------------------------------------------------------------------- - // Public Methods - //------------------------------------------------------------------------- - - /** - * Adds a test suite or test case to the list of test objects to run. - * @param testObject Either a TestCase or a TestSuite that should be run. - * @return {Void} - * @method add - * @static - */ - add : function (testObject /*:Object*/) /*:Void*/ { - this.masterSuite.add(testObject); - }, - - /** - * Removes all test objects from the runner. - * @return {Void} - * @method clear - * @static - */ - clear : function () /*:Void*/ { - this.masterSuite.items = []; - }, - - /** - * Resumes the TestRunner after wait() was called. - * @param {Function} segment The function to run as the rest - * of the haulted test. - * @return {Void} - * @method resume - * @static - */ - resume : function (segment /*:Function*/) /*:Void*/ { - this._resumeTest(segment || function(){}); - }, - - /** - * Runs the test suite. - * @return {Void} - * @method run - * @static - */ - run : function (testObject /*:Object*/) /*:Void*/ { - - //pointer to runner to avoid scope issues - var runner = YAHOO.tool.TestRunner; - - //build the test tree - runner._buildTestTree(); - - //fire the begin event - runner.fireEvent(runner.BEGIN_EVENT); - - //begin the testing - runner._run(); - } - }); - - return new TestRunner(); - -})(); - -YAHOO.namespace("util"); - -//----------------------------------------------------------------------------- -// Assert object -//----------------------------------------------------------------------------- - -/** - * The Assert object provides functions to test JavaScript values against - * known and expected results. Whenever a comparison (assertion) fails, - * an error is thrown. - * - * @namespace YAHOO.util - * @class Assert - * @static - */ -YAHOO.util.Assert = { - - //------------------------------------------------------------------------- - // Generic Assertion Methods - //------------------------------------------------------------------------- - - /** - * Forces an assertion error to occur. - * @param {String} message (Optional) The message to display with the failure. - * @method fail - * @static - */ - fail : function (message /*:String*/) /*:Void*/ { - throw new YAHOO.util.AssertionError(message || "Test force-failed."); - }, - - //------------------------------------------------------------------------- - // Equality Assertion Methods - //------------------------------------------------------------------------- - - /** - * Asserts that a value is equal to another. This uses the double equals sign - * so type cohersion may occur. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areEqual - * @static - */ - areEqual : function (expected /*:Object*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (expected != actual) { - throw new YAHOO.util.ComparisonFailure(message || "Values should be equal.", expected, actual); - } - }, - - /** - * Asserts that a value is not equal to another. This uses the double equals sign - * so type cohersion may occur. - * @param {Object} unexpected The unexpected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areNotEqual - * @static - */ - areNotEqual : function (unexpected /*:Object*/, actual /*:Object*/, - message /*:String*/) /*:Void*/ { - if (unexpected == actual) { - throw new YAHOO.util.UnexpectedValue(message || "Values should not be equal.", unexpected); - } - }, - - /** - * Asserts that a value is not the same as another. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} unexpected The unexpected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areNotSame - * @static - */ - areNotSame : function (unexpected /*:Object*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (unexpected === actual) { - throw new YAHOO.util.UnexpectedValue(message || "Values should not be the same.", unexpected); - } - }, - - /** - * Asserts that a value is the same as another. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areSame - * @static - */ - areSame : function (expected /*:Object*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (expected !== actual) { - throw new YAHOO.util.ComparisonFailure(message || "Values should be the same.", expected, actual); - } - }, - - //------------------------------------------------------------------------- - // Boolean Assertion Methods - //------------------------------------------------------------------------- - - /** - * Asserts that a value is false. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isFalse - * @static - */ - isFalse : function (actual /*:Boolean*/, message /*:String*/) { - if (false !== actual) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be false.", false, actual); - } - }, - - /** - * Asserts that a value is true. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isTrue - * @static - */ - isTrue : function (actual /*:Boolean*/, message /*:String*/) /*:Void*/ { - if (true !== actual) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be true.", true, actual); - } - - }, - - //------------------------------------------------------------------------- - // Special Value Assertion Methods - //------------------------------------------------------------------------- - - /** - * Asserts that a value is not a number. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNaN - * @static - */ - isNaN : function (actual /*:Object*/, message /*:String*/) /*:Void*/{ - if (!isNaN(actual)){ - throw new YAHOO.util.ComparisonFailure(message || "Value should be NaN.", NaN, actual); - } - }, - - /** - * Asserts that a value is not the special NaN value. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotNaN - * @static - */ - isNotNaN : function (actual /*:Object*/, message /*:String*/) /*:Void*/{ - if (isNaN(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Values should not be NaN.", NaN); - } - }, - - /** - * Asserts that a value is not null. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotNull - * @static - */ - isNotNull : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (YAHOO.lang.isNull(actual)) { - throw new YAHOO.util.UnexpectedValue(message || "Values should not be null.", null); - } - }, - - /** - * Asserts that a value is not undefined. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotUndefined - * @static - */ - isNotUndefined : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (YAHOO.lang.isUndefined(actual)) { - throw new YAHOO.util.UnexpectedValue(message || "Value should not be undefined.", undefined); - } - }, - - /** - * Asserts that a value is null. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNull - * @static - */ - isNull : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isNull(actual)) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be null.", null, actual); - } - }, - - /** - * Asserts that a value is undefined. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isUndefined - * @static - */ - isUndefined : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isUndefined(actual)) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be undefined.", undefined, actual); - } - }, - - //-------------------------------------------------------------------------- - // Instance Assertion Methods - //-------------------------------------------------------------------------- - - /** - * Asserts that a value is an array. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isArray - * @static - */ - isArray : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isArray(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be an array.", actual); - } - }, - - /** - * Asserts that a value is a Boolean. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isBoolean - * @static - */ - isBoolean : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isBoolean(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a Boolean.", actual); - } - }, - - /** - * Asserts that a value is a function. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isFunction - * @static - */ - isFunction : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isFunction(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a function.", actual); - } - }, - - /** - * Asserts that a value is an instance of a particular object. This may return - * incorrect results when comparing objects from one frame to constructors in - * another frame. For best results, don't use in a cross-frame manner. - * @param {Function} expected The function that the object should be an instance of. - * @param {Object} actual The object to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isInstanceOf - * @static - */ - isInstanceOf : function (expected /*:Function*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!(actual instanceof expected)){ - throw new YAHOO.util.ComparisonFailure(message || "Value isn't an instance of expected type.", expected, actual); - } - }, - - /** - * Asserts that a value is a number. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNumber - * @static - */ - isNumber : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isNumber(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a number.", actual); - } - }, - - /** - * Asserts that a value is an object. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isObject - * @static - */ - isObject : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isObject(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be an object.", actual); - } - }, - - /** - * Asserts that a value is a string. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isString - * @static - */ - isString : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isString(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a string.", actual); - } - }, - - /** - * Asserts that a value is of a particular type. - * @param {String} expectedType The expected type of the variable. - * @param {Object} actualValue The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isTypeOf - * @static - */ - isTypeOf : function (expectedType /*:String*/, actualValue /*:Object*/, message /*:String*/) /*:Void*/{ - if (typeof actualValue != expectedType){ - throw new YAHOO.util.ComparisonFailure(message || "Value should be of type " + expected + ".", expected, typeof actual); - } - } -}; - -//----------------------------------------------------------------------------- -// Assertion errors -//----------------------------------------------------------------------------- - -/** - * AssertionError is thrown whenever an assertion fails. It provides methods - * to more easily get at error information and also provides a base class - * from which more specific assertion errors can be derived. - * - * @param {String} message The message to display when the error occurs. - * @namespace YAHOO.util - * @class AssertionError - * @extends Error - * @constructor - */ -YAHOO.util.AssertionError = function (message /*:String*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message); - - /* - * Error message. Must be duplicated to ensure browser receives it. - * @type String - * @property message - */ - this.message /*:String*/ = message; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "AssertionError"; -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.AssertionError, Error, { - - /** - * Returns a fully formatted error for an assertion failure. This should - * be overridden by all subclasses to provide specific information. - * @method getMessage - * @return {String} A string describing the error. - */ - getMessage : function () /*:String*/ { - return this.message; - }, - - /** - * Returns a string representation of the error. - * @method toString - * @return {String} A string representation of the error. - */ - toString : function () /*:String*/ { - return this.name + ": " + this.getMessage(); - }, - - /** - * Returns a primitive value version of the error. Same as toString(). - * @method valueOf - * @return {String} A primitive value version of the error. - */ - valueOf : function () /*:String*/ { - return this.toString(); - } - -}); - -/** - * ComparisonFailure is subclass of AssertionError that is thrown whenever - * a comparison between two values fails. It provides mechanisms to retrieve - * both the expected and actual value. - * - * @param {String} message The message to display when the error occurs. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value that caused the assertion to fail. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class ComparisonFailure - * @constructor - */ -YAHOO.util.ComparisonFailure = function (message /*:String*/, expected /*:Object*/, actual /*:Object*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message); - - /** - * The expected value. - * @type Object - * @property expected - */ - this.expected /*:Object*/ = expected; - - /** - * The actual value. - * @type Object - * @property actual - */ - this.actual /*:Object*/ = actual; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "ComparisonFailure"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.ComparisonFailure, YAHOO.util.AssertionError, { - - /** - * Returns a fully formatted error for an assertion failure. This message - * provides information about the expected and actual values. - * @method toString - * @return {String} A string describing the error. - */ - getMessage : function () /*:String*/ { - return this.message + "\nExpected: " + this.expected + " (" + (typeof this.expected) + ")" + - "\nActual:" + this.actual + " (" + (typeof this.actual) + ")"; - } - -}); - -/** - * UnexpectedValue is subclass of AssertionError that is thrown whenever - * a value was unexpected in its scope. This typically means that a test - * was performed to determine that a value was *not* equal to a certain - * value. - * - * @param {String} message The message to display when the error occurs. - * @param {Object} unexpected The unexpected value. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class UnexpectedValue - * @constructor - */ -YAHOO.util.UnexpectedValue = function (message /*:String*/, unexpected /*:Object*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message); - - /** - * The unexpected value. - * @type Object - * @property unexpected - */ - this.unexpected /*:Object*/ = unexpected; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "UnexpectedValue"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.UnexpectedValue, YAHOO.util.AssertionError, { - - /** - * Returns a fully formatted error for an assertion failure. The message - * contains information about the unexpected value that was encountered. - * @method getMessage - * @return {String} A string describing the error. - */ - getMessage : function () /*:String*/ { - return this.message + "\nUnexpected: " + this.unexpected + " (" + (typeof this.unexpected) + ") "; - } - -}); - -/** - * ShouldFail is subclass of AssertionError that is thrown whenever - * a test was expected to fail but did not. - * - * @param {String} message The message to display when the error occurs. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class ShouldFail - * @constructor - */ -YAHOO.util.ShouldFail = function (message /*:String*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message || "This test should fail but didn't."); - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "ShouldFail"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.ShouldFail, YAHOO.util.AssertionError); - -/** - * ShouldError is subclass of AssertionError that is thrown whenever - * a test is expected to throw an error but doesn't. - * - * @param {String} message The message to display when the error occurs. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class ShouldError - * @constructor - */ -YAHOO.util.ShouldError = function (message /*:String*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message || "This test should have thrown an error but didn't."); - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "ShouldError"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.ShouldError, YAHOO.util.AssertionError); - -/** - * UnexpectedError is subclass of AssertionError that is thrown whenever - * an error occurs within the course of a test and the test was not expected - * to throw an error. - * - * @param {Error} cause The unexpected error that caused this error to be - * thrown. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class UnexpectedError - * @constructor - */ -YAHOO.util.UnexpectedError = function (cause /*:Object*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, "Unexpected error: " + cause.message); - - /** - * The unexpected error that occurred. - * @type Error - * @property cause - */ - this.cause /*:Error*/ = cause; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "UnexpectedError"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.UnexpectedError, YAHOO.util.AssertionError); - -//----------------------------------------------------------------------------- -// ArrayAssert object -//----------------------------------------------------------------------------- - -/** - * The ArrayAssert object provides functions to test JavaScript array objects - * for a variety of cases. - * - * @namespace YAHOO.util - * @class ArrayAssert - * @static - */ - -YAHOO.util.ArrayAssert = { - - /** - * Asserts that a value is present in an array. This uses the triple equals - * sign so no type cohersion may occur. - * @param {Object} needle The value that is expected in the array. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method contains - * @static - */ - contains : function (needle /*:Object*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (haystack[i] === needle) { - found = true; - } - } - - if (!found){ - YAHOO.util.Assert.fail(message || "Value (" + needle + ") not found in array."); - } - }, - - /** - * Asserts that a set of values are present in an array. This uses the triple equals - * sign so no type cohersion may occur. For this assertion to pass, all values must - * be found. - * @param {Object[]} needles An array of values that are expected in the array. - * @param {Array} haystack An array of values to check. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method containsItems - * @static - */ - containsItems : function (needles /*:Object[]*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - //begin checking values - for (var i=0; i < needles.length; i++){ - this.contains(needles[i], haystack, message); - } - - if (!found){ - YAHOO.util.Assert.fail(message || "Value not found in array."); - } - }, - - /** - * Asserts that a value matching some condition is present in an array. This uses - * a function to determine a match. - * @param {Function} matcher A function that returns true if the items matches or false if not. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method containsMatch - * @static - */ - containsMatch : function (matcher /*:Function*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - //check for valid matcher - if (typeof matcher != "function"){ - throw new TypeError("ArrayAssert.containsMatch(): First argument must be a function."); - } - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (matcher(haystack[i])) { - found = true; - } - } - - if (!found){ - YAHOO.util.Assert.fail(message || "No match found in array."); - } - }, - - /** - * Asserts that a value is not present in an array. This uses the triple equals - * sign so no type cohersion may occur. - * @param {Object} needle The value that is expected in the array. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method doesNotContain - * @static - */ - doesNotContain : function (needle /*:Object*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (haystack[i] === needle) { - found = true; - } - } - - if (found){ - YAHOO.util.Assert.fail(message || "Value found in array."); - } - }, - - /** - * Asserts that a set of values are not present in an array. This uses the triple equals - * sign so no type cohersion may occur. For this assertion to pass, all values must - * not be found. - * @param {Object[]} needles An array of values that are not expected in the array. - * @param {Array} haystack An array of values to check. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method doesNotContainItems - * @static - */ - doesNotContainItems : function (needles /*:Object[]*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - for (var i=0; i < needles.length; i++){ - this.doesNotContain(needles[i], haystack, message); - } - - }, - - /** - * Asserts that no values matching a condition are present in an array. This uses - * a function to determine a match. - * @param {Function} matcher A function that returns true if the items matches or false if not. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method doesNotContainMatch - * @static - */ - doesNotContainMatch : function (matcher /*:Function*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - //check for valid matcher - if (typeof matcher != "function"){ - throw new TypeError("ArrayAssert.doesNotContainMatch(): First argument must be a function."); - } - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (matcher(haystack[i])) { - found = true; - } - } - - if (found){ - YAHOO.util.Assert.fail(message || "Value found in array."); - } - }, - - /** - * Asserts that the given value is contained in an array at the specified index. - * This uses the triple equals sign so no type cohersion will occur. - * @param {Object} needle The value to look for. - * @param {Array} haystack The array to search in. - * @param {int} index The index at which the value should exist. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method indexOf - * @static - */ - indexOf : function (needle /*:Object*/, haystack /*:Array*/, index /*:int*/, message /*:String*/) /*:Void*/ { - - //try to find the value in the array - for (var i=0; i < haystack.length; i++){ - if (haystack[i] === needle){ - YAHOO.util.Assert.areEqual(index, i, message || "Value exists at index " + i + " but should be at index " + index + "."); - return; - } - } - - //if it makes it here, it wasn't found at all - YAHOO.util.Assert.fail(message || "Value doesn't exist in array."); - }, - - /** - * Asserts that the values in an array are equal, and in the same position, - * as values in another array. This uses the double equals sign - * so type cohersion may occur. Note that the array objects themselves - * need not be the same for this test to pass. - * @param {Array} expected An array of the expected values. - * @param {Array} actual Any array of the actual values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method itemsAreEqual - * @static - */ - itemsAreEqual : function (expected /*:Array*/, actual /*:Array*/, - message /*:String*/) /*:Void*/ { - - //one may be longer than the other, so get the maximum length - var len /*:int*/ = Math.max(expected.length, actual.length); - - //begin checking values - for (var i=0; i < len; i++){ - YAHOO.util.Assert.areEqual(expected[i], actual[i], message || - "Values in position " + i + " are not equal."); - } - }, - - /** - * Asserts that the values in an array are equivalent, and in the same position, - * as values in another array. This uses a function to determine if the values - * are equivalent. Note that the array objects themselves - * need not be the same for this test to pass. - * @param {Array} expected An array of the expected values. - * @param {Array} actual Any array of the actual values. - * @param {Function} comparator A function that returns true if the values are equivalent - * or false if not. - * @param {String} message (Optional) The message to display if the assertion fails. - * @return {Void} - * @method itemsAreEquivalent - * @static - */ - itemsAreEquivalent : function (expected /*:Array*/, actual /*:Array*/, - comparator /*:Function*/, message /*:String*/) /*:Void*/ { - - //make sure the comparator is valid - if (typeof comparator != "function"){ - throw new TypeError("ArrayAssert.itemsAreEquivalent(): Third argument must be a function."); - } - - //one may be longer than the other, so get the maximum length - var len /*:int*/ = Math.max(expected.length, actual.length); - - //begin checking values - for (var i=0; i < len; i++){ - if (!comparator(expected[i], actual[i])){ - throw new YAHOO.util.ComparisonFailure(message || "Values in position " + i + " are not equivalent.", expected[i], actual[i]); - } - } - }, - - /** - * Asserts that an array is empty. - * @param {Array} actual The array to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isEmpty - * @static - */ - isEmpty : function (actual /*:Array*/, message /*:String*/) /*:Void*/ { - if (actual.length > 0){ - YAHOO.util.Assert.fail(message || "Array should be empty."); - } - }, - - /** - * Asserts that an array is not empty. - * @param {Array} actual The array to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotEmpty - * @static - */ - isNotEmpty : function (actual /*:Array*/, message /*:String*/) /*:Void*/ { - if (actual.length === 0){ - YAHOO.util.Assert.fail(message || "Array should not be empty."); - } - }, - - /** - * Asserts that the values in an array are the same, and in the same position, - * as values in another array. This uses the triple equals sign - * so no type cohersion will occur. Note that the array objects themselves - * need not be the same for this test to pass. - * @param {Array} expected An array of the expected values. - * @param {Array} actual Any array of the actual values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method itemsAreSame - * @static - */ - itemsAreSame : function (expected /*:Array*/, actual /*:Array*/, - message /*:String*/) /*:Void*/ { - - //one may be longer than the other, so get the maximum length - var len /*:int*/ = Math.max(expected.length, actual.length); - - //begin checking values - for (var i=0; i < len; i++){ - YAHOO.util.Assert.areSame(expected[i], actual[i], - message || "Values in position " + i + " are not the same."); - } - }, - - /** - * Asserts that the given value is contained in an array at the specified index, - * starting from the back of the array. - * This uses the triple equals sign so no type cohersion will occur. - * @param {Object} needle The value to look for. - * @param {Array} haystack The array to search in. - * @param {int} index The index at which the value should exist. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method lastIndexOf - * @static - */ - lastIndexOf : function (needle /*:Object*/, haystack /*:Array*/, index /*:int*/, message /*:String*/) /*:Void*/ { - - //try to find the value in the array - for (var i=haystack.length; i >= 0; i--){ - if (haystack[i] === needle){ - YAHOO.util.Assert.areEqual(index, i, message || "Value exists at index " + i + " but should be at index " + index + "."); - return; - } - } - - //if it makes it here, it wasn't found at all - YAHOO.util.Assert.fail(message || "Value doesn't exist in array."); - } - -}; - -YAHOO.namespace("util"); - - -//----------------------------------------------------------------------------- -// ObjectAssert object -//----------------------------------------------------------------------------- - -/** - * The ObjectAssert object provides functions to test JavaScript objects - * for a variety of cases. - * - * @namespace YAHOO.util - * @class ObjectAssert - * @static - */ -YAHOO.util.ObjectAssert = { - - /** - * Asserts that all properties in the object exist in another object. - * @param {Object} expected An object with the expected properties. - * @param {Object} actual An object with the actual properties. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method propertiesAreEqual - * @static - */ - propertiesAreEqual : function (expected /*:Object*/, actual /*:Object*/, - message /*:String*/) /*:Void*/ { - - //get all properties in the object - var properties /*:Array*/ = []; - for (var property in expected){ - properties.push(property); - } - - //see if the properties are in the expected object - for (var i=0; i < properties.length; i++){ - YAHOO.util.Assert.isNotUndefined(actual[properties[i]], message || - "Property'" + properties[i] + "' expected."); - } - - }, - - /** - * Asserts that an object has a property with the given name. - * @param {String} propertyName The name of the property to test. - * @param {Object} object The object to search. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method hasProperty - * @static - */ - hasProperty : function (propertyName /*:String*/, object /*:Object*/, message /*:String*/) /*:Void*/ { - if (YAHOO.lang.isUndefined(object[propertyName])){ - YAHOO.util.Assert.fail(message || - "Property " + propertyName + " not found on object."); - } - }, - - /** - * Asserts that a property with the given name exists on an object instance (not on its prototype). - * @param {String} propertyName The name of the property to test. - * @param {Object} object The object to search. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method hasProperty - * @static - */ - hasOwnProperty : function (propertyName /*:String*/, object /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.hasOwnProperty(object, propertyName)){ - YAHOO.util.Assert.fail(message || - "Property " + propertyName + " not found on object instance."); - } - } -}; - -//----------------------------------------------------------------------------- -// DateAssert object -//----------------------------------------------------------------------------- - -/** - * The DateAssert object provides functions to test JavaScript Date objects - * for a variety of cases. - * - * @namespace YAHOO.util - * @class DateAssert - * @static - */ - -YAHOO.util.DateAssert = { - - /** - * Asserts that a date's month, day, and year are equal to another date's. - * @param {Date} expected The expected date. - * @param {Date} actual The actual date to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areEqual - * @static - */ - datesAreEqual : function (expected /*:Date*/, actual /*:Date*/, message /*:String*/){ - if (expected instanceof Date && actual instanceof Date){ - YAHOO.util.Assert.areEqual(expected.getFullYear(), actual.getFullYear(), message || "Years should be equal."); - YAHOO.util.Assert.areEqual(expected.getMonth(), actual.getMonth(), message || "Months should be equal."); - YAHOO.util.Assert.areEqual(expected.getDate(), actual.getDate(), message || "Day of month should be equal."); - } else { - throw new TypeError("DateAssert.datesAreEqual(): Expected and actual values must be Date objects."); - } - }, - - /** - * Asserts that a date's hour, minutes, and seconds are equal to another date's. - * @param {Date} expected The expected date. - * @param {Date} actual The actual date to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areEqual - * @static - */ - timesAreEqual : function (expected /*:Date*/, actual /*:Date*/, message /*:String*/){ - if (expected instanceof Date && actual instanceof Date){ - YAHOO.util.Assert.areEqual(expected.getHours(), actual.getHours(), message || "Hours should be equal."); - YAHOO.util.Assert.areEqual(expected.getMinutes(), actual.getMinutes(), message || "Minutes should be equal."); - YAHOO.util.Assert.areEqual(expected.getSeconds(), actual.getSeconds(), message || "Seconds should be equal."); - } else { - throw new TypeError("DateAssert.timesAreEqual(): Expected and actual values must be Date objects."); - } - } - -}; - -YAHOO.namespace("util"); - -/** - * The UserAction object provides functions that simulate events occurring in - * the browser. Since these are simulated events, they do not behave exactly - * as regular, user-initiated events do, but can be used to test simple - * user interactions safely. - * - * @namespace YAHOO.util - * @class UserAction - * @static - */ -YAHOO.util.UserAction = { - - //-------------------------------------------------------------------------- - // Generic event methods - //-------------------------------------------------------------------------- - - /** - * Simulates a key event using the given event information to populate - * the generated event object. This method does browser-equalizing - * calculations to account for differences in the DOM and IE event models - * as well as different browser quirks. Note: keydown causes Safari 2.x to - * crash. - * @method simulateKeyEvent - * @private - * @static - * @param {HTMLElement} target The target of the given event. - * @param {String} type The type of event to fire. This can be any one of - * the following: keyup, keydown, and keypress. - * @param {Boolean} bubbles (Optional) Indicates if the event can be - * bubbled up. DOM Level 3 specifies that all key events bubble by - * default. The default is true. - * @param {Boolean} cancelable (Optional) Indicates if the event can be - * canceled using preventDefault(). DOM Level 3 specifies that all - * key events can be cancelled. The default - * is true. - * @param {Window} view (Optional) The view containing the target. This is - * typically the window object. The default is window. - * @param {Boolean} ctrlKey (Optional) Indicates if one of the CTRL keys - * is pressed while the event is firing. The default is false. - * @param {Boolean} altKey (Optional) Indicates if one of the ALT keys - * is pressed while the event is firing. The default is false. - * @param {Boolean} shiftKey (Optional) Indicates if one of the SHIFT keys - * is pressed while the event is firing. The default is false. - * @param {Boolean} metaKey (Optional) Indicates if one of the META keys - * is pressed while the event is firing. The default is false. - * @param {int} keyCode (Optional) The code for the key that is in use. - * The default is 0. - * @param {int} charCode (Optional) The Unicode code for the character - * associated with the key being used. The default is 0. - */ - simulateKeyEvent : function (target /*:HTMLElement*/, type /*:String*/, - bubbles /*:Boolean*/, cancelable /*:Boolean*/, - view /*:Window*/, - ctrlKey /*:Boolean*/, altKey /*:Boolean*/, - shiftKey /*:Boolean*/, metaKey /*:Boolean*/, - keyCode /*:int*/, charCode /*:int*/) /*:Void*/ - { - //check target - target = YAHOO.util.Dom.get(target); - if (!target){ - throw new Error("simulateKeyEvent(): Invalid target."); - } - - //check event type - if (YAHOO.lang.isString(type)){ - type = type.toLowerCase(); - switch(type){ - case "keyup": - case "keydown": - case "keypress": - break; - case "textevent": //DOM Level 3 - type = "keypress"; - break; - // @TODO was the fallthrough intentional, if so throw error - default: - throw new Error("simulateKeyEvent(): Event type '" + type + "' not supported."); - } - } else { - throw new Error("simulateKeyEvent(): Event type must be a string."); - } - - //setup default values - if (!YAHOO.lang.isBoolean(bubbles)){ - bubbles = true; //all key events bubble - } - if (!YAHOO.lang.isBoolean(cancelable)){ - cancelable = true; //all key events can be cancelled - } - if (!YAHOO.lang.isObject(view)){ - view = window; //view is typically window - } - if (!YAHOO.lang.isBoolean(ctrlKey)){ - ctrlKey = false; - } - if (!YAHOO.lang.isBoolean(altKey)){ - altKey = false; - } - if (!YAHOO.lang.isBoolean(shiftKey)){ - shiftKey = false; - } - if (!YAHOO.lang.isBoolean(metaKey)){ - metaKey = false; - } - if (!YAHOO.lang.isNumber(keyCode)){ - keyCode = 0; - } - if (!YAHOO.lang.isNumber(charCode)){ - charCode = 0; - } - - //try to create a mouse event - var customEvent /*:MouseEvent*/ = null; - - //check for DOM-compliant browsers first - if (YAHOO.lang.isFunction(document.createEvent)){ - - try { - - //try to create key event - customEvent = document.createEvent("KeyEvents"); - - /* - * Interesting problem: Firefox implemented a non-standard - * version of initKeyEvent() based on DOM Level 2 specs. - * Key event was removed from DOM Level 2 and re-introduced - * in DOM Level 3 with a different interface. Firefox is the - * only browser with any implementation of Key Events, so for - * now, assume it's Firefox if the above line doesn't error. - */ - //TODO: Decipher between Firefox's implementation and a correct one. - customEvent.initKeyEvent(type, bubbles, cancelable, view, ctrlKey, - altKey, shiftKey, metaKey, keyCode, charCode); - - } catch (ex /*:Error*/){ - - /* - * If it got here, that means key events aren't officially supported. - * Safari/WebKit is a real problem now. WebKit 522 won't let you - * set keyCode, charCode, or other properties if you use a - * UIEvent, so we first must try to create a generic event. The - * fun part is that this will throw an error on Safari 2.x. The - * end result is that we need another try...catch statement just to - * deal with this mess. - */ - try { - - //try to create generic event - will fail in Safari 2.x - customEvent = document.createEvent("Events"); - - } catch (uierror /*:Error*/){ - - //the above failed, so create a UIEvent for Safari 2.x - customEvent = document.createEvent("UIEvents"); - - } finally { - - customEvent.initEvent(type, bubbles, cancelable); - - //initialize - customEvent.view = view; - customEvent.altKey = altKey; - customEvent.ctrlKey = ctrlKey; - customEvent.shiftKey = shiftKey; - customEvent.metaKey = metaKey; - customEvent.keyCode = keyCode; - customEvent.charCode = charCode; - - } - - } - - //fire the event - target.dispatchEvent(customEvent); - - } else if (YAHOO.lang.isObject(document.createEventObject)){ //IE - - //create an IE event object - customEvent = document.createEventObject(); - - //assign available properties - customEvent.bubbles = bubbles; - customEvent.cancelable = cancelable; - customEvent.view = view; - customEvent.ctrlKey = ctrlKey; - customEvent.altKey = altKey; - customEvent.shiftKey = shiftKey; - customEvent.metaKey = metaKey; - - /* - * IE doesn't support charCode explicitly. CharCode should - * take precedence over any keyCode value for accurate - * representation. - */ - customEvent.keyCode = (charCode > 0) ? charCode : keyCode; - - //fire the event - target.fireEvent("on" + type, customEvent); - - } else { - throw new Error("simulateKeyEvent(): No event simulation framework present."); - } - }, - - /** - * Simulates a mouse event using the given event information to populate - * the generated event object. This method does browser-equalizing - * calculations to account for differences in the DOM and IE event models - * as well as different browser quirks. - * @method simulateMouseEvent - * @private - * @static - * @param {HTMLElement} target The target of the given event. - * @param {String} type The type of event to fire. This can be any one of - * the following: click, dblclick, mousedown, mouseup, mouseout, - * mouseover, and mousemove. - * @param {Boolean} bubbles (Optional) Indicates if the event can be - * bubbled up. DOM Level 2 specifies that all mouse events bubble by - * default. The default is true. - * @param {Boolean} cancelable (Optional) Indicates if the event can be - * canceled using preventDefault(). DOM Level 2 specifies that all - * mouse events except mousemove can be cancelled. The default - * is true for all events except mousemove, for which the default - * is false. - * @param {Window} view (Optional) The view containing the target. This is - * typically the window object. The default is window. - * @param {int} detail (Optional) The number of times the mouse button has - * been used. The default value is 1. - * @param {int} screenX (Optional) The x-coordinate on the screen at which - * point the event occured. The default is 0. - * @param {int} screenY (Optional) The y-coordinate on the screen at which - * point the event occured. The default is 0. - * @param {int} clientX (Optional) The x-coordinate on the client at which - * point the event occured. The default is 0. - * @param {int} clientY (Optional) The y-coordinate on the client at which - * point the event occured. The default is 0. - * @param {Boolean} ctrlKey (Optional) Indicates if one of the CTRL keys - * is pressed while the event is firing. The default is false. - * @param {Boolean} altKey (Optional) Indicates if one of the ALT keys - * is pressed while the event is firing. The default is false. - * @param {Boolean} shiftKey (Optional) Indicates if one of the SHIFT keys - * is pressed while the event is firing. The default is false. - * @param {Boolean} metaKey (Optional) Indicates if one of the META keys - * is pressed while the event is firing. The default is false. - * @param {int} button (Optional) The button being pressed while the event - * is executing. The value should be 0 for the primary mouse button - * (typically the left button), 1 for the terciary mouse button - * (typically the middle button), and 2 for the secondary mouse button - * (typically the right button). The default is 0. - * @param {HTMLElement} relatedTarget (Optional) For mouseout events, - * this is the element that the mouse has moved to. For mouseover - * events, this is the element that the mouse has moved from. This - * argument is ignored for all other events. The default is null. - */ - simulateMouseEvent : function (target /*:HTMLElement*/, type /*:String*/, - bubbles /*:Boolean*/, cancelable /*:Boolean*/, - view /*:Window*/, detail /*:int*/, - screenX /*:int*/, screenY /*:int*/, - clientX /*:int*/, clientY /*:int*/, - ctrlKey /*:Boolean*/, altKey /*:Boolean*/, - shiftKey /*:Boolean*/, metaKey /*:Boolean*/, - button /*:int*/, relatedTarget /*:HTMLElement*/) /*:Void*/ - { - - //check target - target = YAHOO.util.Dom.get(target); - if (!target){ - throw new Error("simulateMouseEvent(): Invalid target."); - } - - //check event type - if (YAHOO.lang.isString(type)){ - type = type.toLowerCase(); - switch(type){ - case "mouseover": - case "mouseout": - case "mousedown": - case "mouseup": - case "click": - case "dblclick": - case "mousemove": - break; - default: - throw new Error("simulateMouseEvent(): Event type '" + type + "' not supported."); - } - } else { - throw new Error("simulateMouseEvent(): Event type must be a string."); - } - - //setup default values - if (!YAHOO.lang.isBoolean(bubbles)){ - bubbles = true; //all mouse events bubble - } - if (!YAHOO.lang.isBoolean(cancelable)){ - cancelable = (type != "mousemove"); //mousemove is the only one that can't be cancelled - } - if (!YAHOO.lang.isObject(view)){ - view = window; //view is typically window - } - if (!YAHOO.lang.isNumber(detail)){ - detail = 1; //number of mouse clicks must be at least one - } - if (!YAHOO.lang.isNumber(screenX)){ - screenX = 0; - } - if (!YAHOO.lang.isNumber(screenY)){ - screenY = 0; - } - if (!YAHOO.lang.isNumber(clientX)){ - clientX = 0; - } - if (!YAHOO.lang.isNumber(clientY)){ - clientY = 0; - } - if (!YAHOO.lang.isBoolean(ctrlKey)){ - ctrlKey = false; - } - if (!YAHOO.lang.isBoolean(altKey)){ - altKey = false; - } - if (!YAHOO.lang.isBoolean(shiftKey)){ - shiftKey = false; - } - if (!YAHOO.lang.isBoolean(metaKey)){ - metaKey = false; - } - if (!YAHOO.lang.isNumber(button)){ - button = 0; - } - - //try to create a mouse event - var customEvent /*:MouseEvent*/ = null; - - //check for DOM-compliant browsers first - if (YAHOO.lang.isFunction(document.createEvent)){ - - customEvent = document.createEvent("MouseEvents"); - - //Safari 2.x (WebKit 418) still doesn't implement initMouseEvent() - if (customEvent.initMouseEvent){ - customEvent.initMouseEvent(type, bubbles, cancelable, view, detail, - screenX, screenY, clientX, clientY, - ctrlKey, altKey, shiftKey, metaKey, - button, relatedTarget); - } else { //Safari - - //the closest thing available in Safari 2.x is UIEvents - customEvent = document.createEvent("UIEvents"); - customEvent.initEvent(type, bubbles, cancelable); - customEvent.view = view; - customEvent.detail = detail; - customEvent.screenX = screenX; - customEvent.screenY = screenY; - customEvent.clientX = clientX; - customEvent.clientY = clientY; - customEvent.ctrlKey = ctrlKey; - customEvent.altKey = altKey; - customEvent.metaKey = metaKey; - customEvent.shiftKey = shiftKey; - customEvent.button = button; - customEvent.relatedTarget = relatedTarget; - } - - /* - * Check to see if relatedTarget has been assigned. Firefox - * versions less than 2.0 don't allow it to be assigned via - * initMouseEvent() and the property is readonly after event - * creation, so in order to keep YAHOO.util.getRelatedTarget() - * working, assign to the IE proprietary toElement property - * for mouseout event and fromElement property for mouseover - * event. - */ - if (relatedTarget && !customEvent.relatedTarget){ - if (type == "mouseout"){ - customEvent.toElement = relatedTarget; - } else if (type == "mouseover"){ - customEvent.fromElement = relatedTarget; - } - } - - //fire the event - target.dispatchEvent(customEvent); - - } else if (YAHOO.lang.isObject(document.createEventObject)){ //IE - - //create an IE event object - customEvent = document.createEventObject(); - - //assign available properties - customEvent.bubbles = bubbles; - customEvent.cancelable = cancelable; - customEvent.view = view; - customEvent.detail = detail; - customEvent.screenX = screenX; - customEvent.screenY = screenY; - customEvent.clientX = clientX; - customEvent.clientY = clientY; - customEvent.ctrlKey = ctrlKey; - customEvent.altKey = altKey; - customEvent.metaKey = metaKey; - customEvent.shiftKey = shiftKey; - - //fix button property for IE's wacky implementation - switch(button){ - case 0: - customEvent.button = 1; - break; - case 1: - customEvent.button = 4; - break; - case 2: - //leave as is - break; - default: - customEvent.button = 0; - } - - /* - * Have to use relatedTarget because IE won't allow assignment - * to toElement or fromElement on generic events. This keeps - * YAHOO.util.customEvent.getRelatedTarget() functional. - */ - customEvent.relatedTarget = relatedTarget; - - //fire the event - target.fireEvent("on" + type, customEvent); - - } else { - throw new Error("simulateMouseEvent(): No event simulation framework present."); - } - }, - - //-------------------------------------------------------------------------- - // Mouse events - //-------------------------------------------------------------------------- - - /** - * Simulates a mouse event on a particular element. - * @param {HTMLElement} target The element to click on. - * @param {String} type The type of event to fire. This can be any one of - * the following: click, dblclick, mousedown, mouseup, mouseout, - * mouseover, and mousemove. - * @param {Object} options Additional event options (use DOM standard names). - * @method mouseEvent - * @static - */ - fireMouseEvent : function (target /*:HTMLElement*/, type /*:String*/, - options /*:Object*/) /*:Void*/ - { - options = options || {}; - this.simulateMouseEvent(target, type, options.bubbles, - options.cancelable, options.view, options.detail, options.screenX, - options.screenY, options.clientX, options.clientY, options.ctrlKey, - options.altKey, options.shiftKey, options.metaKey, options.button, - options.relatedTarget); - }, - - /** - * Simulates a click on a particular element. - * @param {HTMLElement} target The element to click on. - * @param {Object} options Additional event options (use DOM standard names). - * @method click - * @static - */ - click : function (target /*:HTMLElement*/, options /*:Object*/) /*:Void*/ { - this.fireMouseEvent(target, "click", options); - }, - - /** - * Simulates a double click on a particular element. - * @param {HTMLElement} target The element to double click on. - * @param {Object} options Additional event options (use DOM standard names). - * @method dblclick - * @static - */ - dblclick : function (target /*:HTMLElement*/, options /*:Object*/) /*:Void*/ { - this.fireMouseEvent( target, "dblclick", options); - }, - - /** - * Simulates a mousedown on a particular element. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method mousedown - * @static - */ - mousedown : function (target /*:HTMLElement*/, options /*Object*/) /*:Void*/ { - this.fireMouseEvent(target, "mousedown", options); - }, - - /** - * Simulates a mousemove on a particular element. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method mousemove - * @static - */ - mousemove : function (target /*:HTMLElement*/, options /*Object*/) /*:Void*/ { - this.fireMouseEvent(target, "mousemove", options); - }, - - /** - * Simulates a mouseout event on a particular element. Use "relatedTarget" - * on the options object to specify where the mouse moved to. - * Quirks: Firefox less than 2.0 doesn't set relatedTarget properly, so - * toElement is assigned in its place. IE doesn't allow toElement to be - * be assigned, so relatedTarget is assigned in its place. Both of these - * concessions allow YAHOO.util.Event.getRelatedTarget() to work correctly - * in both browsers. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method mouseout - * @static - */ - mouseout : function (target /*:HTMLElement*/, options /*Object*/) /*:Void*/ { - this.fireMouseEvent(target, "mouseout", options); - }, - - /** - * Simulates a mouseover event on a particular element. Use "relatedTarget" - * on the options object to specify where the mouse moved from. - * Quirks: Firefox less than 2.0 doesn't set relatedTarget properly, so - * fromElement is assigned in its place. IE doesn't allow fromElement to be - * be assigned, so relatedTarget is assigned in its place. Both of these - * concessions allow YAHOO.util.Event.getRelatedTarget() to work correctly - * in both browsers. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method mouseover - * @static - */ - mouseover : function (target /*:HTMLElement*/, options /*Object*/) /*:Void*/ { - this.fireMouseEvent(target, "mouseover", options); - }, - - /** - * Simulates a mouseup on a particular element. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method mouseup - * @static - */ - mouseup : function (target /*:HTMLElement*/, options /*Object*/) /*:Void*/ { - this.fireMouseEvent(target, "mouseup", options); - }, - - //-------------------------------------------------------------------------- - // Key events - //-------------------------------------------------------------------------- - - /** - * Fires an event that normally would be fired by the keyboard (keyup, - * keydown, keypress). Make sure to specify either keyCode or charCode as - * an option. - * @private - * @param {String} type The type of event ("keyup", "keydown" or "keypress"). - * @param {HTMLElement} target The target of the event. - * @param {Object} options Options for the event. Either keyCode or charCode - * are required. - * @method fireKeyEvent - * @static - */ - fireKeyEvent : function (type /*:String*/, target /*:HTMLElement*/, - options /*:Object*/) /*:Void*/ - { - options = options || {}; - this.simulateKeyEvent(target, type, options.bubbles, - options.cancelable, options.view, options.ctrlKey, - options.altKey, options.shiftKey, options.metaKey, - options.keyCode, options.charCode); - }, - - /** - * Simulates a keydown event on a particular element. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method keydown - * @static - */ - keydown : function (target /*:HTMLElement*/, options /*:Object*/) /*:Void*/ { - this.fireKeyEvent("keydown", target, options); - }, - - /** - * Simulates a keypress on a particular element. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method keypress - * @static - */ - keypress : function (target /*:HTMLElement*/, options /*:Object*/) /*:Void*/ { - this.fireKeyEvent("keypress", target, options); - }, - - /** - * Simulates a keyup event on a particular element. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method keyup - * @static - */ - keyup : function (target /*:HTMLElement*/, options /*Object*/) /*:Void*/ { - this.fireKeyEvent("keyup", target, options); - } - - -}; - -YAHOO.namespace("tool"); - -//----------------------------------------------------------------------------- -// TestManager object -//----------------------------------------------------------------------------- - -/** - * Runs pages containing test suite definitions. - * @namespace YAHOO.tool - * @class TestManager - * @static - */ -YAHOO.tool.TestManager = { - - /** - * Constant for the testpagebegin custom event - * @property TEST_PAGE_BEGIN_EVENT - * @static - * @type string - * @final - */ - TEST_PAGE_BEGIN_EVENT /*:String*/ : "testpagebegin", - - /** - * Constant for the testpagecomplete custom event - * @property TEST_PAGE_COMPLETE_EVENT - * @static - * @type string - * @final - */ - TEST_PAGE_COMPLETE_EVENT /*:String*/ : "testpagecomplete", - - /** - * Constant for the testmanagerbegin custom event - * @property TEST_MANAGER_BEGIN_EVENT - * @static - * @type string - * @final - */ - TEST_MANAGER_BEGIN_EVENT /*:String*/ : "testmanagerbegin", - - /** - * Constant for the testmanagercomplete custom event - * @property TEST_MANAGER_COMPLETE_EVENT - * @static - * @type string - * @final - */ - TEST_MANAGER_COMPLETE_EVENT /*:String*/ : "testmanagercomplete", - - //------------------------------------------------------------------------- - // Private Properties - //------------------------------------------------------------------------- - - - /** - * The URL of the page currently being executed. - * @type String - * @private - * @property _curPage - * @static - */ - _curPage /*:String*/ : null, - - /** - * The frame used to load and run tests. - * @type Window - * @private - * @property _frame - * @static - */ - _frame /*:Window*/ : null, - - /** - * The logger used to output results from the various tests. - * @type YAHOO.tool.TestLogger - * @private - * @property _logger - * @static - */ - _logger : null, - - /** - * The timeout ID for the next iteration through the tests. - * @type int - * @private - * @property _timeoutId - * @static - */ - _timeoutId /*:int*/ : 0, - - /** - * Array of pages to load. - * @type String[] - * @private - * @property _pages - * @static - */ - _pages /*:String[]*/ : [], - - /** - * Aggregated results - * @type Object - * @private - * @property _results - * @static - */ - _results: null, - - //------------------------------------------------------------------------- - // Private Methods - //------------------------------------------------------------------------- - - /** - * Handles TestRunner.COMPLETE_EVENT, storing the results and beginning - * the loop again. - * @param {Object} data Data about the event. - * @return {Void} - * @private - * @static - */ - _handleTestRunnerComplete : function (data /*:Object*/) /*:Void*/ { - - this.fireEvent(this.TEST_PAGE_COMPLETE_EVENT, { - page: this._curPage, - results: data.results - }); - - //save results - //this._results[this.curPage] = data.results; - - //process 'em - this._processResults(this._curPage, data.results); - - this._logger.clearTestRunner(); - - //if there's more to do, set a timeout to begin again - if (this._pages.length){ - this._timeoutId = setTimeout(function(){ - YAHOO.tool.TestManager._run(); - }, 1000); - } else { - this.fireEvent(this.TEST_MANAGER_COMPLETE_EVENT, this._results); - } - }, - - /** - * Processes the results of a test page run, outputting log messages - * for failed tests. - * @return {Void} - * @private - * @static - */ - _processResults : function (page /*:String*/, results /*:Object*/) /*:Void*/ { - - var r = this._results; - - r.passed += results.passed; - r.failed += results.failed; - r.ignored += results.ignored; - r.total += results.total; - - if (results.failed){ - r.failedPages.push(page); - } else { - r.passedPages.push(page); - } - - results.name = page; - results.type = "page"; - - r[page] = results; - }, - - /** - * Loads the next test page into the iframe. - * @return {Void} - * @static - * @private - */ - _run : function () /*:Void*/ { - - //set the current page - this._curPage = this._pages.shift(); - - this.fireEvent(this.TEST_PAGE_BEGIN_EVENT, this._curPage); - - //load the frame - destroy history in case there are other iframes that - //need testing - this._frame.location.replace(this._curPage); - - }, - - //------------------------------------------------------------------------- - // Public Methods - //------------------------------------------------------------------------- - - /** - * Signals that a test page has been loaded. This should be called from - * within the test page itself to notify the TestManager that it is ready. - * @return {Void} - * @static - */ - load : function () /*:Void*/ { - if (parent.YAHOO.tool.TestManager !== this){ - parent.YAHOO.tool.TestManager.load(); - } else { - - if (this._frame) { - //assign event handling - var TestRunner = this._frame.YAHOO.tool.TestRunner; - - this._logger.setTestRunner(TestRunner); - TestRunner.subscribe(TestRunner.COMPLETE_EVENT, this._handleTestRunnerComplete, this, true); - - //run it - TestRunner.run(); - } - } - }, - - /** - * Sets the pages to be loaded. - * @param {String[]} pages An array of URLs to load. - * @return {Void} - * @static - */ - setPages : function (pages /*:String[]*/) /*:Void*/ { - this._pages = pages; - }, - - /** - * Begins the process of running the tests. - * @return {Void} - * @static - */ - start : function () /*:Void*/ { - - if (!this._initialized) { - - /** - * Fires when loading a test page - * @event testpagebegin - * @param curPage {string} the page being loaded - * @static - */ - this.createEvent(this.TEST_PAGE_BEGIN_EVENT); - - /** - * Fires when a test page is complete - * @event testpagecomplete - * @param obj {page: string, results: object} the name of the - * page that was loaded, and the test suite results - * @static - */ - this.createEvent(this.TEST_PAGE_COMPLETE_EVENT); - - /** - * Fires when the test manager starts running all test pages - * @event testmanagerbegin - * @static - */ - this.createEvent(this.TEST_MANAGER_BEGIN_EVENT); - - /** - * Fires when the test manager finishes running all test pages. External - * test runners should subscribe to this event in order to get the - * aggregated test results. - * @event testmanagercomplete - * @param obj { pages_passed: int, pages_failed: int, tests_passed: int - * tests_failed: int, passed: string[], failed: string[], - * page_results: {} } - * @static - */ - this.createEvent(this.TEST_MANAGER_COMPLETE_EVENT); - - //create iframe if not already available - if (!this._frame){ - var frame /*:HTMLElement*/ = document.createElement("iframe"); - frame.style.visibility = "hidden"; - frame.style.position = "absolute"; - document.body.appendChild(frame); - this._frame = frame.contentWindow || frame.contentDocument.ownerWindow; - } - - //create test logger if not already available - if (!this._logger){ - this._logger = new YAHOO.tool.TestLogger(); - } - - this._initialized = true; - } - - - // reset the results cache - this._results = { - - passed: 0, - failed: 0, - ignored: 0, - total: 0, - type: "report", - name: "YUI Test Results", - failedPages:[], - passedPages:[] - /* - // number of pages that pass - pages_passed: 0, - // number of pages that fail - pages_failed: 0, - // total number of tests passed - tests_passed: 0, - // total number of tests failed - tests_failed: 0, - // array of pages that passed - passed: [], - // array of pages that failed - failed: [], - // map of full results for each page - page_results: {}*/ - }; - - this.fireEvent(this.TEST_MANAGER_BEGIN_EVENT, null); - this._run(); - - }, - - /** - * Stops the execution of tests. - * @return {Void} - * @static - */ - stop : function () /*:Void*/ { - clearTimeout(this._timeoutId); - } - -}; - -YAHOO.lang.augmentObject(YAHOO.tool.TestManager, YAHOO.util.EventProvider.prototype); - - -YAHOO.namespace("tool"); - -//----------------------------------------------------------------------------- -// TestLogger object -//----------------------------------------------------------------------------- - -/** - * Displays test execution progress and results, providing filters based on - * different key events. - * @namespace YAHOO.tool - * @class TestLogger - * @constructor - * @param {HTMLElement} element (Optional) The element to create the logger in. - * @param {Object} config (Optional) Configuration options for the logger. - */ -YAHOO.tool.TestLogger = function (element, config) { - YAHOO.tool.TestLogger.superclass.constructor.call(this, element, config); - this.init(); -}; - -YAHOO.lang.extend(YAHOO.tool.TestLogger, YAHOO.widget.LogReader, { - - footerEnabled : true, - newestOnTop : false, - - /** - * Formats message string to HTML for output to console. - * @private - * @method formatMsg - * @param oLogMsg {Object} Log message object. - * @return {String} HTML-formatted message for output to console. - */ - formatMsg : function(message /*:Object*/) { - - var category /*:String*/ = message.category; - var text /*:String*/ = this.html2Text(message.msg); - - return "<pre><p><span class=\"" + category + "\">" + category.toUpperCase() + "</span> " + text + "</p></pre>"; - - }, - - //------------------------------------------------------------------------- - // Private Methods - //------------------------------------------------------------------------- - - /* - * Initializes the logger. - * @private - */ - init : function () { - - //attach to any available TestRunner - if (YAHOO.tool.TestRunner){ - this.setTestRunner(YAHOO.tool.TestRunner); - } - - //hide useless sources - this.hideSource("global"); - this.hideSource("LogReader"); - - //hide useless message categories - this.hideCategory("warn"); - this.hideCategory("window"); - this.hideCategory("time"); - - //reset the logger - this.clearConsole(); - }, - - /** - * Clears the reference to the TestRunner from previous operations. This - * unsubscribes all events and removes the object reference. - * @return {Void} - * @static - */ - clearTestRunner : function () /*:Void*/ { - if (this._runner){ - this._runner.unsubscribeAll(); - this._runner = null; - } - }, - - /** - * Sets the source test runner that the logger should monitor. - * @param {YAHOO.tool.TestRunner} testRunner The TestRunner to observe. - * @return {Void} - * @static - */ - setTestRunner : function (testRunner /*:YAHOO.tool.TestRunner*/) /*:Void*/ { - - if (this._runner){ - this.clearTestRunner(); - } - - this._runner = testRunner; - - //setup event _handlers - testRunner.subscribe(testRunner.TEST_PASS_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.TEST_FAIL_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.TEST_IGNORE_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.BEGIN_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.COMPLETE_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.TEST_SUITE_BEGIN_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.TEST_SUITE_COMPLETE_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.TEST_CASE_BEGIN_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.TEST_CASE_COMPLETE_EVENT, this._handleTestRunnerEvent, this, true); - }, - - //------------------------------------------------------------------------- - // Event Handlers - //------------------------------------------------------------------------- - - /** - * Handles all TestRunner events, outputting appropriate data into the console. - * @param {Object} data The event data object. - * @return {Void} - * @private - */ - _handleTestRunnerEvent : function (data /*:Object*/) /*:Void*/ { - - //shortcut variables - var TestRunner /*:Object*/ = YAHOO.tool.TestRunner; - - //data variables - var message /*:String*/ = ""; - var messageType /*:String*/ = ""; - - switch(data.type){ - case TestRunner.BEGIN_EVENT: - message = "Testing began at " + (new Date()).toString() + "."; - messageType = "info"; - break; - - case TestRunner.COMPLETE_EVENT: - message = "Testing completed at " + (new Date()).toString() + ".\nPassed:" + - data.results.passed + " Failed:" + data.results.failed + " Total:" + data.results.total; - messageType = "info"; - break; - - case TestRunner.TEST_FAIL_EVENT: - message = data.testName + ": " + data.error.getMessage(); - messageType = "fail"; - break; - - case TestRunner.TEST_IGNORE_EVENT: - message = data.testName + ": ignored."; - messageType = "ignore"; - break; - - case TestRunner.TEST_PASS_EVENT: - message = data.testName + ": passed."; - messageType = "pass"; - break; - - case TestRunner.TEST_SUITE_BEGIN_EVENT: - message = "Test suite \"" + data.testSuite.name + "\" started."; - messageType = "info"; - break; - - case TestRunner.TEST_SUITE_COMPLETE_EVENT: - message = "Test suite \"" + data.testSuite.name + "\" completed.\nPassed:" + - data.results.passed + " Failed:" + data.results.failed + " Total:" + data.results.total; - messageType = "info"; - break; - - case TestRunner.TEST_CASE_BEGIN_EVENT: - message = "Test case \"" + data.testCase.name + "\" started."; - messageType = "info"; - break; - - case TestRunner.TEST_CASE_COMPLETE_EVENT: - message = "Test case \"" + data.testCase.name + "\" completed.\nPassed:" + - data.results.passed + " Failed:" + data.results.failed + " Total:" + data.results.total; - messageType = "info"; - break; - default: - message = "Unexpected event " + data.type; - message = "info"; - } - - YAHOO.log(message, messageType, "TestRunner"); - } - -}); - -YAHOO.namespace("tool.TestFormat"); - -/** - * Returns test results formatted as a JSON string. Requires JSON utility. - * @param {Object} result The results object created by TestRunner. - * @return {String} An XML-formatted string of results. - * @namespace YAHOO.tool.TestFormat - * @method JSON - * @static - */ -YAHOO.tool.TestFormat.JSON = function(results /*:Object*/) /*:String*/ { - return YAHOO.lang.JSON.stringify(results); -}; - -/** - * Returns test results formatted as an XML string. - * @param {Object} result The results object created by TestRunner. - * @return {String} An XML-formatted string of results. - * @namespace YAHOO.tool.TestFormat - * @method XML - * @static - */ -YAHOO.tool.TestFormat.XML = function(results /*:Object*/) /*:String*/ { - - var l = YAHOO.lang; - var xml /*:String*/ = "<" + results.type + " name=\"" + results.name.replace(/"/g, """).replace(/'/g, "'") + "\""; - - if (results.type == "test"){ - xml += " result=\"" + results.result + "\" message=\"" + results.message + "\">"; - } else { - xml += " passed=\"" + results.passed + "\" failed=\"" + results.failed + "\" ignored=\"" + results.ignored + "\" total=\"" + results.total + "\">"; - for (var prop in results) { - if (l.hasOwnProperty(results, prop) && l.isObject(results[prop]) && !l.isArray(results[prop])){ - xml += arguments.callee(results[prop]); - } - } - } - - xml += "</" + results.type + ">"; - - return xml; - -}; - -YAHOO.namespace("tool"); - -/** - * An object capable of sending test results to a server. - * @param {String} url The URL to submit the results to. - * @param {Function} format (Optiona) A function that outputs the results in a specific format. - * Default is YAHOO.tool.TestFormat.XML. - * @constructor - * @namespace YAHOO.tool - * @class TestReporter - */ -YAHOO.tool.TestReporter = function(url /*:String*/, format /*:Function*/) { - - /** - * The URL to submit the data to. - * @type String - * @property url - */ - this.url /*:String*/ = url; - - /** - * The formatting function to call when submitting the data. - * @type Function - * @property format - */ - this.format /*:Function*/ = format || YAHOO.tool.TestFormat.XML; - - /** - * Extra fields to submit with the request. - * @type Object - * @property _fields - * @private - */ - this._fields /*:Object*/ = new Object(); - - /** - * The form element used to submit the results. - * @type HTMLFormElement - * @property _form - * @private - */ - this._form /*:HTMLElement*/ = null; - - /** - * Iframe used as a target for form submission. - * @type HTMLIFrameElement - * @property _iframe - * @private - */ - this._iframe /*:HTMLElement*/ = null; -}; - -YAHOO.tool.TestReporter.prototype = { - - //restore missing constructor - constructor: YAHOO.tool.TestReporter, - - /** - * Adds a field to the form that submits the results. - * @param {String} name The name of the field. - * @param {Variant} value The value of the field. - * @return {Void} - * @method addField - */ - addField : function (name /*:String*/, value /*:Variant*/) /*:Void*/{ - this._fields[name] = value; - }, - - /** - * Removes all previous defined fields. - * @return {Void} - * @method addField - */ - clearFields : function() /*:Void*/{ - this._fields = new Object(); - }, - - /** - * Cleans up the memory associated with the TestReporter, removing DOM elements - * that were created. - * @return {Void} - * @method destroy - */ - destroy : function() /*:Void*/ { - if (this._form){ - this._form.parentNode.removeChild(this._form); - this._form = null; - } - if (this._iframe){ - this._iframe.parentNode.removeChild(this._iframe); - this._iframe = null; - } - this._fields = null; - }, - - /** - * Sends the report to the server. - * @param {Object} results The results object created by TestRunner. - * @return {Void} - * @method report - */ - report : function(results /*:Object*/) /*:Void*/{ - - //if the form hasn't been created yet, create it - if (!this._form){ - this._form = document.createElement("form"); - this._form.method = "post"; - this._form.style.visibility = "hidden"; - this._form.style.position = "absolute"; - this._form.style.top = 0; - document.body.appendChild(this._form); - - //IE won't let you assign a name using the DOM, must do it the hacky way - if (YAHOO.env.ua.ie){ - this._iframe = document.createElement("<iframe name=\"yuiTestTarget\" />"); - } else { - this._iframe = document.createElement("iframe"); - this._iframe.name = "yuiTestTarget"; - } - - this._iframe.src = "javascript:false"; - this._iframe.style.visibility = "hidden"; - this._iframe.style.position = "absolute"; - this._iframe.style.top = 0; - document.body.appendChild(this._iframe); - - this._form.target = "yuiTestTarget"; - } - - //set the form's action - this._form.action = this.url; - - //remove any existing fields - while(this._form.hasChildNodes()){ - this._form.removeChild(this._form.lastChild); - } - - //create default fields - this._fields.results = this.format(results); - this._fields.useragent = navigator.userAgent; - this._fields.timestamp = (new Date()).toLocaleString(); - - //add fields to the form - for (var prop in this._fields){ - if (YAHOO.lang.hasOwnProperty(this._fields, prop) && typeof this._fields[prop] != "function"){ - input = document.createElement("input"); - input.type = "hidden"; - input.name = prop; - input.value = this._fields[prop]; - this._form.appendChild(input); - } - } - - //remove default fields - delete this._fields.results; - delete this._fields.useragent; - delete this._fields.timestamp; - - if (arguments[1] !== false){ - this._form.submit(); - } - - } - -}; - -YAHOO.register("yuitest", YAHOO.tool.TestRunner, {version: "2.5.0", build: "895"}); diff --git a/lib/yui/yuitest/yuitest-min.js b/lib/yui/yuitest/yuitest-min.js deleted file mode 100644 index c916cc7106..0000000000 --- a/lib/yui/yuitest/yuitest-min.js +++ /dev/null @@ -1,11 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -YAHOO.namespace("tool");YAHOO.tool.TestCase=function(A){this._should={};for(var B in A){this[B]=A[B];}if(!YAHOO.lang.isString(this.name)){this.name=YAHOO.util.Dom.generateId(null,"testCase");}};YAHOO.tool.TestCase.prototype={resume:function(A){YAHOO.tool.TestRunner.resume(A);},wait:function(B,A){throw new YAHOO.tool.TestCase.Wait(B,A);},setUp:function(){},tearDown:function(){}};YAHOO.tool.TestCase.Wait=function(B,A){this.segment=(YAHOO.lang.isFunction(B)?B:null);this.delay=(YAHOO.lang.isNumber(A)?A:0);};YAHOO.namespace("tool");YAHOO.tool.TestSuite=function(A){this.name="";this.items=[];if(YAHOO.lang.isString(A)){this.name=A;}else{if(YAHOO.lang.isObject(A)){YAHOO.lang.augmentObject(this,A,true);}}if(this.name===""){this.name=YAHOO.util.Dom.generateId(null,"testSuite");}};YAHOO.tool.TestSuite.prototype={add:function(A){if(A instanceof YAHOO.tool.TestSuite||A instanceof YAHOO.tool.TestCase){this.items.push(A);}},setUp:function(){},tearDown:function(){}};YAHOO.namespace("tool");YAHOO.tool.TestRunner=(function(){function B(C){this.testObject=C;this.firstChild=null;this.lastChild=null;this.parent=null;this.next=null;this.results={passed:0,failed:0,total:0,ignored:0};if(C instanceof YAHOO.tool.TestSuite){this.results.type="testsuite";this.results.name=C.name;}else{if(C instanceof YAHOO.tool.TestCase){this.results.type="testcase";this.results.name=C.name;}}}B.prototype={appendChild:function(C){var D=new B(C);if(this.firstChild===null){this.firstChild=this.lastChild=D;}else{this.lastChild.next=D;this.lastChild=D;}D.parent=this;return D;}};function A(){A.superclass.constructor.apply(this,arguments);this.masterSuite=new YAHOO.tool.TestSuite("YUI Test Results");this._cur=null;this._root=null;var D=[this.TEST_CASE_BEGIN_EVENT,this.TEST_CASE_COMPLETE_EVENT,this.TEST_SUITE_BEGIN_EVENT,this.TEST_SUITE_COMPLETE_EVENT,this.TEST_PASS_EVENT,this.TEST_FAIL_EVENT,this.TEST_IGNORE_EVENT,this.COMPLETE_EVENT,this.BEGIN_EVENT];for(var C=0;C<D.length;C++){this.createEvent(D[C],{scope:this});}}YAHOO.lang.extend(A,YAHOO.util.EventProvider,{TEST_CASE_BEGIN_EVENT:"testcasebegin",TEST_CASE_COMPLETE_EVENT:"testcasecomplete",TEST_SUITE_BEGIN_EVENT:"testsuitebegin",TEST_SUITE_COMPLETE_EVENT:"testsuitecomplete",TEST_PASS_EVENT:"pass",TEST_FAIL_EVENT:"fail",TEST_IGNORE_EVENT:"ignore",COMPLETE_EVENT:"complete",BEGIN_EVENT:"begin",_addTestCaseToTestTree:function(C,D){var E=C.appendChild(D);for(var F in D){if(F.indexOf("test")===0&&YAHOO.lang.isFunction(D[F])){E.appendChild(F);}}},_addTestSuiteToTestTree:function(C,F){var E=C.appendChild(F);for(var D=0;D<F.items.length;D++){if(F.items[D] instanceof YAHOO.tool.TestSuite){this._addTestSuiteToTestTree(E,F.items[D]);}else{if(F.items[D] instanceof YAHOO.tool.TestCase){this._addTestCaseToTestTree(E,F.items[D]);}}}},_buildTestTree:function(){this._root=new B(this.masterSuite);this._cur=this._root;for(var C=0;C<this.masterSuite.items.length;C++){if(this.masterSuite.items[C] instanceof YAHOO.tool.TestSuite){this._addTestSuiteToTestTree(this._root,this.masterSuite.items[C]);}else{if(this.masterSuite.items[C] instanceof YAHOO.tool.TestCase){this._addTestCaseToTestTree(this._root,this.masterSuite.items[C]);}}}},_handleTestObjectComplete:function(C){if(YAHOO.lang.isObject(C.testObject)){C.parent.results.passed+=C.results.passed;C.parent.results.failed+=C.results.failed;C.parent.results.total+=C.results.total;C.parent.results.ignored+=C.results.ignored;C.parent.results[C.testObject.name]=C.results;if(C.testObject instanceof YAHOO.tool.TestSuite){C.testObject.tearDown();this.fireEvent(this.TEST_SUITE_COMPLETE_EVENT,{testSuite:C.testObject,results:C.results});}else{if(C.testObject instanceof YAHOO.tool.TestCase){this.fireEvent(this.TEST_CASE_COMPLETE_EVENT,{testCase:C.testObject,results:C.results});}}}},_next:function(){if(this._cur.firstChild){this._cur=this._cur.firstChild;}else{if(this._cur.next){this._cur=this._cur.next;}else{while(this._cur&&!this._cur.next&&this._cur!==this._root){this._handleTestObjectComplete(this._cur);this._cur=this._cur.parent;}if(this._cur==this._root){this._cur.results.type="report";this._cur.results.timestamp=(new Date()).toLocaleString();this.fireEvent(this.COMPLETE_EVENT,{results:this._cur.results});this._cur=null;}else{this._handleTestObjectComplete(this._cur);this._cur=this._cur.next;}}}return this._cur;},_run:function(){var E=false;var D=this._next();if(D!==null){var C=D.testObject;if(YAHOO.lang.isObject(C)){if(C instanceof YAHOO.tool.TestSuite){this.fireEvent(this.TEST_SUITE_BEGIN_EVENT,{testSuite:C});C.setUp();}else{if(C instanceof YAHOO.tool.TestCase){this.fireEvent(this.TEST_CASE_BEGIN_EVENT,{testCase:C});}}if(typeof setTimeout!="undefined"){setTimeout(function(){YAHOO.tool.TestRunner._run();},0);}else{this._run();}}else{this._runTest(D);}}},_resumeTest:function(G){var C=this._cur;var H=C.testObject;var E=C.parent.testObject;var K=(E._should.fail||{})[H];var D=(E._should.error||{})[H];var F=false;var I=null;try{G.apply(E);if(K){I=new YAHOO.util.ShouldFail();F=true;}else{if(D){I=new YAHOO.util.ShouldError();F=true;}}}catch(J){if(J instanceof YAHOO.util.AssertionError){if(!K){I=J;F=true;}}else{if(J instanceof YAHOO.tool.TestCase.Wait){if(YAHOO.lang.isFunction(J.segment)){if(YAHOO.lang.isNumber(J.delay)){if(typeof setTimeout!="undefined"){setTimeout(function(){YAHOO.tool.TestRunner._resumeTest(J.segment);},J.delay);}else{throw new Error("Asynchronous tests not supported in this environment.");}}}return ;}else{if(!D){I=new YAHOO.util.UnexpectedError(J);F=true;}else{if(YAHOO.lang.isString(D)){if(J.message!=D){I=new YAHOO.util.UnexpectedError(J);F=true;}}else{if(YAHOO.lang.isFunction(D)){if(!(J instanceof D)){I=new YAHOO.util.UnexpectedError(J);F=true;}}else{if(YAHOO.lang.isObject(D)){if(!(J instanceof D.constructor)||J.message!=D.message){I=new YAHOO.util.UnexpectedError(J);F=true;}}}}}}}}if(F){this.fireEvent(this.TEST_FAIL_EVENT,{testCase:E,testName:H,error:I});}else{this.fireEvent(this.TEST_PASS_EVENT,{testCase:E,testName:H});}E.tearDown();C.parent.results[H]={result:F?"fail":"pass",message:I?I.getMessage():"Test passed",type:"test",name:H}; -if(F){C.parent.results.failed++;}else{C.parent.results.passed++;}C.parent.results.total++;if(typeof setTimeout!="undefined"){setTimeout(function(){YAHOO.tool.TestRunner._run();},0);}else{this._run();}},_runTest:function(F){var C=F.testObject;var D=F.parent.testObject;var G=D[C];var E=(D._should.ignore||{})[C];if(E){F.parent.results[C]={result:"ignore",message:"Test ignored",type:"test",name:C};F.parent.results.ignored++;F.parent.results.total++;this.fireEvent(this.TEST_IGNORE_EVENT,{testCase:D,testName:C});if(typeof setTimeout!="undefined"){setTimeout(function(){YAHOO.tool.TestRunner._run();},0);}else{this._run();}}else{D.setUp();this._resumeTest(G);}},fireEvent:function(C,D){D=D||{};D.type=C;A.superclass.fireEvent.call(this,C,D);},add:function(C){this.masterSuite.add(C);},clear:function(){this.masterSuite.items=[];},resume:function(C){this._resumeTest(C||function(){});},run:function(C){var D=YAHOO.tool.TestRunner;D._buildTestTree();D.fireEvent(D.BEGIN_EVENT);D._run();}});return new A();})();YAHOO.namespace("util");YAHOO.util.Assert={fail:function(A){throw new YAHOO.util.AssertionError(A||"Test force-failed.");},areEqual:function(B,C,A){if(B!=C){throw new YAHOO.util.ComparisonFailure(A||"Values should be equal.",B,C);}},areNotEqual:function(A,C,B){if(A==C){throw new YAHOO.util.UnexpectedValue(B||"Values should not be equal.",A);}},areNotSame:function(A,C,B){if(A===C){throw new YAHOO.util.UnexpectedValue(B||"Values should not be the same.",A);}},areSame:function(B,C,A){if(B!==C){throw new YAHOO.util.ComparisonFailure(A||"Values should be the same.",B,C);}},isFalse:function(B,A){if(false!==B){throw new YAHOO.util.ComparisonFailure(A||"Value should be false.",false,B);}},isTrue:function(B,A){if(true!==B){throw new YAHOO.util.ComparisonFailure(A||"Value should be true.",true,B);}},isNaN:function(B,A){if(!isNaN(B)){throw new YAHOO.util.ComparisonFailure(A||"Value should be NaN.",NaN,B);}},isNotNaN:function(B,A){if(isNaN(B)){throw new YAHOO.util.UnexpectedValue(A||"Values should not be NaN.",NaN);}},isNotNull:function(B,A){if(YAHOO.lang.isNull(B)){throw new YAHOO.util.UnexpectedValue(A||"Values should not be null.",null);}},isNotUndefined:function(B,A){if(YAHOO.lang.isUndefined(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should not be undefined.",undefined);}},isNull:function(B,A){if(!YAHOO.lang.isNull(B)){throw new YAHOO.util.ComparisonFailure(A||"Value should be null.",null,B);}},isUndefined:function(B,A){if(!YAHOO.lang.isUndefined(B)){throw new YAHOO.util.ComparisonFailure(A||"Value should be undefined.",undefined,B);}},isArray:function(B,A){if(!YAHOO.lang.isArray(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should be an array.",B);}},isBoolean:function(B,A){if(!YAHOO.lang.isBoolean(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should be a Boolean.",B);}},isFunction:function(B,A){if(!YAHOO.lang.isFunction(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should be a function.",B);}},isInstanceOf:function(B,C,A){if(!(C instanceof B)){throw new YAHOO.util.ComparisonFailure(A||"Value isn't an instance of expected type.",B,C);}},isNumber:function(B,A){if(!YAHOO.lang.isNumber(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should be a number.",B);}},isObject:function(B,A){if(!YAHOO.lang.isObject(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should be an object.",B);}},isString:function(B,A){if(!YAHOO.lang.isString(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should be a string.",B);}},isTypeOf:function(A,C,B){if(typeof C!=A){throw new YAHOO.util.ComparisonFailure(B||"Value should be of type "+expected+".",expected,typeof actual);}}};YAHOO.util.AssertionError=function(A){arguments.callee.superclass.constructor.call(this,A);this.message=A;this.name="AssertionError";};YAHOO.lang.extend(YAHOO.util.AssertionError,Error,{getMessage:function(){return this.message;},toString:function(){return this.name+": "+this.getMessage();},valueOf:function(){return this.toString();}});YAHOO.util.ComparisonFailure=function(B,A,C){arguments.callee.superclass.constructor.call(this,B);this.expected=A;this.actual=C;this.name="ComparisonFailure";};YAHOO.lang.extend(YAHOO.util.ComparisonFailure,YAHOO.util.AssertionError,{getMessage:function(){return this.message+"\nExpected: "+this.expected+" ("+(typeof this.expected)+")\nActual:"+this.actual+" ("+(typeof this.actual)+")";}});YAHOO.util.UnexpectedValue=function(B,A){arguments.callee.superclass.constructor.call(this,B);this.unexpected=A;this.name="UnexpectedValue";};YAHOO.lang.extend(YAHOO.util.UnexpectedValue,YAHOO.util.AssertionError,{getMessage:function(){return this.message+"\nUnexpected: "+this.unexpected+" ("+(typeof this.unexpected)+") ";}});YAHOO.util.ShouldFail=function(A){arguments.callee.superclass.constructor.call(this,A||"This test should fail but didn't.");this.name="ShouldFail";};YAHOO.lang.extend(YAHOO.util.ShouldFail,YAHOO.util.AssertionError);YAHOO.util.ShouldError=function(A){arguments.callee.superclass.constructor.call(this,A||"This test should have thrown an error but didn't.");this.name="ShouldError";};YAHOO.lang.extend(YAHOO.util.ShouldError,YAHOO.util.AssertionError);YAHOO.util.UnexpectedError=function(A){arguments.callee.superclass.constructor.call(this,"Unexpected error: "+A.message);this.cause=A;this.name="UnexpectedError";};YAHOO.lang.extend(YAHOO.util.UnexpectedError,YAHOO.util.AssertionError);YAHOO.util.ArrayAssert={contains:function(E,D,B){var C=false;for(var A=0;A<D.length&&!C;A++){if(D[A]===E){C=true;}}if(!C){YAHOO.util.Assert.fail(B||"Value ("+E+") not found in array.");}},containsItems:function(C,D,B){for(var A=0;A<C.length;A++){this.contains(C[A],D,B);}if(!found){YAHOO.util.Assert.fail(B||"Value not found in array.");}},containsMatch:function(E,D,B){if(typeof E!="function"){throw new TypeError("ArrayAssert.containsMatch(): First argument must be a function.");}var C=false;for(var A=0;A<D.length&&!C;A++){if(E(D[A])){C=true;}}if(!C){YAHOO.util.Assert.fail(B||"No match found in array.");}},doesNotContain:function(E,D,B){var C=false; -for(var A=0;A<D.length&&!C;A++){if(D[A]===E){C=true;}}if(C){YAHOO.util.Assert.fail(B||"Value found in array.");}},doesNotContainItems:function(C,D,B){for(var A=0;A<C.length;A++){this.doesNotContain(C[A],D,B);}},doesNotContainMatch:function(E,D,B){if(typeof E!="function"){throw new TypeError("ArrayAssert.doesNotContainMatch(): First argument must be a function.");}var C=false;for(var A=0;A<D.length&&!C;A++){if(E(D[A])){C=true;}}if(C){YAHOO.util.Assert.fail(B||"Value found in array.");}},indexOf:function(E,D,A,C){for(var B=0;B<D.length;B++){if(D[B]===E){YAHOO.util.Assert.areEqual(A,B,C||"Value exists at index "+B+" but should be at index "+A+".");return ;}}YAHOO.util.Assert.fail(C||"Value doesn't exist in array.");},itemsAreEqual:function(D,E,C){var A=Math.max(D.length,E.length);for(var B=0;B<A;B++){YAHOO.util.Assert.areEqual(D[B],E[B],C||"Values in position "+B+" are not equal.");}},itemsAreEquivalent:function(E,F,B,D){if(typeof B!="function"){throw new TypeError("ArrayAssert.itemsAreEquivalent(): Third argument must be a function.");}var A=Math.max(E.length,F.length);for(var C=0;C<A;C++){if(!B(E[C],F[C])){throw new YAHOO.util.ComparisonFailure(D||"Values in position "+C+" are not equivalent.",E[C],F[C]);}}},isEmpty:function(B,A){if(B.length>0){YAHOO.util.Assert.fail(A||"Array should be empty.");}},isNotEmpty:function(B,A){if(B.length===0){YAHOO.util.Assert.fail(A||"Array should not be empty.");}},itemsAreSame:function(D,E,C){var A=Math.max(D.length,E.length);for(var B=0;B<A;B++){YAHOO.util.Assert.areSame(D[B],E[B],C||"Values in position "+B+" are not the same.");}},lastIndexOf:function(E,D,A,C){for(var B=D.length;B>=0;B--){if(D[B]===E){YAHOO.util.Assert.areEqual(A,B,C||"Value exists at index "+B+" but should be at index "+A+".");return ;}}YAHOO.util.Assert.fail(C||"Value doesn't exist in array.");}};YAHOO.namespace("util");YAHOO.util.ObjectAssert={propertiesAreEqual:function(D,F,C){var B=[];for(var E in D){B.push(E);}for(var A=0;A<B.length;A++){YAHOO.util.Assert.isNotUndefined(F[B[A]],C||"Property'"+B[A]+"' expected.");}},hasProperty:function(A,B,C){if(YAHOO.lang.isUndefined(B[A])){YAHOO.util.Assert.fail(C||"Property "+A+" not found on object.");}},hasOwnProperty:function(A,B,C){if(!YAHOO.lang.hasOwnProperty(B,A)){YAHOO.util.Assert.fail(C||"Property "+A+" not found on object instance.");}}};YAHOO.util.DateAssert={datesAreEqual:function(B,C,A){if(B instanceof Date&&C instanceof Date){YAHOO.util.Assert.areEqual(B.getFullYear(),C.getFullYear(),A||"Years should be equal.");YAHOO.util.Assert.areEqual(B.getMonth(),C.getMonth(),A||"Months should be equal.");YAHOO.util.Assert.areEqual(B.getDate(),C.getDate(),A||"Day of month should be equal.");}else{throw new TypeError("DateAssert.datesAreEqual(): Expected and actual values must be Date objects.");}},timesAreEqual:function(B,C,A){if(B instanceof Date&&C instanceof Date){YAHOO.util.Assert.areEqual(B.getHours(),C.getHours(),A||"Hours should be equal.");YAHOO.util.Assert.areEqual(B.getMinutes(),C.getMinutes(),A||"Minutes should be equal.");YAHOO.util.Assert.areEqual(B.getSeconds(),C.getSeconds(),A||"Seconds should be equal.");}else{throw new TypeError("DateAssert.timesAreEqual(): Expected and actual values must be Date objects.");}}};YAHOO.namespace("util");YAHOO.util.UserAction={simulateKeyEvent:function(F,J,E,C,L,B,A,K,H,N,M){F=YAHOO.util.Dom.get(F);if(!F){throw new Error("simulateKeyEvent(): Invalid target.");}if(YAHOO.lang.isString(J)){J=J.toLowerCase();switch(J){case"keyup":case"keydown":case"keypress":break;case"textevent":J="keypress";break;default:throw new Error("simulateKeyEvent(): Event type '"+J+"' not supported.");}}else{throw new Error("simulateKeyEvent(): Event type must be a string.");}if(!YAHOO.lang.isBoolean(E)){E=true;}if(!YAHOO.lang.isBoolean(C)){C=true;}if(!YAHOO.lang.isObject(L)){L=window;}if(!YAHOO.lang.isBoolean(B)){B=false;}if(!YAHOO.lang.isBoolean(A)){A=false;}if(!YAHOO.lang.isBoolean(K)){K=false;}if(!YAHOO.lang.isBoolean(H)){H=false;}if(!YAHOO.lang.isNumber(N)){N=0;}if(!YAHOO.lang.isNumber(M)){M=0;}var I=null;if(YAHOO.lang.isFunction(document.createEvent)){try{I=document.createEvent("KeyEvents");I.initKeyEvent(J,E,C,L,B,A,K,H,N,M);}catch(G){try{I=document.createEvent("Events");}catch(D){I=document.createEvent("UIEvents");}finally{I.initEvent(J,E,C);I.view=L;I.altKey=A;I.ctrlKey=B;I.shiftKey=K;I.metaKey=H;I.keyCode=N;I.charCode=M;}}F.dispatchEvent(I);}else{if(YAHOO.lang.isObject(document.createEventObject)){I=document.createEventObject();I.bubbles=E;I.cancelable=C;I.view=L;I.ctrlKey=B;I.altKey=A;I.shiftKey=K;I.metaKey=H;I.keyCode=(M>0)?M:N;F.fireEvent("on"+J,I);}else{throw new Error("simulateKeyEvent(): No event simulation framework present.");}}},simulateMouseEvent:function(K,P,H,E,Q,J,G,F,D,B,C,A,O,M,I,L){K=YAHOO.util.Dom.get(K);if(!K){throw new Error("simulateMouseEvent(): Invalid target.");}if(YAHOO.lang.isString(P)){P=P.toLowerCase();switch(P){case"mouseover":case"mouseout":case"mousedown":case"mouseup":case"click":case"dblclick":case"mousemove":break;default:throw new Error("simulateMouseEvent(): Event type '"+P+"' not supported.");}}else{throw new Error("simulateMouseEvent(): Event type must be a string.");}if(!YAHOO.lang.isBoolean(H)){H=true;}if(!YAHOO.lang.isBoolean(E)){E=(P!="mousemove");}if(!YAHOO.lang.isObject(Q)){Q=window;}if(!YAHOO.lang.isNumber(J)){J=1;}if(!YAHOO.lang.isNumber(G)){G=0;}if(!YAHOO.lang.isNumber(F)){F=0;}if(!YAHOO.lang.isNumber(D)){D=0;}if(!YAHOO.lang.isNumber(B)){B=0;}if(!YAHOO.lang.isBoolean(C)){C=false;}if(!YAHOO.lang.isBoolean(A)){A=false;}if(!YAHOO.lang.isBoolean(O)){O=false;}if(!YAHOO.lang.isBoolean(M)){M=false;}if(!YAHOO.lang.isNumber(I)){I=0;}var N=null;if(YAHOO.lang.isFunction(document.createEvent)){N=document.createEvent("MouseEvents");if(N.initMouseEvent){N.initMouseEvent(P,H,E,Q,J,G,F,D,B,C,A,O,M,I,L);}else{N=document.createEvent("UIEvents");N.initEvent(P,H,E);N.view=Q;N.detail=J;N.screenX=G;N.screenY=F;N.clientX=D;N.clientY=B;N.ctrlKey=C;N.altKey=A;N.metaKey=M;N.shiftKey=O;N.button=I; -N.relatedTarget=L;}if(L&&!N.relatedTarget){if(P=="mouseout"){N.toElement=L;}else{if(P=="mouseover"){N.fromElement=L;}}}K.dispatchEvent(N);}else{if(YAHOO.lang.isObject(document.createEventObject)){N=document.createEventObject();N.bubbles=H;N.cancelable=E;N.view=Q;N.detail=J;N.screenX=G;N.screenY=F;N.clientX=D;N.clientY=B;N.ctrlKey=C;N.altKey=A;N.metaKey=M;N.shiftKey=O;switch(I){case 0:N.button=1;break;case 1:N.button=4;break;case 2:break;default:N.button=0;}N.relatedTarget=L;K.fireEvent("on"+P,N);}else{throw new Error("simulateMouseEvent(): No event simulation framework present.");}}},fireMouseEvent:function(C,B,A){A=A||{};this.simulateMouseEvent(C,B,A.bubbles,A.cancelable,A.view,A.detail,A.screenX,A.screenY,A.clientX,A.clientY,A.ctrlKey,A.altKey,A.shiftKey,A.metaKey,A.button,A.relatedTarget);},click:function(B,A){this.fireMouseEvent(B,"click",A);},dblclick:function(B,A){this.fireMouseEvent(B,"dblclick",A);},mousedown:function(B,A){this.fireMouseEvent(B,"mousedown",A);},mousemove:function(B,A){this.fireMouseEvent(B,"mousemove",A);},mouseout:function(B,A){this.fireMouseEvent(B,"mouseout",A);},mouseover:function(B,A){this.fireMouseEvent(B,"mouseover",A);},mouseup:function(B,A){this.fireMouseEvent(B,"mouseup",A);},fireKeyEvent:function(B,C,A){A=A||{};this.simulateKeyEvent(C,B,A.bubbles,A.cancelable,A.view,A.ctrlKey,A.altKey,A.shiftKey,A.metaKey,A.keyCode,A.charCode);},keydown:function(B,A){this.fireKeyEvent("keydown",B,A);},keypress:function(B,A){this.fireKeyEvent("keypress",B,A);},keyup:function(B,A){this.fireKeyEvent("keyup",B,A);}};YAHOO.namespace("tool");YAHOO.tool.TestManager={TEST_PAGE_BEGIN_EVENT:"testpagebegin",TEST_PAGE_COMPLETE_EVENT:"testpagecomplete",TEST_MANAGER_BEGIN_EVENT:"testmanagerbegin",TEST_MANAGER_COMPLETE_EVENT:"testmanagercomplete",_curPage:null,_frame:null,_logger:null,_timeoutId:0,_pages:[],_results:null,_handleTestRunnerComplete:function(A){this.fireEvent(this.TEST_PAGE_COMPLETE_EVENT,{page:this._curPage,results:A.results});this._processResults(this._curPage,A.results);this._logger.clearTestRunner();if(this._pages.length){this._timeoutId=setTimeout(function(){YAHOO.tool.TestManager._run();},1000);}else{this.fireEvent(this.TEST_MANAGER_COMPLETE_EVENT,this._results);}},_processResults:function(C,A){var B=this._results;B.passed+=A.passed;B.failed+=A.failed;B.ignored+=A.ignored;B.total+=A.total;if(A.failed){B.failedPages.push(C);}else{B.passedPages.push(C);}A.name=C;A.type="page";B[C]=A;},_run:function(){this._curPage=this._pages.shift();this.fireEvent(this.TEST_PAGE_BEGIN_EVENT,this._curPage);this._frame.location.replace(this._curPage);},load:function(){if(parent.YAHOO.tool.TestManager!==this){parent.YAHOO.tool.TestManager.load();}else{if(this._frame){var A=this._frame.YAHOO.tool.TestRunner;this._logger.setTestRunner(A);A.subscribe(A.COMPLETE_EVENT,this._handleTestRunnerComplete,this,true);A.run();}}},setPages:function(A){this._pages=A;},start:function(){if(!this._initialized){this.createEvent(this.TEST_PAGE_BEGIN_EVENT);this.createEvent(this.TEST_PAGE_COMPLETE_EVENT);this.createEvent(this.TEST_MANAGER_BEGIN_EVENT);this.createEvent(this.TEST_MANAGER_COMPLETE_EVENT);if(!this._frame){var A=document.createElement("iframe");A.style.visibility="hidden";A.style.position="absolute";document.body.appendChild(A);this._frame=A.contentWindow||A.contentDocument.ownerWindow;}if(!this._logger){this._logger=new YAHOO.tool.TestLogger();}this._initialized=true;}this._results={passed:0,failed:0,ignored:0,total:0,type:"report",name:"YUI Test Results",failedPages:[],passedPages:[]};this.fireEvent(this.TEST_MANAGER_BEGIN_EVENT,null);this._run();},stop:function(){clearTimeout(this._timeoutId);}};YAHOO.lang.augmentObject(YAHOO.tool.TestManager,YAHOO.util.EventProvider.prototype);YAHOO.namespace("tool");YAHOO.tool.TestLogger=function(B,A){YAHOO.tool.TestLogger.superclass.constructor.call(this,B,A);this.init();};YAHOO.lang.extend(YAHOO.tool.TestLogger,YAHOO.widget.LogReader,{footerEnabled:true,newestOnTop:false,formatMsg:function(B){var A=B.category;var C=this.html2Text(B.msg);return"<pre><p><span class=\""+A+"\">"+A.toUpperCase()+"</span> "+C+"</p></pre>";},init:function(){if(YAHOO.tool.TestRunner){this.setTestRunner(YAHOO.tool.TestRunner);}this.hideSource("global");this.hideSource("LogReader");this.hideCategory("warn");this.hideCategory("window");this.hideCategory("time");this.clearConsole();},clearTestRunner:function(){if(this._runner){this._runner.unsubscribeAll();this._runner=null;}},setTestRunner:function(A){if(this._runner){this.clearTestRunner();}this._runner=A;A.subscribe(A.TEST_PASS_EVENT,this._handleTestRunnerEvent,this,true);A.subscribe(A.TEST_FAIL_EVENT,this._handleTestRunnerEvent,this,true);A.subscribe(A.TEST_IGNORE_EVENT,this._handleTestRunnerEvent,this,true);A.subscribe(A.BEGIN_EVENT,this._handleTestRunnerEvent,this,true);A.subscribe(A.COMPLETE_EVENT,this._handleTestRunnerEvent,this,true);A.subscribe(A.TEST_SUITE_BEGIN_EVENT,this._handleTestRunnerEvent,this,true);A.subscribe(A.TEST_SUITE_COMPLETE_EVENT,this._handleTestRunnerEvent,this,true);A.subscribe(A.TEST_CASE_BEGIN_EVENT,this._handleTestRunnerEvent,this,true);A.subscribe(A.TEST_CASE_COMPLETE_EVENT,this._handleTestRunnerEvent,this,true);},_handleTestRunnerEvent:function(D){var A=YAHOO.tool.TestRunner;var C="";var B="";switch(D.type){case A.BEGIN_EVENT:C="Testing began at "+(new Date()).toString()+".";B="info";break;case A.COMPLETE_EVENT:C="Testing completed at "+(new Date()).toString()+".\nPassed:"+D.results.passed+" Failed:"+D.results.failed+" Total:"+D.results.total;B="info";break;case A.TEST_FAIL_EVENT:C=D.testName+": "+D.error.getMessage();B="fail";break;case A.TEST_IGNORE_EVENT:C=D.testName+": ignored.";B="ignore";break;case A.TEST_PASS_EVENT:C=D.testName+": passed.";B="pass";break;case A.TEST_SUITE_BEGIN_EVENT:C="Test suite \""+D.testSuite.name+"\" started.";B="info";break;case A.TEST_SUITE_COMPLETE_EVENT:C="Test suite \""+D.testSuite.name+"\" completed.\nPassed:"+D.results.passed+" Failed:"+D.results.failed+" Total:"+D.results.total; -B="info";break;case A.TEST_CASE_BEGIN_EVENT:C="Test case \""+D.testCase.name+"\" started.";B="info";break;case A.TEST_CASE_COMPLETE_EVENT:C="Test case \""+D.testCase.name+"\" completed.\nPassed:"+D.results.passed+" Failed:"+D.results.failed+" Total:"+D.results.total;B="info";break;default:C="Unexpected event "+D.type;C="info";}YAHOO.log(C,B,"TestRunner");}});YAHOO.namespace("tool.TestFormat");YAHOO.tool.TestFormat.JSON=function(A){return YAHOO.lang.JSON.stringify(A);};YAHOO.tool.TestFormat.XML=function(C){var A=YAHOO.lang;var B="<"+C.type+" name=\""+C.name.replace(/"/g,""").replace(/'/g,"'")+"\"";if(C.type=="test"){B+=" result=\""+C.result+"\" message=\""+C.message+"\">";}else{B+=" passed=\""+C.passed+"\" failed=\""+C.failed+"\" ignored=\""+C.ignored+"\" total=\""+C.total+"\">";for(var D in C){if(A.hasOwnProperty(C,D)&&A.isObject(C[D])&&!A.isArray(C[D])){B+=arguments.callee(C[D]);}}}B+="</"+C.type+">";return B;};YAHOO.namespace("tool");YAHOO.tool.TestReporter=function(A,B){this.url=A;this.format=B||YAHOO.tool.TestFormat.XML;this._fields=new Object();this._form=null;this._iframe=null;};YAHOO.tool.TestReporter.prototype={constructor:YAHOO.tool.TestReporter,addField:function(A,B){this._fields[A]=B;},clearFields:function(){this._fields=new Object();},destroy:function(){if(this._form){this._form.parentNode.removeChild(this._form);this._form=null;}if(this._iframe){this._iframe.parentNode.removeChild(this._iframe);this._iframe=null;}this._fields=null;},report:function(A){if(!this._form){this._form=document.createElement("form");this._form.method="post";this._form.style.visibility="hidden";this._form.style.position="absolute";this._form.style.top=0;document.body.appendChild(this._form);if(YAHOO.env.ua.ie){this._iframe=document.createElement("<iframe name=\"yuiTestTarget\" />");}else{this._iframe=document.createElement("iframe");this._iframe.name="yuiTestTarget";}this._iframe.src="javascript:false";this._iframe.style.visibility="hidden";this._iframe.style.position="absolute";this._iframe.style.top=0;document.body.appendChild(this._iframe);this._form.target="yuiTestTarget";}this._form.action=this.url;while(this._form.hasChildNodes()){this._form.removeChild(this._form.lastChild);}this._fields.results=this.format(A);this._fields.useragent=navigator.userAgent;this._fields.timestamp=(new Date()).toLocaleString();for(var B in this._fields){if(YAHOO.lang.hasOwnProperty(this._fields,B)&&typeof this._fields[B]!="function"){input=document.createElement("input");input.type="hidden";input.name=B;input.value=this._fields[B];this._form.appendChild(input);}}delete this._fields.results;delete this._fields.useragent;delete this._fields.timestamp;if(arguments[1]!==false){this._form.submit();}}};YAHOO.register("yuitest",YAHOO.tool.TestRunner,{version:"2.5.0",build:"895"}); \ No newline at end of file diff --git a/lib/yui/yuitest/yuitest.js b/lib/yui/yuitest/yuitest.js deleted file mode 100644 index ad114842e9..0000000000 --- a/lib/yui/yuitest/yuitest.js +++ /dev/null @@ -1,3268 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -YAHOO.namespace("tool"); - -//----------------------------------------------------------------------------- -// TestCase object -//----------------------------------------------------------------------------- - -/** - * Test case containing various tests to run. - * @param template An object containing any number of test methods, other methods, - * an optional name, and anything else the test case needs. - * @class TestCase - * @namespace YAHOO.tool - * @constructor - */ -YAHOO.tool.TestCase = function (template /*:Object*/) { - - /** - * Special rules for the test case. Possible subobjects - * are fail, for tests that should fail, and error, for - * tests that should throw an error. - */ - this._should /*:Object*/ = {}; - - //copy over all properties from the template to this object - for (var prop in template) { - this[prop] = template[prop]; - } - - //check for a valid name - if (!YAHOO.lang.isString(this.name)){ - /** - * Name for the test case. - */ - this.name /*:String*/ = YAHOO.util.Dom.generateId(null, "testCase"); - } - -}; - - -YAHOO.tool.TestCase.prototype = { - - /** - * Resumes a paused test and runs the given function. - * @param {Function} segment (Optional) The function to run. - * If omitted, the test automatically passes. - * @return {Void} - * @method resume - */ - resume : function (segment /*:Function*/) /*:Void*/ { - YAHOO.tool.TestRunner.resume(segment); - }, - - /** - * Causes the test case to wait a specified amount of time and then - * continue executing the given code. - * @param {Function} segment (Optional) The function to run after the delay. - * If omitted, the TestRunner will wait until resume() is called. - * @param {int} delay (Optional) The number of milliseconds to wait before running - * the function. If omitted, defaults to zero. - * @return {Void} - * @method wait - */ - wait : function (segment /*:Function*/, delay /*:int*/) /*:Void*/{ - throw new YAHOO.tool.TestCase.Wait(segment, delay); - }, - - //------------------------------------------------------------------------- - // Stub Methods - //------------------------------------------------------------------------- - - /** - * Function to run before each test is executed. - * @return {Void} - * @method setUp - */ - setUp : function () /*:Void*/ { - }, - - /** - * Function to run after each test is executed. - * @return {Void} - * @method tearDown - */ - tearDown: function () /*:Void*/ { - } -}; - -/** - * Represents a stoppage in test execution to wait for an amount of time before - * continuing. - * @param {Function} segment A function to run when the wait is over. - * @param {int} delay The number of milliseconds to wait before running the code. - * @class Wait - * @namespace YAHOO.tool.TestCase - * @constructor - * - */ -YAHOO.tool.TestCase.Wait = function (segment /*:Function*/, delay /*:int*/) { - - /** - * The segment of code to run when the wait is over. - * @type Function - * @property segment - */ - this.segment /*:Function*/ = (YAHOO.lang.isFunction(segment) ? segment : null); - - /** - * The delay before running the segment of code. - * @type int - * @property delay - */ - this.delay /*:int*/ = (YAHOO.lang.isNumber(delay) ? delay : 0); - -}; - -YAHOO.namespace("tool"); - - -//----------------------------------------------------------------------------- -// TestSuite object -//----------------------------------------------------------------------------- - -/** - * A test suite that can contain a collection of TestCase and TestSuite objects. - * @param {String||Object} data The name of the test suite or an object containing - * a name property as well as setUp and tearDown methods. - * @namespace YAHOO.tool - * @class TestSuite - * @constructor - */ -YAHOO.tool.TestSuite = function (data /*:String||Object*/) { - - /** - * The name of the test suite. - * @type String - * @property name - */ - this.name /*:String*/ = ""; - - /** - * Array of test suites and - * @private - */ - this.items /*:Array*/ = []; - - //initialize the properties - if (YAHOO.lang.isString(data)){ - this.name = data; - } else if (YAHOO.lang.isObject(data)){ - YAHOO.lang.augmentObject(this, data, true); - } - - //double-check name - if (this.name === ""){ - this.name = YAHOO.util.Dom.generateId(null, "testSuite"); - } - -}; - -YAHOO.tool.TestSuite.prototype = { - - /** - * Adds a test suite or test case to the test suite. - * @param {YAHOO.tool.TestSuite||YAHOO.tool.TestCase} testObject The test suite or test case to add. - * @return {Void} - * @method add - */ - add : function (testObject /*:YAHOO.tool.TestSuite*/) /*:Void*/ { - if (testObject instanceof YAHOO.tool.TestSuite || testObject instanceof YAHOO.tool.TestCase) { - this.items.push(testObject); - } - }, - - //------------------------------------------------------------------------- - // Stub Methods - //------------------------------------------------------------------------- - - /** - * Function to run before each test is executed. - * @return {Void} - * @method setUp - */ - setUp : function () /*:Void*/ { - }, - - /** - * Function to run after each test is executed. - * @return {Void} - * @method tearDown - */ - tearDown: function () /*:Void*/ { - } - -}; - -YAHOO.namespace("tool"); - -/** - * The YUI test tool - * @module yuitest - * @namespace YAHOO.tool - * @requires yahoo,dom,event,logger - */ - - -//----------------------------------------------------------------------------- -// TestRunner object -//----------------------------------------------------------------------------- - -/** - * Runs test suites and test cases, providing events to allowing for the - * interpretation of test results. - * @namespace YAHOO.tool - * @class TestRunner - * @static - */ -YAHOO.tool.TestRunner = (function(){ - - /** - * A node in the test tree structure. May represent a TestSuite, TestCase, or - * test function. - * @param {Variant} testObject A TestSuite, TestCase, or the name of a test function. - * @class TestNode - * @constructor - * @private - */ - function TestNode(testObject /*:Variant*/){ - - /** - * The TestSuite, TestCase, or test function represented by this node. - * @type Variant - * @property testObject - */ - this.testObject = testObject; - - /** - * Pointer to this node's first child. - * @type TestNode - * @property firstChild - */ - this.firstChild /*:TestNode*/ = null; - - /** - * Pointer to this node's last child. - * @type TestNode - * @property lastChild - */ - this.lastChild = null; - - /** - * Pointer to this node's parent. - * @type TestNode - * @property parent - */ - this.parent = null; - - /** - * Pointer to this node's next sibling. - * @type TestNode - * @property next - */ - this.next = null; - - /** - * Test results for this test object. - * @type object - * @property results - */ - this.results /*:Object*/ = { - passed : 0, - failed : 0, - total : 0, - ignored : 0 - }; - - //initialize results - if (testObject instanceof YAHOO.tool.TestSuite){ - this.results.type = "testsuite"; - this.results.name = testObject.name; - } else if (testObject instanceof YAHOO.tool.TestCase){ - this.results.type = "testcase"; - this.results.name = testObject.name; - } - - } - - TestNode.prototype = { - - /** - * Appends a new test object (TestSuite, TestCase, or test function name) as a child - * of this node. - * @param {Variant} testObject A TestSuite, TestCase, or the name of a test function. - * @return {Void} - */ - appendChild : function (testObject /*:Variant*/) /*:Void*/{ - var node = new TestNode(testObject); - if (this.firstChild === null){ - this.firstChild = this.lastChild = node; - } else { - this.lastChild.next = node; - this.lastChild = node; - } - node.parent = this; - return node; - } - }; - - function TestRunner(){ - - //inherit from EventProvider - TestRunner.superclass.constructor.apply(this,arguments); - - /** - * Suite on which to attach all TestSuites and TestCases to be run. - * @type YAHOO.tool.TestSuite - * @property masterSuite - * @private - */ - this.masterSuite /*:YAHOO.tool.TestSuite*/ = new YAHOO.tool.TestSuite("YUI Test Results"); - - /** - * Pointer to the current node in the test tree. - * @type TestNode - * @private - * @property _cur - */ - this._cur = null; - - /** - * Pointer to the root node in the test tree. - * @type TestNode - * @private - * @property _root - */ - this._root = null; - - //create events - var events /*:Array*/ = [ - this.TEST_CASE_BEGIN_EVENT, - this.TEST_CASE_COMPLETE_EVENT, - this.TEST_SUITE_BEGIN_EVENT, - this.TEST_SUITE_COMPLETE_EVENT, - this.TEST_PASS_EVENT, - this.TEST_FAIL_EVENT, - this.TEST_IGNORE_EVENT, - this.COMPLETE_EVENT, - this.BEGIN_EVENT - ]; - for (var i=0; i < events.length; i++){ - this.createEvent(events[i], { scope: this }); - } - - } - - YAHOO.lang.extend(TestRunner, YAHOO.util.EventProvider, { - - //------------------------------------------------------------------------- - // Constants - //------------------------------------------------------------------------- - - /** - * Fires when a test case is opened but before the first - * test is executed. - * @event testcasebegin - */ - TEST_CASE_BEGIN_EVENT /*:String*/ : "testcasebegin", - - /** - * Fires when all tests in a test case have been executed. - * @event testcasecomplete - */ - TEST_CASE_COMPLETE_EVENT /*:String*/ : "testcasecomplete", - - /** - * Fires when a test suite is opened but before the first - * test is executed. - * @event testsuitebegin - */ - TEST_SUITE_BEGIN_EVENT /*:String*/ : "testsuitebegin", - - /** - * Fires when all test cases in a test suite have been - * completed. - * @event testsuitecomplete - */ - TEST_SUITE_COMPLETE_EVENT /*:String*/ : "testsuitecomplete", - - /** - * Fires when a test has passed. - * @event pass - */ - TEST_PASS_EVENT /*:String*/ : "pass", - - /** - * Fires when a test has failed. - * @event fail - */ - TEST_FAIL_EVENT /*:String*/ : "fail", - - /** - * Fires when a test has been ignored. - * @event ignore - */ - TEST_IGNORE_EVENT /*:String*/ : "ignore", - - /** - * Fires when all test suites and test cases have been completed. - * @event complete - */ - COMPLETE_EVENT /*:String*/ : "complete", - - /** - * Fires when the run() method is called. - * @event begin - */ - BEGIN_EVENT /*:String*/ : "begin", - - //------------------------------------------------------------------------- - // Test Tree-Related Methods - //------------------------------------------------------------------------- - - /** - * Adds a test case to the test tree as a child of the specified node. - * @param {TestNode} parentNode The node to add the test case to as a child. - * @param {YAHOO.tool.TestCase} testCase The test case to add. - * @return {Void} - * @static - * @private - * @method _addTestCaseToTestTree - */ - _addTestCaseToTestTree : function (parentNode /*:TestNode*/, testCase /*:YAHOO.tool.TestCase*/) /*:Void*/{ - - //add the test suite - var node = parentNode.appendChild(testCase); - - //iterate over the items in the test case - for (var prop in testCase){ - if (prop.indexOf("test") === 0 && YAHOO.lang.isFunction(testCase[prop])){ - node.appendChild(prop); - } - } - - }, - - /** - * Adds a test suite to the test tree as a child of the specified node. - * @param {TestNode} parentNode The node to add the test suite to as a child. - * @param {YAHOO.tool.TestSuite} testSuite The test suite to add. - * @return {Void} - * @static - * @private - * @method _addTestSuiteToTestTree - */ - _addTestSuiteToTestTree : function (parentNode /*:TestNode*/, testSuite /*:YAHOO.tool.TestSuite*/) /*:Void*/ { - - //add the test suite - var node = parentNode.appendChild(testSuite); - - //iterate over the items in the master suite - for (var i=0; i < testSuite.items.length; i++){ - if (testSuite.items[i] instanceof YAHOO.tool.TestSuite) { - this._addTestSuiteToTestTree(node, testSuite.items[i]); - } else if (testSuite.items[i] instanceof YAHOO.tool.TestCase) { - this._addTestCaseToTestTree(node, testSuite.items[i]); - } - } - }, - - /** - * Builds the test tree based on items in the master suite. The tree is a hierarchical - * representation of the test suites, test cases, and test functions. The resulting tree - * is stored in _root and the pointer _cur is set to the root initially. - * @return {Void} - * @static - * @private - * @method _buildTestTree - */ - _buildTestTree : function () /*:Void*/ { - - this._root = new TestNode(this.masterSuite); - this._cur = this._root; - - //iterate over the items in the master suite - for (var i=0; i < this.masterSuite.items.length; i++){ - if (this.masterSuite.items[i] instanceof YAHOO.tool.TestSuite) { - this._addTestSuiteToTestTree(this._root, this.masterSuite.items[i]); - } else if (this.masterSuite.items[i] instanceof YAHOO.tool.TestCase) { - this._addTestCaseToTestTree(this._root, this.masterSuite.items[i]); - } - } - - }, - - //------------------------------------------------------------------------- - // Private Methods - //------------------------------------------------------------------------- - - /** - * Handles the completion of a test object's tests. Tallies test results - * from one level up to the next. - * @param {TestNode} node The TestNode representing the test object. - * @return {Void} - * @method _handleTestObjectComplete - * @private - */ - _handleTestObjectComplete : function (node /*:TestNode*/) /*:Void*/ { - if (YAHOO.lang.isObject(node.testObject)){ - node.parent.results.passed += node.results.passed; - node.parent.results.failed += node.results.failed; - node.parent.results.total += node.results.total; - node.parent.results.ignored += node.results.ignored; - node.parent.results[node.testObject.name] = node.results; - - if (node.testObject instanceof YAHOO.tool.TestSuite){ - node.testObject.tearDown(); - this.fireEvent(this.TEST_SUITE_COMPLETE_EVENT, { testSuite: node.testObject, results: node.results}); - } else if (node.testObject instanceof YAHOO.tool.TestCase){ - this.fireEvent(this.TEST_CASE_COMPLETE_EVENT, { testCase: node.testObject, results: node.results}); - } - } - }, - - //------------------------------------------------------------------------- - // Navigation Methods - //------------------------------------------------------------------------- - - /** - * Retrieves the next node in the test tree. - * @return {TestNode} The next node in the test tree or null if the end is reached. - * @private - * @static - * @method _next - */ - _next : function () /*:TestNode*/ { - - if (this._cur.firstChild) { - this._cur = this._cur.firstChild; - } else if (this._cur.next) { - this._cur = this._cur.next; - } else { - while (this._cur && !this._cur.next && this._cur !== this._root){ - this._handleTestObjectComplete(this._cur); - this._cur = this._cur.parent; - } - - if (this._cur == this._root){ - this._cur.results.type = "report"; - this._cur.results.timestamp = (new Date()).toLocaleString(); - this.fireEvent(this.COMPLETE_EVENT, { results: this._cur.results}); - this._cur = null; - } else { - this._handleTestObjectComplete(this._cur); - this._cur = this._cur.next; - } - } - - return this._cur; - }, - - /** - * Runs a test case or test suite, returning the results. - * @param {YAHOO.tool.TestCase|YAHOO.tool.TestSuite} testObject The test case or test suite to run. - * @return {Object} Results of the execution with properties passed, failed, and total. - * @private - * @method _run - * @static - */ - _run : function () /*:Void*/ { - - //flag to indicate if the TestRunner should wait before continuing - var shouldWait /*:Boolean*/ = false; - - //get the next test node - var node = this._next(); - - if (node !== null) { - var testObject = node.testObject; - - //figure out what to do - if (YAHOO.lang.isObject(testObject)){ - if (testObject instanceof YAHOO.tool.TestSuite){ - this.fireEvent(this.TEST_SUITE_BEGIN_EVENT, { testSuite: testObject }); - testObject.setUp(); - } else if (testObject instanceof YAHOO.tool.TestCase){ - this.fireEvent(this.TEST_CASE_BEGIN_EVENT, { testCase: testObject }); - } - - //some environments don't support setTimeout - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._run(); - }, 0); - } else { - this._run(); - } - } else { - this._runTest(node); - } - - } - }, - - _resumeTest : function (segment /*:Function*/) /*:Void*/ { - - //get relevant information - var node /*:TestNode*/ = this._cur; - var testName /*:String*/ = node.testObject; - var testCase /*:YAHOO.tool.TestCase*/ = node.parent.testObject; - - //get the "should" test cases - var shouldFail /*:Object*/ = (testCase._should.fail || {})[testName]; - var shouldError /*:Object*/ = (testCase._should.error || {})[testName]; - - //variable to hold whether or not the test failed - var failed /*:Boolean*/ = false; - var error /*:Error*/ = null; - - //try the test - try { - - //run the test - segment.apply(testCase); - - //if it should fail, and it got here, then it's a fail because it didn't - if (shouldFail){ - error = new YAHOO.util.ShouldFail(); - failed = true; - } else if (shouldError){ - error = new YAHOO.util.ShouldError(); - failed = true; - } - - } catch (thrown /*:Error*/){ - if (thrown instanceof YAHOO.util.AssertionError) { - if (!shouldFail){ - error = thrown; - failed = true; - } - } else if (thrown instanceof YAHOO.tool.TestCase.Wait){ - - if (YAHOO.lang.isFunction(thrown.segment)){ - if (YAHOO.lang.isNumber(thrown.delay)){ - - //some environments don't support setTimeout - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._resumeTest(thrown.segment); - }, thrown.delay); - } else { - throw new Error("Asynchronous tests not supported in this environment."); - } - } - } - - return; - - } else { - //first check to see if it should error - if (!shouldError) { - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } else { - //check to see what type of data we have - if (YAHOO.lang.isString(shouldError)){ - - //if it's a string, check the error message - if (thrown.message != shouldError){ - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } - } else if (YAHOO.lang.isFunction(shouldError)){ - - //if it's a function, see if the error is an instance of it - if (!(thrown instanceof shouldError)){ - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } - - } else if (YAHOO.lang.isObject(shouldError)){ - - //if it's an object, check the instance and message - if (!(thrown instanceof shouldError.constructor) || - thrown.message != shouldError.message){ - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } - - } - - } - } - - } - - //fireEvent appropriate event - if (failed) { - this.fireEvent(this.TEST_FAIL_EVENT, { testCase: testCase, testName: testName, error: error }); - } else { - this.fireEvent(this.TEST_PASS_EVENT, { testCase: testCase, testName: testName }); - } - - //run the tear down - testCase.tearDown(); - - //update results - node.parent.results[testName] = { - result: failed ? "fail" : "pass", - message: error ? error.getMessage() : "Test passed", - type: "test", - name: testName - }; - - if (failed){ - node.parent.results.failed++; - } else { - node.parent.results.passed++; - } - node.parent.results.total++; - - //set timeout not supported in all environments - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._run(); - }, 0); - } else { - this._run(); - } - - }, - - /** - * Runs a single test based on the data provided in the node. - * @param {TestNode} node The TestNode representing the test to run. - * @return {Void} - * @static - * @private - * @name _runTest - */ - _runTest : function (node /*:TestNode*/) /*:Void*/ { - - //get relevant information - var testName /*:String*/ = node.testObject; - var testCase /*:YAHOO.tool.TestCase*/ = node.parent.testObject; - var test /*:Function*/ = testCase[testName]; - - //get the "should" test cases - var shouldIgnore /*:Object*/ = (testCase._should.ignore || {})[testName]; - - //figure out if the test should be ignored or not - if (shouldIgnore){ - - //update results - node.parent.results[testName] = { - result: "ignore", - message: "Test ignored", - type: "test", - name: testName - }; - - node.parent.results.ignored++; - node.parent.results.total++; - - this.fireEvent(this.TEST_IGNORE_EVENT, { testCase: testCase, testName: testName }); - - //some environments don't support setTimeout - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._run(); - }, 0); - } else { - this._run(); - } - - } else { - - //run the setup - testCase.setUp(); - - //now call the body of the test - this._resumeTest(test); - } - - }, - - //------------------------------------------------------------------------- - // Protected Methods - //------------------------------------------------------------------------- - - /* - * Fires events for the TestRunner. This overrides the default fireEvent() - * method from EventProvider to add the type property to the data that is - * passed through on each event call. - * @param {String} type The type of event to fire. - * @param {Object} data (Optional) Data for the event. - * @method fireEvent - * @static - * @protected - */ - fireEvent : function (type /*:String*/, data /*:Object*/) /*:Void*/ { - data = data || {}; - data.type = type; - TestRunner.superclass.fireEvent.call(this, type, data); - }, - - //------------------------------------------------------------------------- - // Public Methods - //------------------------------------------------------------------------- - - /** - * Adds a test suite or test case to the list of test objects to run. - * @param testObject Either a TestCase or a TestSuite that should be run. - * @return {Void} - * @method add - * @static - */ - add : function (testObject /*:Object*/) /*:Void*/ { - this.masterSuite.add(testObject); - }, - - /** - * Removes all test objects from the runner. - * @return {Void} - * @method clear - * @static - */ - clear : function () /*:Void*/ { - this.masterSuite.items = []; - }, - - /** - * Resumes the TestRunner after wait() was called. - * @param {Function} segment The function to run as the rest - * of the haulted test. - * @return {Void} - * @method resume - * @static - */ - resume : function (segment /*:Function*/) /*:Void*/ { - this._resumeTest(segment || function(){}); - }, - - /** - * Runs the test suite. - * @return {Void} - * @method run - * @static - */ - run : function (testObject /*:Object*/) /*:Void*/ { - - //pointer to runner to avoid scope issues - var runner = YAHOO.tool.TestRunner; - - //build the test tree - runner._buildTestTree(); - - //fire the begin event - runner.fireEvent(runner.BEGIN_EVENT); - - //begin the testing - runner._run(); - } - }); - - return new TestRunner(); - -})(); - -YAHOO.namespace("util"); - -//----------------------------------------------------------------------------- -// Assert object -//----------------------------------------------------------------------------- - -/** - * The Assert object provides functions to test JavaScript values against - * known and expected results. Whenever a comparison (assertion) fails, - * an error is thrown. - * - * @namespace YAHOO.util - * @class Assert - * @static - */ -YAHOO.util.Assert = { - - //------------------------------------------------------------------------- - // Generic Assertion Methods - //------------------------------------------------------------------------- - - /** - * Forces an assertion error to occur. - * @param {String} message (Optional) The message to display with the failure. - * @method fail - * @static - */ - fail : function (message /*:String*/) /*:Void*/ { - throw new YAHOO.util.AssertionError(message || "Test force-failed."); - }, - - //------------------------------------------------------------------------- - // Equality Assertion Methods - //------------------------------------------------------------------------- - - /** - * Asserts that a value is equal to another. This uses the double equals sign - * so type cohersion may occur. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areEqual - * @static - */ - areEqual : function (expected /*:Object*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (expected != actual) { - throw new YAHOO.util.ComparisonFailure(message || "Values should be equal.", expected, actual); - } - }, - - /** - * Asserts that a value is not equal to another. This uses the double equals sign - * so type cohersion may occur. - * @param {Object} unexpected The unexpected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areNotEqual - * @static - */ - areNotEqual : function (unexpected /*:Object*/, actual /*:Object*/, - message /*:String*/) /*:Void*/ { - if (unexpected == actual) { - throw new YAHOO.util.UnexpectedValue(message || "Values should not be equal.", unexpected); - } - }, - - /** - * Asserts that a value is not the same as another. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} unexpected The unexpected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areNotSame - * @static - */ - areNotSame : function (unexpected /*:Object*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (unexpected === actual) { - throw new YAHOO.util.UnexpectedValue(message || "Values should not be the same.", unexpected); - } - }, - - /** - * Asserts that a value is the same as another. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areSame - * @static - */ - areSame : function (expected /*:Object*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (expected !== actual) { - throw new YAHOO.util.ComparisonFailure(message || "Values should be the same.", expected, actual); - } - }, - - //------------------------------------------------------------------------- - // Boolean Assertion Methods - //------------------------------------------------------------------------- - - /** - * Asserts that a value is false. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isFalse - * @static - */ - isFalse : function (actual /*:Boolean*/, message /*:String*/) { - if (false !== actual) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be false.", false, actual); - } - }, - - /** - * Asserts that a value is true. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isTrue - * @static - */ - isTrue : function (actual /*:Boolean*/, message /*:String*/) /*:Void*/ { - if (true !== actual) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be true.", true, actual); - } - - }, - - //------------------------------------------------------------------------- - // Special Value Assertion Methods - //------------------------------------------------------------------------- - - /** - * Asserts that a value is not a number. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNaN - * @static - */ - isNaN : function (actual /*:Object*/, message /*:String*/) /*:Void*/{ - if (!isNaN(actual)){ - throw new YAHOO.util.ComparisonFailure(message || "Value should be NaN.", NaN, actual); - } - }, - - /** - * Asserts that a value is not the special NaN value. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotNaN - * @static - */ - isNotNaN : function (actual /*:Object*/, message /*:String*/) /*:Void*/{ - if (isNaN(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Values should not be NaN.", NaN); - } - }, - - /** - * Asserts that a value is not null. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotNull - * @static - */ - isNotNull : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (YAHOO.lang.isNull(actual)) { - throw new YAHOO.util.UnexpectedValue(message || "Values should not be null.", null); - } - }, - - /** - * Asserts that a value is not undefined. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotUndefined - * @static - */ - isNotUndefined : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (YAHOO.lang.isUndefined(actual)) { - throw new YAHOO.util.UnexpectedValue(message || "Value should not be undefined.", undefined); - } - }, - - /** - * Asserts that a value is null. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNull - * @static - */ - isNull : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isNull(actual)) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be null.", null, actual); - } - }, - - /** - * Asserts that a value is undefined. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isUndefined - * @static - */ - isUndefined : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isUndefined(actual)) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be undefined.", undefined, actual); - } - }, - - //-------------------------------------------------------------------------- - // Instance Assertion Methods - //-------------------------------------------------------------------------- - - /** - * Asserts that a value is an array. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isArray - * @static - */ - isArray : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isArray(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be an array.", actual); - } - }, - - /** - * Asserts that a value is a Boolean. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isBoolean - * @static - */ - isBoolean : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isBoolean(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a Boolean.", actual); - } - }, - - /** - * Asserts that a value is a function. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isFunction - * @static - */ - isFunction : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isFunction(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a function.", actual); - } - }, - - /** - * Asserts that a value is an instance of a particular object. This may return - * incorrect results when comparing objects from one frame to constructors in - * another frame. For best results, don't use in a cross-frame manner. - * @param {Function} expected The function that the object should be an instance of. - * @param {Object} actual The object to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isInstanceOf - * @static - */ - isInstanceOf : function (expected /*:Function*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!(actual instanceof expected)){ - throw new YAHOO.util.ComparisonFailure(message || "Value isn't an instance of expected type.", expected, actual); - } - }, - - /** - * Asserts that a value is a number. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNumber - * @static - */ - isNumber : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isNumber(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a number.", actual); - } - }, - - /** - * Asserts that a value is an object. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isObject - * @static - */ - isObject : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isObject(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be an object.", actual); - } - }, - - /** - * Asserts that a value is a string. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isString - * @static - */ - isString : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isString(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a string.", actual); - } - }, - - /** - * Asserts that a value is of a particular type. - * @param {String} expectedType The expected type of the variable. - * @param {Object} actualValue The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isTypeOf - * @static - */ - isTypeOf : function (expectedType /*:String*/, actualValue /*:Object*/, message /*:String*/) /*:Void*/{ - if (typeof actualValue != expectedType){ - throw new YAHOO.util.ComparisonFailure(message || "Value should be of type " + expected + ".", expected, typeof actual); - } - } -}; - -//----------------------------------------------------------------------------- -// Assertion errors -//----------------------------------------------------------------------------- - -/** - * AssertionError is thrown whenever an assertion fails. It provides methods - * to more easily get at error information and also provides a base class - * from which more specific assertion errors can be derived. - * - * @param {String} message The message to display when the error occurs. - * @namespace YAHOO.util - * @class AssertionError - * @extends Error - * @constructor - */ -YAHOO.util.AssertionError = function (message /*:String*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message); - - /* - * Error message. Must be duplicated to ensure browser receives it. - * @type String - * @property message - */ - this.message /*:String*/ = message; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "AssertionError"; -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.AssertionError, Error, { - - /** - * Returns a fully formatted error for an assertion failure. This should - * be overridden by all subclasses to provide specific information. - * @method getMessage - * @return {String} A string describing the error. - */ - getMessage : function () /*:String*/ { - return this.message; - }, - - /** - * Returns a string representation of the error. - * @method toString - * @return {String} A string representation of the error. - */ - toString : function () /*:String*/ { - return this.name + ": " + this.getMessage(); - }, - - /** - * Returns a primitive value version of the error. Same as toString(). - * @method valueOf - * @return {String} A primitive value version of the error. - */ - valueOf : function () /*:String*/ { - return this.toString(); - } - -}); - -/** - * ComparisonFailure is subclass of AssertionError that is thrown whenever - * a comparison between two values fails. It provides mechanisms to retrieve - * both the expected and actual value. - * - * @param {String} message The message to display when the error occurs. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value that caused the assertion to fail. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class ComparisonFailure - * @constructor - */ -YAHOO.util.ComparisonFailure = function (message /*:String*/, expected /*:Object*/, actual /*:Object*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message); - - /** - * The expected value. - * @type Object - * @property expected - */ - this.expected /*:Object*/ = expected; - - /** - * The actual value. - * @type Object - * @property actual - */ - this.actual /*:Object*/ = actual; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "ComparisonFailure"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.ComparisonFailure, YAHOO.util.AssertionError, { - - /** - * Returns a fully formatted error for an assertion failure. This message - * provides information about the expected and actual values. - * @method toString - * @return {String} A string describing the error. - */ - getMessage : function () /*:String*/ { - return this.message + "\nExpected: " + this.expected + " (" + (typeof this.expected) + ")" + - "\nActual:" + this.actual + " (" + (typeof this.actual) + ")"; - } - -}); - -/** - * UnexpectedValue is subclass of AssertionError that is thrown whenever - * a value was unexpected in its scope. This typically means that a test - * was performed to determine that a value was *not* equal to a certain - * value. - * - * @param {String} message The message to display when the error occurs. - * @param {Object} unexpected The unexpected value. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class UnexpectedValue - * @constructor - */ -YAHOO.util.UnexpectedValue = function (message /*:String*/, unexpected /*:Object*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message); - - /** - * The unexpected value. - * @type Object - * @property unexpected - */ - this.unexpected /*:Object*/ = unexpected; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "UnexpectedValue"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.UnexpectedValue, YAHOO.util.AssertionError, { - - /** - * Returns a fully formatted error for an assertion failure. The message - * contains information about the unexpected value that was encountered. - * @method getMessage - * @return {String} A string describing the error. - */ - getMessage : function () /*:String*/ { - return this.message + "\nUnexpected: " + this.unexpected + " (" + (typeof this.unexpected) + ") "; - } - -}); - -/** - * ShouldFail is subclass of AssertionError that is thrown whenever - * a test was expected to fail but did not. - * - * @param {String} message The message to display when the error occurs. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class ShouldFail - * @constructor - */ -YAHOO.util.ShouldFail = function (message /*:String*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message || "This test should fail but didn't."); - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "ShouldFail"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.ShouldFail, YAHOO.util.AssertionError); - -/** - * ShouldError is subclass of AssertionError that is thrown whenever - * a test is expected to throw an error but doesn't. - * - * @param {String} message The message to display when the error occurs. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class ShouldError - * @constructor - */ -YAHOO.util.ShouldError = function (message /*:String*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message || "This test should have thrown an error but didn't."); - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "ShouldError"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.ShouldError, YAHOO.util.AssertionError); - -/** - * UnexpectedError is subclass of AssertionError that is thrown whenever - * an error occurs within the course of a test and the test was not expected - * to throw an error. - * - * @param {Error} cause The unexpected error that caused this error to be - * thrown. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class UnexpectedError - * @constructor - */ -YAHOO.util.UnexpectedError = function (cause /*:Object*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, "Unexpected error: " + cause.message); - - /** - * The unexpected error that occurred. - * @type Error - * @property cause - */ - this.cause /*:Error*/ = cause; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "UnexpectedError"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.UnexpectedError, YAHOO.util.AssertionError); - -//----------------------------------------------------------------------------- -// ArrayAssert object -//----------------------------------------------------------------------------- - -/** - * The ArrayAssert object provides functions to test JavaScript array objects - * for a variety of cases. - * - * @namespace YAHOO.util - * @class ArrayAssert - * @static - */ - -YAHOO.util.ArrayAssert = { - - /** - * Asserts that a value is present in an array. This uses the triple equals - * sign so no type cohersion may occur. - * @param {Object} needle The value that is expected in the array. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method contains - * @static - */ - contains : function (needle /*:Object*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (haystack[i] === needle) { - found = true; - } - } - - if (!found){ - YAHOO.util.Assert.fail(message || "Value (" + needle + ") not found in array."); - } - }, - - /** - * Asserts that a set of values are present in an array. This uses the triple equals - * sign so no type cohersion may occur. For this assertion to pass, all values must - * be found. - * @param {Object[]} needles An array of values that are expected in the array. - * @param {Array} haystack An array of values to check. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method containsItems - * @static - */ - containsItems : function (needles /*:Object[]*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - //begin checking values - for (var i=0; i < needles.length; i++){ - this.contains(needles[i], haystack, message); - } - - if (!found){ - YAHOO.util.Assert.fail(message || "Value not found in array."); - } - }, - - /** - * Asserts that a value matching some condition is present in an array. This uses - * a function to determine a match. - * @param {Function} matcher A function that returns true if the items matches or false if not. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method containsMatch - * @static - */ - containsMatch : function (matcher /*:Function*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - //check for valid matcher - if (typeof matcher != "function"){ - throw new TypeError("ArrayAssert.containsMatch(): First argument must be a function."); - } - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (matcher(haystack[i])) { - found = true; - } - } - - if (!found){ - YAHOO.util.Assert.fail(message || "No match found in array."); - } - }, - - /** - * Asserts that a value is not present in an array. This uses the triple equals - * sign so no type cohersion may occur. - * @param {Object} needle The value that is expected in the array. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method doesNotContain - * @static - */ - doesNotContain : function (needle /*:Object*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (haystack[i] === needle) { - found = true; - } - } - - if (found){ - YAHOO.util.Assert.fail(message || "Value found in array."); - } - }, - - /** - * Asserts that a set of values are not present in an array. This uses the triple equals - * sign so no type cohersion may occur. For this assertion to pass, all values must - * not be found. - * @param {Object[]} needles An array of values that are not expected in the array. - * @param {Array} haystack An array of values to check. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method doesNotContainItems - * @static - */ - doesNotContainItems : function (needles /*:Object[]*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - for (var i=0; i < needles.length; i++){ - this.doesNotContain(needles[i], haystack, message); - } - - }, - - /** - * Asserts that no values matching a condition are present in an array. This uses - * a function to determine a match. - * @param {Function} matcher A function that returns true if the items matches or false if not. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method doesNotContainMatch - * @static - */ - doesNotContainMatch : function (matcher /*:Function*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - //check for valid matcher - if (typeof matcher != "function"){ - throw new TypeError("ArrayAssert.doesNotContainMatch(): First argument must be a function."); - } - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (matcher(haystack[i])) { - found = true; - } - } - - if (found){ - YAHOO.util.Assert.fail(message || "Value found in array."); - } - }, - - /** - * Asserts that the given value is contained in an array at the specified index. - * This uses the triple equals sign so no type cohersion will occur. - * @param {Object} needle The value to look for. - * @param {Array} haystack The array to search in. - * @param {int} index The index at which the value should exist. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method indexOf - * @static - */ - indexOf : function (needle /*:Object*/, haystack /*:Array*/, index /*:int*/, message /*:String*/) /*:Void*/ { - - //try to find the value in the array - for (var i=0; i < haystack.length; i++){ - if (haystack[i] === needle){ - YAHOO.util.Assert.areEqual(index, i, message || "Value exists at index " + i + " but should be at index " + index + "."); - return; - } - } - - //if it makes it here, it wasn't found at all - YAHOO.util.Assert.fail(message || "Value doesn't exist in array."); - }, - - /** - * Asserts that the values in an array are equal, and in the same position, - * as values in another array. This uses the double equals sign - * so type cohersion may occur. Note that the array objects themselves - * need not be the same for this test to pass. - * @param {Array} expected An array of the expected values. - * @param {Array} actual Any array of the actual values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method itemsAreEqual - * @static - */ - itemsAreEqual : function (expected /*:Array*/, actual /*:Array*/, - message /*:String*/) /*:Void*/ { - - //one may be longer than the other, so get the maximum length - var len /*:int*/ = Math.max(expected.length, actual.length); - - //begin checking values - for (var i=0; i < len; i++){ - YAHOO.util.Assert.areEqual(expected[i], actual[i], message || - "Values in position " + i + " are not equal."); - } - }, - - /** - * Asserts that the values in an array are equivalent, and in the same position, - * as values in another array. This uses a function to determine if the values - * are equivalent. Note that the array objects themselves - * need not be the same for this test to pass. - * @param {Array} expected An array of the expected values. - * @param {Array} actual Any array of the actual values. - * @param {Function} comparator A function that returns true if the values are equivalent - * or false if not. - * @param {String} message (Optional) The message to display if the assertion fails. - * @return {Void} - * @method itemsAreEquivalent - * @static - */ - itemsAreEquivalent : function (expected /*:Array*/, actual /*:Array*/, - comparator /*:Function*/, message /*:String*/) /*:Void*/ { - - //make sure the comparator is valid - if (typeof comparator != "function"){ - throw new TypeError("ArrayAssert.itemsAreEquivalent(): Third argument must be a function."); - } - - //one may be longer than the other, so get the maximum length - var len /*:int*/ = Math.max(expected.length, actual.length); - - //begin checking values - for (var i=0; i < len; i++){ - if (!comparator(expected[i], actual[i])){ - throw new YAHOO.util.ComparisonFailure(message || "Values in position " + i + " are not equivalent.", expected[i], actual[i]); - } - } - }, - - /** - * Asserts that an array is empty. - * @param {Array} actual The array to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isEmpty - * @static - */ - isEmpty : function (actual /*:Array*/, message /*:String*/) /*:Void*/ { - if (actual.length > 0){ - YAHOO.util.Assert.fail(message || "Array should be empty."); - } - }, - - /** - * Asserts that an array is not empty. - * @param {Array} actual The array to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotEmpty - * @static - */ - isNotEmpty : function (actual /*:Array*/, message /*:String*/) /*:Void*/ { - if (actual.length === 0){ - YAHOO.util.Assert.fail(message || "Array should not be empty."); - } - }, - - /** - * Asserts that the values in an array are the same, and in the same position, - * as values in another array. This uses the triple equals sign - * so no type cohersion will occur. Note that the array objects themselves - * need not be the same for this test to pass. - * @param {Array} expected An array of the expected values. - * @param {Array} actual Any array of the actual values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method itemsAreSame - * @static - */ - itemsAreSame : function (expected /*:Array*/, actual /*:Array*/, - message /*:String*/) /*:Void*/ { - - //one may be longer than the other, so get the maximum length - var len /*:int*/ = Math.max(expected.length, actual.length); - - //begin checking values - for (var i=0; i < len; i++){ - YAHOO.util.Assert.areSame(expected[i], actual[i], - message || "Values in position " + i + " are not the same."); - } - }, - - /** - * Asserts that the given value is contained in an array at the specified index, - * starting from the back of the array. - * This uses the triple equals sign so no type cohersion will occur. - * @param {Object} needle The value to look for. - * @param {Array} haystack The array to search in. - * @param {int} index The index at which the value should exist. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method lastIndexOf - * @static - */ - lastIndexOf : function (needle /*:Object*/, haystack /*:Array*/, index /*:int*/, message /*:String*/) /*:Void*/ { - - //try to find the value in the array - for (var i=haystack.length; i >= 0; i--){ - if (haystack[i] === needle){ - YAHOO.util.Assert.areEqual(index, i, message || "Value exists at index " + i + " but should be at index " + index + "."); - return; - } - } - - //if it makes it here, it wasn't found at all - YAHOO.util.Assert.fail(message || "Value doesn't exist in array."); - } - -}; - -YAHOO.namespace("util"); - - -//----------------------------------------------------------------------------- -// ObjectAssert object -//----------------------------------------------------------------------------- - -/** - * The ObjectAssert object provides functions to test JavaScript objects - * for a variety of cases. - * - * @namespace YAHOO.util - * @class ObjectAssert - * @static - */ -YAHOO.util.ObjectAssert = { - - /** - * Asserts that all properties in the object exist in another object. - * @param {Object} expected An object with the expected properties. - * @param {Object} actual An object with the actual properties. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method propertiesAreEqual - * @static - */ - propertiesAreEqual : function (expected /*:Object*/, actual /*:Object*/, - message /*:String*/) /*:Void*/ { - - //get all properties in the object - var properties /*:Array*/ = []; - for (var property in expected){ - properties.push(property); - } - - //see if the properties are in the expected object - for (var i=0; i < properties.length; i++){ - YAHOO.util.Assert.isNotUndefined(actual[properties[i]], message || - "Property'" + properties[i] + "' expected."); - } - - }, - - /** - * Asserts that an object has a property with the given name. - * @param {String} propertyName The name of the property to test. - * @param {Object} object The object to search. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method hasProperty - * @static - */ - hasProperty : function (propertyName /*:String*/, object /*:Object*/, message /*:String*/) /*:Void*/ { - if (YAHOO.lang.isUndefined(object[propertyName])){ - YAHOO.util.Assert.fail(message || - "Property " + propertyName + " not found on object."); - } - }, - - /** - * Asserts that a property with the given name exists on an object instance (not on its prototype). - * @param {String} propertyName The name of the property to test. - * @param {Object} object The object to search. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method hasProperty - * @static - */ - hasOwnProperty : function (propertyName /*:String*/, object /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.hasOwnProperty(object, propertyName)){ - YAHOO.util.Assert.fail(message || - "Property " + propertyName + " not found on object instance."); - } - } -}; - -//----------------------------------------------------------------------------- -// DateAssert object -//----------------------------------------------------------------------------- - -/** - * The DateAssert object provides functions to test JavaScript Date objects - * for a variety of cases. - * - * @namespace YAHOO.util - * @class DateAssert - * @static - */ - -YAHOO.util.DateAssert = { - - /** - * Asserts that a date's month, day, and year are equal to another date's. - * @param {Date} expected The expected date. - * @param {Date} actual The actual date to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areEqual - * @static - */ - datesAreEqual : function (expected /*:Date*/, actual /*:Date*/, message /*:String*/){ - if (expected instanceof Date && actual instanceof Date){ - YAHOO.util.Assert.areEqual(expected.getFullYear(), actual.getFullYear(), message || "Years should be equal."); - YAHOO.util.Assert.areEqual(expected.getMonth(), actual.getMonth(), message || "Months should be equal."); - YAHOO.util.Assert.areEqual(expected.getDate(), actual.getDate(), message || "Day of month should be equal."); - } else { - throw new TypeError("DateAssert.datesAreEqual(): Expected and actual values must be Date objects."); - } - }, - - /** - * Asserts that a date's hour, minutes, and seconds are equal to another date's. - * @param {Date} expected The expected date. - * @param {Date} actual The actual date to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areEqual - * @static - */ - timesAreEqual : function (expected /*:Date*/, actual /*:Date*/, message /*:String*/){ - if (expected instanceof Date && actual instanceof Date){ - YAHOO.util.Assert.areEqual(expected.getHours(), actual.getHours(), message || "Hours should be equal."); - YAHOO.util.Assert.areEqual(expected.getMinutes(), actual.getMinutes(), message || "Minutes should be equal."); - YAHOO.util.Assert.areEqual(expected.getSeconds(), actual.getSeconds(), message || "Seconds should be equal."); - } else { - throw new TypeError("DateAssert.timesAreEqual(): Expected and actual values must be Date objects."); - } - } - -}; - -YAHOO.namespace("util"); - -/** - * The UserAction object provides functions that simulate events occurring in - * the browser. Since these are simulated events, they do not behave exactly - * as regular, user-initiated events do, but can be used to test simple - * user interactions safely. - * - * @namespace YAHOO.util - * @class UserAction - * @static - */ -YAHOO.util.UserAction = { - - //-------------------------------------------------------------------------- - // Generic event methods - //-------------------------------------------------------------------------- - - /** - * Simulates a key event using the given event information to populate - * the generated event object. This method does browser-equalizing - * calculations to account for differences in the DOM and IE event models - * as well as different browser quirks. Note: keydown causes Safari 2.x to - * crash. - * @method simulateKeyEvent - * @private - * @static - * @param {HTMLElement} target The target of the given event. - * @param {String} type The type of event to fire. This can be any one of - * the following: keyup, keydown, and keypress. - * @param {Boolean} bubbles (Optional) Indicates if the event can be - * bubbled up. DOM Level 3 specifies that all key events bubble by - * default. The default is true. - * @param {Boolean} cancelable (Optional) Indicates if the event can be - * canceled using preventDefault(). DOM Level 3 specifies that all - * key events can be cancelled. The default - * is true. - * @param {Window} view (Optional) The view containing the target. This is - * typically the window object. The default is window. - * @param {Boolean} ctrlKey (Optional) Indicates if one of the CTRL keys - * is pressed while the event is firing. The default is false. - * @param {Boolean} altKey (Optional) Indicates if one of the ALT keys - * is pressed while the event is firing. The default is false. - * @param {Boolean} shiftKey (Optional) Indicates if one of the SHIFT keys - * is pressed while the event is firing. The default is false. - * @param {Boolean} metaKey (Optional) Indicates if one of the META keys - * is pressed while the event is firing. The default is false. - * @param {int} keyCode (Optional) The code for the key that is in use. - * The default is 0. - * @param {int} charCode (Optional) The Unicode code for the character - * associated with the key being used. The default is 0. - */ - simulateKeyEvent : function (target /*:HTMLElement*/, type /*:String*/, - bubbles /*:Boolean*/, cancelable /*:Boolean*/, - view /*:Window*/, - ctrlKey /*:Boolean*/, altKey /*:Boolean*/, - shiftKey /*:Boolean*/, metaKey /*:Boolean*/, - keyCode /*:int*/, charCode /*:int*/) /*:Void*/ - { - //check target - target = YAHOO.util.Dom.get(target); - if (!target){ - throw new Error("simulateKeyEvent(): Invalid target."); - } - - //check event type - if (YAHOO.lang.isString(type)){ - type = type.toLowerCase(); - switch(type){ - case "keyup": - case "keydown": - case "keypress": - break; - case "textevent": //DOM Level 3 - type = "keypress"; - break; - // @TODO was the fallthrough intentional, if so throw error - default: - throw new Error("simulateKeyEvent(): Event type '" + type + "' not supported."); - } - } else { - throw new Error("simulateKeyEvent(): Event type must be a string."); - } - - //setup default values - if (!YAHOO.lang.isBoolean(bubbles)){ - bubbles = true; //all key events bubble - } - if (!YAHOO.lang.isBoolean(cancelable)){ - cancelable = true; //all key events can be cancelled - } - if (!YAHOO.lang.isObject(view)){ - view = window; //view is typically window - } - if (!YAHOO.lang.isBoolean(ctrlKey)){ - ctrlKey = false; - } - if (!YAHOO.lang.isBoolean(altKey)){ - altKey = false; - } - if (!YAHOO.lang.isBoolean(shiftKey)){ - shiftKey = false; - } - if (!YAHOO.lang.isBoolean(metaKey)){ - metaKey = false; - } - if (!YAHOO.lang.isNumber(keyCode)){ - keyCode = 0; - } - if (!YAHOO.lang.isNumber(charCode)){ - charCode = 0; - } - - //try to create a mouse event - var customEvent /*:MouseEvent*/ = null; - - //check for DOM-compliant browsers first - if (YAHOO.lang.isFunction(document.createEvent)){ - - try { - - //try to create key event - customEvent = document.createEvent("KeyEvents"); - - /* - * Interesting problem: Firefox implemented a non-standard - * version of initKeyEvent() based on DOM Level 2 specs. - * Key event was removed from DOM Level 2 and re-introduced - * in DOM Level 3 with a different interface. Firefox is the - * only browser with any implementation of Key Events, so for - * now, assume it's Firefox if the above line doesn't error. - */ - //TODO: Decipher between Firefox's implementation and a correct one. - customEvent.initKeyEvent(type, bubbles, cancelable, view, ctrlKey, - altKey, shiftKey, metaKey, keyCode, charCode); - - } catch (ex /*:Error*/){ - - /* - * If it got here, that means key events aren't officially supported. - * Safari/WebKit is a real problem now. WebKit 522 won't let you - * set keyCode, charCode, or other properties if you use a - * UIEvent, so we first must try to create a generic event. The - * fun part is that this will throw an error on Safari 2.x. The - * end result is that we need another try...catch statement just to - * deal with this mess. - */ - try { - - //try to create generic event - will fail in Safari 2.x - customEvent = document.createEvent("Events"); - - } catch (uierror /*:Error*/){ - - //the above failed, so create a UIEvent for Safari 2.x - customEvent = document.createEvent("UIEvents"); - - } finally { - - customEvent.initEvent(type, bubbles, cancelable); - - //initialize - customEvent.view = view; - customEvent.altKey = altKey; - customEvent.ctrlKey = ctrlKey; - customEvent.shiftKey = shiftKey; - customEvent.metaKey = metaKey; - customEvent.keyCode = keyCode; - customEvent.charCode = charCode; - - } - - } - - //fire the event - target.dispatchEvent(customEvent); - - } else if (YAHOO.lang.isObject(document.createEventObject)){ //IE - - //create an IE event object - customEvent = document.createEventObject(); - - //assign available properties - customEvent.bubbles = bubbles; - customEvent.cancelable = cancelable; - customEvent.view = view; - customEvent.ctrlKey = ctrlKey; - customEvent.altKey = altKey; - customEvent.shiftKey = shiftKey; - customEvent.metaKey = metaKey; - - /* - * IE doesn't support charCode explicitly. CharCode should - * take precedence over any keyCode value for accurate - * representation. - */ - customEvent.keyCode = (charCode > 0) ? charCode : keyCode; - - //fire the event - target.fireEvent("on" + type, customEvent); - - } else { - throw new Error("simulateKeyEvent(): No event simulation framework present."); - } - }, - - /** - * Simulates a mouse event using the given event information to populate - * the generated event object. This method does browser-equalizing - * calculations to account for differences in the DOM and IE event models - * as well as different browser quirks. - * @method simulateMouseEvent - * @private - * @static - * @param {HTMLElement} target The target of the given event. - * @param {String} type The type of event to fire. This can be any one of - * the following: click, dblclick, mousedown, mouseup, mouseout, - * mouseover, and mousemove. - * @param {Boolean} bubbles (Optional) Indicates if the event can be - * bubbled up. DOM Level 2 specifies that all mouse events bubble by - * default. The default is true. - * @param {Boolean} cancelable (Optional) Indicates if the event can be - * canceled using preventDefault(). DOM Level 2 specifies that all - * mouse events except mousemove can be cancelled. The default - * is true for all events except mousemove, for which the default - * is false. - * @param {Window} view (Optional) The view containing the target. This is - * typically the window object. The default is window. - * @param {int} detail (Optional) The number of times the mouse button has - * been used. The default value is 1. - * @param {int} screenX (Optional) The x-coordinate on the screen at which - * point the event occured. The default is 0. - * @param {int} screenY (Optional) The y-coordinate on the screen at which - * point the event occured. The default is 0. - * @param {int} clientX (Optional) The x-coordinate on the client at which - * point the event occured. The default is 0. - * @param {int} clientY (Optional) The y-coordinate on the client at which - * point the event occured. The default is 0. - * @param {Boolean} ctrlKey (Optional) Indicates if one of the CTRL keys - * is pressed while the event is firing. The default is false. - * @param {Boolean} altKey (Optional) Indicates if one of the ALT keys - * is pressed while the event is firing. The default is false. - * @param {Boolean} shiftKey (Optional) Indicates if one of the SHIFT keys - * is pressed while the event is firing. The default is false. - * @param {Boolean} metaKey (Optional) Indicates if one of the META keys - * is pressed while the event is firing. The default is false. - * @param {int} button (Optional) The button being pressed while the event - * is executing. The value should be 0 for the primary mouse button - * (typically the left button), 1 for the terciary mouse button - * (typically the middle button), and 2 for the secondary mouse button - * (typically the right button). The default is 0. - * @param {HTMLElement} relatedTarget (Optional) For mouseout events, - * this is the element that the mouse has moved to. For mouseover - * events, this is the element that the mouse has moved from. This - * argument is ignored for all other events. The default is null. - */ - simulateMouseEvent : function (target /*:HTMLElement*/, type /*:String*/, - bubbles /*:Boolean*/, cancelable /*:Boolean*/, - view /*:Window*/, detail /*:int*/, - screenX /*:int*/, screenY /*:int*/, - clientX /*:int*/, clientY /*:int*/, - ctrlKey /*:Boolean*/, altKey /*:Boolean*/, - shiftKey /*:Boolean*/, metaKey /*:Boolean*/, - button /*:int*/, relatedTarget /*:HTMLElement*/) /*:Void*/ - { - - //check target - target = YAHOO.util.Dom.get(target); - if (!target){ - throw new Error("simulateMouseEvent(): Invalid target."); - } - - //check event type - if (YAHOO.lang.isString(type)){ - type = type.toLowerCase(); - switch(type){ - case "mouseover": - case "mouseout": - case "mousedown": - case "mouseup": - case "click": - case "dblclick": - case "mousemove": - break; - default: - throw new Error("simulateMouseEvent(): Event type '" + type + "' not supported."); - } - } else { - throw new Error("simulateMouseEvent(): Event type must be a string."); - } - - //setup default values - if (!YAHOO.lang.isBoolean(bubbles)){ - bubbles = true; //all mouse events bubble - } - if (!YAHOO.lang.isBoolean(cancelable)){ - cancelable = (type != "mousemove"); //mousemove is the only one that can't be cancelled - } - if (!YAHOO.lang.isObject(view)){ - view = window; //view is typically window - } - if (!YAHOO.lang.isNumber(detail)){ - detail = 1; //number of mouse clicks must be at least one - } - if (!YAHOO.lang.isNumber(screenX)){ - screenX = 0; - } - if (!YAHOO.lang.isNumber(screenY)){ - screenY = 0; - } - if (!YAHOO.lang.isNumber(clientX)){ - clientX = 0; - } - if (!YAHOO.lang.isNumber(clientY)){ - clientY = 0; - } - if (!YAHOO.lang.isBoolean(ctrlKey)){ - ctrlKey = false; - } - if (!YAHOO.lang.isBoolean(altKey)){ - altKey = false; - } - if (!YAHOO.lang.isBoolean(shiftKey)){ - shiftKey = false; - } - if (!YAHOO.lang.isBoolean(metaKey)){ - metaKey = false; - } - if (!YAHOO.lang.isNumber(button)){ - button = 0; - } - - //try to create a mouse event - var customEvent /*:MouseEvent*/ = null; - - //check for DOM-compliant browsers first - if (YAHOO.lang.isFunction(document.createEvent)){ - - customEvent = document.createEvent("MouseEvents"); - - //Safari 2.x (WebKit 418) still doesn't implement initMouseEvent() - if (customEvent.initMouseEvent){ - customEvent.initMouseEvent(type, bubbles, cancelable, view, detail, - screenX, screenY, clientX, clientY, - ctrlKey, altKey, shiftKey, metaKey, - button, relatedTarget); - } else { //Safari - - //the closest thing available in Safari 2.x is UIEvents - customEvent = document.createEvent("UIEvents"); - customEvent.initEvent(type, bubbles, cancelable); - customEvent.view = view; - customEvent.detail = detail; - customEvent.screenX = screenX; - customEvent.screenY = screenY; - customEvent.clientX = clientX; - customEvent.clientY = clientY; - customEvent.ctrlKey = ctrlKey; - customEvent.altKey = altKey; - customEvent.metaKey = metaKey; - customEvent.shiftKey = shiftKey; - customEvent.button = button; - customEvent.relatedTarget = relatedTarget; - } - - /* - * Check to see if relatedTarget has been assigned. Firefox - * versions less than 2.0 don't allow it to be assigned via - * initMouseEvent() and the property is readonly after event - * creation, so in order to keep YAHOO.util.getRelatedTarget() - * working, assign to the IE proprietary toElement property - * for mouseout event and fromElement property for mouseover - * event. - */ - if (relatedTarget && !customEvent.relatedTarget){ - if (type == "mouseout"){ - customEvent.toElement = relatedTarget; - } else if (type == "mouseover"){ - customEvent.fromElement = relatedTarget; - } - } - - //fire the event - target.dispatchEvent(customEvent); - - } else if (YAHOO.lang.isObject(document.createEventObject)){ //IE - - //create an IE event object - customEvent = document.createEventObject(); - - //assign available properties - customEvent.bubbles = bubbles; - customEvent.cancelable = cancelable; - customEvent.view = view; - customEvent.detail = detail; - customEvent.screenX = screenX; - customEvent.screenY = screenY; - customEvent.clientX = clientX; - customEvent.clientY = clientY; - customEvent.ctrlKey = ctrlKey; - customEvent.altKey = altKey; - customEvent.metaKey = metaKey; - customEvent.shiftKey = shiftKey; - - //fix button property for IE's wacky implementation - switch(button){ - case 0: - customEvent.button = 1; - break; - case 1: - customEvent.button = 4; - break; - case 2: - //leave as is - break; - default: - customEvent.button = 0; - } - - /* - * Have to use relatedTarget because IE won't allow assignment - * to toElement or fromElement on generic events. This keeps - * YAHOO.util.customEvent.getRelatedTarget() functional. - */ - customEvent.relatedTarget = relatedTarget; - - //fire the event - target.fireEvent("on" + type, customEvent); - - } else { - throw new Error("simulateMouseEvent(): No event simulation framework present."); - } - }, - - //-------------------------------------------------------------------------- - // Mouse events - //-------------------------------------------------------------------------- - - /** - * Simulates a mouse event on a particular element. - * @param {HTMLElement} target The element to click on. - * @param {String} type The type of event to fire. This can be any one of - * the following: click, dblclick, mousedown, mouseup, mouseout, - * mouseover, and mousemove. - * @param {Object} options Additional event options (use DOM standard names). - * @method mouseEvent - * @static - */ - fireMouseEvent : function (target /*:HTMLElement*/, type /*:String*/, - options /*:Object*/) /*:Void*/ - { - options = options || {}; - this.simulateMouseEvent(target, type, options.bubbles, - options.cancelable, options.view, options.detail, options.screenX, - options.screenY, options.clientX, options.clientY, options.ctrlKey, - options.altKey, options.shiftKey, options.metaKey, options.button, - options.relatedTarget); - }, - - /** - * Simulates a click on a particular element. - * @param {HTMLElement} target The element to click on. - * @param {Object} options Additional event options (use DOM standard names). - * @method click - * @static - */ - click : function (target /*:HTMLElement*/, options /*:Object*/) /*:Void*/ { - this.fireMouseEvent(target, "click", options); - }, - - /** - * Simulates a double click on a particular element. - * @param {HTMLElement} target The element to double click on. - * @param {Object} options Additional event options (use DOM standard names). - * @method dblclick - * @static - */ - dblclick : function (target /*:HTMLElement*/, options /*:Object*/) /*:Void*/ { - this.fireMouseEvent( target, "dblclick", options); - }, - - /** - * Simulates a mousedown on a particular element. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method mousedown - * @static - */ - mousedown : function (target /*:HTMLElement*/, options /*Object*/) /*:Void*/ { - this.fireMouseEvent(target, "mousedown", options); - }, - - /** - * Simulates a mousemove on a particular element. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method mousemove - * @static - */ - mousemove : function (target /*:HTMLElement*/, options /*Object*/) /*:Void*/ { - this.fireMouseEvent(target, "mousemove", options); - }, - - /** - * Simulates a mouseout event on a particular element. Use "relatedTarget" - * on the options object to specify where the mouse moved to. - * Quirks: Firefox less than 2.0 doesn't set relatedTarget properly, so - * toElement is assigned in its place. IE doesn't allow toElement to be - * be assigned, so relatedTarget is assigned in its place. Both of these - * concessions allow YAHOO.util.Event.getRelatedTarget() to work correctly - * in both browsers. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method mouseout - * @static - */ - mouseout : function (target /*:HTMLElement*/, options /*Object*/) /*:Void*/ { - this.fireMouseEvent(target, "mouseout", options); - }, - - /** - * Simulates a mouseover event on a particular element. Use "relatedTarget" - * on the options object to specify where the mouse moved from. - * Quirks: Firefox less than 2.0 doesn't set relatedTarget properly, so - * fromElement is assigned in its place. IE doesn't allow fromElement to be - * be assigned, so relatedTarget is assigned in its place. Both of these - * concessions allow YAHOO.util.Event.getRelatedTarget() to work correctly - * in both browsers. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method mouseover - * @static - */ - mouseover : function (target /*:HTMLElement*/, options /*Object*/) /*:Void*/ { - this.fireMouseEvent(target, "mouseover", options); - }, - - /** - * Simulates a mouseup on a particular element. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method mouseup - * @static - */ - mouseup : function (target /*:HTMLElement*/, options /*Object*/) /*:Void*/ { - this.fireMouseEvent(target, "mouseup", options); - }, - - //-------------------------------------------------------------------------- - // Key events - //-------------------------------------------------------------------------- - - /** - * Fires an event that normally would be fired by the keyboard (keyup, - * keydown, keypress). Make sure to specify either keyCode or charCode as - * an option. - * @private - * @param {String} type The type of event ("keyup", "keydown" or "keypress"). - * @param {HTMLElement} target The target of the event. - * @param {Object} options Options for the event. Either keyCode or charCode - * are required. - * @method fireKeyEvent - * @static - */ - fireKeyEvent : function (type /*:String*/, target /*:HTMLElement*/, - options /*:Object*/) /*:Void*/ - { - options = options || {}; - this.simulateKeyEvent(target, type, options.bubbles, - options.cancelable, options.view, options.ctrlKey, - options.altKey, options.shiftKey, options.metaKey, - options.keyCode, options.charCode); - }, - - /** - * Simulates a keydown event on a particular element. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method keydown - * @static - */ - keydown : function (target /*:HTMLElement*/, options /*:Object*/) /*:Void*/ { - this.fireKeyEvent("keydown", target, options); - }, - - /** - * Simulates a keypress on a particular element. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method keypress - * @static - */ - keypress : function (target /*:HTMLElement*/, options /*:Object*/) /*:Void*/ { - this.fireKeyEvent("keypress", target, options); - }, - - /** - * Simulates a keyup event on a particular element. - * @param {HTMLElement} target The element to act on. - * @param {Object} options Additional event options (use DOM standard names). - * @method keyup - * @static - */ - keyup : function (target /*:HTMLElement*/, options /*Object*/) /*:Void*/ { - this.fireKeyEvent("keyup", target, options); - } - - -}; - -YAHOO.namespace("tool"); - -//----------------------------------------------------------------------------- -// TestManager object -//----------------------------------------------------------------------------- - -/** - * Runs pages containing test suite definitions. - * @namespace YAHOO.tool - * @class TestManager - * @static - */ -YAHOO.tool.TestManager = { - - /** - * Constant for the testpagebegin custom event - * @property TEST_PAGE_BEGIN_EVENT - * @static - * @type string - * @final - */ - TEST_PAGE_BEGIN_EVENT /*:String*/ : "testpagebegin", - - /** - * Constant for the testpagecomplete custom event - * @property TEST_PAGE_COMPLETE_EVENT - * @static - * @type string - * @final - */ - TEST_PAGE_COMPLETE_EVENT /*:String*/ : "testpagecomplete", - - /** - * Constant for the testmanagerbegin custom event - * @property TEST_MANAGER_BEGIN_EVENT - * @static - * @type string - * @final - */ - TEST_MANAGER_BEGIN_EVENT /*:String*/ : "testmanagerbegin", - - /** - * Constant for the testmanagercomplete custom event - * @property TEST_MANAGER_COMPLETE_EVENT - * @static - * @type string - * @final - */ - TEST_MANAGER_COMPLETE_EVENT /*:String*/ : "testmanagercomplete", - - //------------------------------------------------------------------------- - // Private Properties - //------------------------------------------------------------------------- - - - /** - * The URL of the page currently being executed. - * @type String - * @private - * @property _curPage - * @static - */ - _curPage /*:String*/ : null, - - /** - * The frame used to load and run tests. - * @type Window - * @private - * @property _frame - * @static - */ - _frame /*:Window*/ : null, - - /** - * The logger used to output results from the various tests. - * @type YAHOO.tool.TestLogger - * @private - * @property _logger - * @static - */ - _logger : null, - - /** - * The timeout ID for the next iteration through the tests. - * @type int - * @private - * @property _timeoutId - * @static - */ - _timeoutId /*:int*/ : 0, - - /** - * Array of pages to load. - * @type String[] - * @private - * @property _pages - * @static - */ - _pages /*:String[]*/ : [], - - /** - * Aggregated results - * @type Object - * @private - * @property _results - * @static - */ - _results: null, - - //------------------------------------------------------------------------- - // Private Methods - //------------------------------------------------------------------------- - - /** - * Handles TestRunner.COMPLETE_EVENT, storing the results and beginning - * the loop again. - * @param {Object} data Data about the event. - * @return {Void} - * @private - * @static - */ - _handleTestRunnerComplete : function (data /*:Object*/) /*:Void*/ { - - this.fireEvent(this.TEST_PAGE_COMPLETE_EVENT, { - page: this._curPage, - results: data.results - }); - - //save results - //this._results[this.curPage] = data.results; - - //process 'em - this._processResults(this._curPage, data.results); - - this._logger.clearTestRunner(); - - //if there's more to do, set a timeout to begin again - if (this._pages.length){ - this._timeoutId = setTimeout(function(){ - YAHOO.tool.TestManager._run(); - }, 1000); - } else { - this.fireEvent(this.TEST_MANAGER_COMPLETE_EVENT, this._results); - } - }, - - /** - * Processes the results of a test page run, outputting log messages - * for failed tests. - * @return {Void} - * @private - * @static - */ - _processResults : function (page /*:String*/, results /*:Object*/) /*:Void*/ { - - var r = this._results; - - r.passed += results.passed; - r.failed += results.failed; - r.ignored += results.ignored; - r.total += results.total; - - if (results.failed){ - r.failedPages.push(page); - } else { - r.passedPages.push(page); - } - - results.name = page; - results.type = "page"; - - r[page] = results; - }, - - /** - * Loads the next test page into the iframe. - * @return {Void} - * @static - * @private - */ - _run : function () /*:Void*/ { - - //set the current page - this._curPage = this._pages.shift(); - - this.fireEvent(this.TEST_PAGE_BEGIN_EVENT, this._curPage); - - //load the frame - destroy history in case there are other iframes that - //need testing - this._frame.location.replace(this._curPage); - - }, - - //------------------------------------------------------------------------- - // Public Methods - //------------------------------------------------------------------------- - - /** - * Signals that a test page has been loaded. This should be called from - * within the test page itself to notify the TestManager that it is ready. - * @return {Void} - * @static - */ - load : function () /*:Void*/ { - if (parent.YAHOO.tool.TestManager !== this){ - parent.YAHOO.tool.TestManager.load(); - } else { - - if (this._frame) { - //assign event handling - var TestRunner = this._frame.YAHOO.tool.TestRunner; - - this._logger.setTestRunner(TestRunner); - TestRunner.subscribe(TestRunner.COMPLETE_EVENT, this._handleTestRunnerComplete, this, true); - - //run it - TestRunner.run(); - } - } - }, - - /** - * Sets the pages to be loaded. - * @param {String[]} pages An array of URLs to load. - * @return {Void} - * @static - */ - setPages : function (pages /*:String[]*/) /*:Void*/ { - this._pages = pages; - }, - - /** - * Begins the process of running the tests. - * @return {Void} - * @static - */ - start : function () /*:Void*/ { - - if (!this._initialized) { - - /** - * Fires when loading a test page - * @event testpagebegin - * @param curPage {string} the page being loaded - * @static - */ - this.createEvent(this.TEST_PAGE_BEGIN_EVENT); - - /** - * Fires when a test page is complete - * @event testpagecomplete - * @param obj {page: string, results: object} the name of the - * page that was loaded, and the test suite results - * @static - */ - this.createEvent(this.TEST_PAGE_COMPLETE_EVENT); - - /** - * Fires when the test manager starts running all test pages - * @event testmanagerbegin - * @static - */ - this.createEvent(this.TEST_MANAGER_BEGIN_EVENT); - - /** - * Fires when the test manager finishes running all test pages. External - * test runners should subscribe to this event in order to get the - * aggregated test results. - * @event testmanagercomplete - * @param obj { pages_passed: int, pages_failed: int, tests_passed: int - * tests_failed: int, passed: string[], failed: string[], - * page_results: {} } - * @static - */ - this.createEvent(this.TEST_MANAGER_COMPLETE_EVENT); - - //create iframe if not already available - if (!this._frame){ - var frame /*:HTMLElement*/ = document.createElement("iframe"); - frame.style.visibility = "hidden"; - frame.style.position = "absolute"; - document.body.appendChild(frame); - this._frame = frame.contentWindow || frame.contentDocument.ownerWindow; - } - - //create test logger if not already available - if (!this._logger){ - this._logger = new YAHOO.tool.TestLogger(); - } - - this._initialized = true; - } - - - // reset the results cache - this._results = { - - passed: 0, - failed: 0, - ignored: 0, - total: 0, - type: "report", - name: "YUI Test Results", - failedPages:[], - passedPages:[] - /* - // number of pages that pass - pages_passed: 0, - // number of pages that fail - pages_failed: 0, - // total number of tests passed - tests_passed: 0, - // total number of tests failed - tests_failed: 0, - // array of pages that passed - passed: [], - // array of pages that failed - failed: [], - // map of full results for each page - page_results: {}*/ - }; - - this.fireEvent(this.TEST_MANAGER_BEGIN_EVENT, null); - this._run(); - - }, - - /** - * Stops the execution of tests. - * @return {Void} - * @static - */ - stop : function () /*:Void*/ { - clearTimeout(this._timeoutId); - } - -}; - -YAHOO.lang.augmentObject(YAHOO.tool.TestManager, YAHOO.util.EventProvider.prototype); - - -YAHOO.namespace("tool"); - -//----------------------------------------------------------------------------- -// TestLogger object -//----------------------------------------------------------------------------- - -/** - * Displays test execution progress and results, providing filters based on - * different key events. - * @namespace YAHOO.tool - * @class TestLogger - * @constructor - * @param {HTMLElement} element (Optional) The element to create the logger in. - * @param {Object} config (Optional) Configuration options for the logger. - */ -YAHOO.tool.TestLogger = function (element, config) { - YAHOO.tool.TestLogger.superclass.constructor.call(this, element, config); - this.init(); -}; - -YAHOO.lang.extend(YAHOO.tool.TestLogger, YAHOO.widget.LogReader, { - - footerEnabled : true, - newestOnTop : false, - - /** - * Formats message string to HTML for output to console. - * @private - * @method formatMsg - * @param oLogMsg {Object} Log message object. - * @return {String} HTML-formatted message for output to console. - */ - formatMsg : function(message /*:Object*/) { - - var category /*:String*/ = message.category; - var text /*:String*/ = this.html2Text(message.msg); - - return "<pre><p><span class=\"" + category + "\">" + category.toUpperCase() + "</span> " + text + "</p></pre>"; - - }, - - //------------------------------------------------------------------------- - // Private Methods - //------------------------------------------------------------------------- - - /* - * Initializes the logger. - * @private - */ - init : function () { - - //attach to any available TestRunner - if (YAHOO.tool.TestRunner){ - this.setTestRunner(YAHOO.tool.TestRunner); - } - - //hide useless sources - this.hideSource("global"); - this.hideSource("LogReader"); - - //hide useless message categories - this.hideCategory("warn"); - this.hideCategory("window"); - this.hideCategory("time"); - - //reset the logger - this.clearConsole(); - }, - - /** - * Clears the reference to the TestRunner from previous operations. This - * unsubscribes all events and removes the object reference. - * @return {Void} - * @static - */ - clearTestRunner : function () /*:Void*/ { - if (this._runner){ - this._runner.unsubscribeAll(); - this._runner = null; - } - }, - - /** - * Sets the source test runner that the logger should monitor. - * @param {YAHOO.tool.TestRunner} testRunner The TestRunner to observe. - * @return {Void} - * @static - */ - setTestRunner : function (testRunner /*:YAHOO.tool.TestRunner*/) /*:Void*/ { - - if (this._runner){ - this.clearTestRunner(); - } - - this._runner = testRunner; - - //setup event _handlers - testRunner.subscribe(testRunner.TEST_PASS_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.TEST_FAIL_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.TEST_IGNORE_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.BEGIN_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.COMPLETE_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.TEST_SUITE_BEGIN_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.TEST_SUITE_COMPLETE_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.TEST_CASE_BEGIN_EVENT, this._handleTestRunnerEvent, this, true); - testRunner.subscribe(testRunner.TEST_CASE_COMPLETE_EVENT, this._handleTestRunnerEvent, this, true); - }, - - //------------------------------------------------------------------------- - // Event Handlers - //------------------------------------------------------------------------- - - /** - * Handles all TestRunner events, outputting appropriate data into the console. - * @param {Object} data The event data object. - * @return {Void} - * @private - */ - _handleTestRunnerEvent : function (data /*:Object*/) /*:Void*/ { - - //shortcut variables - var TestRunner /*:Object*/ = YAHOO.tool.TestRunner; - - //data variables - var message /*:String*/ = ""; - var messageType /*:String*/ = ""; - - switch(data.type){ - case TestRunner.BEGIN_EVENT: - message = "Testing began at " + (new Date()).toString() + "."; - messageType = "info"; - break; - - case TestRunner.COMPLETE_EVENT: - message = "Testing completed at " + (new Date()).toString() + ".\nPassed:" + - data.results.passed + " Failed:" + data.results.failed + " Total:" + data.results.total; - messageType = "info"; - break; - - case TestRunner.TEST_FAIL_EVENT: - message = data.testName + ": " + data.error.getMessage(); - messageType = "fail"; - break; - - case TestRunner.TEST_IGNORE_EVENT: - message = data.testName + ": ignored."; - messageType = "ignore"; - break; - - case TestRunner.TEST_PASS_EVENT: - message = data.testName + ": passed."; - messageType = "pass"; - break; - - case TestRunner.TEST_SUITE_BEGIN_EVENT: - message = "Test suite \"" + data.testSuite.name + "\" started."; - messageType = "info"; - break; - - case TestRunner.TEST_SUITE_COMPLETE_EVENT: - message = "Test suite \"" + data.testSuite.name + "\" completed.\nPassed:" + - data.results.passed + " Failed:" + data.results.failed + " Total:" + data.results.total; - messageType = "info"; - break; - - case TestRunner.TEST_CASE_BEGIN_EVENT: - message = "Test case \"" + data.testCase.name + "\" started."; - messageType = "info"; - break; - - case TestRunner.TEST_CASE_COMPLETE_EVENT: - message = "Test case \"" + data.testCase.name + "\" completed.\nPassed:" + - data.results.passed + " Failed:" + data.results.failed + " Total:" + data.results.total; - messageType = "info"; - break; - default: - message = "Unexpected event " + data.type; - message = "info"; - } - - YAHOO.log(message, messageType, "TestRunner"); - } - -}); - -YAHOO.namespace("tool.TestFormat"); - -/** - * Returns test results formatted as a JSON string. Requires JSON utility. - * @param {Object} result The results object created by TestRunner. - * @return {String} An XML-formatted string of results. - * @namespace YAHOO.tool.TestFormat - * @method JSON - * @static - */ -YAHOO.tool.TestFormat.JSON = function(results /*:Object*/) /*:String*/ { - return YAHOO.lang.JSON.stringify(results); -}; - -/** - * Returns test results formatted as an XML string. - * @param {Object} result The results object created by TestRunner. - * @return {String} An XML-formatted string of results. - * @namespace YAHOO.tool.TestFormat - * @method XML - * @static - */ -YAHOO.tool.TestFormat.XML = function(results /*:Object*/) /*:String*/ { - - var l = YAHOO.lang; - var xml /*:String*/ = "<" + results.type + " name=\"" + results.name.replace(/"/g, """).replace(/'/g, "'") + "\""; - - if (results.type == "test"){ - xml += " result=\"" + results.result + "\" message=\"" + results.message + "\">"; - } else { - xml += " passed=\"" + results.passed + "\" failed=\"" + results.failed + "\" ignored=\"" + results.ignored + "\" total=\"" + results.total + "\">"; - for (var prop in results) { - if (l.hasOwnProperty(results, prop) && l.isObject(results[prop]) && !l.isArray(results[prop])){ - xml += arguments.callee(results[prop]); - } - } - } - - xml += "</" + results.type + ">"; - - return xml; - -}; - -YAHOO.namespace("tool"); - -/** - * An object capable of sending test results to a server. - * @param {String} url The URL to submit the results to. - * @param {Function} format (Optiona) A function that outputs the results in a specific format. - * Default is YAHOO.tool.TestFormat.XML. - * @constructor - * @namespace YAHOO.tool - * @class TestReporter - */ -YAHOO.tool.TestReporter = function(url /*:String*/, format /*:Function*/) { - - /** - * The URL to submit the data to. - * @type String - * @property url - */ - this.url /*:String*/ = url; - - /** - * The formatting function to call when submitting the data. - * @type Function - * @property format - */ - this.format /*:Function*/ = format || YAHOO.tool.TestFormat.XML; - - /** - * Extra fields to submit with the request. - * @type Object - * @property _fields - * @private - */ - this._fields /*:Object*/ = new Object(); - - /** - * The form element used to submit the results. - * @type HTMLFormElement - * @property _form - * @private - */ - this._form /*:HTMLElement*/ = null; - - /** - * Iframe used as a target for form submission. - * @type HTMLIFrameElement - * @property _iframe - * @private - */ - this._iframe /*:HTMLElement*/ = null; -}; - -YAHOO.tool.TestReporter.prototype = { - - //restore missing constructor - constructor: YAHOO.tool.TestReporter, - - /** - * Adds a field to the form that submits the results. - * @param {String} name The name of the field. - * @param {Variant} value The value of the field. - * @return {Void} - * @method addField - */ - addField : function (name /*:String*/, value /*:Variant*/) /*:Void*/{ - this._fields[name] = value; - }, - - /** - * Removes all previous defined fields. - * @return {Void} - * @method addField - */ - clearFields : function() /*:Void*/{ - this._fields = new Object(); - }, - - /** - * Cleans up the memory associated with the TestReporter, removing DOM elements - * that were created. - * @return {Void} - * @method destroy - */ - destroy : function() /*:Void*/ { - if (this._form){ - this._form.parentNode.removeChild(this._form); - this._form = null; - } - if (this._iframe){ - this._iframe.parentNode.removeChild(this._iframe); - this._iframe = null; - } - this._fields = null; - }, - - /** - * Sends the report to the server. - * @param {Object} results The results object created by TestRunner. - * @return {Void} - * @method report - */ - report : function(results /*:Object*/) /*:Void*/{ - - //if the form hasn't been created yet, create it - if (!this._form){ - this._form = document.createElement("form"); - this._form.method = "post"; - this._form.style.visibility = "hidden"; - this._form.style.position = "absolute"; - this._form.style.top = 0; - document.body.appendChild(this._form); - - //IE won't let you assign a name using the DOM, must do it the hacky way - if (YAHOO.env.ua.ie){ - this._iframe = document.createElement("<iframe name=\"yuiTestTarget\" />"); - } else { - this._iframe = document.createElement("iframe"); - this._iframe.name = "yuiTestTarget"; - } - - this._iframe.src = "javascript:false"; - this._iframe.style.visibility = "hidden"; - this._iframe.style.position = "absolute"; - this._iframe.style.top = 0; - document.body.appendChild(this._iframe); - - this._form.target = "yuiTestTarget"; - } - - //set the form's action - this._form.action = this.url; - - //remove any existing fields - while(this._form.hasChildNodes()){ - this._form.removeChild(this._form.lastChild); - } - - //create default fields - this._fields.results = this.format(results); - this._fields.useragent = navigator.userAgent; - this._fields.timestamp = (new Date()).toLocaleString(); - - //add fields to the form - for (var prop in this._fields){ - if (YAHOO.lang.hasOwnProperty(this._fields, prop) && typeof this._fields[prop] != "function"){ - input = document.createElement("input"); - input.type = "hidden"; - input.name = prop; - input.value = this._fields[prop]; - this._form.appendChild(input); - } - } - - //remove default fields - delete this._fields.results; - delete this._fields.useragent; - delete this._fields.timestamp; - - if (arguments[1] !== false){ - this._form.submit(); - } - - } - -}; - -YAHOO.register("yuitest", YAHOO.tool.TestRunner, {version: "2.5.0", build: "895"}); diff --git a/lib/yui/yuitest/yuitest_core-beta-debug.js b/lib/yui/yuitest/yuitest_core-beta-debug.js deleted file mode 100644 index 8a431c2178..0000000000 --- a/lib/yui/yuitest/yuitest_core-beta-debug.js +++ /dev/null @@ -1,1922 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -YAHOO.namespace("tool"); - -//----------------------------------------------------------------------------- -// TestCase object -//----------------------------------------------------------------------------- - -/** - * Test case containing various tests to run. - * @param template An object containing any number of test methods, other methods, - * an optional name, and anything else the test case needs. - * @class TestCase - * @namespace YAHOO.tool - * @constructor - */ -YAHOO.tool.TestCase = function (template /*:Object*/) { - - /** - * Special rules for the test case. Possible subobjects - * are fail, for tests that should fail, and error, for - * tests that should throw an error. - */ - this._should /*:Object*/ = {}; - - //copy over all properties from the template to this object - for (var prop in template) { - this[prop] = template[prop]; - } - - //check for a valid name - if (!YAHOO.lang.isString(this.name)){ - /** - * Name for the test case. - */ - this.name /*:String*/ = YAHOO.util.Dom.generateId(null, "testCase"); - } - -}; - - -YAHOO.tool.TestCase.prototype = { - - /** - * Resumes a paused test and runs the given function. - * @param {Function} segment (Optional) The function to run. - * If omitted, the test automatically passes. - * @return {Void} - * @method resume - */ - resume : function (segment /*:Function*/) /*:Void*/ { - YAHOO.tool.TestRunner.resume(segment); - }, - - /** - * Causes the test case to wait a specified amount of time and then - * continue executing the given code. - * @param {Function} segment (Optional) The function to run after the delay. - * If omitted, the TestRunner will wait until resume() is called. - * @param {int} delay (Optional) The number of milliseconds to wait before running - * the function. If omitted, defaults to zero. - * @return {Void} - * @method wait - */ - wait : function (segment /*:Function*/, delay /*:int*/) /*:Void*/{ - throw new YAHOO.tool.TestCase.Wait(segment, delay); - }, - - //------------------------------------------------------------------------- - // Stub Methods - //------------------------------------------------------------------------- - - /** - * Function to run before each test is executed. - * @return {Void} - * @method setUp - */ - setUp : function () /*:Void*/ { - }, - - /** - * Function to run after each test is executed. - * @return {Void} - * @method tearDown - */ - tearDown: function () /*:Void*/ { - } -}; - -/** - * Represents a stoppage in test execution to wait for an amount of time before - * continuing. - * @param {Function} segment A function to run when the wait is over. - * @param {int} delay The number of milliseconds to wait before running the code. - * @class Wait - * @namespace YAHOO.tool.TestCase - * @constructor - * - */ -YAHOO.tool.TestCase.Wait = function (segment /*:Function*/, delay /*:int*/) { - - /** - * The segment of code to run when the wait is over. - * @type Function - * @property segment - */ - this.segment /*:Function*/ = (YAHOO.lang.isFunction(segment) ? segment : null); - - /** - * The delay before running the segment of code. - * @type int - * @property delay - */ - this.delay /*:int*/ = (YAHOO.lang.isNumber(delay) ? delay : 0); - -}; - -YAHOO.namespace("tool"); - - -//----------------------------------------------------------------------------- -// TestSuite object -//----------------------------------------------------------------------------- - -/** - * A test suite that can contain a collection of TestCase and TestSuite objects. - * @param {String||Object} data The name of the test suite or an object containing - * a name property as well as setUp and tearDown methods. - * @namespace YAHOO.tool - * @class TestSuite - * @constructor - */ -YAHOO.tool.TestSuite = function (data /*:String||Object*/) { - - /** - * The name of the test suite. - * @type String - * @property name - */ - this.name /*:String*/ = ""; - - /** - * Array of test suites and - * @private - */ - this.items /*:Array*/ = []; - - //initialize the properties - if (YAHOO.lang.isString(data)){ - this.name = data; - } else if (YAHOO.lang.isObject(data)){ - YAHOO.lang.augmentObject(this, data, true); - } - - //double-check name - if (this.name === ""){ - this.name = YAHOO.util.Dom.generateId(null, "testSuite"); - } - -}; - -YAHOO.tool.TestSuite.prototype = { - - /** - * Adds a test suite or test case to the test suite. - * @param {YAHOO.tool.TestSuite||YAHOO.tool.TestCase} testObject The test suite or test case to add. - * @return {Void} - * @method add - */ - add : function (testObject /*:YAHOO.tool.TestSuite*/) /*:Void*/ { - if (testObject instanceof YAHOO.tool.TestSuite || testObject instanceof YAHOO.tool.TestCase) { - this.items.push(testObject); - } - }, - - //------------------------------------------------------------------------- - // Stub Methods - //------------------------------------------------------------------------- - - /** - * Function to run before each test is executed. - * @return {Void} - * @method setUp - */ - setUp : function () /*:Void*/ { - }, - - /** - * Function to run after each test is executed. - * @return {Void} - * @method tearDown - */ - tearDown: function () /*:Void*/ { - } - -}; - -YAHOO.namespace("tool"); - -/** - * The YUI test tool - * @module yuitest - * @namespace YAHOO.tool - * @requires yahoo,dom,event,logger - */ - - -//----------------------------------------------------------------------------- -// TestRunner object -//----------------------------------------------------------------------------- - -/** - * Runs test suites and test cases, providing events to allowing for the - * interpretation of test results. - * @namespace YAHOO.tool - * @class TestRunner - * @static - */ -YAHOO.tool.TestRunner = (function(){ - - /** - * A node in the test tree structure. May represent a TestSuite, TestCase, or - * test function. - * @param {Variant} testObject A TestSuite, TestCase, or the name of a test function. - * @class TestNode - * @constructor - * @private - */ - function TestNode(testObject /*:Variant*/){ - - /** - * The TestSuite, TestCase, or test function represented by this node. - * @type Variant - * @property testObject - */ - this.testObject = testObject; - - /** - * Pointer to this node's first child. - * @type TestNode - * @property firstChild - */ - this.firstChild /*:TestNode*/ = null; - - /** - * Pointer to this node's last child. - * @type TestNode - * @property lastChild - */ - this.lastChild = null; - - /** - * Pointer to this node's parent. - * @type TestNode - * @property parent - */ - this.parent = null; - - /** - * Pointer to this node's next sibling. - * @type TestNode - * @property next - */ - this.next = null; - - /** - * Test results for this test object. - * @type object - * @property results - */ - this.results /*:Object*/ = { - passed : 0, - failed : 0, - total : 0, - ignored : 0 - }; - - //initialize results - if (testObject instanceof YAHOO.tool.TestSuite){ - this.results.type = "testsuite"; - this.results.name = testObject.name; - } else if (testObject instanceof YAHOO.tool.TestCase){ - this.results.type = "testcase"; - this.results.name = testObject.name; - } - - } - - TestNode.prototype = { - - /** - * Appends a new test object (TestSuite, TestCase, or test function name) as a child - * of this node. - * @param {Variant} testObject A TestSuite, TestCase, or the name of a test function. - * @return {Void} - */ - appendChild : function (testObject /*:Variant*/) /*:Void*/{ - var node = new TestNode(testObject); - if (this.firstChild === null){ - this.firstChild = this.lastChild = node; - } else { - this.lastChild.next = node; - this.lastChild = node; - } - node.parent = this; - return node; - } - }; - - function TestRunner(){ - - //inherit from EventProvider - TestRunner.superclass.constructor.apply(this,arguments); - - /** - * Suite on which to attach all TestSuites and TestCases to be run. - * @type YAHOO.tool.TestSuite - * @property masterSuite - * @private - */ - this.masterSuite /*:YAHOO.tool.TestSuite*/ = new YAHOO.tool.TestSuite("YUI Test Results"); - - /** - * Pointer to the current node in the test tree. - * @type TestNode - * @private - * @property _cur - */ - this._cur = null; - - /** - * Pointer to the root node in the test tree. - * @type TestNode - * @private - * @property _root - */ - this._root = null; - - //create events - var events /*:Array*/ = [ - this.TEST_CASE_BEGIN_EVENT, - this.TEST_CASE_COMPLETE_EVENT, - this.TEST_SUITE_BEGIN_EVENT, - this.TEST_SUITE_COMPLETE_EVENT, - this.TEST_PASS_EVENT, - this.TEST_FAIL_EVENT, - this.TEST_IGNORE_EVENT, - this.COMPLETE_EVENT, - this.BEGIN_EVENT - ]; - for (var i=0; i < events.length; i++){ - this.createEvent(events[i], { scope: this }); - } - - } - - YAHOO.lang.extend(TestRunner, YAHOO.util.EventProvider, { - - //------------------------------------------------------------------------- - // Constants - //------------------------------------------------------------------------- - - /** - * Fires when a test case is opened but before the first - * test is executed. - * @event testcasebegin - */ - TEST_CASE_BEGIN_EVENT /*:String*/ : "testcasebegin", - - /** - * Fires when all tests in a test case have been executed. - * @event testcasecomplete - */ - TEST_CASE_COMPLETE_EVENT /*:String*/ : "testcasecomplete", - - /** - * Fires when a test suite is opened but before the first - * test is executed. - * @event testsuitebegin - */ - TEST_SUITE_BEGIN_EVENT /*:String*/ : "testsuitebegin", - - /** - * Fires when all test cases in a test suite have been - * completed. - * @event testsuitecomplete - */ - TEST_SUITE_COMPLETE_EVENT /*:String*/ : "testsuitecomplete", - - /** - * Fires when a test has passed. - * @event pass - */ - TEST_PASS_EVENT /*:String*/ : "pass", - - /** - * Fires when a test has failed. - * @event fail - */ - TEST_FAIL_EVENT /*:String*/ : "fail", - - /** - * Fires when a test has been ignored. - * @event ignore - */ - TEST_IGNORE_EVENT /*:String*/ : "ignore", - - /** - * Fires when all test suites and test cases have been completed. - * @event complete - */ - COMPLETE_EVENT /*:String*/ : "complete", - - /** - * Fires when the run() method is called. - * @event begin - */ - BEGIN_EVENT /*:String*/ : "begin", - - //------------------------------------------------------------------------- - // Test Tree-Related Methods - //------------------------------------------------------------------------- - - /** - * Adds a test case to the test tree as a child of the specified node. - * @param {TestNode} parentNode The node to add the test case to as a child. - * @param {YAHOO.tool.TestCase} testCase The test case to add. - * @return {Void} - * @static - * @private - * @method _addTestCaseToTestTree - */ - _addTestCaseToTestTree : function (parentNode /*:TestNode*/, testCase /*:YAHOO.tool.TestCase*/) /*:Void*/{ - - //add the test suite - var node = parentNode.appendChild(testCase); - - //iterate over the items in the test case - for (var prop in testCase){ - if (prop.indexOf("test") === 0 && YAHOO.lang.isFunction(testCase[prop])){ - node.appendChild(prop); - } - } - - }, - - /** - * Adds a test suite to the test tree as a child of the specified node. - * @param {TestNode} parentNode The node to add the test suite to as a child. - * @param {YAHOO.tool.TestSuite} testSuite The test suite to add. - * @return {Void} - * @static - * @private - * @method _addTestSuiteToTestTree - */ - _addTestSuiteToTestTree : function (parentNode /*:TestNode*/, testSuite /*:YAHOO.tool.TestSuite*/) /*:Void*/ { - - //add the test suite - var node = parentNode.appendChild(testSuite); - - //iterate over the items in the master suite - for (var i=0; i < testSuite.items.length; i++){ - if (testSuite.items[i] instanceof YAHOO.tool.TestSuite) { - this._addTestSuiteToTestTree(node, testSuite.items[i]); - } else if (testSuite.items[i] instanceof YAHOO.tool.TestCase) { - this._addTestCaseToTestTree(node, testSuite.items[i]); - } - } - }, - - /** - * Builds the test tree based on items in the master suite. The tree is a hierarchical - * representation of the test suites, test cases, and test functions. The resulting tree - * is stored in _root and the pointer _cur is set to the root initially. - * @return {Void} - * @static - * @private - * @method _buildTestTree - */ - _buildTestTree : function () /*:Void*/ { - - this._root = new TestNode(this.masterSuite); - this._cur = this._root; - - //iterate over the items in the master suite - for (var i=0; i < this.masterSuite.items.length; i++){ - if (this.masterSuite.items[i] instanceof YAHOO.tool.TestSuite) { - this._addTestSuiteToTestTree(this._root, this.masterSuite.items[i]); - } else if (this.masterSuite.items[i] instanceof YAHOO.tool.TestCase) { - this._addTestCaseToTestTree(this._root, this.masterSuite.items[i]); - } - } - - }, - - //------------------------------------------------------------------------- - // Private Methods - //------------------------------------------------------------------------- - - /** - * Handles the completion of a test object's tests. Tallies test results - * from one level up to the next. - * @param {TestNode} node The TestNode representing the test object. - * @return {Void} - * @method _handleTestObjectComplete - * @private - */ - _handleTestObjectComplete : function (node /*:TestNode*/) /*:Void*/ { - if (YAHOO.lang.isObject(node.testObject)){ - node.parent.results.passed += node.results.passed; - node.parent.results.failed += node.results.failed; - node.parent.results.total += node.results.total; - node.parent.results.ignored += node.results.ignored; - node.parent.results[node.testObject.name] = node.results; - - if (node.testObject instanceof YAHOO.tool.TestSuite){ - node.testObject.tearDown(); - this.fireEvent(this.TEST_SUITE_COMPLETE_EVENT, { testSuite: node.testObject, results: node.results}); - } else if (node.testObject instanceof YAHOO.tool.TestCase){ - this.fireEvent(this.TEST_CASE_COMPLETE_EVENT, { testCase: node.testObject, results: node.results}); - } - } - }, - - //------------------------------------------------------------------------- - // Navigation Methods - //------------------------------------------------------------------------- - - /** - * Retrieves the next node in the test tree. - * @return {TestNode} The next node in the test tree or null if the end is reached. - * @private - * @static - * @method _next - */ - _next : function () /*:TestNode*/ { - - if (this._cur.firstChild) { - this._cur = this._cur.firstChild; - } else if (this._cur.next) { - this._cur = this._cur.next; - } else { - while (this._cur && !this._cur.next && this._cur !== this._root){ - this._handleTestObjectComplete(this._cur); - this._cur = this._cur.parent; - } - - if (this._cur == this._root){ - this._cur.results.type = "report"; - this._cur.results.timestamp = (new Date()).toLocaleString(); - this.fireEvent(this.COMPLETE_EVENT, { results: this._cur.results}); - this._cur = null; - } else { - this._handleTestObjectComplete(this._cur); - this._cur = this._cur.next; - } - } - - return this._cur; - }, - - /** - * Runs a test case or test suite, returning the results. - * @param {YAHOO.tool.TestCase|YAHOO.tool.TestSuite} testObject The test case or test suite to run. - * @return {Object} Results of the execution with properties passed, failed, and total. - * @private - * @method _run - * @static - */ - _run : function () /*:Void*/ { - - //flag to indicate if the TestRunner should wait before continuing - var shouldWait /*:Boolean*/ = false; - - //get the next test node - var node = this._next(); - - if (node !== null) { - var testObject = node.testObject; - - //figure out what to do - if (YAHOO.lang.isObject(testObject)){ - if (testObject instanceof YAHOO.tool.TestSuite){ - this.fireEvent(this.TEST_SUITE_BEGIN_EVENT, { testSuite: testObject }); - testObject.setUp(); - } else if (testObject instanceof YAHOO.tool.TestCase){ - this.fireEvent(this.TEST_CASE_BEGIN_EVENT, { testCase: testObject }); - } - - //some environments don't support setTimeout - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._run(); - }, 0); - } else { - this._run(); - } - } else { - this._runTest(node); - } - - } - }, - - _resumeTest : function (segment /*:Function*/) /*:Void*/ { - - //get relevant information - var node /*:TestNode*/ = this._cur; - var testName /*:String*/ = node.testObject; - var testCase /*:YAHOO.tool.TestCase*/ = node.parent.testObject; - - //get the "should" test cases - var shouldFail /*:Object*/ = (testCase._should.fail || {})[testName]; - var shouldError /*:Object*/ = (testCase._should.error || {})[testName]; - - //variable to hold whether or not the test failed - var failed /*:Boolean*/ = false; - var error /*:Error*/ = null; - - //try the test - try { - - //run the test - segment.apply(testCase); - - //if it should fail, and it got here, then it's a fail because it didn't - if (shouldFail){ - error = new YAHOO.util.ShouldFail(); - failed = true; - } else if (shouldError){ - error = new YAHOO.util.ShouldError(); - failed = true; - } - - } catch (thrown /*:Error*/){ - if (thrown instanceof YAHOO.util.AssertionError) { - if (!shouldFail){ - error = thrown; - failed = true; - } - } else if (thrown instanceof YAHOO.tool.TestCase.Wait){ - - if (YAHOO.lang.isFunction(thrown.segment)){ - if (YAHOO.lang.isNumber(thrown.delay)){ - - //some environments don't support setTimeout - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._resumeTest(thrown.segment); - }, thrown.delay); - } else { - throw new Error("Asynchronous tests not supported in this environment."); - } - } - } - - return; - - } else { - //first check to see if it should error - if (!shouldError) { - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } else { - //check to see what type of data we have - if (YAHOO.lang.isString(shouldError)){ - - //if it's a string, check the error message - if (thrown.message != shouldError){ - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } - } else if (YAHOO.lang.isFunction(shouldError)){ - - //if it's a function, see if the error is an instance of it - if (!(thrown instanceof shouldError)){ - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } - - } else if (YAHOO.lang.isObject(shouldError)){ - - //if it's an object, check the instance and message - if (!(thrown instanceof shouldError.constructor) || - thrown.message != shouldError.message){ - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } - - } - - } - } - - } - - //fireEvent appropriate event - if (failed) { - this.fireEvent(this.TEST_FAIL_EVENT, { testCase: testCase, testName: testName, error: error }); - } else { - this.fireEvent(this.TEST_PASS_EVENT, { testCase: testCase, testName: testName }); - } - - //run the tear down - testCase.tearDown(); - - //update results - node.parent.results[testName] = { - result: failed ? "fail" : "pass", - message: error ? error.getMessage() : "Test passed", - type: "test", - name: testName - }; - - if (failed){ - node.parent.results.failed++; - } else { - node.parent.results.passed++; - } - node.parent.results.total++; - - //set timeout not supported in all environments - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._run(); - }, 0); - } else { - this._run(); - } - - }, - - /** - * Runs a single test based on the data provided in the node. - * @param {TestNode} node The TestNode representing the test to run. - * @return {Void} - * @static - * @private - * @name _runTest - */ - _runTest : function (node /*:TestNode*/) /*:Void*/ { - - //get relevant information - var testName /*:String*/ = node.testObject; - var testCase /*:YAHOO.tool.TestCase*/ = node.parent.testObject; - var test /*:Function*/ = testCase[testName]; - - //get the "should" test cases - var shouldIgnore /*:Object*/ = (testCase._should.ignore || {})[testName]; - - //figure out if the test should be ignored or not - if (shouldIgnore){ - - //update results - node.parent.results[testName] = { - result: "ignore", - message: "Test ignored", - type: "test", - name: testName - }; - - node.parent.results.ignored++; - node.parent.results.total++; - - this.fireEvent(this.TEST_IGNORE_EVENT, { testCase: testCase, testName: testName }); - - //some environments don't support setTimeout - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._run(); - }, 0); - } else { - this._run(); - } - - } else { - - //run the setup - testCase.setUp(); - - //now call the body of the test - this._resumeTest(test); - } - - }, - - //------------------------------------------------------------------------- - // Protected Methods - //------------------------------------------------------------------------- - - /* - * Fires events for the TestRunner. This overrides the default fireEvent() - * method from EventProvider to add the type property to the data that is - * passed through on each event call. - * @param {String} type The type of event to fire. - * @param {Object} data (Optional) Data for the event. - * @method fireEvent - * @static - * @protected - */ - fireEvent : function (type /*:String*/, data /*:Object*/) /*:Void*/ { - data = data || {}; - data.type = type; - TestRunner.superclass.fireEvent.call(this, type, data); - }, - - //------------------------------------------------------------------------- - // Public Methods - //------------------------------------------------------------------------- - - /** - * Adds a test suite or test case to the list of test objects to run. - * @param testObject Either a TestCase or a TestSuite that should be run. - * @return {Void} - * @method add - * @static - */ - add : function (testObject /*:Object*/) /*:Void*/ { - this.masterSuite.add(testObject); - }, - - /** - * Removes all test objects from the runner. - * @return {Void} - * @method clear - * @static - */ - clear : function () /*:Void*/ { - this.masterSuite.items = []; - }, - - /** - * Resumes the TestRunner after wait() was called. - * @param {Function} segment The function to run as the rest - * of the haulted test. - * @return {Void} - * @method resume - * @static - */ - resume : function (segment /*:Function*/) /*:Void*/ { - this._resumeTest(segment || function(){}); - }, - - /** - * Runs the test suite. - * @return {Void} - * @method run - * @static - */ - run : function (testObject /*:Object*/) /*:Void*/ { - - //pointer to runner to avoid scope issues - var runner = YAHOO.tool.TestRunner; - - //build the test tree - runner._buildTestTree(); - - //fire the begin event - runner.fireEvent(runner.BEGIN_EVENT); - - //begin the testing - runner._run(); - } - }); - - return new TestRunner(); - -})(); - -YAHOO.namespace("util"); - -//----------------------------------------------------------------------------- -// Assert object -//----------------------------------------------------------------------------- - -/** - * The Assert object provides functions to test JavaScript values against - * known and expected results. Whenever a comparison (assertion) fails, - * an error is thrown. - * - * @namespace YAHOO.util - * @class Assert - * @static - */ -YAHOO.util.Assert = { - - //------------------------------------------------------------------------- - // Generic Assertion Methods - //------------------------------------------------------------------------- - - /** - * Forces an assertion error to occur. - * @param {String} message (Optional) The message to display with the failure. - * @method fail - * @static - */ - fail : function (message /*:String*/) /*:Void*/ { - throw new YAHOO.util.AssertionError(message || "Test force-failed."); - }, - - //------------------------------------------------------------------------- - // Equality Assertion Methods - //------------------------------------------------------------------------- - - /** - * Asserts that a value is equal to another. This uses the double equals sign - * so type cohersion may occur. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areEqual - * @static - */ - areEqual : function (expected /*:Object*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (expected != actual) { - throw new YAHOO.util.ComparisonFailure(message || "Values should be equal.", expected, actual); - } - }, - - /** - * Asserts that a value is not equal to another. This uses the double equals sign - * so type cohersion may occur. - * @param {Object} unexpected The unexpected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areNotEqual - * @static - */ - areNotEqual : function (unexpected /*:Object*/, actual /*:Object*/, - message /*:String*/) /*:Void*/ { - if (unexpected == actual) { - throw new YAHOO.util.UnexpectedValue(message || "Values should not be equal.", unexpected); - } - }, - - /** - * Asserts that a value is not the same as another. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} unexpected The unexpected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areNotSame - * @static - */ - areNotSame : function (unexpected /*:Object*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (unexpected === actual) { - throw new YAHOO.util.UnexpectedValue(message || "Values should not be the same.", unexpected); - } - }, - - /** - * Asserts that a value is the same as another. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areSame - * @static - */ - areSame : function (expected /*:Object*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (expected !== actual) { - throw new YAHOO.util.ComparisonFailure(message || "Values should be the same.", expected, actual); - } - }, - - //------------------------------------------------------------------------- - // Boolean Assertion Methods - //------------------------------------------------------------------------- - - /** - * Asserts that a value is false. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isFalse - * @static - */ - isFalse : function (actual /*:Boolean*/, message /*:String*/) { - if (false !== actual) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be false.", false, actual); - } - }, - - /** - * Asserts that a value is true. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isTrue - * @static - */ - isTrue : function (actual /*:Boolean*/, message /*:String*/) /*:Void*/ { - if (true !== actual) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be true.", true, actual); - } - - }, - - //------------------------------------------------------------------------- - // Special Value Assertion Methods - //------------------------------------------------------------------------- - - /** - * Asserts that a value is not a number. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNaN - * @static - */ - isNaN : function (actual /*:Object*/, message /*:String*/) /*:Void*/{ - if (!isNaN(actual)){ - throw new YAHOO.util.ComparisonFailure(message || "Value should be NaN.", NaN, actual); - } - }, - - /** - * Asserts that a value is not the special NaN value. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotNaN - * @static - */ - isNotNaN : function (actual /*:Object*/, message /*:String*/) /*:Void*/{ - if (isNaN(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Values should not be NaN.", NaN); - } - }, - - /** - * Asserts that a value is not null. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotNull - * @static - */ - isNotNull : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (YAHOO.lang.isNull(actual)) { - throw new YAHOO.util.UnexpectedValue(message || "Values should not be null.", null); - } - }, - - /** - * Asserts that a value is not undefined. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotUndefined - * @static - */ - isNotUndefined : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (YAHOO.lang.isUndefined(actual)) { - throw new YAHOO.util.UnexpectedValue(message || "Value should not be undefined.", undefined); - } - }, - - /** - * Asserts that a value is null. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNull - * @static - */ - isNull : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isNull(actual)) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be null.", null, actual); - } - }, - - /** - * Asserts that a value is undefined. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isUndefined - * @static - */ - isUndefined : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isUndefined(actual)) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be undefined.", undefined, actual); - } - }, - - //-------------------------------------------------------------------------- - // Instance Assertion Methods - //-------------------------------------------------------------------------- - - /** - * Asserts that a value is an array. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isArray - * @static - */ - isArray : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isArray(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be an array.", actual); - } - }, - - /** - * Asserts that a value is a Boolean. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isBoolean - * @static - */ - isBoolean : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isBoolean(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a Boolean.", actual); - } - }, - - /** - * Asserts that a value is a function. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isFunction - * @static - */ - isFunction : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isFunction(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a function.", actual); - } - }, - - /** - * Asserts that a value is an instance of a particular object. This may return - * incorrect results when comparing objects from one frame to constructors in - * another frame. For best results, don't use in a cross-frame manner. - * @param {Function} expected The function that the object should be an instance of. - * @param {Object} actual The object to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isInstanceOf - * @static - */ - isInstanceOf : function (expected /*:Function*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!(actual instanceof expected)){ - throw new YAHOO.util.ComparisonFailure(message || "Value isn't an instance of expected type.", expected, actual); - } - }, - - /** - * Asserts that a value is a number. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNumber - * @static - */ - isNumber : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isNumber(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a number.", actual); - } - }, - - /** - * Asserts that a value is an object. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isObject - * @static - */ - isObject : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isObject(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be an object.", actual); - } - }, - - /** - * Asserts that a value is a string. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isString - * @static - */ - isString : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isString(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a string.", actual); - } - }, - - /** - * Asserts that a value is of a particular type. - * @param {String} expectedType The expected type of the variable. - * @param {Object} actualValue The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isTypeOf - * @static - */ - isTypeOf : function (expectedType /*:String*/, actualValue /*:Object*/, message /*:String*/) /*:Void*/{ - if (typeof actualValue != expectedType){ - throw new YAHOO.util.ComparisonFailure(message || "Value should be of type " + expected + ".", expected, typeof actual); - } - } -}; - -//----------------------------------------------------------------------------- -// Assertion errors -//----------------------------------------------------------------------------- - -/** - * AssertionError is thrown whenever an assertion fails. It provides methods - * to more easily get at error information and also provides a base class - * from which more specific assertion errors can be derived. - * - * @param {String} message The message to display when the error occurs. - * @namespace YAHOO.util - * @class AssertionError - * @extends Error - * @constructor - */ -YAHOO.util.AssertionError = function (message /*:String*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message); - - /* - * Error message. Must be duplicated to ensure browser receives it. - * @type String - * @property message - */ - this.message /*:String*/ = message; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "AssertionError"; -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.AssertionError, Error, { - - /** - * Returns a fully formatted error for an assertion failure. This should - * be overridden by all subclasses to provide specific information. - * @method getMessage - * @return {String} A string describing the error. - */ - getMessage : function () /*:String*/ { - return this.message; - }, - - /** - * Returns a string representation of the error. - * @method toString - * @return {String} A string representation of the error. - */ - toString : function () /*:String*/ { - return this.name + ": " + this.getMessage(); - }, - - /** - * Returns a primitive value version of the error. Same as toString(). - * @method valueOf - * @return {String} A primitive value version of the error. - */ - valueOf : function () /*:String*/ { - return this.toString(); - } - -}); - -/** - * ComparisonFailure is subclass of AssertionError that is thrown whenever - * a comparison between two values fails. It provides mechanisms to retrieve - * both the expected and actual value. - * - * @param {String} message The message to display when the error occurs. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value that caused the assertion to fail. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class ComparisonFailure - * @constructor - */ -YAHOO.util.ComparisonFailure = function (message /*:String*/, expected /*:Object*/, actual /*:Object*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message); - - /** - * The expected value. - * @type Object - * @property expected - */ - this.expected /*:Object*/ = expected; - - /** - * The actual value. - * @type Object - * @property actual - */ - this.actual /*:Object*/ = actual; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "ComparisonFailure"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.ComparisonFailure, YAHOO.util.AssertionError, { - - /** - * Returns a fully formatted error for an assertion failure. This message - * provides information about the expected and actual values. - * @method toString - * @return {String} A string describing the error. - */ - getMessage : function () /*:String*/ { - return this.message + "\nExpected: " + this.expected + " (" + (typeof this.expected) + ")" + - "\nActual:" + this.actual + " (" + (typeof this.actual) + ")"; - } - -}); - -/** - * UnexpectedValue is subclass of AssertionError that is thrown whenever - * a value was unexpected in its scope. This typically means that a test - * was performed to determine that a value was *not* equal to a certain - * value. - * - * @param {String} message The message to display when the error occurs. - * @param {Object} unexpected The unexpected value. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class UnexpectedValue - * @constructor - */ -YAHOO.util.UnexpectedValue = function (message /*:String*/, unexpected /*:Object*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message); - - /** - * The unexpected value. - * @type Object - * @property unexpected - */ - this.unexpected /*:Object*/ = unexpected; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "UnexpectedValue"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.UnexpectedValue, YAHOO.util.AssertionError, { - - /** - * Returns a fully formatted error for an assertion failure. The message - * contains information about the unexpected value that was encountered. - * @method getMessage - * @return {String} A string describing the error. - */ - getMessage : function () /*:String*/ { - return this.message + "\nUnexpected: " + this.unexpected + " (" + (typeof this.unexpected) + ") "; - } - -}); - -/** - * ShouldFail is subclass of AssertionError that is thrown whenever - * a test was expected to fail but did not. - * - * @param {String} message The message to display when the error occurs. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class ShouldFail - * @constructor - */ -YAHOO.util.ShouldFail = function (message /*:String*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message || "This test should fail but didn't."); - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "ShouldFail"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.ShouldFail, YAHOO.util.AssertionError); - -/** - * ShouldError is subclass of AssertionError that is thrown whenever - * a test is expected to throw an error but doesn't. - * - * @param {String} message The message to display when the error occurs. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class ShouldError - * @constructor - */ -YAHOO.util.ShouldError = function (message /*:String*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message || "This test should have thrown an error but didn't."); - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "ShouldError"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.ShouldError, YAHOO.util.AssertionError); - -/** - * UnexpectedError is subclass of AssertionError that is thrown whenever - * an error occurs within the course of a test and the test was not expected - * to throw an error. - * - * @param {Error} cause The unexpected error that caused this error to be - * thrown. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class UnexpectedError - * @constructor - */ -YAHOO.util.UnexpectedError = function (cause /*:Object*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, "Unexpected error: " + cause.message); - - /** - * The unexpected error that occurred. - * @type Error - * @property cause - */ - this.cause /*:Error*/ = cause; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "UnexpectedError"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.UnexpectedError, YAHOO.util.AssertionError); - -//----------------------------------------------------------------------------- -// ArrayAssert object -//----------------------------------------------------------------------------- - -/** - * The ArrayAssert object provides functions to test JavaScript array objects - * for a variety of cases. - * - * @namespace YAHOO.util - * @class ArrayAssert - * @static - */ - -YAHOO.util.ArrayAssert = { - - /** - * Asserts that a value is present in an array. This uses the triple equals - * sign so no type cohersion may occur. - * @param {Object} needle The value that is expected in the array. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method contains - * @static - */ - contains : function (needle /*:Object*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (haystack[i] === needle) { - found = true; - } - } - - if (!found){ - YAHOO.util.Assert.fail(message || "Value (" + needle + ") not found in array."); - } - }, - - /** - * Asserts that a set of values are present in an array. This uses the triple equals - * sign so no type cohersion may occur. For this assertion to pass, all values must - * be found. - * @param {Object[]} needles An array of values that are expected in the array. - * @param {Array} haystack An array of values to check. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method containsItems - * @static - */ - containsItems : function (needles /*:Object[]*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - //begin checking values - for (var i=0; i < needles.length; i++){ - this.contains(needles[i], haystack, message); - } - - if (!found){ - YAHOO.util.Assert.fail(message || "Value not found in array."); - } - }, - - /** - * Asserts that a value matching some condition is present in an array. This uses - * a function to determine a match. - * @param {Function} matcher A function that returns true if the items matches or false if not. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method containsMatch - * @static - */ - containsMatch : function (matcher /*:Function*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - //check for valid matcher - if (typeof matcher != "function"){ - throw new TypeError("ArrayAssert.containsMatch(): First argument must be a function."); - } - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (matcher(haystack[i])) { - found = true; - } - } - - if (!found){ - YAHOO.util.Assert.fail(message || "No match found in array."); - } - }, - - /** - * Asserts that a value is not present in an array. This uses the triple equals - * sign so no type cohersion may occur. - * @param {Object} needle The value that is expected in the array. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method doesNotContain - * @static - */ - doesNotContain : function (needle /*:Object*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (haystack[i] === needle) { - found = true; - } - } - - if (found){ - YAHOO.util.Assert.fail(message || "Value found in array."); - } - }, - - /** - * Asserts that a set of values are not present in an array. This uses the triple equals - * sign so no type cohersion may occur. For this assertion to pass, all values must - * not be found. - * @param {Object[]} needles An array of values that are not expected in the array. - * @param {Array} haystack An array of values to check. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method doesNotContainItems - * @static - */ - doesNotContainItems : function (needles /*:Object[]*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - for (var i=0; i < needles.length; i++){ - this.doesNotContain(needles[i], haystack, message); - } - - }, - - /** - * Asserts that no values matching a condition are present in an array. This uses - * a function to determine a match. - * @param {Function} matcher A function that returns true if the items matches or false if not. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method doesNotContainMatch - * @static - */ - doesNotContainMatch : function (matcher /*:Function*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - //check for valid matcher - if (typeof matcher != "function"){ - throw new TypeError("ArrayAssert.doesNotContainMatch(): First argument must be a function."); - } - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (matcher(haystack[i])) { - found = true; - } - } - - if (found){ - YAHOO.util.Assert.fail(message || "Value found in array."); - } - }, - - /** - * Asserts that the given value is contained in an array at the specified index. - * This uses the triple equals sign so no type cohersion will occur. - * @param {Object} needle The value to look for. - * @param {Array} haystack The array to search in. - * @param {int} index The index at which the value should exist. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method indexOf - * @static - */ - indexOf : function (needle /*:Object*/, haystack /*:Array*/, index /*:int*/, message /*:String*/) /*:Void*/ { - - //try to find the value in the array - for (var i=0; i < haystack.length; i++){ - if (haystack[i] === needle){ - YAHOO.util.Assert.areEqual(index, i, message || "Value exists at index " + i + " but should be at index " + index + "."); - return; - } - } - - //if it makes it here, it wasn't found at all - YAHOO.util.Assert.fail(message || "Value doesn't exist in array."); - }, - - /** - * Asserts that the values in an array are equal, and in the same position, - * as values in another array. This uses the double equals sign - * so type cohersion may occur. Note that the array objects themselves - * need not be the same for this test to pass. - * @param {Array} expected An array of the expected values. - * @param {Array} actual Any array of the actual values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method itemsAreEqual - * @static - */ - itemsAreEqual : function (expected /*:Array*/, actual /*:Array*/, - message /*:String*/) /*:Void*/ { - - //one may be longer than the other, so get the maximum length - var len /*:int*/ = Math.max(expected.length, actual.length); - - //begin checking values - for (var i=0; i < len; i++){ - YAHOO.util.Assert.areEqual(expected[i], actual[i], message || - "Values in position " + i + " are not equal."); - } - }, - - /** - * Asserts that the values in an array are equivalent, and in the same position, - * as values in another array. This uses a function to determine if the values - * are equivalent. Note that the array objects themselves - * need not be the same for this test to pass. - * @param {Array} expected An array of the expected values. - * @param {Array} actual Any array of the actual values. - * @param {Function} comparator A function that returns true if the values are equivalent - * or false if not. - * @param {String} message (Optional) The message to display if the assertion fails. - * @return {Void} - * @method itemsAreEquivalent - * @static - */ - itemsAreEquivalent : function (expected /*:Array*/, actual /*:Array*/, - comparator /*:Function*/, message /*:String*/) /*:Void*/ { - - //make sure the comparator is valid - if (typeof comparator != "function"){ - throw new TypeError("ArrayAssert.itemsAreEquivalent(): Third argument must be a function."); - } - - //one may be longer than the other, so get the maximum length - var len /*:int*/ = Math.max(expected.length, actual.length); - - //begin checking values - for (var i=0; i < len; i++){ - if (!comparator(expected[i], actual[i])){ - throw new YAHOO.util.ComparisonFailure(message || "Values in position " + i + " are not equivalent.", expected[i], actual[i]); - } - } - }, - - /** - * Asserts that an array is empty. - * @param {Array} actual The array to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isEmpty - * @static - */ - isEmpty : function (actual /*:Array*/, message /*:String*/) /*:Void*/ { - if (actual.length > 0){ - YAHOO.util.Assert.fail(message || "Array should be empty."); - } - }, - - /** - * Asserts that an array is not empty. - * @param {Array} actual The array to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotEmpty - * @static - */ - isNotEmpty : function (actual /*:Array*/, message /*:String*/) /*:Void*/ { - if (actual.length === 0){ - YAHOO.util.Assert.fail(message || "Array should not be empty."); - } - }, - - /** - * Asserts that the values in an array are the same, and in the same position, - * as values in another array. This uses the triple equals sign - * so no type cohersion will occur. Note that the array objects themselves - * need not be the same for this test to pass. - * @param {Array} expected An array of the expected values. - * @param {Array} actual Any array of the actual values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method itemsAreSame - * @static - */ - itemsAreSame : function (expected /*:Array*/, actual /*:Array*/, - message /*:String*/) /*:Void*/ { - - //one may be longer than the other, so get the maximum length - var len /*:int*/ = Math.max(expected.length, actual.length); - - //begin checking values - for (var i=0; i < len; i++){ - YAHOO.util.Assert.areSame(expected[i], actual[i], - message || "Values in position " + i + " are not the same."); - } - }, - - /** - * Asserts that the given value is contained in an array at the specified index, - * starting from the back of the array. - * This uses the triple equals sign so no type cohersion will occur. - * @param {Object} needle The value to look for. - * @param {Array} haystack The array to search in. - * @param {int} index The index at which the value should exist. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method lastIndexOf - * @static - */ - lastIndexOf : function (needle /*:Object*/, haystack /*:Array*/, index /*:int*/, message /*:String*/) /*:Void*/ { - - //try to find the value in the array - for (var i=haystack.length; i >= 0; i--){ - if (haystack[i] === needle){ - YAHOO.util.Assert.areEqual(index, i, message || "Value exists at index " + i + " but should be at index " + index + "."); - return; - } - } - - //if it makes it here, it wasn't found at all - YAHOO.util.Assert.fail(message || "Value doesn't exist in array."); - } - -}; - -YAHOO.namespace("util"); - - -//----------------------------------------------------------------------------- -// ObjectAssert object -//----------------------------------------------------------------------------- - -/** - * The ObjectAssert object provides functions to test JavaScript objects - * for a variety of cases. - * - * @namespace YAHOO.util - * @class ObjectAssert - * @static - */ -YAHOO.util.ObjectAssert = { - - /** - * Asserts that all properties in the object exist in another object. - * @param {Object} expected An object with the expected properties. - * @param {Object} actual An object with the actual properties. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method propertiesAreEqual - * @static - */ - propertiesAreEqual : function (expected /*:Object*/, actual /*:Object*/, - message /*:String*/) /*:Void*/ { - - //get all properties in the object - var properties /*:Array*/ = []; - for (var property in expected){ - properties.push(property); - } - - //see if the properties are in the expected object - for (var i=0; i < properties.length; i++){ - YAHOO.util.Assert.isNotUndefined(actual[properties[i]], message || - "Property'" + properties[i] + "' expected."); - } - - }, - - /** - * Asserts that an object has a property with the given name. - * @param {String} propertyName The name of the property to test. - * @param {Object} object The object to search. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method hasProperty - * @static - */ - hasProperty : function (propertyName /*:String*/, object /*:Object*/, message /*:String*/) /*:Void*/ { - if (YAHOO.lang.isUndefined(object[propertyName])){ - YAHOO.util.Assert.fail(message || - "Property " + propertyName + " not found on object."); - } - }, - - /** - * Asserts that a property with the given name exists on an object instance (not on its prototype). - * @param {String} propertyName The name of the property to test. - * @param {Object} object The object to search. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method hasProperty - * @static - */ - hasOwnProperty : function (propertyName /*:String*/, object /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.hasOwnProperty(object, propertyName)){ - YAHOO.util.Assert.fail(message || - "Property " + propertyName + " not found on object instance."); - } - } -}; - -//----------------------------------------------------------------------------- -// DateAssert object -//----------------------------------------------------------------------------- - -/** - * The DateAssert object provides functions to test JavaScript Date objects - * for a variety of cases. - * - * @namespace YAHOO.util - * @class DateAssert - * @static - */ - -YAHOO.util.DateAssert = { - - /** - * Asserts that a date's month, day, and year are equal to another date's. - * @param {Date} expected The expected date. - * @param {Date} actual The actual date to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areEqual - * @static - */ - datesAreEqual : function (expected /*:Date*/, actual /*:Date*/, message /*:String*/){ - if (expected instanceof Date && actual instanceof Date){ - YAHOO.util.Assert.areEqual(expected.getFullYear(), actual.getFullYear(), message || "Years should be equal."); - YAHOO.util.Assert.areEqual(expected.getMonth(), actual.getMonth(), message || "Months should be equal."); - YAHOO.util.Assert.areEqual(expected.getDate(), actual.getDate(), message || "Day of month should be equal."); - } else { - throw new TypeError("DateAssert.datesAreEqual(): Expected and actual values must be Date objects."); - } - }, - - /** - * Asserts that a date's hour, minutes, and seconds are equal to another date's. - * @param {Date} expected The expected date. - * @param {Date} actual The actual date to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areEqual - * @static - */ - timesAreEqual : function (expected /*:Date*/, actual /*:Date*/, message /*:String*/){ - if (expected instanceof Date && actual instanceof Date){ - YAHOO.util.Assert.areEqual(expected.getHours(), actual.getHours(), message || "Hours should be equal."); - YAHOO.util.Assert.areEqual(expected.getMinutes(), actual.getMinutes(), message || "Minutes should be equal."); - YAHOO.util.Assert.areEqual(expected.getSeconds(), actual.getSeconds(), message || "Seconds should be equal."); - } else { - throw new TypeError("DateAssert.timesAreEqual(): Expected and actual values must be Date objects."); - } - } - -}; - -YAHOO.register("yuitest_core", YAHOO.tool.TestRunner, {version: "2.5.0", build: "895"}); diff --git a/lib/yui/yuitest/yuitest_core-beta-min.js b/lib/yui/yuitest/yuitest_core-beta-min.js deleted file mode 100644 index dcb313fd5c..0000000000 --- a/lib/yui/yuitest/yuitest_core-beta-min.js +++ /dev/null @@ -1,9 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -YAHOO.namespace("tool");YAHOO.tool.TestCase=function(A){this._should={};for(var B in A){this[B]=A[B];}if(!YAHOO.lang.isString(this.name)){this.name=YAHOO.util.Dom.generateId(null,"testCase");}};YAHOO.tool.TestCase.prototype={resume:function(A){YAHOO.tool.TestRunner.resume(A);},wait:function(B,A){throw new YAHOO.tool.TestCase.Wait(B,A);},setUp:function(){},tearDown:function(){}};YAHOO.tool.TestCase.Wait=function(B,A){this.segment=(YAHOO.lang.isFunction(B)?B:null);this.delay=(YAHOO.lang.isNumber(A)?A:0);};YAHOO.namespace("tool");YAHOO.tool.TestSuite=function(A){this.name="";this.items=[];if(YAHOO.lang.isString(A)){this.name=A;}else{if(YAHOO.lang.isObject(A)){YAHOO.lang.augmentObject(this,A,true);}}if(this.name===""){this.name=YAHOO.util.Dom.generateId(null,"testSuite");}};YAHOO.tool.TestSuite.prototype={add:function(A){if(A instanceof YAHOO.tool.TestSuite||A instanceof YAHOO.tool.TestCase){this.items.push(A);}},setUp:function(){},tearDown:function(){}};YAHOO.namespace("tool");YAHOO.tool.TestRunner=(function(){function B(C){this.testObject=C;this.firstChild=null;this.lastChild=null;this.parent=null;this.next=null;this.results={passed:0,failed:0,total:0,ignored:0};if(C instanceof YAHOO.tool.TestSuite){this.results.type="testsuite";this.results.name=C.name;}else{if(C instanceof YAHOO.tool.TestCase){this.results.type="testcase";this.results.name=C.name;}}}B.prototype={appendChild:function(C){var D=new B(C);if(this.firstChild===null){this.firstChild=this.lastChild=D;}else{this.lastChild.next=D;this.lastChild=D;}D.parent=this;return D;}};function A(){A.superclass.constructor.apply(this,arguments);this.masterSuite=new YAHOO.tool.TestSuite("YUI Test Results");this._cur=null;this._root=null;var D=[this.TEST_CASE_BEGIN_EVENT,this.TEST_CASE_COMPLETE_EVENT,this.TEST_SUITE_BEGIN_EVENT,this.TEST_SUITE_COMPLETE_EVENT,this.TEST_PASS_EVENT,this.TEST_FAIL_EVENT,this.TEST_IGNORE_EVENT,this.COMPLETE_EVENT,this.BEGIN_EVENT];for(var C=0;C<D.length;C++){this.createEvent(D[C],{scope:this});}}YAHOO.lang.extend(A,YAHOO.util.EventProvider,{TEST_CASE_BEGIN_EVENT:"testcasebegin",TEST_CASE_COMPLETE_EVENT:"testcasecomplete",TEST_SUITE_BEGIN_EVENT:"testsuitebegin",TEST_SUITE_COMPLETE_EVENT:"testsuitecomplete",TEST_PASS_EVENT:"pass",TEST_FAIL_EVENT:"fail",TEST_IGNORE_EVENT:"ignore",COMPLETE_EVENT:"complete",BEGIN_EVENT:"begin",_addTestCaseToTestTree:function(C,D){var E=C.appendChild(D);for(var F in D){if(F.indexOf("test")===0&&YAHOO.lang.isFunction(D[F])){E.appendChild(F);}}},_addTestSuiteToTestTree:function(C,F){var E=C.appendChild(F);for(var D=0;D<F.items.length;D++){if(F.items[D] instanceof YAHOO.tool.TestSuite){this._addTestSuiteToTestTree(E,F.items[D]);}else{if(F.items[D] instanceof YAHOO.tool.TestCase){this._addTestCaseToTestTree(E,F.items[D]);}}}},_buildTestTree:function(){this._root=new B(this.masterSuite);this._cur=this._root;for(var C=0;C<this.masterSuite.items.length;C++){if(this.masterSuite.items[C] instanceof YAHOO.tool.TestSuite){this._addTestSuiteToTestTree(this._root,this.masterSuite.items[C]);}else{if(this.masterSuite.items[C] instanceof YAHOO.tool.TestCase){this._addTestCaseToTestTree(this._root,this.masterSuite.items[C]);}}}},_handleTestObjectComplete:function(C){if(YAHOO.lang.isObject(C.testObject)){C.parent.results.passed+=C.results.passed;C.parent.results.failed+=C.results.failed;C.parent.results.total+=C.results.total;C.parent.results.ignored+=C.results.ignored;C.parent.results[C.testObject.name]=C.results;if(C.testObject instanceof YAHOO.tool.TestSuite){C.testObject.tearDown();this.fireEvent(this.TEST_SUITE_COMPLETE_EVENT,{testSuite:C.testObject,results:C.results});}else{if(C.testObject instanceof YAHOO.tool.TestCase){this.fireEvent(this.TEST_CASE_COMPLETE_EVENT,{testCase:C.testObject,results:C.results});}}}},_next:function(){if(this._cur.firstChild){this._cur=this._cur.firstChild;}else{if(this._cur.next){this._cur=this._cur.next;}else{while(this._cur&&!this._cur.next&&this._cur!==this._root){this._handleTestObjectComplete(this._cur);this._cur=this._cur.parent;}if(this._cur==this._root){this._cur.results.type="report";this._cur.results.timestamp=(new Date()).toLocaleString();this.fireEvent(this.COMPLETE_EVENT,{results:this._cur.results});this._cur=null;}else{this._handleTestObjectComplete(this._cur);this._cur=this._cur.next;}}}return this._cur;},_run:function(){var E=false;var D=this._next();if(D!==null){var C=D.testObject;if(YAHOO.lang.isObject(C)){if(C instanceof YAHOO.tool.TestSuite){this.fireEvent(this.TEST_SUITE_BEGIN_EVENT,{testSuite:C});C.setUp();}else{if(C instanceof YAHOO.tool.TestCase){this.fireEvent(this.TEST_CASE_BEGIN_EVENT,{testCase:C});}}if(typeof setTimeout!="undefined"){setTimeout(function(){YAHOO.tool.TestRunner._run();},0);}else{this._run();}}else{this._runTest(D);}}},_resumeTest:function(G){var C=this._cur;var H=C.testObject;var E=C.parent.testObject;var K=(E._should.fail||{})[H];var D=(E._should.error||{})[H];var F=false;var I=null;try{G.apply(E);if(K){I=new YAHOO.util.ShouldFail();F=true;}else{if(D){I=new YAHOO.util.ShouldError();F=true;}}}catch(J){if(J instanceof YAHOO.util.AssertionError){if(!K){I=J;F=true;}}else{if(J instanceof YAHOO.tool.TestCase.Wait){if(YAHOO.lang.isFunction(J.segment)){if(YAHOO.lang.isNumber(J.delay)){if(typeof setTimeout!="undefined"){setTimeout(function(){YAHOO.tool.TestRunner._resumeTest(J.segment);},J.delay);}else{throw new Error("Asynchronous tests not supported in this environment.");}}}return ;}else{if(!D){I=new YAHOO.util.UnexpectedError(J);F=true;}else{if(YAHOO.lang.isString(D)){if(J.message!=D){I=new YAHOO.util.UnexpectedError(J);F=true;}}else{if(YAHOO.lang.isFunction(D)){if(!(J instanceof D)){I=new YAHOO.util.UnexpectedError(J);F=true;}}else{if(YAHOO.lang.isObject(D)){if(!(J instanceof D.constructor)||J.message!=D.message){I=new YAHOO.util.UnexpectedError(J);F=true;}}}}}}}}if(F){this.fireEvent(this.TEST_FAIL_EVENT,{testCase:E,testName:H,error:I});}else{this.fireEvent(this.TEST_PASS_EVENT,{testCase:E,testName:H});}E.tearDown();C.parent.results[H]={result:F?"fail":"pass",message:I?I.getMessage():"Test passed",type:"test",name:H}; -if(F){C.parent.results.failed++;}else{C.parent.results.passed++;}C.parent.results.total++;if(typeof setTimeout!="undefined"){setTimeout(function(){YAHOO.tool.TestRunner._run();},0);}else{this._run();}},_runTest:function(F){var C=F.testObject;var D=F.parent.testObject;var G=D[C];var E=(D._should.ignore||{})[C];if(E){F.parent.results[C]={result:"ignore",message:"Test ignored",type:"test",name:C};F.parent.results.ignored++;F.parent.results.total++;this.fireEvent(this.TEST_IGNORE_EVENT,{testCase:D,testName:C});if(typeof setTimeout!="undefined"){setTimeout(function(){YAHOO.tool.TestRunner._run();},0);}else{this._run();}}else{D.setUp();this._resumeTest(G);}},fireEvent:function(C,D){D=D||{};D.type=C;A.superclass.fireEvent.call(this,C,D);},add:function(C){this.masterSuite.add(C);},clear:function(){this.masterSuite.items=[];},resume:function(C){this._resumeTest(C||function(){});},run:function(C){var D=YAHOO.tool.TestRunner;D._buildTestTree();D.fireEvent(D.BEGIN_EVENT);D._run();}});return new A();})();YAHOO.namespace("util");YAHOO.util.Assert={fail:function(A){throw new YAHOO.util.AssertionError(A||"Test force-failed.");},areEqual:function(B,C,A){if(B!=C){throw new YAHOO.util.ComparisonFailure(A||"Values should be equal.",B,C);}},areNotEqual:function(A,C,B){if(A==C){throw new YAHOO.util.UnexpectedValue(B||"Values should not be equal.",A);}},areNotSame:function(A,C,B){if(A===C){throw new YAHOO.util.UnexpectedValue(B||"Values should not be the same.",A);}},areSame:function(B,C,A){if(B!==C){throw new YAHOO.util.ComparisonFailure(A||"Values should be the same.",B,C);}},isFalse:function(B,A){if(false!==B){throw new YAHOO.util.ComparisonFailure(A||"Value should be false.",false,B);}},isTrue:function(B,A){if(true!==B){throw new YAHOO.util.ComparisonFailure(A||"Value should be true.",true,B);}},isNaN:function(B,A){if(!isNaN(B)){throw new YAHOO.util.ComparisonFailure(A||"Value should be NaN.",NaN,B);}},isNotNaN:function(B,A){if(isNaN(B)){throw new YAHOO.util.UnexpectedValue(A||"Values should not be NaN.",NaN);}},isNotNull:function(B,A){if(YAHOO.lang.isNull(B)){throw new YAHOO.util.UnexpectedValue(A||"Values should not be null.",null);}},isNotUndefined:function(B,A){if(YAHOO.lang.isUndefined(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should not be undefined.",undefined);}},isNull:function(B,A){if(!YAHOO.lang.isNull(B)){throw new YAHOO.util.ComparisonFailure(A||"Value should be null.",null,B);}},isUndefined:function(B,A){if(!YAHOO.lang.isUndefined(B)){throw new YAHOO.util.ComparisonFailure(A||"Value should be undefined.",undefined,B);}},isArray:function(B,A){if(!YAHOO.lang.isArray(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should be an array.",B);}},isBoolean:function(B,A){if(!YAHOO.lang.isBoolean(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should be a Boolean.",B);}},isFunction:function(B,A){if(!YAHOO.lang.isFunction(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should be a function.",B);}},isInstanceOf:function(B,C,A){if(!(C instanceof B)){throw new YAHOO.util.ComparisonFailure(A||"Value isn't an instance of expected type.",B,C);}},isNumber:function(B,A){if(!YAHOO.lang.isNumber(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should be a number.",B);}},isObject:function(B,A){if(!YAHOO.lang.isObject(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should be an object.",B);}},isString:function(B,A){if(!YAHOO.lang.isString(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should be a string.",B);}},isTypeOf:function(A,C,B){if(typeof C!=A){throw new YAHOO.util.ComparisonFailure(B||"Value should be of type "+expected+".",expected,typeof actual);}}};YAHOO.util.AssertionError=function(A){arguments.callee.superclass.constructor.call(this,A);this.message=A;this.name="AssertionError";};YAHOO.lang.extend(YAHOO.util.AssertionError,Error,{getMessage:function(){return this.message;},toString:function(){return this.name+": "+this.getMessage();},valueOf:function(){return this.toString();}});YAHOO.util.ComparisonFailure=function(B,A,C){arguments.callee.superclass.constructor.call(this,B);this.expected=A;this.actual=C;this.name="ComparisonFailure";};YAHOO.lang.extend(YAHOO.util.ComparisonFailure,YAHOO.util.AssertionError,{getMessage:function(){return this.message+"\nExpected: "+this.expected+" ("+(typeof this.expected)+")\nActual:"+this.actual+" ("+(typeof this.actual)+")";}});YAHOO.util.UnexpectedValue=function(B,A){arguments.callee.superclass.constructor.call(this,B);this.unexpected=A;this.name="UnexpectedValue";};YAHOO.lang.extend(YAHOO.util.UnexpectedValue,YAHOO.util.AssertionError,{getMessage:function(){return this.message+"\nUnexpected: "+this.unexpected+" ("+(typeof this.unexpected)+") ";}});YAHOO.util.ShouldFail=function(A){arguments.callee.superclass.constructor.call(this,A||"This test should fail but didn't.");this.name="ShouldFail";};YAHOO.lang.extend(YAHOO.util.ShouldFail,YAHOO.util.AssertionError);YAHOO.util.ShouldError=function(A){arguments.callee.superclass.constructor.call(this,A||"This test should have thrown an error but didn't.");this.name="ShouldError";};YAHOO.lang.extend(YAHOO.util.ShouldError,YAHOO.util.AssertionError);YAHOO.util.UnexpectedError=function(A){arguments.callee.superclass.constructor.call(this,"Unexpected error: "+A.message);this.cause=A;this.name="UnexpectedError";};YAHOO.lang.extend(YAHOO.util.UnexpectedError,YAHOO.util.AssertionError);YAHOO.util.ArrayAssert={contains:function(E,D,B){var C=false;for(var A=0;A<D.length&&!C;A++){if(D[A]===E){C=true;}}if(!C){YAHOO.util.Assert.fail(B||"Value ("+E+") not found in array.");}},containsItems:function(C,D,B){for(var A=0;A<C.length;A++){this.contains(C[A],D,B);}if(!found){YAHOO.util.Assert.fail(B||"Value not found in array.");}},containsMatch:function(E,D,B){if(typeof E!="function"){throw new TypeError("ArrayAssert.containsMatch(): First argument must be a function.");}var C=false;for(var A=0;A<D.length&&!C;A++){if(E(D[A])){C=true;}}if(!C){YAHOO.util.Assert.fail(B||"No match found in array.");}},doesNotContain:function(E,D,B){var C=false; -for(var A=0;A<D.length&&!C;A++){if(D[A]===E){C=true;}}if(C){YAHOO.util.Assert.fail(B||"Value found in array.");}},doesNotContainItems:function(C,D,B){for(var A=0;A<C.length;A++){this.doesNotContain(C[A],D,B);}},doesNotContainMatch:function(E,D,B){if(typeof E!="function"){throw new TypeError("ArrayAssert.doesNotContainMatch(): First argument must be a function.");}var C=false;for(var A=0;A<D.length&&!C;A++){if(E(D[A])){C=true;}}if(C){YAHOO.util.Assert.fail(B||"Value found in array.");}},indexOf:function(E,D,A,C){for(var B=0;B<D.length;B++){if(D[B]===E){YAHOO.util.Assert.areEqual(A,B,C||"Value exists at index "+B+" but should be at index "+A+".");return ;}}YAHOO.util.Assert.fail(C||"Value doesn't exist in array.");},itemsAreEqual:function(D,E,C){var A=Math.max(D.length,E.length);for(var B=0;B<A;B++){YAHOO.util.Assert.areEqual(D[B],E[B],C||"Values in position "+B+" are not equal.");}},itemsAreEquivalent:function(E,F,B,D){if(typeof B!="function"){throw new TypeError("ArrayAssert.itemsAreEquivalent(): Third argument must be a function.");}var A=Math.max(E.length,F.length);for(var C=0;C<A;C++){if(!B(E[C],F[C])){throw new YAHOO.util.ComparisonFailure(D||"Values in position "+C+" are not equivalent.",E[C],F[C]);}}},isEmpty:function(B,A){if(B.length>0){YAHOO.util.Assert.fail(A||"Array should be empty.");}},isNotEmpty:function(B,A){if(B.length===0){YAHOO.util.Assert.fail(A||"Array should not be empty.");}},itemsAreSame:function(D,E,C){var A=Math.max(D.length,E.length);for(var B=0;B<A;B++){YAHOO.util.Assert.areSame(D[B],E[B],C||"Values in position "+B+" are not the same.");}},lastIndexOf:function(E,D,A,C){for(var B=D.length;B>=0;B--){if(D[B]===E){YAHOO.util.Assert.areEqual(A,B,C||"Value exists at index "+B+" but should be at index "+A+".");return ;}}YAHOO.util.Assert.fail(C||"Value doesn't exist in array.");}};YAHOO.namespace("util");YAHOO.util.ObjectAssert={propertiesAreEqual:function(D,F,C){var B=[];for(var E in D){B.push(E);}for(var A=0;A<B.length;A++){YAHOO.util.Assert.isNotUndefined(F[B[A]],C||"Property'"+B[A]+"' expected.");}},hasProperty:function(A,B,C){if(YAHOO.lang.isUndefined(B[A])){YAHOO.util.Assert.fail(C||"Property "+A+" not found on object.");}},hasOwnProperty:function(A,B,C){if(!YAHOO.lang.hasOwnProperty(B,A)){YAHOO.util.Assert.fail(C||"Property "+A+" not found on object instance.");}}};YAHOO.util.DateAssert={datesAreEqual:function(B,C,A){if(B instanceof Date&&C instanceof Date){YAHOO.util.Assert.areEqual(B.getFullYear(),C.getFullYear(),A||"Years should be equal.");YAHOO.util.Assert.areEqual(B.getMonth(),C.getMonth(),A||"Months should be equal.");YAHOO.util.Assert.areEqual(B.getDate(),C.getDate(),A||"Day of month should be equal.");}else{throw new TypeError("DateAssert.datesAreEqual(): Expected and actual values must be Date objects.");}},timesAreEqual:function(B,C,A){if(B instanceof Date&&C instanceof Date){YAHOO.util.Assert.areEqual(B.getHours(),C.getHours(),A||"Hours should be equal.");YAHOO.util.Assert.areEqual(B.getMinutes(),C.getMinutes(),A||"Minutes should be equal.");YAHOO.util.Assert.areEqual(B.getSeconds(),C.getSeconds(),A||"Seconds should be equal.");}else{throw new TypeError("DateAssert.timesAreEqual(): Expected and actual values must be Date objects.");}}};YAHOO.register("yuitest_core",YAHOO.tool.TestRunner,{version:"2.5.0",build:"895"}); \ No newline at end of file diff --git a/lib/yui/yuitest/yuitest_core-beta.js b/lib/yui/yuitest/yuitest_core-beta.js deleted file mode 100644 index 8a431c2178..0000000000 --- a/lib/yui/yuitest/yuitest_core-beta.js +++ /dev/null @@ -1,1922 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -YAHOO.namespace("tool"); - -//----------------------------------------------------------------------------- -// TestCase object -//----------------------------------------------------------------------------- - -/** - * Test case containing various tests to run. - * @param template An object containing any number of test methods, other methods, - * an optional name, and anything else the test case needs. - * @class TestCase - * @namespace YAHOO.tool - * @constructor - */ -YAHOO.tool.TestCase = function (template /*:Object*/) { - - /** - * Special rules for the test case. Possible subobjects - * are fail, for tests that should fail, and error, for - * tests that should throw an error. - */ - this._should /*:Object*/ = {}; - - //copy over all properties from the template to this object - for (var prop in template) { - this[prop] = template[prop]; - } - - //check for a valid name - if (!YAHOO.lang.isString(this.name)){ - /** - * Name for the test case. - */ - this.name /*:String*/ = YAHOO.util.Dom.generateId(null, "testCase"); - } - -}; - - -YAHOO.tool.TestCase.prototype = { - - /** - * Resumes a paused test and runs the given function. - * @param {Function} segment (Optional) The function to run. - * If omitted, the test automatically passes. - * @return {Void} - * @method resume - */ - resume : function (segment /*:Function*/) /*:Void*/ { - YAHOO.tool.TestRunner.resume(segment); - }, - - /** - * Causes the test case to wait a specified amount of time and then - * continue executing the given code. - * @param {Function} segment (Optional) The function to run after the delay. - * If omitted, the TestRunner will wait until resume() is called. - * @param {int} delay (Optional) The number of milliseconds to wait before running - * the function. If omitted, defaults to zero. - * @return {Void} - * @method wait - */ - wait : function (segment /*:Function*/, delay /*:int*/) /*:Void*/{ - throw new YAHOO.tool.TestCase.Wait(segment, delay); - }, - - //------------------------------------------------------------------------- - // Stub Methods - //------------------------------------------------------------------------- - - /** - * Function to run before each test is executed. - * @return {Void} - * @method setUp - */ - setUp : function () /*:Void*/ { - }, - - /** - * Function to run after each test is executed. - * @return {Void} - * @method tearDown - */ - tearDown: function () /*:Void*/ { - } -}; - -/** - * Represents a stoppage in test execution to wait for an amount of time before - * continuing. - * @param {Function} segment A function to run when the wait is over. - * @param {int} delay The number of milliseconds to wait before running the code. - * @class Wait - * @namespace YAHOO.tool.TestCase - * @constructor - * - */ -YAHOO.tool.TestCase.Wait = function (segment /*:Function*/, delay /*:int*/) { - - /** - * The segment of code to run when the wait is over. - * @type Function - * @property segment - */ - this.segment /*:Function*/ = (YAHOO.lang.isFunction(segment) ? segment : null); - - /** - * The delay before running the segment of code. - * @type int - * @property delay - */ - this.delay /*:int*/ = (YAHOO.lang.isNumber(delay) ? delay : 0); - -}; - -YAHOO.namespace("tool"); - - -//----------------------------------------------------------------------------- -// TestSuite object -//----------------------------------------------------------------------------- - -/** - * A test suite that can contain a collection of TestCase and TestSuite objects. - * @param {String||Object} data The name of the test suite or an object containing - * a name property as well as setUp and tearDown methods. - * @namespace YAHOO.tool - * @class TestSuite - * @constructor - */ -YAHOO.tool.TestSuite = function (data /*:String||Object*/) { - - /** - * The name of the test suite. - * @type String - * @property name - */ - this.name /*:String*/ = ""; - - /** - * Array of test suites and - * @private - */ - this.items /*:Array*/ = []; - - //initialize the properties - if (YAHOO.lang.isString(data)){ - this.name = data; - } else if (YAHOO.lang.isObject(data)){ - YAHOO.lang.augmentObject(this, data, true); - } - - //double-check name - if (this.name === ""){ - this.name = YAHOO.util.Dom.generateId(null, "testSuite"); - } - -}; - -YAHOO.tool.TestSuite.prototype = { - - /** - * Adds a test suite or test case to the test suite. - * @param {YAHOO.tool.TestSuite||YAHOO.tool.TestCase} testObject The test suite or test case to add. - * @return {Void} - * @method add - */ - add : function (testObject /*:YAHOO.tool.TestSuite*/) /*:Void*/ { - if (testObject instanceof YAHOO.tool.TestSuite || testObject instanceof YAHOO.tool.TestCase) { - this.items.push(testObject); - } - }, - - //------------------------------------------------------------------------- - // Stub Methods - //------------------------------------------------------------------------- - - /** - * Function to run before each test is executed. - * @return {Void} - * @method setUp - */ - setUp : function () /*:Void*/ { - }, - - /** - * Function to run after each test is executed. - * @return {Void} - * @method tearDown - */ - tearDown: function () /*:Void*/ { - } - -}; - -YAHOO.namespace("tool"); - -/** - * The YUI test tool - * @module yuitest - * @namespace YAHOO.tool - * @requires yahoo,dom,event,logger - */ - - -//----------------------------------------------------------------------------- -// TestRunner object -//----------------------------------------------------------------------------- - -/** - * Runs test suites and test cases, providing events to allowing for the - * interpretation of test results. - * @namespace YAHOO.tool - * @class TestRunner - * @static - */ -YAHOO.tool.TestRunner = (function(){ - - /** - * A node in the test tree structure. May represent a TestSuite, TestCase, or - * test function. - * @param {Variant} testObject A TestSuite, TestCase, or the name of a test function. - * @class TestNode - * @constructor - * @private - */ - function TestNode(testObject /*:Variant*/){ - - /** - * The TestSuite, TestCase, or test function represented by this node. - * @type Variant - * @property testObject - */ - this.testObject = testObject; - - /** - * Pointer to this node's first child. - * @type TestNode - * @property firstChild - */ - this.firstChild /*:TestNode*/ = null; - - /** - * Pointer to this node's last child. - * @type TestNode - * @property lastChild - */ - this.lastChild = null; - - /** - * Pointer to this node's parent. - * @type TestNode - * @property parent - */ - this.parent = null; - - /** - * Pointer to this node's next sibling. - * @type TestNode - * @property next - */ - this.next = null; - - /** - * Test results for this test object. - * @type object - * @property results - */ - this.results /*:Object*/ = { - passed : 0, - failed : 0, - total : 0, - ignored : 0 - }; - - //initialize results - if (testObject instanceof YAHOO.tool.TestSuite){ - this.results.type = "testsuite"; - this.results.name = testObject.name; - } else if (testObject instanceof YAHOO.tool.TestCase){ - this.results.type = "testcase"; - this.results.name = testObject.name; - } - - } - - TestNode.prototype = { - - /** - * Appends a new test object (TestSuite, TestCase, or test function name) as a child - * of this node. - * @param {Variant} testObject A TestSuite, TestCase, or the name of a test function. - * @return {Void} - */ - appendChild : function (testObject /*:Variant*/) /*:Void*/{ - var node = new TestNode(testObject); - if (this.firstChild === null){ - this.firstChild = this.lastChild = node; - } else { - this.lastChild.next = node; - this.lastChild = node; - } - node.parent = this; - return node; - } - }; - - function TestRunner(){ - - //inherit from EventProvider - TestRunner.superclass.constructor.apply(this,arguments); - - /** - * Suite on which to attach all TestSuites and TestCases to be run. - * @type YAHOO.tool.TestSuite - * @property masterSuite - * @private - */ - this.masterSuite /*:YAHOO.tool.TestSuite*/ = new YAHOO.tool.TestSuite("YUI Test Results"); - - /** - * Pointer to the current node in the test tree. - * @type TestNode - * @private - * @property _cur - */ - this._cur = null; - - /** - * Pointer to the root node in the test tree. - * @type TestNode - * @private - * @property _root - */ - this._root = null; - - //create events - var events /*:Array*/ = [ - this.TEST_CASE_BEGIN_EVENT, - this.TEST_CASE_COMPLETE_EVENT, - this.TEST_SUITE_BEGIN_EVENT, - this.TEST_SUITE_COMPLETE_EVENT, - this.TEST_PASS_EVENT, - this.TEST_FAIL_EVENT, - this.TEST_IGNORE_EVENT, - this.COMPLETE_EVENT, - this.BEGIN_EVENT - ]; - for (var i=0; i < events.length; i++){ - this.createEvent(events[i], { scope: this }); - } - - } - - YAHOO.lang.extend(TestRunner, YAHOO.util.EventProvider, { - - //------------------------------------------------------------------------- - // Constants - //------------------------------------------------------------------------- - - /** - * Fires when a test case is opened but before the first - * test is executed. - * @event testcasebegin - */ - TEST_CASE_BEGIN_EVENT /*:String*/ : "testcasebegin", - - /** - * Fires when all tests in a test case have been executed. - * @event testcasecomplete - */ - TEST_CASE_COMPLETE_EVENT /*:String*/ : "testcasecomplete", - - /** - * Fires when a test suite is opened but before the first - * test is executed. - * @event testsuitebegin - */ - TEST_SUITE_BEGIN_EVENT /*:String*/ : "testsuitebegin", - - /** - * Fires when all test cases in a test suite have been - * completed. - * @event testsuitecomplete - */ - TEST_SUITE_COMPLETE_EVENT /*:String*/ : "testsuitecomplete", - - /** - * Fires when a test has passed. - * @event pass - */ - TEST_PASS_EVENT /*:String*/ : "pass", - - /** - * Fires when a test has failed. - * @event fail - */ - TEST_FAIL_EVENT /*:String*/ : "fail", - - /** - * Fires when a test has been ignored. - * @event ignore - */ - TEST_IGNORE_EVENT /*:String*/ : "ignore", - - /** - * Fires when all test suites and test cases have been completed. - * @event complete - */ - COMPLETE_EVENT /*:String*/ : "complete", - - /** - * Fires when the run() method is called. - * @event begin - */ - BEGIN_EVENT /*:String*/ : "begin", - - //------------------------------------------------------------------------- - // Test Tree-Related Methods - //------------------------------------------------------------------------- - - /** - * Adds a test case to the test tree as a child of the specified node. - * @param {TestNode} parentNode The node to add the test case to as a child. - * @param {YAHOO.tool.TestCase} testCase The test case to add. - * @return {Void} - * @static - * @private - * @method _addTestCaseToTestTree - */ - _addTestCaseToTestTree : function (parentNode /*:TestNode*/, testCase /*:YAHOO.tool.TestCase*/) /*:Void*/{ - - //add the test suite - var node = parentNode.appendChild(testCase); - - //iterate over the items in the test case - for (var prop in testCase){ - if (prop.indexOf("test") === 0 && YAHOO.lang.isFunction(testCase[prop])){ - node.appendChild(prop); - } - } - - }, - - /** - * Adds a test suite to the test tree as a child of the specified node. - * @param {TestNode} parentNode The node to add the test suite to as a child. - * @param {YAHOO.tool.TestSuite} testSuite The test suite to add. - * @return {Void} - * @static - * @private - * @method _addTestSuiteToTestTree - */ - _addTestSuiteToTestTree : function (parentNode /*:TestNode*/, testSuite /*:YAHOO.tool.TestSuite*/) /*:Void*/ { - - //add the test suite - var node = parentNode.appendChild(testSuite); - - //iterate over the items in the master suite - for (var i=0; i < testSuite.items.length; i++){ - if (testSuite.items[i] instanceof YAHOO.tool.TestSuite) { - this._addTestSuiteToTestTree(node, testSuite.items[i]); - } else if (testSuite.items[i] instanceof YAHOO.tool.TestCase) { - this._addTestCaseToTestTree(node, testSuite.items[i]); - } - } - }, - - /** - * Builds the test tree based on items in the master suite. The tree is a hierarchical - * representation of the test suites, test cases, and test functions. The resulting tree - * is stored in _root and the pointer _cur is set to the root initially. - * @return {Void} - * @static - * @private - * @method _buildTestTree - */ - _buildTestTree : function () /*:Void*/ { - - this._root = new TestNode(this.masterSuite); - this._cur = this._root; - - //iterate over the items in the master suite - for (var i=0; i < this.masterSuite.items.length; i++){ - if (this.masterSuite.items[i] instanceof YAHOO.tool.TestSuite) { - this._addTestSuiteToTestTree(this._root, this.masterSuite.items[i]); - } else if (this.masterSuite.items[i] instanceof YAHOO.tool.TestCase) { - this._addTestCaseToTestTree(this._root, this.masterSuite.items[i]); - } - } - - }, - - //------------------------------------------------------------------------- - // Private Methods - //------------------------------------------------------------------------- - - /** - * Handles the completion of a test object's tests. Tallies test results - * from one level up to the next. - * @param {TestNode} node The TestNode representing the test object. - * @return {Void} - * @method _handleTestObjectComplete - * @private - */ - _handleTestObjectComplete : function (node /*:TestNode*/) /*:Void*/ { - if (YAHOO.lang.isObject(node.testObject)){ - node.parent.results.passed += node.results.passed; - node.parent.results.failed += node.results.failed; - node.parent.results.total += node.results.total; - node.parent.results.ignored += node.results.ignored; - node.parent.results[node.testObject.name] = node.results; - - if (node.testObject instanceof YAHOO.tool.TestSuite){ - node.testObject.tearDown(); - this.fireEvent(this.TEST_SUITE_COMPLETE_EVENT, { testSuite: node.testObject, results: node.results}); - } else if (node.testObject instanceof YAHOO.tool.TestCase){ - this.fireEvent(this.TEST_CASE_COMPLETE_EVENT, { testCase: node.testObject, results: node.results}); - } - } - }, - - //------------------------------------------------------------------------- - // Navigation Methods - //------------------------------------------------------------------------- - - /** - * Retrieves the next node in the test tree. - * @return {TestNode} The next node in the test tree or null if the end is reached. - * @private - * @static - * @method _next - */ - _next : function () /*:TestNode*/ { - - if (this._cur.firstChild) { - this._cur = this._cur.firstChild; - } else if (this._cur.next) { - this._cur = this._cur.next; - } else { - while (this._cur && !this._cur.next && this._cur !== this._root){ - this._handleTestObjectComplete(this._cur); - this._cur = this._cur.parent; - } - - if (this._cur == this._root){ - this._cur.results.type = "report"; - this._cur.results.timestamp = (new Date()).toLocaleString(); - this.fireEvent(this.COMPLETE_EVENT, { results: this._cur.results}); - this._cur = null; - } else { - this._handleTestObjectComplete(this._cur); - this._cur = this._cur.next; - } - } - - return this._cur; - }, - - /** - * Runs a test case or test suite, returning the results. - * @param {YAHOO.tool.TestCase|YAHOO.tool.TestSuite} testObject The test case or test suite to run. - * @return {Object} Results of the execution with properties passed, failed, and total. - * @private - * @method _run - * @static - */ - _run : function () /*:Void*/ { - - //flag to indicate if the TestRunner should wait before continuing - var shouldWait /*:Boolean*/ = false; - - //get the next test node - var node = this._next(); - - if (node !== null) { - var testObject = node.testObject; - - //figure out what to do - if (YAHOO.lang.isObject(testObject)){ - if (testObject instanceof YAHOO.tool.TestSuite){ - this.fireEvent(this.TEST_SUITE_BEGIN_EVENT, { testSuite: testObject }); - testObject.setUp(); - } else if (testObject instanceof YAHOO.tool.TestCase){ - this.fireEvent(this.TEST_CASE_BEGIN_EVENT, { testCase: testObject }); - } - - //some environments don't support setTimeout - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._run(); - }, 0); - } else { - this._run(); - } - } else { - this._runTest(node); - } - - } - }, - - _resumeTest : function (segment /*:Function*/) /*:Void*/ { - - //get relevant information - var node /*:TestNode*/ = this._cur; - var testName /*:String*/ = node.testObject; - var testCase /*:YAHOO.tool.TestCase*/ = node.parent.testObject; - - //get the "should" test cases - var shouldFail /*:Object*/ = (testCase._should.fail || {})[testName]; - var shouldError /*:Object*/ = (testCase._should.error || {})[testName]; - - //variable to hold whether or not the test failed - var failed /*:Boolean*/ = false; - var error /*:Error*/ = null; - - //try the test - try { - - //run the test - segment.apply(testCase); - - //if it should fail, and it got here, then it's a fail because it didn't - if (shouldFail){ - error = new YAHOO.util.ShouldFail(); - failed = true; - } else if (shouldError){ - error = new YAHOO.util.ShouldError(); - failed = true; - } - - } catch (thrown /*:Error*/){ - if (thrown instanceof YAHOO.util.AssertionError) { - if (!shouldFail){ - error = thrown; - failed = true; - } - } else if (thrown instanceof YAHOO.tool.TestCase.Wait){ - - if (YAHOO.lang.isFunction(thrown.segment)){ - if (YAHOO.lang.isNumber(thrown.delay)){ - - //some environments don't support setTimeout - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._resumeTest(thrown.segment); - }, thrown.delay); - } else { - throw new Error("Asynchronous tests not supported in this environment."); - } - } - } - - return; - - } else { - //first check to see if it should error - if (!shouldError) { - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } else { - //check to see what type of data we have - if (YAHOO.lang.isString(shouldError)){ - - //if it's a string, check the error message - if (thrown.message != shouldError){ - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } - } else if (YAHOO.lang.isFunction(shouldError)){ - - //if it's a function, see if the error is an instance of it - if (!(thrown instanceof shouldError)){ - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } - - } else if (YAHOO.lang.isObject(shouldError)){ - - //if it's an object, check the instance and message - if (!(thrown instanceof shouldError.constructor) || - thrown.message != shouldError.message){ - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } - - } - - } - } - - } - - //fireEvent appropriate event - if (failed) { - this.fireEvent(this.TEST_FAIL_EVENT, { testCase: testCase, testName: testName, error: error }); - } else { - this.fireEvent(this.TEST_PASS_EVENT, { testCase: testCase, testName: testName }); - } - - //run the tear down - testCase.tearDown(); - - //update results - node.parent.results[testName] = { - result: failed ? "fail" : "pass", - message: error ? error.getMessage() : "Test passed", - type: "test", - name: testName - }; - - if (failed){ - node.parent.results.failed++; - } else { - node.parent.results.passed++; - } - node.parent.results.total++; - - //set timeout not supported in all environments - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._run(); - }, 0); - } else { - this._run(); - } - - }, - - /** - * Runs a single test based on the data provided in the node. - * @param {TestNode} node The TestNode representing the test to run. - * @return {Void} - * @static - * @private - * @name _runTest - */ - _runTest : function (node /*:TestNode*/) /*:Void*/ { - - //get relevant information - var testName /*:String*/ = node.testObject; - var testCase /*:YAHOO.tool.TestCase*/ = node.parent.testObject; - var test /*:Function*/ = testCase[testName]; - - //get the "should" test cases - var shouldIgnore /*:Object*/ = (testCase._should.ignore || {})[testName]; - - //figure out if the test should be ignored or not - if (shouldIgnore){ - - //update results - node.parent.results[testName] = { - result: "ignore", - message: "Test ignored", - type: "test", - name: testName - }; - - node.parent.results.ignored++; - node.parent.results.total++; - - this.fireEvent(this.TEST_IGNORE_EVENT, { testCase: testCase, testName: testName }); - - //some environments don't support setTimeout - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._run(); - }, 0); - } else { - this._run(); - } - - } else { - - //run the setup - testCase.setUp(); - - //now call the body of the test - this._resumeTest(test); - } - - }, - - //------------------------------------------------------------------------- - // Protected Methods - //------------------------------------------------------------------------- - - /* - * Fires events for the TestRunner. This overrides the default fireEvent() - * method from EventProvider to add the type property to the data that is - * passed through on each event call. - * @param {String} type The type of event to fire. - * @param {Object} data (Optional) Data for the event. - * @method fireEvent - * @static - * @protected - */ - fireEvent : function (type /*:String*/, data /*:Object*/) /*:Void*/ { - data = data || {}; - data.type = type; - TestRunner.superclass.fireEvent.call(this, type, data); - }, - - //------------------------------------------------------------------------- - // Public Methods - //------------------------------------------------------------------------- - - /** - * Adds a test suite or test case to the list of test objects to run. - * @param testObject Either a TestCase or a TestSuite that should be run. - * @return {Void} - * @method add - * @static - */ - add : function (testObject /*:Object*/) /*:Void*/ { - this.masterSuite.add(testObject); - }, - - /** - * Removes all test objects from the runner. - * @return {Void} - * @method clear - * @static - */ - clear : function () /*:Void*/ { - this.masterSuite.items = []; - }, - - /** - * Resumes the TestRunner after wait() was called. - * @param {Function} segment The function to run as the rest - * of the haulted test. - * @return {Void} - * @method resume - * @static - */ - resume : function (segment /*:Function*/) /*:Void*/ { - this._resumeTest(segment || function(){}); - }, - - /** - * Runs the test suite. - * @return {Void} - * @method run - * @static - */ - run : function (testObject /*:Object*/) /*:Void*/ { - - //pointer to runner to avoid scope issues - var runner = YAHOO.tool.TestRunner; - - //build the test tree - runner._buildTestTree(); - - //fire the begin event - runner.fireEvent(runner.BEGIN_EVENT); - - //begin the testing - runner._run(); - } - }); - - return new TestRunner(); - -})(); - -YAHOO.namespace("util"); - -//----------------------------------------------------------------------------- -// Assert object -//----------------------------------------------------------------------------- - -/** - * The Assert object provides functions to test JavaScript values against - * known and expected results. Whenever a comparison (assertion) fails, - * an error is thrown. - * - * @namespace YAHOO.util - * @class Assert - * @static - */ -YAHOO.util.Assert = { - - //------------------------------------------------------------------------- - // Generic Assertion Methods - //------------------------------------------------------------------------- - - /** - * Forces an assertion error to occur. - * @param {String} message (Optional) The message to display with the failure. - * @method fail - * @static - */ - fail : function (message /*:String*/) /*:Void*/ { - throw new YAHOO.util.AssertionError(message || "Test force-failed."); - }, - - //------------------------------------------------------------------------- - // Equality Assertion Methods - //------------------------------------------------------------------------- - - /** - * Asserts that a value is equal to another. This uses the double equals sign - * so type cohersion may occur. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areEqual - * @static - */ - areEqual : function (expected /*:Object*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (expected != actual) { - throw new YAHOO.util.ComparisonFailure(message || "Values should be equal.", expected, actual); - } - }, - - /** - * Asserts that a value is not equal to another. This uses the double equals sign - * so type cohersion may occur. - * @param {Object} unexpected The unexpected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areNotEqual - * @static - */ - areNotEqual : function (unexpected /*:Object*/, actual /*:Object*/, - message /*:String*/) /*:Void*/ { - if (unexpected == actual) { - throw new YAHOO.util.UnexpectedValue(message || "Values should not be equal.", unexpected); - } - }, - - /** - * Asserts that a value is not the same as another. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} unexpected The unexpected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areNotSame - * @static - */ - areNotSame : function (unexpected /*:Object*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (unexpected === actual) { - throw new YAHOO.util.UnexpectedValue(message || "Values should not be the same.", unexpected); - } - }, - - /** - * Asserts that a value is the same as another. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areSame - * @static - */ - areSame : function (expected /*:Object*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (expected !== actual) { - throw new YAHOO.util.ComparisonFailure(message || "Values should be the same.", expected, actual); - } - }, - - //------------------------------------------------------------------------- - // Boolean Assertion Methods - //------------------------------------------------------------------------- - - /** - * Asserts that a value is false. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isFalse - * @static - */ - isFalse : function (actual /*:Boolean*/, message /*:String*/) { - if (false !== actual) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be false.", false, actual); - } - }, - - /** - * Asserts that a value is true. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isTrue - * @static - */ - isTrue : function (actual /*:Boolean*/, message /*:String*/) /*:Void*/ { - if (true !== actual) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be true.", true, actual); - } - - }, - - //------------------------------------------------------------------------- - // Special Value Assertion Methods - //------------------------------------------------------------------------- - - /** - * Asserts that a value is not a number. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNaN - * @static - */ - isNaN : function (actual /*:Object*/, message /*:String*/) /*:Void*/{ - if (!isNaN(actual)){ - throw new YAHOO.util.ComparisonFailure(message || "Value should be NaN.", NaN, actual); - } - }, - - /** - * Asserts that a value is not the special NaN value. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotNaN - * @static - */ - isNotNaN : function (actual /*:Object*/, message /*:String*/) /*:Void*/{ - if (isNaN(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Values should not be NaN.", NaN); - } - }, - - /** - * Asserts that a value is not null. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotNull - * @static - */ - isNotNull : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (YAHOO.lang.isNull(actual)) { - throw new YAHOO.util.UnexpectedValue(message || "Values should not be null.", null); - } - }, - - /** - * Asserts that a value is not undefined. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotUndefined - * @static - */ - isNotUndefined : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (YAHOO.lang.isUndefined(actual)) { - throw new YAHOO.util.UnexpectedValue(message || "Value should not be undefined.", undefined); - } - }, - - /** - * Asserts that a value is null. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNull - * @static - */ - isNull : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isNull(actual)) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be null.", null, actual); - } - }, - - /** - * Asserts that a value is undefined. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isUndefined - * @static - */ - isUndefined : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isUndefined(actual)) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be undefined.", undefined, actual); - } - }, - - //-------------------------------------------------------------------------- - // Instance Assertion Methods - //-------------------------------------------------------------------------- - - /** - * Asserts that a value is an array. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isArray - * @static - */ - isArray : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isArray(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be an array.", actual); - } - }, - - /** - * Asserts that a value is a Boolean. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isBoolean - * @static - */ - isBoolean : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isBoolean(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a Boolean.", actual); - } - }, - - /** - * Asserts that a value is a function. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isFunction - * @static - */ - isFunction : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isFunction(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a function.", actual); - } - }, - - /** - * Asserts that a value is an instance of a particular object. This may return - * incorrect results when comparing objects from one frame to constructors in - * another frame. For best results, don't use in a cross-frame manner. - * @param {Function} expected The function that the object should be an instance of. - * @param {Object} actual The object to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isInstanceOf - * @static - */ - isInstanceOf : function (expected /*:Function*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!(actual instanceof expected)){ - throw new YAHOO.util.ComparisonFailure(message || "Value isn't an instance of expected type.", expected, actual); - } - }, - - /** - * Asserts that a value is a number. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNumber - * @static - */ - isNumber : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isNumber(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a number.", actual); - } - }, - - /** - * Asserts that a value is an object. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isObject - * @static - */ - isObject : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isObject(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be an object.", actual); - } - }, - - /** - * Asserts that a value is a string. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isString - * @static - */ - isString : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isString(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a string.", actual); - } - }, - - /** - * Asserts that a value is of a particular type. - * @param {String} expectedType The expected type of the variable. - * @param {Object} actualValue The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isTypeOf - * @static - */ - isTypeOf : function (expectedType /*:String*/, actualValue /*:Object*/, message /*:String*/) /*:Void*/{ - if (typeof actualValue != expectedType){ - throw new YAHOO.util.ComparisonFailure(message || "Value should be of type " + expected + ".", expected, typeof actual); - } - } -}; - -//----------------------------------------------------------------------------- -// Assertion errors -//----------------------------------------------------------------------------- - -/** - * AssertionError is thrown whenever an assertion fails. It provides methods - * to more easily get at error information and also provides a base class - * from which more specific assertion errors can be derived. - * - * @param {String} message The message to display when the error occurs. - * @namespace YAHOO.util - * @class AssertionError - * @extends Error - * @constructor - */ -YAHOO.util.AssertionError = function (message /*:String*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message); - - /* - * Error message. Must be duplicated to ensure browser receives it. - * @type String - * @property message - */ - this.message /*:String*/ = message; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "AssertionError"; -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.AssertionError, Error, { - - /** - * Returns a fully formatted error for an assertion failure. This should - * be overridden by all subclasses to provide specific information. - * @method getMessage - * @return {String} A string describing the error. - */ - getMessage : function () /*:String*/ { - return this.message; - }, - - /** - * Returns a string representation of the error. - * @method toString - * @return {String} A string representation of the error. - */ - toString : function () /*:String*/ { - return this.name + ": " + this.getMessage(); - }, - - /** - * Returns a primitive value version of the error. Same as toString(). - * @method valueOf - * @return {String} A primitive value version of the error. - */ - valueOf : function () /*:String*/ { - return this.toString(); - } - -}); - -/** - * ComparisonFailure is subclass of AssertionError that is thrown whenever - * a comparison between two values fails. It provides mechanisms to retrieve - * both the expected and actual value. - * - * @param {String} message The message to display when the error occurs. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value that caused the assertion to fail. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class ComparisonFailure - * @constructor - */ -YAHOO.util.ComparisonFailure = function (message /*:String*/, expected /*:Object*/, actual /*:Object*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message); - - /** - * The expected value. - * @type Object - * @property expected - */ - this.expected /*:Object*/ = expected; - - /** - * The actual value. - * @type Object - * @property actual - */ - this.actual /*:Object*/ = actual; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "ComparisonFailure"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.ComparisonFailure, YAHOO.util.AssertionError, { - - /** - * Returns a fully formatted error for an assertion failure. This message - * provides information about the expected and actual values. - * @method toString - * @return {String} A string describing the error. - */ - getMessage : function () /*:String*/ { - return this.message + "\nExpected: " + this.expected + " (" + (typeof this.expected) + ")" + - "\nActual:" + this.actual + " (" + (typeof this.actual) + ")"; - } - -}); - -/** - * UnexpectedValue is subclass of AssertionError that is thrown whenever - * a value was unexpected in its scope. This typically means that a test - * was performed to determine that a value was *not* equal to a certain - * value. - * - * @param {String} message The message to display when the error occurs. - * @param {Object} unexpected The unexpected value. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class UnexpectedValue - * @constructor - */ -YAHOO.util.UnexpectedValue = function (message /*:String*/, unexpected /*:Object*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message); - - /** - * The unexpected value. - * @type Object - * @property unexpected - */ - this.unexpected /*:Object*/ = unexpected; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "UnexpectedValue"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.UnexpectedValue, YAHOO.util.AssertionError, { - - /** - * Returns a fully formatted error for an assertion failure. The message - * contains information about the unexpected value that was encountered. - * @method getMessage - * @return {String} A string describing the error. - */ - getMessage : function () /*:String*/ { - return this.message + "\nUnexpected: " + this.unexpected + " (" + (typeof this.unexpected) + ") "; - } - -}); - -/** - * ShouldFail is subclass of AssertionError that is thrown whenever - * a test was expected to fail but did not. - * - * @param {String} message The message to display when the error occurs. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class ShouldFail - * @constructor - */ -YAHOO.util.ShouldFail = function (message /*:String*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message || "This test should fail but didn't."); - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "ShouldFail"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.ShouldFail, YAHOO.util.AssertionError); - -/** - * ShouldError is subclass of AssertionError that is thrown whenever - * a test is expected to throw an error but doesn't. - * - * @param {String} message The message to display when the error occurs. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class ShouldError - * @constructor - */ -YAHOO.util.ShouldError = function (message /*:String*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message || "This test should have thrown an error but didn't."); - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "ShouldError"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.ShouldError, YAHOO.util.AssertionError); - -/** - * UnexpectedError is subclass of AssertionError that is thrown whenever - * an error occurs within the course of a test and the test was not expected - * to throw an error. - * - * @param {Error} cause The unexpected error that caused this error to be - * thrown. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class UnexpectedError - * @constructor - */ -YAHOO.util.UnexpectedError = function (cause /*:Object*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, "Unexpected error: " + cause.message); - - /** - * The unexpected error that occurred. - * @type Error - * @property cause - */ - this.cause /*:Error*/ = cause; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "UnexpectedError"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.UnexpectedError, YAHOO.util.AssertionError); - -//----------------------------------------------------------------------------- -// ArrayAssert object -//----------------------------------------------------------------------------- - -/** - * The ArrayAssert object provides functions to test JavaScript array objects - * for a variety of cases. - * - * @namespace YAHOO.util - * @class ArrayAssert - * @static - */ - -YAHOO.util.ArrayAssert = { - - /** - * Asserts that a value is present in an array. This uses the triple equals - * sign so no type cohersion may occur. - * @param {Object} needle The value that is expected in the array. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method contains - * @static - */ - contains : function (needle /*:Object*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (haystack[i] === needle) { - found = true; - } - } - - if (!found){ - YAHOO.util.Assert.fail(message || "Value (" + needle + ") not found in array."); - } - }, - - /** - * Asserts that a set of values are present in an array. This uses the triple equals - * sign so no type cohersion may occur. For this assertion to pass, all values must - * be found. - * @param {Object[]} needles An array of values that are expected in the array. - * @param {Array} haystack An array of values to check. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method containsItems - * @static - */ - containsItems : function (needles /*:Object[]*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - //begin checking values - for (var i=0; i < needles.length; i++){ - this.contains(needles[i], haystack, message); - } - - if (!found){ - YAHOO.util.Assert.fail(message || "Value not found in array."); - } - }, - - /** - * Asserts that a value matching some condition is present in an array. This uses - * a function to determine a match. - * @param {Function} matcher A function that returns true if the items matches or false if not. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method containsMatch - * @static - */ - containsMatch : function (matcher /*:Function*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - //check for valid matcher - if (typeof matcher != "function"){ - throw new TypeError("ArrayAssert.containsMatch(): First argument must be a function."); - } - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (matcher(haystack[i])) { - found = true; - } - } - - if (!found){ - YAHOO.util.Assert.fail(message || "No match found in array."); - } - }, - - /** - * Asserts that a value is not present in an array. This uses the triple equals - * sign so no type cohersion may occur. - * @param {Object} needle The value that is expected in the array. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method doesNotContain - * @static - */ - doesNotContain : function (needle /*:Object*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (haystack[i] === needle) { - found = true; - } - } - - if (found){ - YAHOO.util.Assert.fail(message || "Value found in array."); - } - }, - - /** - * Asserts that a set of values are not present in an array. This uses the triple equals - * sign so no type cohersion may occur. For this assertion to pass, all values must - * not be found. - * @param {Object[]} needles An array of values that are not expected in the array. - * @param {Array} haystack An array of values to check. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method doesNotContainItems - * @static - */ - doesNotContainItems : function (needles /*:Object[]*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - for (var i=0; i < needles.length; i++){ - this.doesNotContain(needles[i], haystack, message); - } - - }, - - /** - * Asserts that no values matching a condition are present in an array. This uses - * a function to determine a match. - * @param {Function} matcher A function that returns true if the items matches or false if not. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method doesNotContainMatch - * @static - */ - doesNotContainMatch : function (matcher /*:Function*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - //check for valid matcher - if (typeof matcher != "function"){ - throw new TypeError("ArrayAssert.doesNotContainMatch(): First argument must be a function."); - } - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (matcher(haystack[i])) { - found = true; - } - } - - if (found){ - YAHOO.util.Assert.fail(message || "Value found in array."); - } - }, - - /** - * Asserts that the given value is contained in an array at the specified index. - * This uses the triple equals sign so no type cohersion will occur. - * @param {Object} needle The value to look for. - * @param {Array} haystack The array to search in. - * @param {int} index The index at which the value should exist. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method indexOf - * @static - */ - indexOf : function (needle /*:Object*/, haystack /*:Array*/, index /*:int*/, message /*:String*/) /*:Void*/ { - - //try to find the value in the array - for (var i=0; i < haystack.length; i++){ - if (haystack[i] === needle){ - YAHOO.util.Assert.areEqual(index, i, message || "Value exists at index " + i + " but should be at index " + index + "."); - return; - } - } - - //if it makes it here, it wasn't found at all - YAHOO.util.Assert.fail(message || "Value doesn't exist in array."); - }, - - /** - * Asserts that the values in an array are equal, and in the same position, - * as values in another array. This uses the double equals sign - * so type cohersion may occur. Note that the array objects themselves - * need not be the same for this test to pass. - * @param {Array} expected An array of the expected values. - * @param {Array} actual Any array of the actual values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method itemsAreEqual - * @static - */ - itemsAreEqual : function (expected /*:Array*/, actual /*:Array*/, - message /*:String*/) /*:Void*/ { - - //one may be longer than the other, so get the maximum length - var len /*:int*/ = Math.max(expected.length, actual.length); - - //begin checking values - for (var i=0; i < len; i++){ - YAHOO.util.Assert.areEqual(expected[i], actual[i], message || - "Values in position " + i + " are not equal."); - } - }, - - /** - * Asserts that the values in an array are equivalent, and in the same position, - * as values in another array. This uses a function to determine if the values - * are equivalent. Note that the array objects themselves - * need not be the same for this test to pass. - * @param {Array} expected An array of the expected values. - * @param {Array} actual Any array of the actual values. - * @param {Function} comparator A function that returns true if the values are equivalent - * or false if not. - * @param {String} message (Optional) The message to display if the assertion fails. - * @return {Void} - * @method itemsAreEquivalent - * @static - */ - itemsAreEquivalent : function (expected /*:Array*/, actual /*:Array*/, - comparator /*:Function*/, message /*:String*/) /*:Void*/ { - - //make sure the comparator is valid - if (typeof comparator != "function"){ - throw new TypeError("ArrayAssert.itemsAreEquivalent(): Third argument must be a function."); - } - - //one may be longer than the other, so get the maximum length - var len /*:int*/ = Math.max(expected.length, actual.length); - - //begin checking values - for (var i=0; i < len; i++){ - if (!comparator(expected[i], actual[i])){ - throw new YAHOO.util.ComparisonFailure(message || "Values in position " + i + " are not equivalent.", expected[i], actual[i]); - } - } - }, - - /** - * Asserts that an array is empty. - * @param {Array} actual The array to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isEmpty - * @static - */ - isEmpty : function (actual /*:Array*/, message /*:String*/) /*:Void*/ { - if (actual.length > 0){ - YAHOO.util.Assert.fail(message || "Array should be empty."); - } - }, - - /** - * Asserts that an array is not empty. - * @param {Array} actual The array to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotEmpty - * @static - */ - isNotEmpty : function (actual /*:Array*/, message /*:String*/) /*:Void*/ { - if (actual.length === 0){ - YAHOO.util.Assert.fail(message || "Array should not be empty."); - } - }, - - /** - * Asserts that the values in an array are the same, and in the same position, - * as values in another array. This uses the triple equals sign - * so no type cohersion will occur. Note that the array objects themselves - * need not be the same for this test to pass. - * @param {Array} expected An array of the expected values. - * @param {Array} actual Any array of the actual values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method itemsAreSame - * @static - */ - itemsAreSame : function (expected /*:Array*/, actual /*:Array*/, - message /*:String*/) /*:Void*/ { - - //one may be longer than the other, so get the maximum length - var len /*:int*/ = Math.max(expected.length, actual.length); - - //begin checking values - for (var i=0; i < len; i++){ - YAHOO.util.Assert.areSame(expected[i], actual[i], - message || "Values in position " + i + " are not the same."); - } - }, - - /** - * Asserts that the given value is contained in an array at the specified index, - * starting from the back of the array. - * This uses the triple equals sign so no type cohersion will occur. - * @param {Object} needle The value to look for. - * @param {Array} haystack The array to search in. - * @param {int} index The index at which the value should exist. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method lastIndexOf - * @static - */ - lastIndexOf : function (needle /*:Object*/, haystack /*:Array*/, index /*:int*/, message /*:String*/) /*:Void*/ { - - //try to find the value in the array - for (var i=haystack.length; i >= 0; i--){ - if (haystack[i] === needle){ - YAHOO.util.Assert.areEqual(index, i, message || "Value exists at index " + i + " but should be at index " + index + "."); - return; - } - } - - //if it makes it here, it wasn't found at all - YAHOO.util.Assert.fail(message || "Value doesn't exist in array."); - } - -}; - -YAHOO.namespace("util"); - - -//----------------------------------------------------------------------------- -// ObjectAssert object -//----------------------------------------------------------------------------- - -/** - * The ObjectAssert object provides functions to test JavaScript objects - * for a variety of cases. - * - * @namespace YAHOO.util - * @class ObjectAssert - * @static - */ -YAHOO.util.ObjectAssert = { - - /** - * Asserts that all properties in the object exist in another object. - * @param {Object} expected An object with the expected properties. - * @param {Object} actual An object with the actual properties. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method propertiesAreEqual - * @static - */ - propertiesAreEqual : function (expected /*:Object*/, actual /*:Object*/, - message /*:String*/) /*:Void*/ { - - //get all properties in the object - var properties /*:Array*/ = []; - for (var property in expected){ - properties.push(property); - } - - //see if the properties are in the expected object - for (var i=0; i < properties.length; i++){ - YAHOO.util.Assert.isNotUndefined(actual[properties[i]], message || - "Property'" + properties[i] + "' expected."); - } - - }, - - /** - * Asserts that an object has a property with the given name. - * @param {String} propertyName The name of the property to test. - * @param {Object} object The object to search. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method hasProperty - * @static - */ - hasProperty : function (propertyName /*:String*/, object /*:Object*/, message /*:String*/) /*:Void*/ { - if (YAHOO.lang.isUndefined(object[propertyName])){ - YAHOO.util.Assert.fail(message || - "Property " + propertyName + " not found on object."); - } - }, - - /** - * Asserts that a property with the given name exists on an object instance (not on its prototype). - * @param {String} propertyName The name of the property to test. - * @param {Object} object The object to search. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method hasProperty - * @static - */ - hasOwnProperty : function (propertyName /*:String*/, object /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.hasOwnProperty(object, propertyName)){ - YAHOO.util.Assert.fail(message || - "Property " + propertyName + " not found on object instance."); - } - } -}; - -//----------------------------------------------------------------------------- -// DateAssert object -//----------------------------------------------------------------------------- - -/** - * The DateAssert object provides functions to test JavaScript Date objects - * for a variety of cases. - * - * @namespace YAHOO.util - * @class DateAssert - * @static - */ - -YAHOO.util.DateAssert = { - - /** - * Asserts that a date's month, day, and year are equal to another date's. - * @param {Date} expected The expected date. - * @param {Date} actual The actual date to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areEqual - * @static - */ - datesAreEqual : function (expected /*:Date*/, actual /*:Date*/, message /*:String*/){ - if (expected instanceof Date && actual instanceof Date){ - YAHOO.util.Assert.areEqual(expected.getFullYear(), actual.getFullYear(), message || "Years should be equal."); - YAHOO.util.Assert.areEqual(expected.getMonth(), actual.getMonth(), message || "Months should be equal."); - YAHOO.util.Assert.areEqual(expected.getDate(), actual.getDate(), message || "Day of month should be equal."); - } else { - throw new TypeError("DateAssert.datesAreEqual(): Expected and actual values must be Date objects."); - } - }, - - /** - * Asserts that a date's hour, minutes, and seconds are equal to another date's. - * @param {Date} expected The expected date. - * @param {Date} actual The actual date to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areEqual - * @static - */ - timesAreEqual : function (expected /*:Date*/, actual /*:Date*/, message /*:String*/){ - if (expected instanceof Date && actual instanceof Date){ - YAHOO.util.Assert.areEqual(expected.getHours(), actual.getHours(), message || "Hours should be equal."); - YAHOO.util.Assert.areEqual(expected.getMinutes(), actual.getMinutes(), message || "Minutes should be equal."); - YAHOO.util.Assert.areEqual(expected.getSeconds(), actual.getSeconds(), message || "Seconds should be equal."); - } else { - throw new TypeError("DateAssert.timesAreEqual(): Expected and actual values must be Date objects."); - } - } - -}; - -YAHOO.register("yuitest_core", YAHOO.tool.TestRunner, {version: "2.5.0", build: "895"}); diff --git a/lib/yui/yuitest/yuitest_core-debug.js b/lib/yui/yuitest/yuitest_core-debug.js deleted file mode 100644 index 8a431c2178..0000000000 --- a/lib/yui/yuitest/yuitest_core-debug.js +++ /dev/null @@ -1,1922 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -YAHOO.namespace("tool"); - -//----------------------------------------------------------------------------- -// TestCase object -//----------------------------------------------------------------------------- - -/** - * Test case containing various tests to run. - * @param template An object containing any number of test methods, other methods, - * an optional name, and anything else the test case needs. - * @class TestCase - * @namespace YAHOO.tool - * @constructor - */ -YAHOO.tool.TestCase = function (template /*:Object*/) { - - /** - * Special rules for the test case. Possible subobjects - * are fail, for tests that should fail, and error, for - * tests that should throw an error. - */ - this._should /*:Object*/ = {}; - - //copy over all properties from the template to this object - for (var prop in template) { - this[prop] = template[prop]; - } - - //check for a valid name - if (!YAHOO.lang.isString(this.name)){ - /** - * Name for the test case. - */ - this.name /*:String*/ = YAHOO.util.Dom.generateId(null, "testCase"); - } - -}; - - -YAHOO.tool.TestCase.prototype = { - - /** - * Resumes a paused test and runs the given function. - * @param {Function} segment (Optional) The function to run. - * If omitted, the test automatically passes. - * @return {Void} - * @method resume - */ - resume : function (segment /*:Function*/) /*:Void*/ { - YAHOO.tool.TestRunner.resume(segment); - }, - - /** - * Causes the test case to wait a specified amount of time and then - * continue executing the given code. - * @param {Function} segment (Optional) The function to run after the delay. - * If omitted, the TestRunner will wait until resume() is called. - * @param {int} delay (Optional) The number of milliseconds to wait before running - * the function. If omitted, defaults to zero. - * @return {Void} - * @method wait - */ - wait : function (segment /*:Function*/, delay /*:int*/) /*:Void*/{ - throw new YAHOO.tool.TestCase.Wait(segment, delay); - }, - - //------------------------------------------------------------------------- - // Stub Methods - //------------------------------------------------------------------------- - - /** - * Function to run before each test is executed. - * @return {Void} - * @method setUp - */ - setUp : function () /*:Void*/ { - }, - - /** - * Function to run after each test is executed. - * @return {Void} - * @method tearDown - */ - tearDown: function () /*:Void*/ { - } -}; - -/** - * Represents a stoppage in test execution to wait for an amount of time before - * continuing. - * @param {Function} segment A function to run when the wait is over. - * @param {int} delay The number of milliseconds to wait before running the code. - * @class Wait - * @namespace YAHOO.tool.TestCase - * @constructor - * - */ -YAHOO.tool.TestCase.Wait = function (segment /*:Function*/, delay /*:int*/) { - - /** - * The segment of code to run when the wait is over. - * @type Function - * @property segment - */ - this.segment /*:Function*/ = (YAHOO.lang.isFunction(segment) ? segment : null); - - /** - * The delay before running the segment of code. - * @type int - * @property delay - */ - this.delay /*:int*/ = (YAHOO.lang.isNumber(delay) ? delay : 0); - -}; - -YAHOO.namespace("tool"); - - -//----------------------------------------------------------------------------- -// TestSuite object -//----------------------------------------------------------------------------- - -/** - * A test suite that can contain a collection of TestCase and TestSuite objects. - * @param {String||Object} data The name of the test suite or an object containing - * a name property as well as setUp and tearDown methods. - * @namespace YAHOO.tool - * @class TestSuite - * @constructor - */ -YAHOO.tool.TestSuite = function (data /*:String||Object*/) { - - /** - * The name of the test suite. - * @type String - * @property name - */ - this.name /*:String*/ = ""; - - /** - * Array of test suites and - * @private - */ - this.items /*:Array*/ = []; - - //initialize the properties - if (YAHOO.lang.isString(data)){ - this.name = data; - } else if (YAHOO.lang.isObject(data)){ - YAHOO.lang.augmentObject(this, data, true); - } - - //double-check name - if (this.name === ""){ - this.name = YAHOO.util.Dom.generateId(null, "testSuite"); - } - -}; - -YAHOO.tool.TestSuite.prototype = { - - /** - * Adds a test suite or test case to the test suite. - * @param {YAHOO.tool.TestSuite||YAHOO.tool.TestCase} testObject The test suite or test case to add. - * @return {Void} - * @method add - */ - add : function (testObject /*:YAHOO.tool.TestSuite*/) /*:Void*/ { - if (testObject instanceof YAHOO.tool.TestSuite || testObject instanceof YAHOO.tool.TestCase) { - this.items.push(testObject); - } - }, - - //------------------------------------------------------------------------- - // Stub Methods - //------------------------------------------------------------------------- - - /** - * Function to run before each test is executed. - * @return {Void} - * @method setUp - */ - setUp : function () /*:Void*/ { - }, - - /** - * Function to run after each test is executed. - * @return {Void} - * @method tearDown - */ - tearDown: function () /*:Void*/ { - } - -}; - -YAHOO.namespace("tool"); - -/** - * The YUI test tool - * @module yuitest - * @namespace YAHOO.tool - * @requires yahoo,dom,event,logger - */ - - -//----------------------------------------------------------------------------- -// TestRunner object -//----------------------------------------------------------------------------- - -/** - * Runs test suites and test cases, providing events to allowing for the - * interpretation of test results. - * @namespace YAHOO.tool - * @class TestRunner - * @static - */ -YAHOO.tool.TestRunner = (function(){ - - /** - * A node in the test tree structure. May represent a TestSuite, TestCase, or - * test function. - * @param {Variant} testObject A TestSuite, TestCase, or the name of a test function. - * @class TestNode - * @constructor - * @private - */ - function TestNode(testObject /*:Variant*/){ - - /** - * The TestSuite, TestCase, or test function represented by this node. - * @type Variant - * @property testObject - */ - this.testObject = testObject; - - /** - * Pointer to this node's first child. - * @type TestNode - * @property firstChild - */ - this.firstChild /*:TestNode*/ = null; - - /** - * Pointer to this node's last child. - * @type TestNode - * @property lastChild - */ - this.lastChild = null; - - /** - * Pointer to this node's parent. - * @type TestNode - * @property parent - */ - this.parent = null; - - /** - * Pointer to this node's next sibling. - * @type TestNode - * @property next - */ - this.next = null; - - /** - * Test results for this test object. - * @type object - * @property results - */ - this.results /*:Object*/ = { - passed : 0, - failed : 0, - total : 0, - ignored : 0 - }; - - //initialize results - if (testObject instanceof YAHOO.tool.TestSuite){ - this.results.type = "testsuite"; - this.results.name = testObject.name; - } else if (testObject instanceof YAHOO.tool.TestCase){ - this.results.type = "testcase"; - this.results.name = testObject.name; - } - - } - - TestNode.prototype = { - - /** - * Appends a new test object (TestSuite, TestCase, or test function name) as a child - * of this node. - * @param {Variant} testObject A TestSuite, TestCase, or the name of a test function. - * @return {Void} - */ - appendChild : function (testObject /*:Variant*/) /*:Void*/{ - var node = new TestNode(testObject); - if (this.firstChild === null){ - this.firstChild = this.lastChild = node; - } else { - this.lastChild.next = node; - this.lastChild = node; - } - node.parent = this; - return node; - } - }; - - function TestRunner(){ - - //inherit from EventProvider - TestRunner.superclass.constructor.apply(this,arguments); - - /** - * Suite on which to attach all TestSuites and TestCases to be run. - * @type YAHOO.tool.TestSuite - * @property masterSuite - * @private - */ - this.masterSuite /*:YAHOO.tool.TestSuite*/ = new YAHOO.tool.TestSuite("YUI Test Results"); - - /** - * Pointer to the current node in the test tree. - * @type TestNode - * @private - * @property _cur - */ - this._cur = null; - - /** - * Pointer to the root node in the test tree. - * @type TestNode - * @private - * @property _root - */ - this._root = null; - - //create events - var events /*:Array*/ = [ - this.TEST_CASE_BEGIN_EVENT, - this.TEST_CASE_COMPLETE_EVENT, - this.TEST_SUITE_BEGIN_EVENT, - this.TEST_SUITE_COMPLETE_EVENT, - this.TEST_PASS_EVENT, - this.TEST_FAIL_EVENT, - this.TEST_IGNORE_EVENT, - this.COMPLETE_EVENT, - this.BEGIN_EVENT - ]; - for (var i=0; i < events.length; i++){ - this.createEvent(events[i], { scope: this }); - } - - } - - YAHOO.lang.extend(TestRunner, YAHOO.util.EventProvider, { - - //------------------------------------------------------------------------- - // Constants - //------------------------------------------------------------------------- - - /** - * Fires when a test case is opened but before the first - * test is executed. - * @event testcasebegin - */ - TEST_CASE_BEGIN_EVENT /*:String*/ : "testcasebegin", - - /** - * Fires when all tests in a test case have been executed. - * @event testcasecomplete - */ - TEST_CASE_COMPLETE_EVENT /*:String*/ : "testcasecomplete", - - /** - * Fires when a test suite is opened but before the first - * test is executed. - * @event testsuitebegin - */ - TEST_SUITE_BEGIN_EVENT /*:String*/ : "testsuitebegin", - - /** - * Fires when all test cases in a test suite have been - * completed. - * @event testsuitecomplete - */ - TEST_SUITE_COMPLETE_EVENT /*:String*/ : "testsuitecomplete", - - /** - * Fires when a test has passed. - * @event pass - */ - TEST_PASS_EVENT /*:String*/ : "pass", - - /** - * Fires when a test has failed. - * @event fail - */ - TEST_FAIL_EVENT /*:String*/ : "fail", - - /** - * Fires when a test has been ignored. - * @event ignore - */ - TEST_IGNORE_EVENT /*:String*/ : "ignore", - - /** - * Fires when all test suites and test cases have been completed. - * @event complete - */ - COMPLETE_EVENT /*:String*/ : "complete", - - /** - * Fires when the run() method is called. - * @event begin - */ - BEGIN_EVENT /*:String*/ : "begin", - - //------------------------------------------------------------------------- - // Test Tree-Related Methods - //------------------------------------------------------------------------- - - /** - * Adds a test case to the test tree as a child of the specified node. - * @param {TestNode} parentNode The node to add the test case to as a child. - * @param {YAHOO.tool.TestCase} testCase The test case to add. - * @return {Void} - * @static - * @private - * @method _addTestCaseToTestTree - */ - _addTestCaseToTestTree : function (parentNode /*:TestNode*/, testCase /*:YAHOO.tool.TestCase*/) /*:Void*/{ - - //add the test suite - var node = parentNode.appendChild(testCase); - - //iterate over the items in the test case - for (var prop in testCase){ - if (prop.indexOf("test") === 0 && YAHOO.lang.isFunction(testCase[prop])){ - node.appendChild(prop); - } - } - - }, - - /** - * Adds a test suite to the test tree as a child of the specified node. - * @param {TestNode} parentNode The node to add the test suite to as a child. - * @param {YAHOO.tool.TestSuite} testSuite The test suite to add. - * @return {Void} - * @static - * @private - * @method _addTestSuiteToTestTree - */ - _addTestSuiteToTestTree : function (parentNode /*:TestNode*/, testSuite /*:YAHOO.tool.TestSuite*/) /*:Void*/ { - - //add the test suite - var node = parentNode.appendChild(testSuite); - - //iterate over the items in the master suite - for (var i=0; i < testSuite.items.length; i++){ - if (testSuite.items[i] instanceof YAHOO.tool.TestSuite) { - this._addTestSuiteToTestTree(node, testSuite.items[i]); - } else if (testSuite.items[i] instanceof YAHOO.tool.TestCase) { - this._addTestCaseToTestTree(node, testSuite.items[i]); - } - } - }, - - /** - * Builds the test tree based on items in the master suite. The tree is a hierarchical - * representation of the test suites, test cases, and test functions. The resulting tree - * is stored in _root and the pointer _cur is set to the root initially. - * @return {Void} - * @static - * @private - * @method _buildTestTree - */ - _buildTestTree : function () /*:Void*/ { - - this._root = new TestNode(this.masterSuite); - this._cur = this._root; - - //iterate over the items in the master suite - for (var i=0; i < this.masterSuite.items.length; i++){ - if (this.masterSuite.items[i] instanceof YAHOO.tool.TestSuite) { - this._addTestSuiteToTestTree(this._root, this.masterSuite.items[i]); - } else if (this.masterSuite.items[i] instanceof YAHOO.tool.TestCase) { - this._addTestCaseToTestTree(this._root, this.masterSuite.items[i]); - } - } - - }, - - //------------------------------------------------------------------------- - // Private Methods - //------------------------------------------------------------------------- - - /** - * Handles the completion of a test object's tests. Tallies test results - * from one level up to the next. - * @param {TestNode} node The TestNode representing the test object. - * @return {Void} - * @method _handleTestObjectComplete - * @private - */ - _handleTestObjectComplete : function (node /*:TestNode*/) /*:Void*/ { - if (YAHOO.lang.isObject(node.testObject)){ - node.parent.results.passed += node.results.passed; - node.parent.results.failed += node.results.failed; - node.parent.results.total += node.results.total; - node.parent.results.ignored += node.results.ignored; - node.parent.results[node.testObject.name] = node.results; - - if (node.testObject instanceof YAHOO.tool.TestSuite){ - node.testObject.tearDown(); - this.fireEvent(this.TEST_SUITE_COMPLETE_EVENT, { testSuite: node.testObject, results: node.results}); - } else if (node.testObject instanceof YAHOO.tool.TestCase){ - this.fireEvent(this.TEST_CASE_COMPLETE_EVENT, { testCase: node.testObject, results: node.results}); - } - } - }, - - //------------------------------------------------------------------------- - // Navigation Methods - //------------------------------------------------------------------------- - - /** - * Retrieves the next node in the test tree. - * @return {TestNode} The next node in the test tree or null if the end is reached. - * @private - * @static - * @method _next - */ - _next : function () /*:TestNode*/ { - - if (this._cur.firstChild) { - this._cur = this._cur.firstChild; - } else if (this._cur.next) { - this._cur = this._cur.next; - } else { - while (this._cur && !this._cur.next && this._cur !== this._root){ - this._handleTestObjectComplete(this._cur); - this._cur = this._cur.parent; - } - - if (this._cur == this._root){ - this._cur.results.type = "report"; - this._cur.results.timestamp = (new Date()).toLocaleString(); - this.fireEvent(this.COMPLETE_EVENT, { results: this._cur.results}); - this._cur = null; - } else { - this._handleTestObjectComplete(this._cur); - this._cur = this._cur.next; - } - } - - return this._cur; - }, - - /** - * Runs a test case or test suite, returning the results. - * @param {YAHOO.tool.TestCase|YAHOO.tool.TestSuite} testObject The test case or test suite to run. - * @return {Object} Results of the execution with properties passed, failed, and total. - * @private - * @method _run - * @static - */ - _run : function () /*:Void*/ { - - //flag to indicate if the TestRunner should wait before continuing - var shouldWait /*:Boolean*/ = false; - - //get the next test node - var node = this._next(); - - if (node !== null) { - var testObject = node.testObject; - - //figure out what to do - if (YAHOO.lang.isObject(testObject)){ - if (testObject instanceof YAHOO.tool.TestSuite){ - this.fireEvent(this.TEST_SUITE_BEGIN_EVENT, { testSuite: testObject }); - testObject.setUp(); - } else if (testObject instanceof YAHOO.tool.TestCase){ - this.fireEvent(this.TEST_CASE_BEGIN_EVENT, { testCase: testObject }); - } - - //some environments don't support setTimeout - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._run(); - }, 0); - } else { - this._run(); - } - } else { - this._runTest(node); - } - - } - }, - - _resumeTest : function (segment /*:Function*/) /*:Void*/ { - - //get relevant information - var node /*:TestNode*/ = this._cur; - var testName /*:String*/ = node.testObject; - var testCase /*:YAHOO.tool.TestCase*/ = node.parent.testObject; - - //get the "should" test cases - var shouldFail /*:Object*/ = (testCase._should.fail || {})[testName]; - var shouldError /*:Object*/ = (testCase._should.error || {})[testName]; - - //variable to hold whether or not the test failed - var failed /*:Boolean*/ = false; - var error /*:Error*/ = null; - - //try the test - try { - - //run the test - segment.apply(testCase); - - //if it should fail, and it got here, then it's a fail because it didn't - if (shouldFail){ - error = new YAHOO.util.ShouldFail(); - failed = true; - } else if (shouldError){ - error = new YAHOO.util.ShouldError(); - failed = true; - } - - } catch (thrown /*:Error*/){ - if (thrown instanceof YAHOO.util.AssertionError) { - if (!shouldFail){ - error = thrown; - failed = true; - } - } else if (thrown instanceof YAHOO.tool.TestCase.Wait){ - - if (YAHOO.lang.isFunction(thrown.segment)){ - if (YAHOO.lang.isNumber(thrown.delay)){ - - //some environments don't support setTimeout - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._resumeTest(thrown.segment); - }, thrown.delay); - } else { - throw new Error("Asynchronous tests not supported in this environment."); - } - } - } - - return; - - } else { - //first check to see if it should error - if (!shouldError) { - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } else { - //check to see what type of data we have - if (YAHOO.lang.isString(shouldError)){ - - //if it's a string, check the error message - if (thrown.message != shouldError){ - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } - } else if (YAHOO.lang.isFunction(shouldError)){ - - //if it's a function, see if the error is an instance of it - if (!(thrown instanceof shouldError)){ - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } - - } else if (YAHOO.lang.isObject(shouldError)){ - - //if it's an object, check the instance and message - if (!(thrown instanceof shouldError.constructor) || - thrown.message != shouldError.message){ - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } - - } - - } - } - - } - - //fireEvent appropriate event - if (failed) { - this.fireEvent(this.TEST_FAIL_EVENT, { testCase: testCase, testName: testName, error: error }); - } else { - this.fireEvent(this.TEST_PASS_EVENT, { testCase: testCase, testName: testName }); - } - - //run the tear down - testCase.tearDown(); - - //update results - node.parent.results[testName] = { - result: failed ? "fail" : "pass", - message: error ? error.getMessage() : "Test passed", - type: "test", - name: testName - }; - - if (failed){ - node.parent.results.failed++; - } else { - node.parent.results.passed++; - } - node.parent.results.total++; - - //set timeout not supported in all environments - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._run(); - }, 0); - } else { - this._run(); - } - - }, - - /** - * Runs a single test based on the data provided in the node. - * @param {TestNode} node The TestNode representing the test to run. - * @return {Void} - * @static - * @private - * @name _runTest - */ - _runTest : function (node /*:TestNode*/) /*:Void*/ { - - //get relevant information - var testName /*:String*/ = node.testObject; - var testCase /*:YAHOO.tool.TestCase*/ = node.parent.testObject; - var test /*:Function*/ = testCase[testName]; - - //get the "should" test cases - var shouldIgnore /*:Object*/ = (testCase._should.ignore || {})[testName]; - - //figure out if the test should be ignored or not - if (shouldIgnore){ - - //update results - node.parent.results[testName] = { - result: "ignore", - message: "Test ignored", - type: "test", - name: testName - }; - - node.parent.results.ignored++; - node.parent.results.total++; - - this.fireEvent(this.TEST_IGNORE_EVENT, { testCase: testCase, testName: testName }); - - //some environments don't support setTimeout - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._run(); - }, 0); - } else { - this._run(); - } - - } else { - - //run the setup - testCase.setUp(); - - //now call the body of the test - this._resumeTest(test); - } - - }, - - //------------------------------------------------------------------------- - // Protected Methods - //------------------------------------------------------------------------- - - /* - * Fires events for the TestRunner. This overrides the default fireEvent() - * method from EventProvider to add the type property to the data that is - * passed through on each event call. - * @param {String} type The type of event to fire. - * @param {Object} data (Optional) Data for the event. - * @method fireEvent - * @static - * @protected - */ - fireEvent : function (type /*:String*/, data /*:Object*/) /*:Void*/ { - data = data || {}; - data.type = type; - TestRunner.superclass.fireEvent.call(this, type, data); - }, - - //------------------------------------------------------------------------- - // Public Methods - //------------------------------------------------------------------------- - - /** - * Adds a test suite or test case to the list of test objects to run. - * @param testObject Either a TestCase or a TestSuite that should be run. - * @return {Void} - * @method add - * @static - */ - add : function (testObject /*:Object*/) /*:Void*/ { - this.masterSuite.add(testObject); - }, - - /** - * Removes all test objects from the runner. - * @return {Void} - * @method clear - * @static - */ - clear : function () /*:Void*/ { - this.masterSuite.items = []; - }, - - /** - * Resumes the TestRunner after wait() was called. - * @param {Function} segment The function to run as the rest - * of the haulted test. - * @return {Void} - * @method resume - * @static - */ - resume : function (segment /*:Function*/) /*:Void*/ { - this._resumeTest(segment || function(){}); - }, - - /** - * Runs the test suite. - * @return {Void} - * @method run - * @static - */ - run : function (testObject /*:Object*/) /*:Void*/ { - - //pointer to runner to avoid scope issues - var runner = YAHOO.tool.TestRunner; - - //build the test tree - runner._buildTestTree(); - - //fire the begin event - runner.fireEvent(runner.BEGIN_EVENT); - - //begin the testing - runner._run(); - } - }); - - return new TestRunner(); - -})(); - -YAHOO.namespace("util"); - -//----------------------------------------------------------------------------- -// Assert object -//----------------------------------------------------------------------------- - -/** - * The Assert object provides functions to test JavaScript values against - * known and expected results. Whenever a comparison (assertion) fails, - * an error is thrown. - * - * @namespace YAHOO.util - * @class Assert - * @static - */ -YAHOO.util.Assert = { - - //------------------------------------------------------------------------- - // Generic Assertion Methods - //------------------------------------------------------------------------- - - /** - * Forces an assertion error to occur. - * @param {String} message (Optional) The message to display with the failure. - * @method fail - * @static - */ - fail : function (message /*:String*/) /*:Void*/ { - throw new YAHOO.util.AssertionError(message || "Test force-failed."); - }, - - //------------------------------------------------------------------------- - // Equality Assertion Methods - //------------------------------------------------------------------------- - - /** - * Asserts that a value is equal to another. This uses the double equals sign - * so type cohersion may occur. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areEqual - * @static - */ - areEqual : function (expected /*:Object*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (expected != actual) { - throw new YAHOO.util.ComparisonFailure(message || "Values should be equal.", expected, actual); - } - }, - - /** - * Asserts that a value is not equal to another. This uses the double equals sign - * so type cohersion may occur. - * @param {Object} unexpected The unexpected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areNotEqual - * @static - */ - areNotEqual : function (unexpected /*:Object*/, actual /*:Object*/, - message /*:String*/) /*:Void*/ { - if (unexpected == actual) { - throw new YAHOO.util.UnexpectedValue(message || "Values should not be equal.", unexpected); - } - }, - - /** - * Asserts that a value is not the same as another. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} unexpected The unexpected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areNotSame - * @static - */ - areNotSame : function (unexpected /*:Object*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (unexpected === actual) { - throw new YAHOO.util.UnexpectedValue(message || "Values should not be the same.", unexpected); - } - }, - - /** - * Asserts that a value is the same as another. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areSame - * @static - */ - areSame : function (expected /*:Object*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (expected !== actual) { - throw new YAHOO.util.ComparisonFailure(message || "Values should be the same.", expected, actual); - } - }, - - //------------------------------------------------------------------------- - // Boolean Assertion Methods - //------------------------------------------------------------------------- - - /** - * Asserts that a value is false. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isFalse - * @static - */ - isFalse : function (actual /*:Boolean*/, message /*:String*/) { - if (false !== actual) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be false.", false, actual); - } - }, - - /** - * Asserts that a value is true. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isTrue - * @static - */ - isTrue : function (actual /*:Boolean*/, message /*:String*/) /*:Void*/ { - if (true !== actual) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be true.", true, actual); - } - - }, - - //------------------------------------------------------------------------- - // Special Value Assertion Methods - //------------------------------------------------------------------------- - - /** - * Asserts that a value is not a number. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNaN - * @static - */ - isNaN : function (actual /*:Object*/, message /*:String*/) /*:Void*/{ - if (!isNaN(actual)){ - throw new YAHOO.util.ComparisonFailure(message || "Value should be NaN.", NaN, actual); - } - }, - - /** - * Asserts that a value is not the special NaN value. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotNaN - * @static - */ - isNotNaN : function (actual /*:Object*/, message /*:String*/) /*:Void*/{ - if (isNaN(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Values should not be NaN.", NaN); - } - }, - - /** - * Asserts that a value is not null. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotNull - * @static - */ - isNotNull : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (YAHOO.lang.isNull(actual)) { - throw new YAHOO.util.UnexpectedValue(message || "Values should not be null.", null); - } - }, - - /** - * Asserts that a value is not undefined. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotUndefined - * @static - */ - isNotUndefined : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (YAHOO.lang.isUndefined(actual)) { - throw new YAHOO.util.UnexpectedValue(message || "Value should not be undefined.", undefined); - } - }, - - /** - * Asserts that a value is null. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNull - * @static - */ - isNull : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isNull(actual)) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be null.", null, actual); - } - }, - - /** - * Asserts that a value is undefined. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isUndefined - * @static - */ - isUndefined : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isUndefined(actual)) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be undefined.", undefined, actual); - } - }, - - //-------------------------------------------------------------------------- - // Instance Assertion Methods - //-------------------------------------------------------------------------- - - /** - * Asserts that a value is an array. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isArray - * @static - */ - isArray : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isArray(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be an array.", actual); - } - }, - - /** - * Asserts that a value is a Boolean. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isBoolean - * @static - */ - isBoolean : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isBoolean(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a Boolean.", actual); - } - }, - - /** - * Asserts that a value is a function. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isFunction - * @static - */ - isFunction : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isFunction(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a function.", actual); - } - }, - - /** - * Asserts that a value is an instance of a particular object. This may return - * incorrect results when comparing objects from one frame to constructors in - * another frame. For best results, don't use in a cross-frame manner. - * @param {Function} expected The function that the object should be an instance of. - * @param {Object} actual The object to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isInstanceOf - * @static - */ - isInstanceOf : function (expected /*:Function*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!(actual instanceof expected)){ - throw new YAHOO.util.ComparisonFailure(message || "Value isn't an instance of expected type.", expected, actual); - } - }, - - /** - * Asserts that a value is a number. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNumber - * @static - */ - isNumber : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isNumber(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a number.", actual); - } - }, - - /** - * Asserts that a value is an object. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isObject - * @static - */ - isObject : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isObject(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be an object.", actual); - } - }, - - /** - * Asserts that a value is a string. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isString - * @static - */ - isString : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isString(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a string.", actual); - } - }, - - /** - * Asserts that a value is of a particular type. - * @param {String} expectedType The expected type of the variable. - * @param {Object} actualValue The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isTypeOf - * @static - */ - isTypeOf : function (expectedType /*:String*/, actualValue /*:Object*/, message /*:String*/) /*:Void*/{ - if (typeof actualValue != expectedType){ - throw new YAHOO.util.ComparisonFailure(message || "Value should be of type " + expected + ".", expected, typeof actual); - } - } -}; - -//----------------------------------------------------------------------------- -// Assertion errors -//----------------------------------------------------------------------------- - -/** - * AssertionError is thrown whenever an assertion fails. It provides methods - * to more easily get at error information and also provides a base class - * from which more specific assertion errors can be derived. - * - * @param {String} message The message to display when the error occurs. - * @namespace YAHOO.util - * @class AssertionError - * @extends Error - * @constructor - */ -YAHOO.util.AssertionError = function (message /*:String*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message); - - /* - * Error message. Must be duplicated to ensure browser receives it. - * @type String - * @property message - */ - this.message /*:String*/ = message; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "AssertionError"; -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.AssertionError, Error, { - - /** - * Returns a fully formatted error for an assertion failure. This should - * be overridden by all subclasses to provide specific information. - * @method getMessage - * @return {String} A string describing the error. - */ - getMessage : function () /*:String*/ { - return this.message; - }, - - /** - * Returns a string representation of the error. - * @method toString - * @return {String} A string representation of the error. - */ - toString : function () /*:String*/ { - return this.name + ": " + this.getMessage(); - }, - - /** - * Returns a primitive value version of the error. Same as toString(). - * @method valueOf - * @return {String} A primitive value version of the error. - */ - valueOf : function () /*:String*/ { - return this.toString(); - } - -}); - -/** - * ComparisonFailure is subclass of AssertionError that is thrown whenever - * a comparison between two values fails. It provides mechanisms to retrieve - * both the expected and actual value. - * - * @param {String} message The message to display when the error occurs. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value that caused the assertion to fail. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class ComparisonFailure - * @constructor - */ -YAHOO.util.ComparisonFailure = function (message /*:String*/, expected /*:Object*/, actual /*:Object*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message); - - /** - * The expected value. - * @type Object - * @property expected - */ - this.expected /*:Object*/ = expected; - - /** - * The actual value. - * @type Object - * @property actual - */ - this.actual /*:Object*/ = actual; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "ComparisonFailure"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.ComparisonFailure, YAHOO.util.AssertionError, { - - /** - * Returns a fully formatted error for an assertion failure. This message - * provides information about the expected and actual values. - * @method toString - * @return {String} A string describing the error. - */ - getMessage : function () /*:String*/ { - return this.message + "\nExpected: " + this.expected + " (" + (typeof this.expected) + ")" + - "\nActual:" + this.actual + " (" + (typeof this.actual) + ")"; - } - -}); - -/** - * UnexpectedValue is subclass of AssertionError that is thrown whenever - * a value was unexpected in its scope. This typically means that a test - * was performed to determine that a value was *not* equal to a certain - * value. - * - * @param {String} message The message to display when the error occurs. - * @param {Object} unexpected The unexpected value. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class UnexpectedValue - * @constructor - */ -YAHOO.util.UnexpectedValue = function (message /*:String*/, unexpected /*:Object*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message); - - /** - * The unexpected value. - * @type Object - * @property unexpected - */ - this.unexpected /*:Object*/ = unexpected; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "UnexpectedValue"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.UnexpectedValue, YAHOO.util.AssertionError, { - - /** - * Returns a fully formatted error for an assertion failure. The message - * contains information about the unexpected value that was encountered. - * @method getMessage - * @return {String} A string describing the error. - */ - getMessage : function () /*:String*/ { - return this.message + "\nUnexpected: " + this.unexpected + " (" + (typeof this.unexpected) + ") "; - } - -}); - -/** - * ShouldFail is subclass of AssertionError that is thrown whenever - * a test was expected to fail but did not. - * - * @param {String} message The message to display when the error occurs. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class ShouldFail - * @constructor - */ -YAHOO.util.ShouldFail = function (message /*:String*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message || "This test should fail but didn't."); - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "ShouldFail"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.ShouldFail, YAHOO.util.AssertionError); - -/** - * ShouldError is subclass of AssertionError that is thrown whenever - * a test is expected to throw an error but doesn't. - * - * @param {String} message The message to display when the error occurs. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class ShouldError - * @constructor - */ -YAHOO.util.ShouldError = function (message /*:String*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message || "This test should have thrown an error but didn't."); - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "ShouldError"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.ShouldError, YAHOO.util.AssertionError); - -/** - * UnexpectedError is subclass of AssertionError that is thrown whenever - * an error occurs within the course of a test and the test was not expected - * to throw an error. - * - * @param {Error} cause The unexpected error that caused this error to be - * thrown. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class UnexpectedError - * @constructor - */ -YAHOO.util.UnexpectedError = function (cause /*:Object*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, "Unexpected error: " + cause.message); - - /** - * The unexpected error that occurred. - * @type Error - * @property cause - */ - this.cause /*:Error*/ = cause; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "UnexpectedError"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.UnexpectedError, YAHOO.util.AssertionError); - -//----------------------------------------------------------------------------- -// ArrayAssert object -//----------------------------------------------------------------------------- - -/** - * The ArrayAssert object provides functions to test JavaScript array objects - * for a variety of cases. - * - * @namespace YAHOO.util - * @class ArrayAssert - * @static - */ - -YAHOO.util.ArrayAssert = { - - /** - * Asserts that a value is present in an array. This uses the triple equals - * sign so no type cohersion may occur. - * @param {Object} needle The value that is expected in the array. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method contains - * @static - */ - contains : function (needle /*:Object*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (haystack[i] === needle) { - found = true; - } - } - - if (!found){ - YAHOO.util.Assert.fail(message || "Value (" + needle + ") not found in array."); - } - }, - - /** - * Asserts that a set of values are present in an array. This uses the triple equals - * sign so no type cohersion may occur. For this assertion to pass, all values must - * be found. - * @param {Object[]} needles An array of values that are expected in the array. - * @param {Array} haystack An array of values to check. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method containsItems - * @static - */ - containsItems : function (needles /*:Object[]*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - //begin checking values - for (var i=0; i < needles.length; i++){ - this.contains(needles[i], haystack, message); - } - - if (!found){ - YAHOO.util.Assert.fail(message || "Value not found in array."); - } - }, - - /** - * Asserts that a value matching some condition is present in an array. This uses - * a function to determine a match. - * @param {Function} matcher A function that returns true if the items matches or false if not. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method containsMatch - * @static - */ - containsMatch : function (matcher /*:Function*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - //check for valid matcher - if (typeof matcher != "function"){ - throw new TypeError("ArrayAssert.containsMatch(): First argument must be a function."); - } - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (matcher(haystack[i])) { - found = true; - } - } - - if (!found){ - YAHOO.util.Assert.fail(message || "No match found in array."); - } - }, - - /** - * Asserts that a value is not present in an array. This uses the triple equals - * sign so no type cohersion may occur. - * @param {Object} needle The value that is expected in the array. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method doesNotContain - * @static - */ - doesNotContain : function (needle /*:Object*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (haystack[i] === needle) { - found = true; - } - } - - if (found){ - YAHOO.util.Assert.fail(message || "Value found in array."); - } - }, - - /** - * Asserts that a set of values are not present in an array. This uses the triple equals - * sign so no type cohersion may occur. For this assertion to pass, all values must - * not be found. - * @param {Object[]} needles An array of values that are not expected in the array. - * @param {Array} haystack An array of values to check. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method doesNotContainItems - * @static - */ - doesNotContainItems : function (needles /*:Object[]*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - for (var i=0; i < needles.length; i++){ - this.doesNotContain(needles[i], haystack, message); - } - - }, - - /** - * Asserts that no values matching a condition are present in an array. This uses - * a function to determine a match. - * @param {Function} matcher A function that returns true if the items matches or false if not. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method doesNotContainMatch - * @static - */ - doesNotContainMatch : function (matcher /*:Function*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - //check for valid matcher - if (typeof matcher != "function"){ - throw new TypeError("ArrayAssert.doesNotContainMatch(): First argument must be a function."); - } - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (matcher(haystack[i])) { - found = true; - } - } - - if (found){ - YAHOO.util.Assert.fail(message || "Value found in array."); - } - }, - - /** - * Asserts that the given value is contained in an array at the specified index. - * This uses the triple equals sign so no type cohersion will occur. - * @param {Object} needle The value to look for. - * @param {Array} haystack The array to search in. - * @param {int} index The index at which the value should exist. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method indexOf - * @static - */ - indexOf : function (needle /*:Object*/, haystack /*:Array*/, index /*:int*/, message /*:String*/) /*:Void*/ { - - //try to find the value in the array - for (var i=0; i < haystack.length; i++){ - if (haystack[i] === needle){ - YAHOO.util.Assert.areEqual(index, i, message || "Value exists at index " + i + " but should be at index " + index + "."); - return; - } - } - - //if it makes it here, it wasn't found at all - YAHOO.util.Assert.fail(message || "Value doesn't exist in array."); - }, - - /** - * Asserts that the values in an array are equal, and in the same position, - * as values in another array. This uses the double equals sign - * so type cohersion may occur. Note that the array objects themselves - * need not be the same for this test to pass. - * @param {Array} expected An array of the expected values. - * @param {Array} actual Any array of the actual values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method itemsAreEqual - * @static - */ - itemsAreEqual : function (expected /*:Array*/, actual /*:Array*/, - message /*:String*/) /*:Void*/ { - - //one may be longer than the other, so get the maximum length - var len /*:int*/ = Math.max(expected.length, actual.length); - - //begin checking values - for (var i=0; i < len; i++){ - YAHOO.util.Assert.areEqual(expected[i], actual[i], message || - "Values in position " + i + " are not equal."); - } - }, - - /** - * Asserts that the values in an array are equivalent, and in the same position, - * as values in another array. This uses a function to determine if the values - * are equivalent. Note that the array objects themselves - * need not be the same for this test to pass. - * @param {Array} expected An array of the expected values. - * @param {Array} actual Any array of the actual values. - * @param {Function} comparator A function that returns true if the values are equivalent - * or false if not. - * @param {String} message (Optional) The message to display if the assertion fails. - * @return {Void} - * @method itemsAreEquivalent - * @static - */ - itemsAreEquivalent : function (expected /*:Array*/, actual /*:Array*/, - comparator /*:Function*/, message /*:String*/) /*:Void*/ { - - //make sure the comparator is valid - if (typeof comparator != "function"){ - throw new TypeError("ArrayAssert.itemsAreEquivalent(): Third argument must be a function."); - } - - //one may be longer than the other, so get the maximum length - var len /*:int*/ = Math.max(expected.length, actual.length); - - //begin checking values - for (var i=0; i < len; i++){ - if (!comparator(expected[i], actual[i])){ - throw new YAHOO.util.ComparisonFailure(message || "Values in position " + i + " are not equivalent.", expected[i], actual[i]); - } - } - }, - - /** - * Asserts that an array is empty. - * @param {Array} actual The array to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isEmpty - * @static - */ - isEmpty : function (actual /*:Array*/, message /*:String*/) /*:Void*/ { - if (actual.length > 0){ - YAHOO.util.Assert.fail(message || "Array should be empty."); - } - }, - - /** - * Asserts that an array is not empty. - * @param {Array} actual The array to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotEmpty - * @static - */ - isNotEmpty : function (actual /*:Array*/, message /*:String*/) /*:Void*/ { - if (actual.length === 0){ - YAHOO.util.Assert.fail(message || "Array should not be empty."); - } - }, - - /** - * Asserts that the values in an array are the same, and in the same position, - * as values in another array. This uses the triple equals sign - * so no type cohersion will occur. Note that the array objects themselves - * need not be the same for this test to pass. - * @param {Array} expected An array of the expected values. - * @param {Array} actual Any array of the actual values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method itemsAreSame - * @static - */ - itemsAreSame : function (expected /*:Array*/, actual /*:Array*/, - message /*:String*/) /*:Void*/ { - - //one may be longer than the other, so get the maximum length - var len /*:int*/ = Math.max(expected.length, actual.length); - - //begin checking values - for (var i=0; i < len; i++){ - YAHOO.util.Assert.areSame(expected[i], actual[i], - message || "Values in position " + i + " are not the same."); - } - }, - - /** - * Asserts that the given value is contained in an array at the specified index, - * starting from the back of the array. - * This uses the triple equals sign so no type cohersion will occur. - * @param {Object} needle The value to look for. - * @param {Array} haystack The array to search in. - * @param {int} index The index at which the value should exist. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method lastIndexOf - * @static - */ - lastIndexOf : function (needle /*:Object*/, haystack /*:Array*/, index /*:int*/, message /*:String*/) /*:Void*/ { - - //try to find the value in the array - for (var i=haystack.length; i >= 0; i--){ - if (haystack[i] === needle){ - YAHOO.util.Assert.areEqual(index, i, message || "Value exists at index " + i + " but should be at index " + index + "."); - return; - } - } - - //if it makes it here, it wasn't found at all - YAHOO.util.Assert.fail(message || "Value doesn't exist in array."); - } - -}; - -YAHOO.namespace("util"); - - -//----------------------------------------------------------------------------- -// ObjectAssert object -//----------------------------------------------------------------------------- - -/** - * The ObjectAssert object provides functions to test JavaScript objects - * for a variety of cases. - * - * @namespace YAHOO.util - * @class ObjectAssert - * @static - */ -YAHOO.util.ObjectAssert = { - - /** - * Asserts that all properties in the object exist in another object. - * @param {Object} expected An object with the expected properties. - * @param {Object} actual An object with the actual properties. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method propertiesAreEqual - * @static - */ - propertiesAreEqual : function (expected /*:Object*/, actual /*:Object*/, - message /*:String*/) /*:Void*/ { - - //get all properties in the object - var properties /*:Array*/ = []; - for (var property in expected){ - properties.push(property); - } - - //see if the properties are in the expected object - for (var i=0; i < properties.length; i++){ - YAHOO.util.Assert.isNotUndefined(actual[properties[i]], message || - "Property'" + properties[i] + "' expected."); - } - - }, - - /** - * Asserts that an object has a property with the given name. - * @param {String} propertyName The name of the property to test. - * @param {Object} object The object to search. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method hasProperty - * @static - */ - hasProperty : function (propertyName /*:String*/, object /*:Object*/, message /*:String*/) /*:Void*/ { - if (YAHOO.lang.isUndefined(object[propertyName])){ - YAHOO.util.Assert.fail(message || - "Property " + propertyName + " not found on object."); - } - }, - - /** - * Asserts that a property with the given name exists on an object instance (not on its prototype). - * @param {String} propertyName The name of the property to test. - * @param {Object} object The object to search. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method hasProperty - * @static - */ - hasOwnProperty : function (propertyName /*:String*/, object /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.hasOwnProperty(object, propertyName)){ - YAHOO.util.Assert.fail(message || - "Property " + propertyName + " not found on object instance."); - } - } -}; - -//----------------------------------------------------------------------------- -// DateAssert object -//----------------------------------------------------------------------------- - -/** - * The DateAssert object provides functions to test JavaScript Date objects - * for a variety of cases. - * - * @namespace YAHOO.util - * @class DateAssert - * @static - */ - -YAHOO.util.DateAssert = { - - /** - * Asserts that a date's month, day, and year are equal to another date's. - * @param {Date} expected The expected date. - * @param {Date} actual The actual date to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areEqual - * @static - */ - datesAreEqual : function (expected /*:Date*/, actual /*:Date*/, message /*:String*/){ - if (expected instanceof Date && actual instanceof Date){ - YAHOO.util.Assert.areEqual(expected.getFullYear(), actual.getFullYear(), message || "Years should be equal."); - YAHOO.util.Assert.areEqual(expected.getMonth(), actual.getMonth(), message || "Months should be equal."); - YAHOO.util.Assert.areEqual(expected.getDate(), actual.getDate(), message || "Day of month should be equal."); - } else { - throw new TypeError("DateAssert.datesAreEqual(): Expected and actual values must be Date objects."); - } - }, - - /** - * Asserts that a date's hour, minutes, and seconds are equal to another date's. - * @param {Date} expected The expected date. - * @param {Date} actual The actual date to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areEqual - * @static - */ - timesAreEqual : function (expected /*:Date*/, actual /*:Date*/, message /*:String*/){ - if (expected instanceof Date && actual instanceof Date){ - YAHOO.util.Assert.areEqual(expected.getHours(), actual.getHours(), message || "Hours should be equal."); - YAHOO.util.Assert.areEqual(expected.getMinutes(), actual.getMinutes(), message || "Minutes should be equal."); - YAHOO.util.Assert.areEqual(expected.getSeconds(), actual.getSeconds(), message || "Seconds should be equal."); - } else { - throw new TypeError("DateAssert.timesAreEqual(): Expected and actual values must be Date objects."); - } - } - -}; - -YAHOO.register("yuitest_core", YAHOO.tool.TestRunner, {version: "2.5.0", build: "895"}); diff --git a/lib/yui/yuitest/yuitest_core-min.js b/lib/yui/yuitest/yuitest_core-min.js deleted file mode 100644 index dcb313fd5c..0000000000 --- a/lib/yui/yuitest/yuitest_core-min.js +++ /dev/null @@ -1,9 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -YAHOO.namespace("tool");YAHOO.tool.TestCase=function(A){this._should={};for(var B in A){this[B]=A[B];}if(!YAHOO.lang.isString(this.name)){this.name=YAHOO.util.Dom.generateId(null,"testCase");}};YAHOO.tool.TestCase.prototype={resume:function(A){YAHOO.tool.TestRunner.resume(A);},wait:function(B,A){throw new YAHOO.tool.TestCase.Wait(B,A);},setUp:function(){},tearDown:function(){}};YAHOO.tool.TestCase.Wait=function(B,A){this.segment=(YAHOO.lang.isFunction(B)?B:null);this.delay=(YAHOO.lang.isNumber(A)?A:0);};YAHOO.namespace("tool");YAHOO.tool.TestSuite=function(A){this.name="";this.items=[];if(YAHOO.lang.isString(A)){this.name=A;}else{if(YAHOO.lang.isObject(A)){YAHOO.lang.augmentObject(this,A,true);}}if(this.name===""){this.name=YAHOO.util.Dom.generateId(null,"testSuite");}};YAHOO.tool.TestSuite.prototype={add:function(A){if(A instanceof YAHOO.tool.TestSuite||A instanceof YAHOO.tool.TestCase){this.items.push(A);}},setUp:function(){},tearDown:function(){}};YAHOO.namespace("tool");YAHOO.tool.TestRunner=(function(){function B(C){this.testObject=C;this.firstChild=null;this.lastChild=null;this.parent=null;this.next=null;this.results={passed:0,failed:0,total:0,ignored:0};if(C instanceof YAHOO.tool.TestSuite){this.results.type="testsuite";this.results.name=C.name;}else{if(C instanceof YAHOO.tool.TestCase){this.results.type="testcase";this.results.name=C.name;}}}B.prototype={appendChild:function(C){var D=new B(C);if(this.firstChild===null){this.firstChild=this.lastChild=D;}else{this.lastChild.next=D;this.lastChild=D;}D.parent=this;return D;}};function A(){A.superclass.constructor.apply(this,arguments);this.masterSuite=new YAHOO.tool.TestSuite("YUI Test Results");this._cur=null;this._root=null;var D=[this.TEST_CASE_BEGIN_EVENT,this.TEST_CASE_COMPLETE_EVENT,this.TEST_SUITE_BEGIN_EVENT,this.TEST_SUITE_COMPLETE_EVENT,this.TEST_PASS_EVENT,this.TEST_FAIL_EVENT,this.TEST_IGNORE_EVENT,this.COMPLETE_EVENT,this.BEGIN_EVENT];for(var C=0;C<D.length;C++){this.createEvent(D[C],{scope:this});}}YAHOO.lang.extend(A,YAHOO.util.EventProvider,{TEST_CASE_BEGIN_EVENT:"testcasebegin",TEST_CASE_COMPLETE_EVENT:"testcasecomplete",TEST_SUITE_BEGIN_EVENT:"testsuitebegin",TEST_SUITE_COMPLETE_EVENT:"testsuitecomplete",TEST_PASS_EVENT:"pass",TEST_FAIL_EVENT:"fail",TEST_IGNORE_EVENT:"ignore",COMPLETE_EVENT:"complete",BEGIN_EVENT:"begin",_addTestCaseToTestTree:function(C,D){var E=C.appendChild(D);for(var F in D){if(F.indexOf("test")===0&&YAHOO.lang.isFunction(D[F])){E.appendChild(F);}}},_addTestSuiteToTestTree:function(C,F){var E=C.appendChild(F);for(var D=0;D<F.items.length;D++){if(F.items[D] instanceof YAHOO.tool.TestSuite){this._addTestSuiteToTestTree(E,F.items[D]);}else{if(F.items[D] instanceof YAHOO.tool.TestCase){this._addTestCaseToTestTree(E,F.items[D]);}}}},_buildTestTree:function(){this._root=new B(this.masterSuite);this._cur=this._root;for(var C=0;C<this.masterSuite.items.length;C++){if(this.masterSuite.items[C] instanceof YAHOO.tool.TestSuite){this._addTestSuiteToTestTree(this._root,this.masterSuite.items[C]);}else{if(this.masterSuite.items[C] instanceof YAHOO.tool.TestCase){this._addTestCaseToTestTree(this._root,this.masterSuite.items[C]);}}}},_handleTestObjectComplete:function(C){if(YAHOO.lang.isObject(C.testObject)){C.parent.results.passed+=C.results.passed;C.parent.results.failed+=C.results.failed;C.parent.results.total+=C.results.total;C.parent.results.ignored+=C.results.ignored;C.parent.results[C.testObject.name]=C.results;if(C.testObject instanceof YAHOO.tool.TestSuite){C.testObject.tearDown();this.fireEvent(this.TEST_SUITE_COMPLETE_EVENT,{testSuite:C.testObject,results:C.results});}else{if(C.testObject instanceof YAHOO.tool.TestCase){this.fireEvent(this.TEST_CASE_COMPLETE_EVENT,{testCase:C.testObject,results:C.results});}}}},_next:function(){if(this._cur.firstChild){this._cur=this._cur.firstChild;}else{if(this._cur.next){this._cur=this._cur.next;}else{while(this._cur&&!this._cur.next&&this._cur!==this._root){this._handleTestObjectComplete(this._cur);this._cur=this._cur.parent;}if(this._cur==this._root){this._cur.results.type="report";this._cur.results.timestamp=(new Date()).toLocaleString();this.fireEvent(this.COMPLETE_EVENT,{results:this._cur.results});this._cur=null;}else{this._handleTestObjectComplete(this._cur);this._cur=this._cur.next;}}}return this._cur;},_run:function(){var E=false;var D=this._next();if(D!==null){var C=D.testObject;if(YAHOO.lang.isObject(C)){if(C instanceof YAHOO.tool.TestSuite){this.fireEvent(this.TEST_SUITE_BEGIN_EVENT,{testSuite:C});C.setUp();}else{if(C instanceof YAHOO.tool.TestCase){this.fireEvent(this.TEST_CASE_BEGIN_EVENT,{testCase:C});}}if(typeof setTimeout!="undefined"){setTimeout(function(){YAHOO.tool.TestRunner._run();},0);}else{this._run();}}else{this._runTest(D);}}},_resumeTest:function(G){var C=this._cur;var H=C.testObject;var E=C.parent.testObject;var K=(E._should.fail||{})[H];var D=(E._should.error||{})[H];var F=false;var I=null;try{G.apply(E);if(K){I=new YAHOO.util.ShouldFail();F=true;}else{if(D){I=new YAHOO.util.ShouldError();F=true;}}}catch(J){if(J instanceof YAHOO.util.AssertionError){if(!K){I=J;F=true;}}else{if(J instanceof YAHOO.tool.TestCase.Wait){if(YAHOO.lang.isFunction(J.segment)){if(YAHOO.lang.isNumber(J.delay)){if(typeof setTimeout!="undefined"){setTimeout(function(){YAHOO.tool.TestRunner._resumeTest(J.segment);},J.delay);}else{throw new Error("Asynchronous tests not supported in this environment.");}}}return ;}else{if(!D){I=new YAHOO.util.UnexpectedError(J);F=true;}else{if(YAHOO.lang.isString(D)){if(J.message!=D){I=new YAHOO.util.UnexpectedError(J);F=true;}}else{if(YAHOO.lang.isFunction(D)){if(!(J instanceof D)){I=new YAHOO.util.UnexpectedError(J);F=true;}}else{if(YAHOO.lang.isObject(D)){if(!(J instanceof D.constructor)||J.message!=D.message){I=new YAHOO.util.UnexpectedError(J);F=true;}}}}}}}}if(F){this.fireEvent(this.TEST_FAIL_EVENT,{testCase:E,testName:H,error:I});}else{this.fireEvent(this.TEST_PASS_EVENT,{testCase:E,testName:H});}E.tearDown();C.parent.results[H]={result:F?"fail":"pass",message:I?I.getMessage():"Test passed",type:"test",name:H}; -if(F){C.parent.results.failed++;}else{C.parent.results.passed++;}C.parent.results.total++;if(typeof setTimeout!="undefined"){setTimeout(function(){YAHOO.tool.TestRunner._run();},0);}else{this._run();}},_runTest:function(F){var C=F.testObject;var D=F.parent.testObject;var G=D[C];var E=(D._should.ignore||{})[C];if(E){F.parent.results[C]={result:"ignore",message:"Test ignored",type:"test",name:C};F.parent.results.ignored++;F.parent.results.total++;this.fireEvent(this.TEST_IGNORE_EVENT,{testCase:D,testName:C});if(typeof setTimeout!="undefined"){setTimeout(function(){YAHOO.tool.TestRunner._run();},0);}else{this._run();}}else{D.setUp();this._resumeTest(G);}},fireEvent:function(C,D){D=D||{};D.type=C;A.superclass.fireEvent.call(this,C,D);},add:function(C){this.masterSuite.add(C);},clear:function(){this.masterSuite.items=[];},resume:function(C){this._resumeTest(C||function(){});},run:function(C){var D=YAHOO.tool.TestRunner;D._buildTestTree();D.fireEvent(D.BEGIN_EVENT);D._run();}});return new A();})();YAHOO.namespace("util");YAHOO.util.Assert={fail:function(A){throw new YAHOO.util.AssertionError(A||"Test force-failed.");},areEqual:function(B,C,A){if(B!=C){throw new YAHOO.util.ComparisonFailure(A||"Values should be equal.",B,C);}},areNotEqual:function(A,C,B){if(A==C){throw new YAHOO.util.UnexpectedValue(B||"Values should not be equal.",A);}},areNotSame:function(A,C,B){if(A===C){throw new YAHOO.util.UnexpectedValue(B||"Values should not be the same.",A);}},areSame:function(B,C,A){if(B!==C){throw new YAHOO.util.ComparisonFailure(A||"Values should be the same.",B,C);}},isFalse:function(B,A){if(false!==B){throw new YAHOO.util.ComparisonFailure(A||"Value should be false.",false,B);}},isTrue:function(B,A){if(true!==B){throw new YAHOO.util.ComparisonFailure(A||"Value should be true.",true,B);}},isNaN:function(B,A){if(!isNaN(B)){throw new YAHOO.util.ComparisonFailure(A||"Value should be NaN.",NaN,B);}},isNotNaN:function(B,A){if(isNaN(B)){throw new YAHOO.util.UnexpectedValue(A||"Values should not be NaN.",NaN);}},isNotNull:function(B,A){if(YAHOO.lang.isNull(B)){throw new YAHOO.util.UnexpectedValue(A||"Values should not be null.",null);}},isNotUndefined:function(B,A){if(YAHOO.lang.isUndefined(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should not be undefined.",undefined);}},isNull:function(B,A){if(!YAHOO.lang.isNull(B)){throw new YAHOO.util.ComparisonFailure(A||"Value should be null.",null,B);}},isUndefined:function(B,A){if(!YAHOO.lang.isUndefined(B)){throw new YAHOO.util.ComparisonFailure(A||"Value should be undefined.",undefined,B);}},isArray:function(B,A){if(!YAHOO.lang.isArray(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should be an array.",B);}},isBoolean:function(B,A){if(!YAHOO.lang.isBoolean(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should be a Boolean.",B);}},isFunction:function(B,A){if(!YAHOO.lang.isFunction(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should be a function.",B);}},isInstanceOf:function(B,C,A){if(!(C instanceof B)){throw new YAHOO.util.ComparisonFailure(A||"Value isn't an instance of expected type.",B,C);}},isNumber:function(B,A){if(!YAHOO.lang.isNumber(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should be a number.",B);}},isObject:function(B,A){if(!YAHOO.lang.isObject(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should be an object.",B);}},isString:function(B,A){if(!YAHOO.lang.isString(B)){throw new YAHOO.util.UnexpectedValue(A||"Value should be a string.",B);}},isTypeOf:function(A,C,B){if(typeof C!=A){throw new YAHOO.util.ComparisonFailure(B||"Value should be of type "+expected+".",expected,typeof actual);}}};YAHOO.util.AssertionError=function(A){arguments.callee.superclass.constructor.call(this,A);this.message=A;this.name="AssertionError";};YAHOO.lang.extend(YAHOO.util.AssertionError,Error,{getMessage:function(){return this.message;},toString:function(){return this.name+": "+this.getMessage();},valueOf:function(){return this.toString();}});YAHOO.util.ComparisonFailure=function(B,A,C){arguments.callee.superclass.constructor.call(this,B);this.expected=A;this.actual=C;this.name="ComparisonFailure";};YAHOO.lang.extend(YAHOO.util.ComparisonFailure,YAHOO.util.AssertionError,{getMessage:function(){return this.message+"\nExpected: "+this.expected+" ("+(typeof this.expected)+")\nActual:"+this.actual+" ("+(typeof this.actual)+")";}});YAHOO.util.UnexpectedValue=function(B,A){arguments.callee.superclass.constructor.call(this,B);this.unexpected=A;this.name="UnexpectedValue";};YAHOO.lang.extend(YAHOO.util.UnexpectedValue,YAHOO.util.AssertionError,{getMessage:function(){return this.message+"\nUnexpected: "+this.unexpected+" ("+(typeof this.unexpected)+") ";}});YAHOO.util.ShouldFail=function(A){arguments.callee.superclass.constructor.call(this,A||"This test should fail but didn't.");this.name="ShouldFail";};YAHOO.lang.extend(YAHOO.util.ShouldFail,YAHOO.util.AssertionError);YAHOO.util.ShouldError=function(A){arguments.callee.superclass.constructor.call(this,A||"This test should have thrown an error but didn't.");this.name="ShouldError";};YAHOO.lang.extend(YAHOO.util.ShouldError,YAHOO.util.AssertionError);YAHOO.util.UnexpectedError=function(A){arguments.callee.superclass.constructor.call(this,"Unexpected error: "+A.message);this.cause=A;this.name="UnexpectedError";};YAHOO.lang.extend(YAHOO.util.UnexpectedError,YAHOO.util.AssertionError);YAHOO.util.ArrayAssert={contains:function(E,D,B){var C=false;for(var A=0;A<D.length&&!C;A++){if(D[A]===E){C=true;}}if(!C){YAHOO.util.Assert.fail(B||"Value ("+E+") not found in array.");}},containsItems:function(C,D,B){for(var A=0;A<C.length;A++){this.contains(C[A],D,B);}if(!found){YAHOO.util.Assert.fail(B||"Value not found in array.");}},containsMatch:function(E,D,B){if(typeof E!="function"){throw new TypeError("ArrayAssert.containsMatch(): First argument must be a function.");}var C=false;for(var A=0;A<D.length&&!C;A++){if(E(D[A])){C=true;}}if(!C){YAHOO.util.Assert.fail(B||"No match found in array.");}},doesNotContain:function(E,D,B){var C=false; -for(var A=0;A<D.length&&!C;A++){if(D[A]===E){C=true;}}if(C){YAHOO.util.Assert.fail(B||"Value found in array.");}},doesNotContainItems:function(C,D,B){for(var A=0;A<C.length;A++){this.doesNotContain(C[A],D,B);}},doesNotContainMatch:function(E,D,B){if(typeof E!="function"){throw new TypeError("ArrayAssert.doesNotContainMatch(): First argument must be a function.");}var C=false;for(var A=0;A<D.length&&!C;A++){if(E(D[A])){C=true;}}if(C){YAHOO.util.Assert.fail(B||"Value found in array.");}},indexOf:function(E,D,A,C){for(var B=0;B<D.length;B++){if(D[B]===E){YAHOO.util.Assert.areEqual(A,B,C||"Value exists at index "+B+" but should be at index "+A+".");return ;}}YAHOO.util.Assert.fail(C||"Value doesn't exist in array.");},itemsAreEqual:function(D,E,C){var A=Math.max(D.length,E.length);for(var B=0;B<A;B++){YAHOO.util.Assert.areEqual(D[B],E[B],C||"Values in position "+B+" are not equal.");}},itemsAreEquivalent:function(E,F,B,D){if(typeof B!="function"){throw new TypeError("ArrayAssert.itemsAreEquivalent(): Third argument must be a function.");}var A=Math.max(E.length,F.length);for(var C=0;C<A;C++){if(!B(E[C],F[C])){throw new YAHOO.util.ComparisonFailure(D||"Values in position "+C+" are not equivalent.",E[C],F[C]);}}},isEmpty:function(B,A){if(B.length>0){YAHOO.util.Assert.fail(A||"Array should be empty.");}},isNotEmpty:function(B,A){if(B.length===0){YAHOO.util.Assert.fail(A||"Array should not be empty.");}},itemsAreSame:function(D,E,C){var A=Math.max(D.length,E.length);for(var B=0;B<A;B++){YAHOO.util.Assert.areSame(D[B],E[B],C||"Values in position "+B+" are not the same.");}},lastIndexOf:function(E,D,A,C){for(var B=D.length;B>=0;B--){if(D[B]===E){YAHOO.util.Assert.areEqual(A,B,C||"Value exists at index "+B+" but should be at index "+A+".");return ;}}YAHOO.util.Assert.fail(C||"Value doesn't exist in array.");}};YAHOO.namespace("util");YAHOO.util.ObjectAssert={propertiesAreEqual:function(D,F,C){var B=[];for(var E in D){B.push(E);}for(var A=0;A<B.length;A++){YAHOO.util.Assert.isNotUndefined(F[B[A]],C||"Property'"+B[A]+"' expected.");}},hasProperty:function(A,B,C){if(YAHOO.lang.isUndefined(B[A])){YAHOO.util.Assert.fail(C||"Property "+A+" not found on object.");}},hasOwnProperty:function(A,B,C){if(!YAHOO.lang.hasOwnProperty(B,A)){YAHOO.util.Assert.fail(C||"Property "+A+" not found on object instance.");}}};YAHOO.util.DateAssert={datesAreEqual:function(B,C,A){if(B instanceof Date&&C instanceof Date){YAHOO.util.Assert.areEqual(B.getFullYear(),C.getFullYear(),A||"Years should be equal.");YAHOO.util.Assert.areEqual(B.getMonth(),C.getMonth(),A||"Months should be equal.");YAHOO.util.Assert.areEqual(B.getDate(),C.getDate(),A||"Day of month should be equal.");}else{throw new TypeError("DateAssert.datesAreEqual(): Expected and actual values must be Date objects.");}},timesAreEqual:function(B,C,A){if(B instanceof Date&&C instanceof Date){YAHOO.util.Assert.areEqual(B.getHours(),C.getHours(),A||"Hours should be equal.");YAHOO.util.Assert.areEqual(B.getMinutes(),C.getMinutes(),A||"Minutes should be equal.");YAHOO.util.Assert.areEqual(B.getSeconds(),C.getSeconds(),A||"Seconds should be equal.");}else{throw new TypeError("DateAssert.timesAreEqual(): Expected and actual values must be Date objects.");}}};YAHOO.register("yuitest_core",YAHOO.tool.TestRunner,{version:"2.5.0",build:"895"}); \ No newline at end of file diff --git a/lib/yui/yuitest/yuitest_core.js b/lib/yui/yuitest/yuitest_core.js deleted file mode 100644 index 8a431c2178..0000000000 --- a/lib/yui/yuitest/yuitest_core.js +++ /dev/null @@ -1,1922 +0,0 @@ -/* -Copyright (c) 2008, Yahoo! Inc. All rights reserved. -Code licensed under the BSD License: -http://developer.yahoo.net/yui/license.txt -version: 2.5.0 -*/ -YAHOO.namespace("tool"); - -//----------------------------------------------------------------------------- -// TestCase object -//----------------------------------------------------------------------------- - -/** - * Test case containing various tests to run. - * @param template An object containing any number of test methods, other methods, - * an optional name, and anything else the test case needs. - * @class TestCase - * @namespace YAHOO.tool - * @constructor - */ -YAHOO.tool.TestCase = function (template /*:Object*/) { - - /** - * Special rules for the test case. Possible subobjects - * are fail, for tests that should fail, and error, for - * tests that should throw an error. - */ - this._should /*:Object*/ = {}; - - //copy over all properties from the template to this object - for (var prop in template) { - this[prop] = template[prop]; - } - - //check for a valid name - if (!YAHOO.lang.isString(this.name)){ - /** - * Name for the test case. - */ - this.name /*:String*/ = YAHOO.util.Dom.generateId(null, "testCase"); - } - -}; - - -YAHOO.tool.TestCase.prototype = { - - /** - * Resumes a paused test and runs the given function. - * @param {Function} segment (Optional) The function to run. - * If omitted, the test automatically passes. - * @return {Void} - * @method resume - */ - resume : function (segment /*:Function*/) /*:Void*/ { - YAHOO.tool.TestRunner.resume(segment); - }, - - /** - * Causes the test case to wait a specified amount of time and then - * continue executing the given code. - * @param {Function} segment (Optional) The function to run after the delay. - * If omitted, the TestRunner will wait until resume() is called. - * @param {int} delay (Optional) The number of milliseconds to wait before running - * the function. If omitted, defaults to zero. - * @return {Void} - * @method wait - */ - wait : function (segment /*:Function*/, delay /*:int*/) /*:Void*/{ - throw new YAHOO.tool.TestCase.Wait(segment, delay); - }, - - //------------------------------------------------------------------------- - // Stub Methods - //------------------------------------------------------------------------- - - /** - * Function to run before each test is executed. - * @return {Void} - * @method setUp - */ - setUp : function () /*:Void*/ { - }, - - /** - * Function to run after each test is executed. - * @return {Void} - * @method tearDown - */ - tearDown: function () /*:Void*/ { - } -}; - -/** - * Represents a stoppage in test execution to wait for an amount of time before - * continuing. - * @param {Function} segment A function to run when the wait is over. - * @param {int} delay The number of milliseconds to wait before running the code. - * @class Wait - * @namespace YAHOO.tool.TestCase - * @constructor - * - */ -YAHOO.tool.TestCase.Wait = function (segment /*:Function*/, delay /*:int*/) { - - /** - * The segment of code to run when the wait is over. - * @type Function - * @property segment - */ - this.segment /*:Function*/ = (YAHOO.lang.isFunction(segment) ? segment : null); - - /** - * The delay before running the segment of code. - * @type int - * @property delay - */ - this.delay /*:int*/ = (YAHOO.lang.isNumber(delay) ? delay : 0); - -}; - -YAHOO.namespace("tool"); - - -//----------------------------------------------------------------------------- -// TestSuite object -//----------------------------------------------------------------------------- - -/** - * A test suite that can contain a collection of TestCase and TestSuite objects. - * @param {String||Object} data The name of the test suite or an object containing - * a name property as well as setUp and tearDown methods. - * @namespace YAHOO.tool - * @class TestSuite - * @constructor - */ -YAHOO.tool.TestSuite = function (data /*:String||Object*/) { - - /** - * The name of the test suite. - * @type String - * @property name - */ - this.name /*:String*/ = ""; - - /** - * Array of test suites and - * @private - */ - this.items /*:Array*/ = []; - - //initialize the properties - if (YAHOO.lang.isString(data)){ - this.name = data; - } else if (YAHOO.lang.isObject(data)){ - YAHOO.lang.augmentObject(this, data, true); - } - - //double-check name - if (this.name === ""){ - this.name = YAHOO.util.Dom.generateId(null, "testSuite"); - } - -}; - -YAHOO.tool.TestSuite.prototype = { - - /** - * Adds a test suite or test case to the test suite. - * @param {YAHOO.tool.TestSuite||YAHOO.tool.TestCase} testObject The test suite or test case to add. - * @return {Void} - * @method add - */ - add : function (testObject /*:YAHOO.tool.TestSuite*/) /*:Void*/ { - if (testObject instanceof YAHOO.tool.TestSuite || testObject instanceof YAHOO.tool.TestCase) { - this.items.push(testObject); - } - }, - - //------------------------------------------------------------------------- - // Stub Methods - //------------------------------------------------------------------------- - - /** - * Function to run before each test is executed. - * @return {Void} - * @method setUp - */ - setUp : function () /*:Void*/ { - }, - - /** - * Function to run after each test is executed. - * @return {Void} - * @method tearDown - */ - tearDown: function () /*:Void*/ { - } - -}; - -YAHOO.namespace("tool"); - -/** - * The YUI test tool - * @module yuitest - * @namespace YAHOO.tool - * @requires yahoo,dom,event,logger - */ - - -//----------------------------------------------------------------------------- -// TestRunner object -//----------------------------------------------------------------------------- - -/** - * Runs test suites and test cases, providing events to allowing for the - * interpretation of test results. - * @namespace YAHOO.tool - * @class TestRunner - * @static - */ -YAHOO.tool.TestRunner = (function(){ - - /** - * A node in the test tree structure. May represent a TestSuite, TestCase, or - * test function. - * @param {Variant} testObject A TestSuite, TestCase, or the name of a test function. - * @class TestNode - * @constructor - * @private - */ - function TestNode(testObject /*:Variant*/){ - - /** - * The TestSuite, TestCase, or test function represented by this node. - * @type Variant - * @property testObject - */ - this.testObject = testObject; - - /** - * Pointer to this node's first child. - * @type TestNode - * @property firstChild - */ - this.firstChild /*:TestNode*/ = null; - - /** - * Pointer to this node's last child. - * @type TestNode - * @property lastChild - */ - this.lastChild = null; - - /** - * Pointer to this node's parent. - * @type TestNode - * @property parent - */ - this.parent = null; - - /** - * Pointer to this node's next sibling. - * @type TestNode - * @property next - */ - this.next = null; - - /** - * Test results for this test object. - * @type object - * @property results - */ - this.results /*:Object*/ = { - passed : 0, - failed : 0, - total : 0, - ignored : 0 - }; - - //initialize results - if (testObject instanceof YAHOO.tool.TestSuite){ - this.results.type = "testsuite"; - this.results.name = testObject.name; - } else if (testObject instanceof YAHOO.tool.TestCase){ - this.results.type = "testcase"; - this.results.name = testObject.name; - } - - } - - TestNode.prototype = { - - /** - * Appends a new test object (TestSuite, TestCase, or test function name) as a child - * of this node. - * @param {Variant} testObject A TestSuite, TestCase, or the name of a test function. - * @return {Void} - */ - appendChild : function (testObject /*:Variant*/) /*:Void*/{ - var node = new TestNode(testObject); - if (this.firstChild === null){ - this.firstChild = this.lastChild = node; - } else { - this.lastChild.next = node; - this.lastChild = node; - } - node.parent = this; - return node; - } - }; - - function TestRunner(){ - - //inherit from EventProvider - TestRunner.superclass.constructor.apply(this,arguments); - - /** - * Suite on which to attach all TestSuites and TestCases to be run. - * @type YAHOO.tool.TestSuite - * @property masterSuite - * @private - */ - this.masterSuite /*:YAHOO.tool.TestSuite*/ = new YAHOO.tool.TestSuite("YUI Test Results"); - - /** - * Pointer to the current node in the test tree. - * @type TestNode - * @private - * @property _cur - */ - this._cur = null; - - /** - * Pointer to the root node in the test tree. - * @type TestNode - * @private - * @property _root - */ - this._root = null; - - //create events - var events /*:Array*/ = [ - this.TEST_CASE_BEGIN_EVENT, - this.TEST_CASE_COMPLETE_EVENT, - this.TEST_SUITE_BEGIN_EVENT, - this.TEST_SUITE_COMPLETE_EVENT, - this.TEST_PASS_EVENT, - this.TEST_FAIL_EVENT, - this.TEST_IGNORE_EVENT, - this.COMPLETE_EVENT, - this.BEGIN_EVENT - ]; - for (var i=0; i < events.length; i++){ - this.createEvent(events[i], { scope: this }); - } - - } - - YAHOO.lang.extend(TestRunner, YAHOO.util.EventProvider, { - - //------------------------------------------------------------------------- - // Constants - //------------------------------------------------------------------------- - - /** - * Fires when a test case is opened but before the first - * test is executed. - * @event testcasebegin - */ - TEST_CASE_BEGIN_EVENT /*:String*/ : "testcasebegin", - - /** - * Fires when all tests in a test case have been executed. - * @event testcasecomplete - */ - TEST_CASE_COMPLETE_EVENT /*:String*/ : "testcasecomplete", - - /** - * Fires when a test suite is opened but before the first - * test is executed. - * @event testsuitebegin - */ - TEST_SUITE_BEGIN_EVENT /*:String*/ : "testsuitebegin", - - /** - * Fires when all test cases in a test suite have been - * completed. - * @event testsuitecomplete - */ - TEST_SUITE_COMPLETE_EVENT /*:String*/ : "testsuitecomplete", - - /** - * Fires when a test has passed. - * @event pass - */ - TEST_PASS_EVENT /*:String*/ : "pass", - - /** - * Fires when a test has failed. - * @event fail - */ - TEST_FAIL_EVENT /*:String*/ : "fail", - - /** - * Fires when a test has been ignored. - * @event ignore - */ - TEST_IGNORE_EVENT /*:String*/ : "ignore", - - /** - * Fires when all test suites and test cases have been completed. - * @event complete - */ - COMPLETE_EVENT /*:String*/ : "complete", - - /** - * Fires when the run() method is called. - * @event begin - */ - BEGIN_EVENT /*:String*/ : "begin", - - //------------------------------------------------------------------------- - // Test Tree-Related Methods - //------------------------------------------------------------------------- - - /** - * Adds a test case to the test tree as a child of the specified node. - * @param {TestNode} parentNode The node to add the test case to as a child. - * @param {YAHOO.tool.TestCase} testCase The test case to add. - * @return {Void} - * @static - * @private - * @method _addTestCaseToTestTree - */ - _addTestCaseToTestTree : function (parentNode /*:TestNode*/, testCase /*:YAHOO.tool.TestCase*/) /*:Void*/{ - - //add the test suite - var node = parentNode.appendChild(testCase); - - //iterate over the items in the test case - for (var prop in testCase){ - if (prop.indexOf("test") === 0 && YAHOO.lang.isFunction(testCase[prop])){ - node.appendChild(prop); - } - } - - }, - - /** - * Adds a test suite to the test tree as a child of the specified node. - * @param {TestNode} parentNode The node to add the test suite to as a child. - * @param {YAHOO.tool.TestSuite} testSuite The test suite to add. - * @return {Void} - * @static - * @private - * @method _addTestSuiteToTestTree - */ - _addTestSuiteToTestTree : function (parentNode /*:TestNode*/, testSuite /*:YAHOO.tool.TestSuite*/) /*:Void*/ { - - //add the test suite - var node = parentNode.appendChild(testSuite); - - //iterate over the items in the master suite - for (var i=0; i < testSuite.items.length; i++){ - if (testSuite.items[i] instanceof YAHOO.tool.TestSuite) { - this._addTestSuiteToTestTree(node, testSuite.items[i]); - } else if (testSuite.items[i] instanceof YAHOO.tool.TestCase) { - this._addTestCaseToTestTree(node, testSuite.items[i]); - } - } - }, - - /** - * Builds the test tree based on items in the master suite. The tree is a hierarchical - * representation of the test suites, test cases, and test functions. The resulting tree - * is stored in _root and the pointer _cur is set to the root initially. - * @return {Void} - * @static - * @private - * @method _buildTestTree - */ - _buildTestTree : function () /*:Void*/ { - - this._root = new TestNode(this.masterSuite); - this._cur = this._root; - - //iterate over the items in the master suite - for (var i=0; i < this.masterSuite.items.length; i++){ - if (this.masterSuite.items[i] instanceof YAHOO.tool.TestSuite) { - this._addTestSuiteToTestTree(this._root, this.masterSuite.items[i]); - } else if (this.masterSuite.items[i] instanceof YAHOO.tool.TestCase) { - this._addTestCaseToTestTree(this._root, this.masterSuite.items[i]); - } - } - - }, - - //------------------------------------------------------------------------- - // Private Methods - //------------------------------------------------------------------------- - - /** - * Handles the completion of a test object's tests. Tallies test results - * from one level up to the next. - * @param {TestNode} node The TestNode representing the test object. - * @return {Void} - * @method _handleTestObjectComplete - * @private - */ - _handleTestObjectComplete : function (node /*:TestNode*/) /*:Void*/ { - if (YAHOO.lang.isObject(node.testObject)){ - node.parent.results.passed += node.results.passed; - node.parent.results.failed += node.results.failed; - node.parent.results.total += node.results.total; - node.parent.results.ignored += node.results.ignored; - node.parent.results[node.testObject.name] = node.results; - - if (node.testObject instanceof YAHOO.tool.TestSuite){ - node.testObject.tearDown(); - this.fireEvent(this.TEST_SUITE_COMPLETE_EVENT, { testSuite: node.testObject, results: node.results}); - } else if (node.testObject instanceof YAHOO.tool.TestCase){ - this.fireEvent(this.TEST_CASE_COMPLETE_EVENT, { testCase: node.testObject, results: node.results}); - } - } - }, - - //------------------------------------------------------------------------- - // Navigation Methods - //------------------------------------------------------------------------- - - /** - * Retrieves the next node in the test tree. - * @return {TestNode} The next node in the test tree or null if the end is reached. - * @private - * @static - * @method _next - */ - _next : function () /*:TestNode*/ { - - if (this._cur.firstChild) { - this._cur = this._cur.firstChild; - } else if (this._cur.next) { - this._cur = this._cur.next; - } else { - while (this._cur && !this._cur.next && this._cur !== this._root){ - this._handleTestObjectComplete(this._cur); - this._cur = this._cur.parent; - } - - if (this._cur == this._root){ - this._cur.results.type = "report"; - this._cur.results.timestamp = (new Date()).toLocaleString(); - this.fireEvent(this.COMPLETE_EVENT, { results: this._cur.results}); - this._cur = null; - } else { - this._handleTestObjectComplete(this._cur); - this._cur = this._cur.next; - } - } - - return this._cur; - }, - - /** - * Runs a test case or test suite, returning the results. - * @param {YAHOO.tool.TestCase|YAHOO.tool.TestSuite} testObject The test case or test suite to run. - * @return {Object} Results of the execution with properties passed, failed, and total. - * @private - * @method _run - * @static - */ - _run : function () /*:Void*/ { - - //flag to indicate if the TestRunner should wait before continuing - var shouldWait /*:Boolean*/ = false; - - //get the next test node - var node = this._next(); - - if (node !== null) { - var testObject = node.testObject; - - //figure out what to do - if (YAHOO.lang.isObject(testObject)){ - if (testObject instanceof YAHOO.tool.TestSuite){ - this.fireEvent(this.TEST_SUITE_BEGIN_EVENT, { testSuite: testObject }); - testObject.setUp(); - } else if (testObject instanceof YAHOO.tool.TestCase){ - this.fireEvent(this.TEST_CASE_BEGIN_EVENT, { testCase: testObject }); - } - - //some environments don't support setTimeout - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._run(); - }, 0); - } else { - this._run(); - } - } else { - this._runTest(node); - } - - } - }, - - _resumeTest : function (segment /*:Function*/) /*:Void*/ { - - //get relevant information - var node /*:TestNode*/ = this._cur; - var testName /*:String*/ = node.testObject; - var testCase /*:YAHOO.tool.TestCase*/ = node.parent.testObject; - - //get the "should" test cases - var shouldFail /*:Object*/ = (testCase._should.fail || {})[testName]; - var shouldError /*:Object*/ = (testCase._should.error || {})[testName]; - - //variable to hold whether or not the test failed - var failed /*:Boolean*/ = false; - var error /*:Error*/ = null; - - //try the test - try { - - //run the test - segment.apply(testCase); - - //if it should fail, and it got here, then it's a fail because it didn't - if (shouldFail){ - error = new YAHOO.util.ShouldFail(); - failed = true; - } else if (shouldError){ - error = new YAHOO.util.ShouldError(); - failed = true; - } - - } catch (thrown /*:Error*/){ - if (thrown instanceof YAHOO.util.AssertionError) { - if (!shouldFail){ - error = thrown; - failed = true; - } - } else if (thrown instanceof YAHOO.tool.TestCase.Wait){ - - if (YAHOO.lang.isFunction(thrown.segment)){ - if (YAHOO.lang.isNumber(thrown.delay)){ - - //some environments don't support setTimeout - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._resumeTest(thrown.segment); - }, thrown.delay); - } else { - throw new Error("Asynchronous tests not supported in this environment."); - } - } - } - - return; - - } else { - //first check to see if it should error - if (!shouldError) { - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } else { - //check to see what type of data we have - if (YAHOO.lang.isString(shouldError)){ - - //if it's a string, check the error message - if (thrown.message != shouldError){ - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } - } else if (YAHOO.lang.isFunction(shouldError)){ - - //if it's a function, see if the error is an instance of it - if (!(thrown instanceof shouldError)){ - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } - - } else if (YAHOO.lang.isObject(shouldError)){ - - //if it's an object, check the instance and message - if (!(thrown instanceof shouldError.constructor) || - thrown.message != shouldError.message){ - error = new YAHOO.util.UnexpectedError(thrown); - failed = true; - } - - } - - } - } - - } - - //fireEvent appropriate event - if (failed) { - this.fireEvent(this.TEST_FAIL_EVENT, { testCase: testCase, testName: testName, error: error }); - } else { - this.fireEvent(this.TEST_PASS_EVENT, { testCase: testCase, testName: testName }); - } - - //run the tear down - testCase.tearDown(); - - //update results - node.parent.results[testName] = { - result: failed ? "fail" : "pass", - message: error ? error.getMessage() : "Test passed", - type: "test", - name: testName - }; - - if (failed){ - node.parent.results.failed++; - } else { - node.parent.results.passed++; - } - node.parent.results.total++; - - //set timeout not supported in all environments - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._run(); - }, 0); - } else { - this._run(); - } - - }, - - /** - * Runs a single test based on the data provided in the node. - * @param {TestNode} node The TestNode representing the test to run. - * @return {Void} - * @static - * @private - * @name _runTest - */ - _runTest : function (node /*:TestNode*/) /*:Void*/ { - - //get relevant information - var testName /*:String*/ = node.testObject; - var testCase /*:YAHOO.tool.TestCase*/ = node.parent.testObject; - var test /*:Function*/ = testCase[testName]; - - //get the "should" test cases - var shouldIgnore /*:Object*/ = (testCase._should.ignore || {})[testName]; - - //figure out if the test should be ignored or not - if (shouldIgnore){ - - //update results - node.parent.results[testName] = { - result: "ignore", - message: "Test ignored", - type: "test", - name: testName - }; - - node.parent.results.ignored++; - node.parent.results.total++; - - this.fireEvent(this.TEST_IGNORE_EVENT, { testCase: testCase, testName: testName }); - - //some environments don't support setTimeout - if (typeof setTimeout != "undefined"){ - setTimeout(function(){ - YAHOO.tool.TestRunner._run(); - }, 0); - } else { - this._run(); - } - - } else { - - //run the setup - testCase.setUp(); - - //now call the body of the test - this._resumeTest(test); - } - - }, - - //------------------------------------------------------------------------- - // Protected Methods - //------------------------------------------------------------------------- - - /* - * Fires events for the TestRunner. This overrides the default fireEvent() - * method from EventProvider to add the type property to the data that is - * passed through on each event call. - * @param {String} type The type of event to fire. - * @param {Object} data (Optional) Data for the event. - * @method fireEvent - * @static - * @protected - */ - fireEvent : function (type /*:String*/, data /*:Object*/) /*:Void*/ { - data = data || {}; - data.type = type; - TestRunner.superclass.fireEvent.call(this, type, data); - }, - - //------------------------------------------------------------------------- - // Public Methods - //------------------------------------------------------------------------- - - /** - * Adds a test suite or test case to the list of test objects to run. - * @param testObject Either a TestCase or a TestSuite that should be run. - * @return {Void} - * @method add - * @static - */ - add : function (testObject /*:Object*/) /*:Void*/ { - this.masterSuite.add(testObject); - }, - - /** - * Removes all test objects from the runner. - * @return {Void} - * @method clear - * @static - */ - clear : function () /*:Void*/ { - this.masterSuite.items = []; - }, - - /** - * Resumes the TestRunner after wait() was called. - * @param {Function} segment The function to run as the rest - * of the haulted test. - * @return {Void} - * @method resume - * @static - */ - resume : function (segment /*:Function*/) /*:Void*/ { - this._resumeTest(segment || function(){}); - }, - - /** - * Runs the test suite. - * @return {Void} - * @method run - * @static - */ - run : function (testObject /*:Object*/) /*:Void*/ { - - //pointer to runner to avoid scope issues - var runner = YAHOO.tool.TestRunner; - - //build the test tree - runner._buildTestTree(); - - //fire the begin event - runner.fireEvent(runner.BEGIN_EVENT); - - //begin the testing - runner._run(); - } - }); - - return new TestRunner(); - -})(); - -YAHOO.namespace("util"); - -//----------------------------------------------------------------------------- -// Assert object -//----------------------------------------------------------------------------- - -/** - * The Assert object provides functions to test JavaScript values against - * known and expected results. Whenever a comparison (assertion) fails, - * an error is thrown. - * - * @namespace YAHOO.util - * @class Assert - * @static - */ -YAHOO.util.Assert = { - - //------------------------------------------------------------------------- - // Generic Assertion Methods - //------------------------------------------------------------------------- - - /** - * Forces an assertion error to occur. - * @param {String} message (Optional) The message to display with the failure. - * @method fail - * @static - */ - fail : function (message /*:String*/) /*:Void*/ { - throw new YAHOO.util.AssertionError(message || "Test force-failed."); - }, - - //------------------------------------------------------------------------- - // Equality Assertion Methods - //------------------------------------------------------------------------- - - /** - * Asserts that a value is equal to another. This uses the double equals sign - * so type cohersion may occur. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areEqual - * @static - */ - areEqual : function (expected /*:Object*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (expected != actual) { - throw new YAHOO.util.ComparisonFailure(message || "Values should be equal.", expected, actual); - } - }, - - /** - * Asserts that a value is not equal to another. This uses the double equals sign - * so type cohersion may occur. - * @param {Object} unexpected The unexpected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areNotEqual - * @static - */ - areNotEqual : function (unexpected /*:Object*/, actual /*:Object*/, - message /*:String*/) /*:Void*/ { - if (unexpected == actual) { - throw new YAHOO.util.UnexpectedValue(message || "Values should not be equal.", unexpected); - } - }, - - /** - * Asserts that a value is not the same as another. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} unexpected The unexpected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areNotSame - * @static - */ - areNotSame : function (unexpected /*:Object*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (unexpected === actual) { - throw new YAHOO.util.UnexpectedValue(message || "Values should not be the same.", unexpected); - } - }, - - /** - * Asserts that a value is the same as another. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areSame - * @static - */ - areSame : function (expected /*:Object*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (expected !== actual) { - throw new YAHOO.util.ComparisonFailure(message || "Values should be the same.", expected, actual); - } - }, - - //------------------------------------------------------------------------- - // Boolean Assertion Methods - //------------------------------------------------------------------------- - - /** - * Asserts that a value is false. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isFalse - * @static - */ - isFalse : function (actual /*:Boolean*/, message /*:String*/) { - if (false !== actual) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be false.", false, actual); - } - }, - - /** - * Asserts that a value is true. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isTrue - * @static - */ - isTrue : function (actual /*:Boolean*/, message /*:String*/) /*:Void*/ { - if (true !== actual) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be true.", true, actual); - } - - }, - - //------------------------------------------------------------------------- - // Special Value Assertion Methods - //------------------------------------------------------------------------- - - /** - * Asserts that a value is not a number. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNaN - * @static - */ - isNaN : function (actual /*:Object*/, message /*:String*/) /*:Void*/{ - if (!isNaN(actual)){ - throw new YAHOO.util.ComparisonFailure(message || "Value should be NaN.", NaN, actual); - } - }, - - /** - * Asserts that a value is not the special NaN value. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotNaN - * @static - */ - isNotNaN : function (actual /*:Object*/, message /*:String*/) /*:Void*/{ - if (isNaN(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Values should not be NaN.", NaN); - } - }, - - /** - * Asserts that a value is not null. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotNull - * @static - */ - isNotNull : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (YAHOO.lang.isNull(actual)) { - throw new YAHOO.util.UnexpectedValue(message || "Values should not be null.", null); - } - }, - - /** - * Asserts that a value is not undefined. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotUndefined - * @static - */ - isNotUndefined : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (YAHOO.lang.isUndefined(actual)) { - throw new YAHOO.util.UnexpectedValue(message || "Value should not be undefined.", undefined); - } - }, - - /** - * Asserts that a value is null. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNull - * @static - */ - isNull : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isNull(actual)) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be null.", null, actual); - } - }, - - /** - * Asserts that a value is undefined. This uses the triple equals sign - * so no type cohersion may occur. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isUndefined - * @static - */ - isUndefined : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isUndefined(actual)) { - throw new YAHOO.util.ComparisonFailure(message || "Value should be undefined.", undefined, actual); - } - }, - - //-------------------------------------------------------------------------- - // Instance Assertion Methods - //-------------------------------------------------------------------------- - - /** - * Asserts that a value is an array. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isArray - * @static - */ - isArray : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isArray(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be an array.", actual); - } - }, - - /** - * Asserts that a value is a Boolean. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isBoolean - * @static - */ - isBoolean : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isBoolean(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a Boolean.", actual); - } - }, - - /** - * Asserts that a value is a function. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isFunction - * @static - */ - isFunction : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isFunction(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a function.", actual); - } - }, - - /** - * Asserts that a value is an instance of a particular object. This may return - * incorrect results when comparing objects from one frame to constructors in - * another frame. For best results, don't use in a cross-frame manner. - * @param {Function} expected The function that the object should be an instance of. - * @param {Object} actual The object to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isInstanceOf - * @static - */ - isInstanceOf : function (expected /*:Function*/, actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!(actual instanceof expected)){ - throw new YAHOO.util.ComparisonFailure(message || "Value isn't an instance of expected type.", expected, actual); - } - }, - - /** - * Asserts that a value is a number. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNumber - * @static - */ - isNumber : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isNumber(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a number.", actual); - } - }, - - /** - * Asserts that a value is an object. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isObject - * @static - */ - isObject : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isObject(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be an object.", actual); - } - }, - - /** - * Asserts that a value is a string. - * @param {Object} actual The value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isString - * @static - */ - isString : function (actual /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.isString(actual)){ - throw new YAHOO.util.UnexpectedValue(message || "Value should be a string.", actual); - } - }, - - /** - * Asserts that a value is of a particular type. - * @param {String} expectedType The expected type of the variable. - * @param {Object} actualValue The actual value to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isTypeOf - * @static - */ - isTypeOf : function (expectedType /*:String*/, actualValue /*:Object*/, message /*:String*/) /*:Void*/{ - if (typeof actualValue != expectedType){ - throw new YAHOO.util.ComparisonFailure(message || "Value should be of type " + expected + ".", expected, typeof actual); - } - } -}; - -//----------------------------------------------------------------------------- -// Assertion errors -//----------------------------------------------------------------------------- - -/** - * AssertionError is thrown whenever an assertion fails. It provides methods - * to more easily get at error information and also provides a base class - * from which more specific assertion errors can be derived. - * - * @param {String} message The message to display when the error occurs. - * @namespace YAHOO.util - * @class AssertionError - * @extends Error - * @constructor - */ -YAHOO.util.AssertionError = function (message /*:String*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message); - - /* - * Error message. Must be duplicated to ensure browser receives it. - * @type String - * @property message - */ - this.message /*:String*/ = message; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "AssertionError"; -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.AssertionError, Error, { - - /** - * Returns a fully formatted error for an assertion failure. This should - * be overridden by all subclasses to provide specific information. - * @method getMessage - * @return {String} A string describing the error. - */ - getMessage : function () /*:String*/ { - return this.message; - }, - - /** - * Returns a string representation of the error. - * @method toString - * @return {String} A string representation of the error. - */ - toString : function () /*:String*/ { - return this.name + ": " + this.getMessage(); - }, - - /** - * Returns a primitive value version of the error. Same as toString(). - * @method valueOf - * @return {String} A primitive value version of the error. - */ - valueOf : function () /*:String*/ { - return this.toString(); - } - -}); - -/** - * ComparisonFailure is subclass of AssertionError that is thrown whenever - * a comparison between two values fails. It provides mechanisms to retrieve - * both the expected and actual value. - * - * @param {String} message The message to display when the error occurs. - * @param {Object} expected The expected value. - * @param {Object} actual The actual value that caused the assertion to fail. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class ComparisonFailure - * @constructor - */ -YAHOO.util.ComparisonFailure = function (message /*:String*/, expected /*:Object*/, actual /*:Object*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message); - - /** - * The expected value. - * @type Object - * @property expected - */ - this.expected /*:Object*/ = expected; - - /** - * The actual value. - * @type Object - * @property actual - */ - this.actual /*:Object*/ = actual; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "ComparisonFailure"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.ComparisonFailure, YAHOO.util.AssertionError, { - - /** - * Returns a fully formatted error for an assertion failure. This message - * provides information about the expected and actual values. - * @method toString - * @return {String} A string describing the error. - */ - getMessage : function () /*:String*/ { - return this.message + "\nExpected: " + this.expected + " (" + (typeof this.expected) + ")" + - "\nActual:" + this.actual + " (" + (typeof this.actual) + ")"; - } - -}); - -/** - * UnexpectedValue is subclass of AssertionError that is thrown whenever - * a value was unexpected in its scope. This typically means that a test - * was performed to determine that a value was *not* equal to a certain - * value. - * - * @param {String} message The message to display when the error occurs. - * @param {Object} unexpected The unexpected value. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class UnexpectedValue - * @constructor - */ -YAHOO.util.UnexpectedValue = function (message /*:String*/, unexpected /*:Object*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message); - - /** - * The unexpected value. - * @type Object - * @property unexpected - */ - this.unexpected /*:Object*/ = unexpected; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "UnexpectedValue"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.UnexpectedValue, YAHOO.util.AssertionError, { - - /** - * Returns a fully formatted error for an assertion failure. The message - * contains information about the unexpected value that was encountered. - * @method getMessage - * @return {String} A string describing the error. - */ - getMessage : function () /*:String*/ { - return this.message + "\nUnexpected: " + this.unexpected + " (" + (typeof this.unexpected) + ") "; - } - -}); - -/** - * ShouldFail is subclass of AssertionError that is thrown whenever - * a test was expected to fail but did not. - * - * @param {String} message The message to display when the error occurs. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class ShouldFail - * @constructor - */ -YAHOO.util.ShouldFail = function (message /*:String*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message || "This test should fail but didn't."); - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "ShouldFail"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.ShouldFail, YAHOO.util.AssertionError); - -/** - * ShouldError is subclass of AssertionError that is thrown whenever - * a test is expected to throw an error but doesn't. - * - * @param {String} message The message to display when the error occurs. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class ShouldError - * @constructor - */ -YAHOO.util.ShouldError = function (message /*:String*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, message || "This test should have thrown an error but didn't."); - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "ShouldError"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.ShouldError, YAHOO.util.AssertionError); - -/** - * UnexpectedError is subclass of AssertionError that is thrown whenever - * an error occurs within the course of a test and the test was not expected - * to throw an error. - * - * @param {Error} cause The unexpected error that caused this error to be - * thrown. - * @namespace YAHOO.util - * @extends YAHOO.util.AssertionError - * @class UnexpectedError - * @constructor - */ -YAHOO.util.UnexpectedError = function (cause /*:Object*/){ - - //call superclass - arguments.callee.superclass.constructor.call(this, "Unexpected error: " + cause.message); - - /** - * The unexpected error that occurred. - * @type Error - * @property cause - */ - this.cause /*:Error*/ = cause; - - /** - * The name of the error that occurred. - * @type String - * @property name - */ - this.name /*:String*/ = "UnexpectedError"; - -}; - -//inherit methods -YAHOO.lang.extend(YAHOO.util.UnexpectedError, YAHOO.util.AssertionError); - -//----------------------------------------------------------------------------- -// ArrayAssert object -//----------------------------------------------------------------------------- - -/** - * The ArrayAssert object provides functions to test JavaScript array objects - * for a variety of cases. - * - * @namespace YAHOO.util - * @class ArrayAssert - * @static - */ - -YAHOO.util.ArrayAssert = { - - /** - * Asserts that a value is present in an array. This uses the triple equals - * sign so no type cohersion may occur. - * @param {Object} needle The value that is expected in the array. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method contains - * @static - */ - contains : function (needle /*:Object*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (haystack[i] === needle) { - found = true; - } - } - - if (!found){ - YAHOO.util.Assert.fail(message || "Value (" + needle + ") not found in array."); - } - }, - - /** - * Asserts that a set of values are present in an array. This uses the triple equals - * sign so no type cohersion may occur. For this assertion to pass, all values must - * be found. - * @param {Object[]} needles An array of values that are expected in the array. - * @param {Array} haystack An array of values to check. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method containsItems - * @static - */ - containsItems : function (needles /*:Object[]*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - //begin checking values - for (var i=0; i < needles.length; i++){ - this.contains(needles[i], haystack, message); - } - - if (!found){ - YAHOO.util.Assert.fail(message || "Value not found in array."); - } - }, - - /** - * Asserts that a value matching some condition is present in an array. This uses - * a function to determine a match. - * @param {Function} matcher A function that returns true if the items matches or false if not. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method containsMatch - * @static - */ - containsMatch : function (matcher /*:Function*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - //check for valid matcher - if (typeof matcher != "function"){ - throw new TypeError("ArrayAssert.containsMatch(): First argument must be a function."); - } - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (matcher(haystack[i])) { - found = true; - } - } - - if (!found){ - YAHOO.util.Assert.fail(message || "No match found in array."); - } - }, - - /** - * Asserts that a value is not present in an array. This uses the triple equals - * sign so no type cohersion may occur. - * @param {Object} needle The value that is expected in the array. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method doesNotContain - * @static - */ - doesNotContain : function (needle /*:Object*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (haystack[i] === needle) { - found = true; - } - } - - if (found){ - YAHOO.util.Assert.fail(message || "Value found in array."); - } - }, - - /** - * Asserts that a set of values are not present in an array. This uses the triple equals - * sign so no type cohersion may occur. For this assertion to pass, all values must - * not be found. - * @param {Object[]} needles An array of values that are not expected in the array. - * @param {Array} haystack An array of values to check. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method doesNotContainItems - * @static - */ - doesNotContainItems : function (needles /*:Object[]*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - for (var i=0; i < needles.length; i++){ - this.doesNotContain(needles[i], haystack, message); - } - - }, - - /** - * Asserts that no values matching a condition are present in an array. This uses - * a function to determine a match. - * @param {Function} matcher A function that returns true if the items matches or false if not. - * @param {Array} haystack An array of values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method doesNotContainMatch - * @static - */ - doesNotContainMatch : function (matcher /*:Function*/, haystack /*:Array*/, - message /*:String*/) /*:Void*/ { - - //check for valid matcher - if (typeof matcher != "function"){ - throw new TypeError("ArrayAssert.doesNotContainMatch(): First argument must be a function."); - } - - var found /*:Boolean*/ = false; - - //begin checking values - for (var i=0; i < haystack.length && !found; i++){ - if (matcher(haystack[i])) { - found = true; - } - } - - if (found){ - YAHOO.util.Assert.fail(message || "Value found in array."); - } - }, - - /** - * Asserts that the given value is contained in an array at the specified index. - * This uses the triple equals sign so no type cohersion will occur. - * @param {Object} needle The value to look for. - * @param {Array} haystack The array to search in. - * @param {int} index The index at which the value should exist. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method indexOf - * @static - */ - indexOf : function (needle /*:Object*/, haystack /*:Array*/, index /*:int*/, message /*:String*/) /*:Void*/ { - - //try to find the value in the array - for (var i=0; i < haystack.length; i++){ - if (haystack[i] === needle){ - YAHOO.util.Assert.areEqual(index, i, message || "Value exists at index " + i + " but should be at index " + index + "."); - return; - } - } - - //if it makes it here, it wasn't found at all - YAHOO.util.Assert.fail(message || "Value doesn't exist in array."); - }, - - /** - * Asserts that the values in an array are equal, and in the same position, - * as values in another array. This uses the double equals sign - * so type cohersion may occur. Note that the array objects themselves - * need not be the same for this test to pass. - * @param {Array} expected An array of the expected values. - * @param {Array} actual Any array of the actual values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method itemsAreEqual - * @static - */ - itemsAreEqual : function (expected /*:Array*/, actual /*:Array*/, - message /*:String*/) /*:Void*/ { - - //one may be longer than the other, so get the maximum length - var len /*:int*/ = Math.max(expected.length, actual.length); - - //begin checking values - for (var i=0; i < len; i++){ - YAHOO.util.Assert.areEqual(expected[i], actual[i], message || - "Values in position " + i + " are not equal."); - } - }, - - /** - * Asserts that the values in an array are equivalent, and in the same position, - * as values in another array. This uses a function to determine if the values - * are equivalent. Note that the array objects themselves - * need not be the same for this test to pass. - * @param {Array} expected An array of the expected values. - * @param {Array} actual Any array of the actual values. - * @param {Function} comparator A function that returns true if the values are equivalent - * or false if not. - * @param {String} message (Optional) The message to display if the assertion fails. - * @return {Void} - * @method itemsAreEquivalent - * @static - */ - itemsAreEquivalent : function (expected /*:Array*/, actual /*:Array*/, - comparator /*:Function*/, message /*:String*/) /*:Void*/ { - - //make sure the comparator is valid - if (typeof comparator != "function"){ - throw new TypeError("ArrayAssert.itemsAreEquivalent(): Third argument must be a function."); - } - - //one may be longer than the other, so get the maximum length - var len /*:int*/ = Math.max(expected.length, actual.length); - - //begin checking values - for (var i=0; i < len; i++){ - if (!comparator(expected[i], actual[i])){ - throw new YAHOO.util.ComparisonFailure(message || "Values in position " + i + " are not equivalent.", expected[i], actual[i]); - } - } - }, - - /** - * Asserts that an array is empty. - * @param {Array} actual The array to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isEmpty - * @static - */ - isEmpty : function (actual /*:Array*/, message /*:String*/) /*:Void*/ { - if (actual.length > 0){ - YAHOO.util.Assert.fail(message || "Array should be empty."); - } - }, - - /** - * Asserts that an array is not empty. - * @param {Array} actual The array to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method isNotEmpty - * @static - */ - isNotEmpty : function (actual /*:Array*/, message /*:String*/) /*:Void*/ { - if (actual.length === 0){ - YAHOO.util.Assert.fail(message || "Array should not be empty."); - } - }, - - /** - * Asserts that the values in an array are the same, and in the same position, - * as values in another array. This uses the triple equals sign - * so no type cohersion will occur. Note that the array objects themselves - * need not be the same for this test to pass. - * @param {Array} expected An array of the expected values. - * @param {Array} actual Any array of the actual values. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method itemsAreSame - * @static - */ - itemsAreSame : function (expected /*:Array*/, actual /*:Array*/, - message /*:String*/) /*:Void*/ { - - //one may be longer than the other, so get the maximum length - var len /*:int*/ = Math.max(expected.length, actual.length); - - //begin checking values - for (var i=0; i < len; i++){ - YAHOO.util.Assert.areSame(expected[i], actual[i], - message || "Values in position " + i + " are not the same."); - } - }, - - /** - * Asserts that the given value is contained in an array at the specified index, - * starting from the back of the array. - * This uses the triple equals sign so no type cohersion will occur. - * @param {Object} needle The value to look for. - * @param {Array} haystack The array to search in. - * @param {int} index The index at which the value should exist. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method lastIndexOf - * @static - */ - lastIndexOf : function (needle /*:Object*/, haystack /*:Array*/, index /*:int*/, message /*:String*/) /*:Void*/ { - - //try to find the value in the array - for (var i=haystack.length; i >= 0; i--){ - if (haystack[i] === needle){ - YAHOO.util.Assert.areEqual(index, i, message || "Value exists at index " + i + " but should be at index " + index + "."); - return; - } - } - - //if it makes it here, it wasn't found at all - YAHOO.util.Assert.fail(message || "Value doesn't exist in array."); - } - -}; - -YAHOO.namespace("util"); - - -//----------------------------------------------------------------------------- -// ObjectAssert object -//----------------------------------------------------------------------------- - -/** - * The ObjectAssert object provides functions to test JavaScript objects - * for a variety of cases. - * - * @namespace YAHOO.util - * @class ObjectAssert - * @static - */ -YAHOO.util.ObjectAssert = { - - /** - * Asserts that all properties in the object exist in another object. - * @param {Object} expected An object with the expected properties. - * @param {Object} actual An object with the actual properties. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method propertiesAreEqual - * @static - */ - propertiesAreEqual : function (expected /*:Object*/, actual /*:Object*/, - message /*:String*/) /*:Void*/ { - - //get all properties in the object - var properties /*:Array*/ = []; - for (var property in expected){ - properties.push(property); - } - - //see if the properties are in the expected object - for (var i=0; i < properties.length; i++){ - YAHOO.util.Assert.isNotUndefined(actual[properties[i]], message || - "Property'" + properties[i] + "' expected."); - } - - }, - - /** - * Asserts that an object has a property with the given name. - * @param {String} propertyName The name of the property to test. - * @param {Object} object The object to search. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method hasProperty - * @static - */ - hasProperty : function (propertyName /*:String*/, object /*:Object*/, message /*:String*/) /*:Void*/ { - if (YAHOO.lang.isUndefined(object[propertyName])){ - YAHOO.util.Assert.fail(message || - "Property " + propertyName + " not found on object."); - } - }, - - /** - * Asserts that a property with the given name exists on an object instance (not on its prototype). - * @param {String} propertyName The name of the property to test. - * @param {Object} object The object to search. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method hasProperty - * @static - */ - hasOwnProperty : function (propertyName /*:String*/, object /*:Object*/, message /*:String*/) /*:Void*/ { - if (!YAHOO.lang.hasOwnProperty(object, propertyName)){ - YAHOO.util.Assert.fail(message || - "Property " + propertyName + " not found on object instance."); - } - } -}; - -//----------------------------------------------------------------------------- -// DateAssert object -//----------------------------------------------------------------------------- - -/** - * The DateAssert object provides functions to test JavaScript Date objects - * for a variety of cases. - * - * @namespace YAHOO.util - * @class DateAssert - * @static - */ - -YAHOO.util.DateAssert = { - - /** - * Asserts that a date's month, day, and year are equal to another date's. - * @param {Date} expected The expected date. - * @param {Date} actual The actual date to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areEqual - * @static - */ - datesAreEqual : function (expected /*:Date*/, actual /*:Date*/, message /*:String*/){ - if (expected instanceof Date && actual instanceof Date){ - YAHOO.util.Assert.areEqual(expected.getFullYear(), actual.getFullYear(), message || "Years should be equal."); - YAHOO.util.Assert.areEqual(expected.getMonth(), actual.getMonth(), message || "Months should be equal."); - YAHOO.util.Assert.areEqual(expected.getDate(), actual.getDate(), message || "Day of month should be equal."); - } else { - throw new TypeError("DateAssert.datesAreEqual(): Expected and actual values must be Date objects."); - } - }, - - /** - * Asserts that a date's hour, minutes, and seconds are equal to another date's. - * @param {Date} expected The expected date. - * @param {Date} actual The actual date to test. - * @param {String} message (Optional) The message to display if the assertion fails. - * @method areEqual - * @static - */ - timesAreEqual : function (expected /*:Date*/, actual /*:Date*/, message /*:String*/){ - if (expected instanceof Date && actual instanceof Date){ - YAHOO.util.Assert.areEqual(expected.getHours(), actual.getHours(), message || "Hours should be equal."); - YAHOO.util.Assert.areEqual(expected.getMinutes(), actual.getMinutes(), message || "Minutes should be equal."); - YAHOO.util.Assert.areEqual(expected.getSeconds(), actual.getSeconds(), message || "Seconds should be equal."); - } else { - throw new TypeError("DateAssert.timesAreEqual(): Expected and actual values must be Date objects."); - } - } - -}; - -YAHOO.register("yuitest_core", YAHOO.tool.TestRunner, {version: "2.5.0", build: "895"});