README revision 9f7c20b894a93b0da425b8b9470043abefb6d7de
3.0.0 beta1
* Removed Attribute.CLONE support in the interests of simplicity.
Was not being used. Can add support if real demand for it exists.
* Changed "set" and "get" configuration properties for setter and
getter methods to "setter" and "getter" respectively.
* Added support for setter to return Attribute.INVALID_VALUE
to prevent attribute state from being changed.
This allows developers to combine setter and validator
functionality into one method if performance optimization
is required.
* "validator" is now invoked before "setter". Didn't make sense
to validate values which were already massaged by the setter.
* Renamed xxxAtt and xxxAtts methods to xxxAttr, xxxAttrs for
consistency.
* After listeners are only notified if attribute value really
changed (using ===).
* Extending classes can now overwrite ATTRS configuration propreties
from super classes, including writeOnce and readOnly attributes.
The ATTRS configurations are merged across the class heirarchy,
before they are used to initialize the attributes.
* addAttr now prevents re-adding attributes which are already
configured inorder to maintain consistent state.
* Event prefix wrapper functions (on, after etc.) removed -
Event.Target now accepts an event prefix configuration value
* Added additional log messages to assist with debugging.
* Attribute change events are no longer fired for initial set
* Split up State add/get/remove into add/addAll, get/getAll, remove/removeAll
to avoid having to create object literals for critical path [ add/get single
key values ]
3.0.0PR2
* Added valueFn support, to allowing static
attribute values configuration to set instance
based values.
* Added reset method.
* Added private setter for use by class implementation
code to set readOnly, writeOnce values.
3.0.0PR1 - Initial release
Module Name: "attribute"
Documentation: http://developer.yahoo.com/yui/3/attribute
The Attribute utility allows you to add attributes to any class
through an augmentable Attribute interface. The interface adds
get and set methods to your class for attribute access, in
addition to supporting change events allowing you to listen
for changes in attribute values.