readme

这是YUI的源码及相关示例。里面有很多很炫的Javascript效果。

  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