diff -r 322d0feea350 -r 89ef5ed3c48b src/cm/media/js/lib/yui/yui_3.10.3/releasenotes/HISTORY.app.md --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/cm/media/js/lib/yui/yui_3.10.3/releasenotes/HISTORY.app.md Tue Jul 16 14:29:46 2013 +0200 @@ -0,0 +1,410 @@ +App Framework Change History +============================ + +3.10.3 +------ + +* No changes. + +3.10.2 +------ + +### Router + +* Router now properly dispatches when using hash-based URLs and calling + `replace()` without arguments; before it would throw an error. [#739] + + +3.10.1 +------ + +* No changes. + + +3.10.0 +------ + +### Model + +* Fixed: The `options` object passed to Model's `setAttrs()` method was being + modified. Now a shallow copy of this object is now created so that the + `_transaction` property is added to the copy and not the passed-in object. + [#598] + + +3.9.1 +----- + +### LazyModelList + +* Fixed: Changing an attribute on a revived model did not update the + corresponding property on the original object. [#528] [Ryan Grove] + +* Fixed: Revived models didn't have the same `clientId` as the original object. + [#530] [Ryan Grove] + +### Router + +* Added a more helpful error when a named route callback function doesn't exist. + [#513] [Ryan Grove] + + +3.9.0 +----- + +### App + +* Applied the same changes from CSS Grids to App Transitions to support changes + in how Chrome 25 renders `word-spacing`. + + +3.8.1 +----- + +* No changes. + + +3.8.0 +----- + +### Router + +* Decode URL-encoded path matches for Router's `req.params`. [Ticket #2532941] + + +3.7.3 +----- + +### App + +* Add support for App Transitions in browsers which support native CSS3 + transitions without using vendor prefixes. This change means IE10 and Opera + get view transitions. + + +3.7.2 +----- + +* No changes. + + +3.7.1 +----- + +* No changes. + + +3.7.0 +----- + +### App + +* Added App.Content, an App extension that provides pjax-style content fetching + and handling, making it seamless to use a mixture of server and client + rendered views. + +### Model + +* Added custom response parsing to ModelSync.REST to make it easy for developers + to gain access to the full `Y.io()` response object. Developers using + ModelSync.REST can either assign the `parseIOResponse` property to `false` to + gain access to the full `Y.io()` response object in their `parse()` method, + or provide a custom implementation of the `parseIOResponse()` method. + +* ModelSync.REST's `serialize()` method now receives the `action` which the + `sync()` method was invoked with. [Ticket #2532625] + +### ModelList + +* You may now add models to a ModelList at instantiation time by providing an + Object, array of Objects, Model instance, array of Model instances, or another + ModelList instance in the `items` property of the config object passed to + ModelList's constructor. This change also applies to LazyModelList. + +### Router + +* Added support for route-based middleware to Router. The `route()` method now + accepts an arbitrary number of callbacks enabling more reuse of routing code. + For people familiar with Express.js' route middleware, this behaves the same. + [Ticket #2532620] + +### View + +* Log a warning when a handler function is not present when a view's `events` + are being attached. [Ticket #2532326] [Jay Shirley, Jeff Pihach] + + +3.6.0 +----- + +### App + +* Added static property: `Y.App.serverRouting`, which serves as the default + value for the `serverRouting` attribute of all apps. [Ticket #2532319] + +* Fixed issue with non-collapsing white space between views while transitioning. + White space is now fully collapsed and prevents views from jumping after a + cross-fade transition. [Ticket #2532298] + +* Organized all CSS classes `Y.App` uses under a static `CLASS_NAMES` property. + +* Moved `transitioning` CSS classname under `Y.App.CLASS_NAMES`. + +### Model + +* Added ModelSync.REST, an extension which provides a RESTful XHR `sync()` + implementation that can be mixed into a Model or ModelList subclass. + +### ModelList + +* Added LazyModelList, a subclass of ModelList that manages a list of plain + objects rather than a list of Model instances. This can be more efficient when + working with large numbers of items. [Ryan Grove] + +* The `add()` method now accepts an `index` option, which can be used to insert + the specified model(s) at a specific index in the list. [Greg Hinch] + +* The `each()` and `some()` methods now iterate over a copy of the list, so it's + safe to remove a model during iteration. [Ticket #2531910] + +* The `remove()` method now optionally accepts the index of a model to remove + (or an array of indices). You no longer need to specify the actual model + instance(s), although that's still supported as well. + +* The `filter()` method now returns an instance of the subclass rather than + ModelList itself when called with `options.asList` set to `true` on a subclass + of ModelList. [Ryan Grove] + +* Fixed an issue where a list that received bubbled events from a model would + assume the model was in the list if its `id` changed, even if the model + actually wasn't in the list and was merely bubbling events to the list. + [Ticket #2532240] + +### Router + +* [!] Changed how hash-based paths interact with the URL's real path. The + path-like hash fragments are now treated as a continuation of the URL's path + when the router has been configured with a `root`. [Ticket #2532318] + +* Fixed issue when multiple routers are on the page and one router is destroyed + the remaining routers would stop dispatching. [Ticket #2532317] + +* Fixed a multi-router issue where creating a router instance after a previous + router's `save()`/`replace()` method was called would cause in infinite + History replace loop. [Ticket #2532340] + +* The `req` object passed to routes now has a `pendingRoutes` property that + indicates the number of matching routes after the current route in the + dispatch chain. [Steven Olmsted] + +* Added a static `Y.Router.dispatch()` method which provides a mechanism to + cause all active router instances to dispatch to their route handlers without + needing to change the URL or fire the `history:change` or `hashchange` event. + + +3.5.1 +----- + +### App + +* Added `render` and `update` options to the `showView()` method. + [PR #100 Pat Cavit] + +### Router + +* Added a `removeQuery()` function that accepts a URL and returns it without a + query string (if it had one). [Pat Cavit] + +* Fixed `hasRoute()` failing to match routes with query params. [Pat Cavit] + +* Fixed bad route regex generation if a placeholder was the last thing in the + route. [Pat Cavit] + +* Fixed generated route regexes matching hash/query params when they shouldn't + have. [Pat Cavit] + + +3.5.0 +----- + +### App + +* Initial release. + +### Model + +* [!] The `validate()` method is now asynchronous, and is expected to call a + callback function on success or failure. Old-style synchronous `validate()` + methods will still work, but are deprecated. [Ticket #2531218] + +* Model now supports ad-hoc attributes, which means it's no longer necessary to + subclass `Y.Model` and declare attributes ahead of time. The following is now + perfectly valid, and will result in a model instance with "foo" and "bar" + attributes: + + var model = new Y.Model({foo: 'foo', bar: 'bar'}); + +* `load()` now fires a `load` event after the operation completes successfully, + or an `error` event on failure. The `load()` callback (if provided) will still + be called in both cases. [Ticket #2531207] + +* `save()` now fires a `save` event after the operation completes successfully, + or an `error` event on failure. The `save()` callback (if provided) will still + be called in both cases. [Ticket #2531207] + +* Options passed to `set()` and `setAttrs()` are now correctly merged into the + event facade of the `change` event. [Ticket #2531492] + +* Model's `destroy` event is now fully preventable (previously it was possible + for the model to be deleted even if the `destroy` event was prevented by a + subscriber in the `on` phase). + +### ModelList + +* ModelList's `model` property is now set to `Y.Model` by default. Since + `Y.Model` now supports ad-hoc attributes, this makes it much easier to create + and populate a ModelList without doing any subclassing: + + var list = new Y.ModelList(); + + list.add([ + {foo: 'bar'}, + {baz: 'quux'} + ]); + +* Added a `filter()` method that returns a filtered array of models or, + optionally, a new ModelList containing the filtered models. [Ticket #2531250] + +* Added a `create` event that fires when a model is created/updated via the + `create()` method, but before that model has actually been saved and added to + the list (and before the `add` method has fired). [Ticket #2531400] + +* Added a `load` event that fires when models are loaded. [Ticket #2531399] + +* Models' `id` attributes (if set) are now used to enforce uniqueness. If you + attempt to add a model to the list that has the same id as another model in + the list, an `error` event will be fired and the model will not be added. + [Ticket #2531409] + +* The `add()`, `remove()` and `reset()` methods now accept other ModelList + instances in addition to models and arrays of models. For example, passing a + ModelList to `add()` will add all the models in that list to this list as + well. [Ticket #2531408] + +* ModelList now allows you to add models to the list even if they were + instantiated in another window or another YUI sandbox. [Ticket #2531543] + +* ModelList subclasses can now override the protected `_compare()` method to + customize the low-level comparison logic used for sorting. This makes it easy + to do things like descending sort, multi-field sorting, etc. See the API docs + for details. + +* The `reset()` method now allows the caller-provided options object to override + the `src` property that's passed on the event facade of the `reset` event. + [Ticket #2531888] + +### Router (formerly Controller) + +* [!] The `Controller` class and `controller` module have been renamed to + `Router` and `router` respectively. The old names are deprecated, but have + been retained as aliases for backwards compatibility. They will be removed + in a future version of YUI. + +* [!] The `html5`, `root`, and `routes` properties are now attributes, and + `routes` may be set both during and after init. Code that refers to the old + properties, like `myController.root` and `myController.root = '/foo'`, must be + updated to use the attribute syntax instead: `myRouter.get('root')` and + `myRouter.set('root', '/foo')`. + +* [!] The signature for route handlers has changed. Route handlers now receive + three arguments: `req`, `res`, and `next`. To preserve backcompat, `res` is a + function that, when executed, calls `next()`. This behavior is deprecated and + will be removed in a future version of YUI, so please update your route + handlers to expect `next` as the third param. + +* `"*"` can now be used to create a wildcard route that will match any path + (previously it was necessary to use a regex to do this). Additionally, paths + which contain a `"*"` (e.g., `"/users/*"`) act as a wildcard matching + everything after it. + +* The `hasRoute()` method now accepts full URLs as well as paths. + +* The hashes used when `html5` is `false` are now root-less; the router's `root` + is removed from the hash before it is set on the URL. + +* When multiple Router instances exist on a page, calling `save()` in one will + now cause matching routes to be dispatched in all routers, rather than only + the router that was the source of the change. + +* Added `url` and `src` properties to the request object that's passed to route + handlers. + +* Made the `html5` config attribute writable. This allows you to force a router + to use (`true`) or not use (`false`) HTML5 history. Please don't set it to + `false` unless you understand the consequences. + +* Added a workaround for a nasty iOS 5 bug that destroys stored references to + `window.location` when the page is restored from the page cache. We already + had a workaround in place since this issue is present in desktop Safari as + well, but the old workaround no longer does the trick in iOS 5. + [Ticket #2531608] + +### View + +* [!] The `container`, `model`, and `modelList` properties are now attributes. + Code that refers to the old properties, like `myView.model` and + `myView.model = model`, must be updated to use the attribute syntax instead: + `myView.get('model')` and `myView.set('model', model)`. + +* [!] The `container` attribute now treats string values as CSS selectors. + Previously, it assumed string values represented raw HTML. To get the same + functionality as the old behavior, pass your HTML string through + `Y.Node.create()` before passing it to `container`. + +* [!] Destroying a view no longer also destroys the view's container node by + default. To destroy a view's container node when destroying the view, pass + `{remove: true}` to the view's `destroy()` method. [Ticket #2531689] + +* View now supports ad-hoc attributes, which means it's no longer necessary to + subclass `Y.View` and declare attributes ahead of time. The following is now + perfectly valid, and will result in a view instance with "foo" and "bar" + attributes: + + var view = new Y.View({foo: 'foo', bar: 'bar'}); + +* Added a `containerTemplate` property that contains an HTML template used to + create a container node when one isn't specified. Defaults to "
". + +* When no `container` node is specified at instantiation time, the container + won't be created until it's needed. `create()` is now only used to create a + default container; it's never called when a custom container node is + specified. + +* Added a View extension, `Y.View.NodeMap`, that can be mixed into a `View` + subclass to provide a static `getByNode()` method that returns the nearest + View instance associated with a given Node (similar to `Widget.getByNode()`). + + +3.4.1 +----- + +### Controller + +* Added a workaround for an iOS 4 bug that causes the previous URL to be + displayed in the location bar after calling `save()` or `replace()` with a + new URL. + +* Fixed a bug that caused the controller to get stuck in a "dispatching" state + if `save()` was called with no routes defined. + +### Model + +* The `validate()` method is now only called when `save()` is called, rather + than on every attribute change. If validation fails, the save operation will + be aborted. + + +3.4.0 +----- + +* Initial release.