*** Version 2.3.0 ***
Added the following features:
-----------------------------
+ Added a "focusmenu" configuration attribute that controls whether or not a
Button instance's menu will automatically be focused when made visible.
+ Added a "lazyloadmenu" configuration attribute that controls the value of
the "lazyload" configuration property of a Button's menu.
+ Added "menuclassname" configuration attribute that defines a CSS class name
to be applied to the root HTML element of a button's menu.
Fixed the following bugs:
-------------------------
+ Setting the "label" attribute of a Button of type "link" to a string with
a "www." prefix will no longer result in the value of the "href" property
being used for the "label" in IE.
+ Disabling a Button when its menu is visible will now result in the menu
being hidden.
+ Hidden field(s) created by a Button instance are now removed if the
submission of its parent form is cancelled.
+ If a Button instance is preceeded by another enabled HTML submit button
(<input type="submit" ...> or <button type="submit" ...>), it will no longer
create a hidden field representing its name and value when its parent form
is submitted.
+ If an HTML form contains a mix of YUI Buttons of type "submit" and standard
HTML submit buttons (<input type="submit" ...> or <button type="submit" ...>)
its "submit" event will no longer fire twice when it is submitted by the user
pressing the enter key while focus inside another HTML form control.
+ If all Button instances in a form are disabled, the form will no longer be
submitted when the user presses the enter key while focused inside another
HTML form control.
+ The first enabled Button instance in a form now correctly adds its name and
value to the form's data set when the form is submitted by the user pressing
the enter key while focused inside another form control.
+ Fixed typo in the source file for the ButtonGroup class that was causing the
private variable "m_oButtons" to be declared as a global.
+ Switched to use of the CSS display type "-moz-inline-box" from
"-moz-inline-stack" for Gecko-based browsers so that the entire area of a
Button instance is clickable when it is rendered inside another inline
element.
+ Added "yui-button" and "yui-[button type]-button" prefix to CSS classes to
sandbox Button styles.
Changes:
--------
+ Default value of "type" configuration attribute now "push" (was "button").
+ Type "menubutton" now "menu."
+ Type "splitbuton" now "split."
+ Added "addStateCSSClasses" method.
+ Added "removeStateCSSClasses" method.
+ Renamed protected property "_hiddenField" to "_hiddenFields."
+ Removed protected "submit" event handler named "_onFormSubmit."
+ Renamed public method "createHiddenField" to "createHiddenFields."
+ Added new "removeHiddenFields" method.
+ Renamed static method "YAHOO.widget.Button.onFormKeyDown"
to "YAHOO.widget.Button.onFormKeyPress."
+ Renamed "TAG_NAME" constant (YAHOO.widget.Button.prototype.TAG_NAME and
YAHOO.widget.ButtonGroup.prototype.TAG_NAME) to
"NODE_NAME" (YAHOO.widget.Button.prototype.NODE_NAME and
YAHOO.widget.ButtonGroup.prototype.NODE_NAME).
+ The "selectedMenuItem" configuration attribute now correctly gets/sets the
index of the selected MenuItem instance of the button's menu, rather than a
MenuItem instance.
+ The "container" configuration attribute is now writeonce
+ The "menu" configuration attribute is now writeonce
+ The root element of each button's menu now will have two CSS classes
appended to it:
- The CSS class name specified by the "menuclassname" configuration
attribute (by default is "yui-button-menu")
- A type-specific class name (either "yui-split-button-menu"
or "yui-menu-button-menu")
+ "menu" configuration attribute now supports creation or use of
YAHOO.widget.Overlay in addition to previously supported
YAHOO.widget.Menu:
- To create a menu from existing markup using YAHOO.widget.Overlay, pass the
id or node reference of the HTML element to be used to create the Overlay
as the value of the "menu" configuration attribute.
- YAHOO.widget.Overlay instances passed as a value for the "menu"
configuration attribute need to be fully rendered.
- To create a menu from existing markup using YAHOO.widget.Menu, pass the
id or node reference of the HTML element to be used to create the menu
as the value of the "menu" configuration attribute and give the
HTML element the same class name as specified by
YAHOO.widget.Menu.prototype.CSS_CLASS_NAME.
- YAHOO.widget.Overlay instances used as a menu are by default not rendered
until they are are made visible for the first time. This behavior
can be changed so that they are rendered immediately by setting the value
of the "lazyloadmenu" configuration attribute to "false."
+ If you pass an element id for the value of the "menu" configuration
attribute, that node is now accessed immediately via the "get" method of the
Dom utility (YAHOO.util.Dom) as opposed to the "onContentReady" method of the
Event utility (YAHOO.util.Event).
+ Modified code to support a more generic markup format. Now any number of
HTML elements can exist between a Button's root HTML element and its button
node (be it an <A> or <BUTTON> element):
<ROOT_NODE> ... <BUTTON_NODE /> ... </ROOT_NODE>
+ A Button can now be initialized using any of the following six HTML patterns:
- <A> TEXT/HTML </A>
- <BUTTON> TEXT/HTML </BUTTON>
- <INPUT />
- <ROOT_NODE> ... <A> TEXT/HTML </A> ... </ROOT_NODE>
- <ROOT_NODE> ... <BUTTON> TEXT/HTML </BUTTON> ... </ROOT_NODE>
- <ROOT_NODE> ... <INPUT /> ... </ROOT_NODE>
+ The id of a Button instance can now match that of its source element.
+ CSS changes:
1) All Buttons have a "yui-" prefix as opposed to "yui":
2.2.2 | 2.3
-------------------------
.yuibutton | .yui-button
2) Each Button type has its own class name with a "yui-" prefix and
"-button" suffix IN ADDITION TO the default "yui-button" class name:
2.2.2 | 2.3
------------------------------------------
.yuibutton.splitbutton | .yui-split-button
.yuibutton.menubutton | .yui-menu-button
* Allows for the definition of generic styles that apply to all buttons,
while providing a means for uniquely styling buttons of a specific type.
3) For states that are common to all Buttons, two classes are applied: a
generic class name (i.e. yui-button-[state]) and a type-specific state class
name (yui-[type]-button-[state]):
2.2.2 | 2.3
-------------------------------------------
.yuibutton.focus | .yui-button-focus
.yuibutton.radio.focus | .yui-radio-button-focus
* States common to all Button types are:
+ focus
+ hover
+ active
+ disabled
** Allows for the definition of generic styles that apply to all states of
all buttons, while providing a means for uniquely styling states for
buttons of a specific type.
4) Buttons of type "radio" and "checkbox" have two classes applied to
represent their "checked" state: a generic class name
(i.e. yui-button-checked) and a type-specific class
name (yui-[type]-button-checked):
2.2.2 | 2.3
-------------------------------------------
.yuibutton.checked | .yui-button-checked
.yuibutton.radio.checked | .yui-radio-button-checked
.yuibutton.checkbox.checked | .yui-checkbox-button-checked
** This allows for the definition of a universal style for all Buttons that
have a "checked" state or the ability to define a type-specific style for
the "checked" state.
5) States that are specific to a particular type only get a type-specific
state class name. Currently this only applies to the "splitbutton" type:
2.2.2 | 2.3
-------------------------------------------
.yuibutton.activeoption | .yui-split-button-activeoption
6) The "ie6" class name is removed.
*** Version 2.2.2 ***
+ No changes
*** Version 2.2.1 ***
Added the following features:
-----------------------------
+ Added "getHiddenField" method to YAHOO.widget.Button.
Fixed the following bugs:
-------------------------
+ Removed built-in use of the Event utility's "onAvailable" method from the
constructor of Button and ButtonGroup as it was preventing the addition of
event listeners on instances created from existing markup. Going forward
Button and ButtonGroup instances created from existing markup can only be
instantiated once their source HTML element is available in the DOM. The
Button examples illustrate how this can be accomplished.
+ Modified code so that disabled Button instances no longer fire DOM events.
+ Pressing the enter key while focused on a form field whose parent form
contains a Button instance of type "submit" will now automatically submit
the form using the first Button instance of type "submit".
+ Clicking a Button instance of type="submit" will now cause the Button's
parent form's "submit" event to fire.
+ Modified Button CSS so that the filter used to apply alpha transparency to
a Button's background PNG is only used by IE 6. The previous code was
enabling IE's Alpha image loader for IE 7 in Quirks mode.
+ Fixed documentation error for "getForm" method.
Changes:
--------
+ Made the "submitForm" method of YAHOO.widget.Button public (was
previously protected).
+ Removed "init" event and corresponding "oninit" configuration attribute
from YAHOO.widget.Button and YAHOO.widget.ButtonGroup.
+ Added the CSS class "ie6" to button.css. This classname is append to root
DOM element of Button instances created with IE 6. By default this class
is used to apply a filter that gives alpha transparency to a Button's
background PNG.
*** Version 2.2.0 ***
* Button Control introduced