*** 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