include/javascript/yui/README

   1 YUI Library Release Notes
   2
   3 *** version 2.6.0 ***
   4
   5 The 2.6.0 release of YUI contains:
   6
   7 - Two new components:
   8   - Carousel
   9   - Paginator (code that handles navigation of chunked data previously released as a part of DataTable)
  10 - Seven components promoted from Beta to GA status
  11   - Cookie
  12   - DataTable
  13   - DataSource
  14   - Layout Manager
  15   - Rich Text Editor
  16   - Resize
  17   - Profiler
  18 - Many bug fixes to DataTable as well as a number of enhancements including:
  19   - CellEditor, BaseCellEditor, and associated subclasses which handle inline cell editing
  20   - ScrollingDataTable, a new subclass which to isolates and manages the fixed scrolling architecture
  21   - Pagination and sorting features that have been reworked to better support dynamically driven DataTables
  22 - The addition of Undo/Redo support to Rich Text Editor in addition to updates to indent/outdent processing,
  23   text attribute handling, toolbar button support.
  24 - New configuration properties in both Menu and Button.
  25 - An updated TreeView component that now includes support for keyboard navigation, delegated event listeners,
  26   tree serialization/deserialization and other new features.
  27 - Enhancements for Flash 10 support in the Uploader.
  28 - Fixes to more than 280 Source Forge bug reports.
  29
  30 This list is a brief summary of some of the highlights of this release.  There are many enhancements and
  31 bug fixes throughout the library. Please see the README file for each component in the build directory, or the
  32 README Digest posted to ydn-javascript as part of the 2.6.0 release announcement, for specific updates since
  33 version 2.5.2.
  34
  35
  36 *** version 2.5.2 ***
  37
  38 This update contains the following:
  39
  40 - Patches for DataTable and Menu posted to developer site following the release of 2.5.1 have been incorporated into the build.
  41 - FireFox 3 compatibility in advance of its release.
  42 - Opera 9.5 beta compatibility in advance of its release.
  43 - ActionScript source for Charts and Uploader is now included.
  44 - Charts component now includes support for dynamically created legends, and new chart and series styles.
  45 - DataTable bug fixes in pagination, scrolling, and column handling.
  46 - Several Rich Text Editor bug fixes.
  47 - Approximately 15 Source Forge bug fixes.
  48
  49 Please see the README file for each component in the build directory for specific updates since version 2.5.1.
  50
  51 *** version 2.5.1 ***
  52
  53 This update contains the following:
  54
  55 - additions to the Yahoo, Uploader, Editor, and DataSource components to improve YUI support for Adobe AIR
  56 - Douglas Crockford's fix for a security vulnerability where the JSON parser could be tricked into processing
  57 an unquoted string as quoted which could allow unsafe scripts to be evaled
  58 - a new aggregate file Ñ yuiloader-dom-event.js that is the ideal baseline rollup to use to be able to
  59 lazy-load any part of YUI on-demand
  60 - over 60 bug fixes
  61
  62 Please see the README file for each component in the build directory for specific updates since version 2.5.0.
  63
  64 *** version 2.5.0 ***
  65
  66 This release introduces six new components into YUI:
  67
  68    * Cookie Utility
  69    * ImageCropper
  70    * Layout Manager
  71    * Resize
  72    * Uploader
  73    * Profiler Viewer
  74
  75 These new components are introduced as "beta", with the exception of the Charts
  76 WidgeUploadert which is released as an experimental component.  Please see the YUI FAQ
  77 on the definition of beta and experimental at:
  78 http://developer.yahoo.com/yui/articles/faq/#beta
  79
  80 In addition to new components, you'll find updates and bug fixes throughout the
  81 library.
  82
  83 *** version 2.4.1 ***
  84
  85 This update contains one change.  We have reverted the change to the way the Event Utility cleans up
  86 events in its page unload handler that was introduced in 2.4.0. The change resulted in some events
  87 not being properly unloaded, which in turn resulted in IE-specific memory leaks in some YUI components
  88 including the Menu Control and controls in the Container Family.
  89
  90 *** version 2.4.0 ***
  91
  92 This release introduces five new components into YUI:
  93
  94    * Selector
  95    * Charts Widget
  96    * Get Utility
  97    * Profiler
  98    * JSON Utility
  99
 100 These new components are introduced as "beta", with the exception of the Charts
 101 Widget which is released as an experimental component.  Please see the YUI FAQ
 102 on the definition of beta and experimental at:
 103 http://developer.yahoo.com/yui/articles/faq/#beta
 104
 105 In addition to new components, you'll find updates and bug fixes throughout the
 106 library.
 107
 108 *** version 2.3.1 ***
 109
 110 This update contains general fixes to the YUI library.  Please see the README
 111 file for each component in the build directory for specific updates since
 112 version 2.3.0.
 113
 114 *** version 2.3.0 ***
 115
 116 This release introduces six new components into YUI:
 117
 118    * Base CSS
 119    * Color Picker Control
 120    * ImageLoader Utility
 121    * Rich Text Editor
 122    * YUI Loader Utility
 123    * YUI Test Utility
 124
 125 These new components are introduced as "beta", with the exception of ImageLoader
 126 Utility which is released as an experimental component.  Please see the YUI
 127 FAQ on the definition of beta and experimental at:
 128 http://developer.yahoo.com/yui/articles/faq/#beta
 129
 130 In addition to new components, you'll find updates and bug fixes throughout the
 131 library.
 132
 133 *** version 2.2.2 ***
 134
 135 This update contains general fixes to the YUI library.  Please see the
 136 README file for each component in the build directory for specific updates since
 137 version 2.2.1.
 138
 139 *** version 2.2.1 ***
 140
 141 This update contains general fixes to the YUI library.  Please see the
 142 README file for each component in the build directory for specific updates since
 143 version 2.2.0.
 144
 145 *** version 2.2.0 ***
 146
 147 This release synchronizes the SourceForge version with Yahoo!'s version of YUI
 148 -- version number 2.2.0.  Please see the following blog article for information
 149 on this specific version increment at:
 150 http://www.yuiblog.com/blog/2007/02/20/yui-220-released
 151
 152 The following new components are introduced with this release:
 153
 154    * Button
 155    * DataTable
 156    * Browser History Manager
 157
 158    The following components are now available as utilities:
 159
 160    * Element
 161    * DataSource
 162
 163 These new components are introduced as "beta", with the exception of Browser
 164 History Manager as an experimental component.  Please see the YUI FAQ on the
 165 definition of beta and experimental at:
 166 http://developer.yahoo.com/yui/articles/faq/#beta
 167
 168 * CSS customizations *
 169 Calendar, Container, and Menu have been revised to allow image customizations
 170 through their respective CSS files.  Please refer to each component's README to
 171 see the full details on affected properties.
 172
 173 Additional details for fixes and updates can be found in the README files for
 174 each updated component.  All YUI API cheatsheets have been updated for the
 175 current version and can be found at: yui/docs/assets/cheatsheets.zip.
 176
 177 *** version 0.12.2 ***
 178
 179 This update contains general fixes to the YUI library.  Please see the
 180 README file for each component in the build directory for specific updates since
 181 version 0.12.1.  As part of the 0.12.2 update, a number of corrections have been
 182 made to functional examples that were configured incorrectly in 0.12.1.
 183
 184 *** version 0.12.1 ***
 185
 186 This update contains general fixes to the YUI library.  Please see the
 187 README file for each component in the build directory for specific updates since
 188 version 0.12.0.
 189
 190 Beginning with this release, all YUI minification will be performed with JSMin(
 191 http://www.crockford.com/javascript/jsmin.html).  Line breaks will be preserved.
 192
 193 *** version 0.12.0 ***
 194
 195 This version introduces the Tabview widget as well as general fixes to the YUI
 196 library.  Additional details can be found in the README files for each updated
 197 component.  All YUI API cheatsheets have been updated for the current version
 198 and can be found at: yui/docs/assets/cheatsheets.zip.
 199
 200 * documentation *
 201 The YUI API documentation format is revised with this release.  This new
 202 format -- now a flat file structure under yui/docs/ -- implements the YUI
 203 AutoComplete widget on the main landing page to allow keyword searching of YUI.
 204 It also contains the full API documentation for all YUI components along with
 205 the following categories of data for each component(if applicable):
 206
 207 * Inheritance hierarchy for extensions and subclasses.
 208 * YUI dependencies
 209 * Properties and methods
 210 * Events
 211 * Configuration attributes.
 212
 213 * concatenated files *
 214 For convenience, three additional, minified variations of YUI are now available
 215 for your use:
 216
 217 * reset-fonts-grids.css
 218 * yahoo-dom-event.js
 219 * utilities.js
 220
 221 * API changes *
 222 There are interface changes to the Calendar widget.  Please see the 0.12.0
 223 Calendar upgrade guide at http:// developer.yahoo.com/yui/calendar/upgrade.html
 224 to see if this update affects your Calendar implementation and instructions on
 225 upgrading to version 0.12.0.
 226
 227
 228 *** version 0.11.4 ***
 229
 230 This update contains some priority bug fixes to the following components:
 231
 232 * Yahoo
 233 * Container
 234 * Drag and Drop
 235 * Event
 236
 237 Additional details can be found in the README files for each updated component.
 238
 239 *** version 0.11.3 ***
 240
 241 This update contains general fixes to the YUI library.  Please see the
 242 README file for each component in the build directory for updates and fixes
 243 since version 0.11.2.
 244
 245 *** version 0.11.2 ***
 246
 247 This update contains a high-priority fix to Drag and Drop that prevents text
 248 selection.  Additional details can be found in the README file for:
 249
 250 * Drag and Drop
 251
 252 *** version 0.11.1 ***
 253
 254 Release 0.11.1 addresses some high-priority bugs reported in the recently
 255 released version 0.11.0. Additional details can be found in the README files for
 256 each updated component:
 257
 258 * Animation
 259 * Dom
 260 * Drag and Drop
 261 * Connection Manager
 262 * Container
 263
 264 *** version 0.11.0 ***
 265
 266 This version introduces the Logger widget.  The YUI cheatsheets for version
 267 0.11.0 and 0.10.0 are also included in this distribution under docs/assets.
 268
 269 Please see the README file for each component in the build directory for
 270 updates and fixes since version 0.10.0.
 271
 272 *** version 0.10.0 ***
 273
 274 In this release, the directory structure has been modified to provide more
 275 component organization.  This is the new format:
 276
 277 yui/
 278   |
 279   -- build/
 280   | |
 281   | -- dom/
 282   | |
 283   | | -- assets/
 284   | |
 285   | | -- dom.js
 286   | |
 287   -- docs/
 288   | |
 289   | -- dom/
 290   | |
 291   -- examples/
 292   | |
 293   | -- dom/
 294   | |
 295   | | -- img/
 296
 297 Notice there are three immediate directories under the
 298 root YUI.  They are:
 299
 300 *build/*
 301 This directory contains the source files for each YUI component, and each
 302 component is presented as a sub-directory under build/.  Notice that there are
 303 generally two source files: component.js and component-min.js.  The "component"
 304 source is the raw, commented build and "component-min" is the minified version
 305 of the same file with comments and whitespace removed.  With some components,
 306 there is an assets sub-directory.  CSS and image dependencies for each
 307 component are stored in its assets sub-directory.
 308
 309 Note: If a component makes use of images, the image source path in the
 310 component's CSS file will point to Akamai.  The physical images are also
 311 available in the assets/ directory for local availability.  Please modify the
 312 CSS image references if you wish to use your own image assets.
 313
 314 *docs/*
 315 This directory contains the jsdoc-generated API reference for every YUI
 316 component.  Each component is presented as a sub-directory under docs/.
 317
 318 *examples/*
 319 This directory contains functional examples for each component in the YUI
 320 Library.  The examples are not part of the formal distribution; rather,
 321 they provide demonstrations of each component in use.  Each example uses YUI
 322 Library source files from the build/ directory, while all example-specific
 323 dependencies are stored in sub-directories (e.g. examples/dom/img).
 324 Some components, including the AutoComplete Control and Connection Manager,
 325 make use of PHP to implement certain examples.
 326
 327 For example:
 328 In yui/examples/dom, the dom.js source file and all YUI .js dependencies
 329 are drawn from yui/build/ directories.  All other example-specific sources are
 330 stored as sub-directories: yui/examples/dom/css and yui/examples/dom/img.
 331
 332 Each functional example is also available and functional on
 333 developer.yahoo.com/yui/.  They reproduced here as part of the distribution
 334 for your convenience.
 335
 336
 337
 338