177 KiB
1.2.0-rc.2 barehand-atomsplitting (2013-09-04)
Features
- Scope: asynchronously auto-flush
$evalAsyncqueue when outside of$digestcycle (6b91aa0a, #3539, #2438) - minErr: log minerr doc url in development builds (37123cd2, #3566)
- ngMock:
Bug Fixes
-
$injector: don't parse fns with no args (44b6b72e)
-
$parse: handle promises returned from parsed function calls (3a658220, #3503)
-
$q:
-
$location: fix history problems on Boxee box (eefcdad0)
-
$timeout: clean deferreds immediately after callback exec/cancel (920a3804)
-
Directives:
-
Filters:
-
Misc:
-
i18n: remove obsolete locale files (6382e21f)
-
ngAnimate:
- ensure that
ngClassis always compiled before enter, leave and move animations are applied (36ad40b1, #3727, #3603) - cut down on extra
$timeoutcalls (4382df03) - skip
ngAnimateanimations if the provided element already has transitions applied to it (7c605ddf, #3587) - only apply a timeout when transitions or keyframe animations are used (ee2f3d21, #3613)
- ensure older versions of webkit work for animations (b1a43cd0)
- ensure that
-
ngMocks:
$logProvidershould not use internal APIs (baaa73ee, #3612)
Breaking Changes
- i18n: due to 6382e21f, some uncommon region-specific local files were removed.
1.0.8 bubble-burst (2013-08-22)
Contains only these fixes cherry-picked from v1.2.0rc1.
Bug Fixes
-
$compile:
-
$http: ensure case-insensitive header overriding (25d9f5a8)
-
$location:
-
$parse: move global getter out of parse.js (099138fb)
-
$q: call
reject()even if$exceptionHandlerrethrows (d59027c4) -
$timeout: clean deferreds immediately after callback exec/cancel (ac69392c)
-
$sanitize: match URI schemes case-insensitively (fcd761b9, #3210)
-
Scope: watches can be safely unregistered inside watch handlers (a4ec2979, #2915)
-
ngMock
- $timeout should forward delay argument (a5fb372e)
-
jqLite:
-
Directives:
- form: pick the right attribute name for ngForm (dc1e55ce, #2997)
- input: fix the email regex to accept TLDs up to 6 characters long (ad76e77f)
- ngCloak: hide element even when CSS 'display' is set (06b0930b)
- ngSubmit: expose $event to ngSubmit callback (b0d5f062)
- ngValue: made ngValue to write value attribute to element (3b898664)
-
Filters:
-
i18n: Do not transform arrays into objects (751c77f8)
-
jqLite:
-
Misc:
1.2.0rc1 spooky-giraffe (2013-08-13)
Features
-
ngAnimate: complete rewrite of animations (81923f1e)
-
$sce: new $sce service for Strict Contextual Escaping and lots of other security enhancements (bea9422e)
-
minErr: add error message minification and better error messages (c8fcf3b3, 09fa0656, b8ea7f6a)
-
$compile:
-
$http: accept function as headers value (a7150f12)
-
$q:
-
$resource:
-
$route: express style route matching (support for optional params and new wildcard syntax) (04cebcc1)
-
jqLite: switch bind/unbind to more recent jQuery on/off (f1b94b4b)
-
Misc:
-
Directives:
-
ngMobile/ngTouch:
-
ngMock:
-
scenario: expose jQuery for usage outside of angular scenario (3fdbe81a)
-
ngDocs:
- provide support for user to jump between different versions of the angularjs doc (46dfb92a)
- add links to source for API (52d6a599)
- support popover, foldouts and foldover annotations (ef229688)
- provide documentation for the new ngRepeat repeater syntax (b3650457)
- provide support for inline variable hinting (21c70729)
Bug Fixes
-
$compile:
- correct controller instantiation for async directives (c173ca41, #3493, #3482, #3537, #3540)
- always instantiate controllers before pre-link fns run (5c560117, #3493, #3482, #3514)
- always instantiate controllers in parent->child order (45f9f623, #2738)
- don't check attr.specified on non-ie7 (f9ea69f6, #3231, #2160)
- allow
data:image URIs inimg[src]bindings (3e39ac7e) - empty normalized href url should pass sanitation check (fc8c9baa, #2219)
- prevent infinite loop w/ replace+transclude directives (69f42b76, #2155)
- reject multi-expression interpolations for
srcattribute (38deedd6) - disallow interpolations for DOM event handlers (39841f2e)
- sanitize values bound to
img[src](1adf29af) - support multi-element group over text nodes (b28f9694)
- correct component transclusion on compilation root. (15e1a29c)
-
$http:
-
$location:
-
$parse:
-
$q: call
reject()even if$exceptionHandlerrethrows (664526d6) -
$resource: check whether response matches action.isArray (a644ca7b, #2255)
-
$sanitize: match URI schemes case-insensitively (7fef06fe, #3210)
-
Scope:
-
jqLite:
- properly detect unsupported calls for on()/off() (3824e400, 4f5dfbc3, #3501)
- return array from multi select in val() (306a6134)
- forgive unregistration of a non-registered handler (ab59cc6c)
- support space-separated events in off (bdd4e982, #3256)
- prepend array in correct order (fd87eb0c)
- allow override of jqLite.triggerHandler event object (0cac8729)
- added optional name arg in removeData (e1a050e6)
- correctly monkey-patch core jQuery methods (da5f537c)
-
i18n: Do not transform arrays into objects (b3d7a038)
-
ngMobile/ngTouch:
-
ngMock:
-
ngScenario: select().option(val) should prefer exact value match (22a9b1ac, #2856)
-
Directives:
-
ngRepeat:
-
ngShowHide: change the .ng-hide CSS class to use an !important flag (246c1439)
-
ngSubmit: expose $event to ngSubmit callback (3371fc25)
-
ngValue: made ngValue to write value attribute to element (09a1e7af)
-
ngView: ensure ngView is terminal and uses its own manual transclusion system (87405e25)
-
ngCloak: hide ngCloak-ed element even when CSS 'display' is set (3ffddad1)
-
input[email]: fix the email regex to accept TLDs up to 6 characters long (af731354) -
form: pick the right attribute name for ngForm (0fcd1e3b, #2997)
-
select: don't support binding to
select[multiple](d87fa004, #3230)
-
-
Filters:
- numberFilter: always convert scientific notation to decimal (a13c01a8)
-
Misc:
- detect transition/animation on older Android browsers (ef5bc6c7)
- handle duplicate params in parseKeyValue/toKeyValue (80739409)
- don't crash on invalid query parameters (8264d080)
- change angular.copy to correctly clone RegExp (f80730f4, #3473, #3474)
- angular.equals now supports for regular expressions (724819e3, #2685)
- angular.equals should not match keys defined in the prototype chain (7829c50f)
- angular.equals should not consider {} and [] to be equivalent (1dcafd18)
- angular.bootstrap should throw an error when bootstrapping a bootstrapped element (3ee744cc)
- angular.toJson should skip JSON.stringify for undefined (5a294c86)
- change css wrapping in grunt to prepend styles to the top of the head tag (fbad068a)
Breaking Changes
-
ngAnimate: due to 81923f1e, too many things changed, we'll write up a separate doc with migration instructions and will publish it at http://yearofmoo.com. Please check out the ngAnimate module docs and $animate api docs in the meantime.
-
$compile:
-
due to 1adf29af and 3e39ac7e,
img[src]URLs are now being sanitized and a whitelist configured via$compileProvidercan be used to configure what safe urls look like.By default all common protocol prefixes are whitelisted including
data:URIs with mime typesimage/*. Therefore this change is expected to have no impact on apps that don't contain malicious image links. -
due to 38deedd6, binding more than a single expression to
*[src]or*[ng-src]with the exception of<a>and<img>elements is not supported.Concatenating expressions makes it hard to understand whether some combination of concatenated values are unsafe to use and potentially subject to XSS vulnerabilities. To simplify the task of auditing for XSS issues, we now require that a single expression be used for
*[src/ng-src]bindings such as bindings foriframe[src],object[src], etc. (but notimg[src/ng-src]since that value is sanitized).
This change ensures that the possible pool of values that are used for data-binding is easier to trace down.
To migrate your code, follow the example below:
Before: JS: scope.baseUrl = 'page'; scope.a = 1; scope.b = 2; HTML: <!-- Are a and b properly escaped here? Is baseUrl controlled by user? --> <iframe src="{{baseUrl}}?a={{a}&b={{b}}"> After: JS: var baseUrl = "page"; scope.getIframeSrc = function() { // There are obviously better ways to do this. The // key point is that one will think about this and do // it the right way. var qs = ["a", "b"].map(function(value, name) { return encodeURIComponent(name) + "=" + encodeURIComponent(value); }).join("&"); // baseUrl isn't on scope so it isn't bound to a user // controlled value. return baseUrl + "?" + qs; } HTML: <iframe src="{{getIframeSrc()}}">-
due to 39841f2e, Interpolations inside DOM event handlers are disallowed.
DOM event handlers execute arbitrary Javascript code. Using an interpolation for such handlers means that the interpolated value is a JS string that is evaluated. Storing or generating such strings is error prone and leads to XSS vulnerabilities. On the other hand,
ngClickand other Angular specific event handlers evaluate Angular expressions in non-window (Scope) context which makes them much safer.To migrate the code follow the example below:
Before:
JS: scope.foo = 'alert(1)'; HTML: <div onclick="{{foo}}">After:
JS: scope.foo = function() { alert(1); } HTML: <div ng-click="foo()"> -
due to e46100f7, existing directives with name ending with
"-start"or"-end"will stop working.This change was necessary to enable multi-element directives. The best fix is to rename existing directives, so that they don't end with these suffixes.
-
-
$q: due to f078762d, the
alwaysmethod is now exposed asfinally.The reason for this change is to align
$qwith the Q promise library, despite the fact that this makes it a bit more difficult to use with non-ES5 browsers, like IE8.finallyalso goes well together withcatchapi that was added to $q recently and is part of the DOM promises standard.To migrate the code follow the example below:
Before:
$http.get('/foo').always(doSomething);After:
$http.get('/foo').finally(doSomething);or for IE8 compatible code:
$http.get('/foo')['finally'](doSomething); -
$resource:
-
due to 05772e15, resource instance does not have a
$thenfunction anymore. Use the$promise.theninstead.Before:
Resource.query().$then(callback);After:
Resource.query().$promise.then(callback); -
due to 05772e15, instance methods return the promise rather than the instance itself.
Before:
resource.$save().chaining = true;After:
resource.$save(); resource.chaining = true; -
due to 05772e15, on success, the resource promise is resolved with the resource instance rather than http response object.
Use interceptor api to access the http response object.
Before:
Resource.query().$then(function(response) {...});After:
var Resource = $resource('/url', {}, { get: { method: 'get', interceptor: { response: function(response) { // expose response return response; } } } });
-
-
$route:
-
due to 04cebcc1, the syntax for named wildcard parameters in routes has changed from
*wildcardto:wildcard*To migrate the code, follow the example below. Here,
*highlightbecomes:highlight*:Before:
$routeProvider.when('/Book1/:book/Chapter/:chapter/*highlight/edit', {controller: noop, templateUrl: 'Chapter.html'});After:
$routeProvider.when('/Book1/:book/Chapter/:chapter/:highlight*/edit', {controller: noop, templateUrl: 'Chapter.html'}); -
due to 5599b55b, applications that use
$routewill now need to load an angular-route.js file and define a dependency on the ngRoute module.Before:
... <script src="angular.js"></script> ... var myApp = angular.module('myApp', ['someOtherModule']); ...After:
... <script src="angular.js"></script> <script src="angular-route.js"></script> ... var myApp = angular.module('myApp', ['ngRoute', 'someOtherModule']); ...
-
-
$location: due to 80739409,
$location.searchnow supports multiple keys with the same value provided that the values are stored in an array in$location.search.Before this change:
parseKeyValueonly took the last key overwriting all the previous keys;toKeyValuejoined the keys together in a comma delimited string.
This was deemed buggy behavior. If your server relied on this behavior then either the server should be fixed, or a simple serialization of the array should be done on the client before passing it to $location.
-
ngBindHtml, sce: due to dae69473,
ngHtmlBindUnsafehas been removed and replaced byngHtmlBind(which has been moved fromngSanitizemodule to the corengmodule).ngBindHtmlprovidesngHtmlBindUnsafelike behavior (evaluate an expression and innerHTML the result into the DOM) when bound to the result of$sce.trustAsHtml(string). When bound to a plain string, the string is sanitized via$sanitizebefore being innerHTML'd. If the$sanitizeservice isn't available (ngSanitizemodule is not loaded) and the bound expression evaluates to a value that is not trusted an exception is thrown. -
ngForm: due to 8ea802a1,
If you have form names that will evaluate as an expression:
<form name="ctrl.form">And if you are accessing the form from your controller:
Before:
function($scope) { $scope['ctrl.form'] // form controller instance }After:
function($scope) { $scope.ctrl.form // form controller instance }This makes it possible to access a form from a controller using the new "controller as" syntax. Supporting the previous behavior offers no benefit.
-
ngView: due to 7d69d52a, previously ngView only updated its content, after this change ngView will recreate itself every time a new content is included. This ensures that a single rootElement for all the included contents always exists, which makes definition of css styles for animations much easier.
-
ngInclude: due to aa2133ad, previously ngInclude only updated its content, after this change ngInclude will recreate itself every time a new content is included. This ensures that a single rootElement for all the included contents always exists, which makes definition of css styles for animations much easier.
-
select: due to d87fa004, binding to
select[multiple]directly or via ngMultiple (ng-multiple) directive is not supported. This feature never worked with two-way data-binding, so it's not expected that anybody actually depends on it. -
ngMobile: due to 94ec84e7, since all the code in the ngMobile module is touch related, we are renaming the module to ngTouch.
To migrate, please replace all references to "ngMobile" with "ngTouch" and "angular-mobile.js" to "angular-touch.js".
1.1.5 triangle-squarification (2013-05-22)
Note: 1.1.x releases are considered unstable. They pass all tests but we reserve the right to change new features/apis in between minor releases. Check them out and please give us feedback.
Note: This release also contains all bug fixes available in 1.0.7.
Features
-
$animator:
-
$http:
-
$parse: add support for ternary operators to parser (6798fec4)
-
$q: add $q.always() method (6605adf6)
-
$controller: support "Controller as" syntax (cd38cbf9, 400f9360)
-
Directives:
-
Mobile:
-
docs:
-
scenario runner: adds mousedown and mouseup event triggers to scenario (629fb373)
Bug Fixes
-
$animator: remove dependency on window.setTimeout (021bdf39)
-
$controller: allow dots in a controller name (de2cdb06)
-
$location:
-
$resource:
-
$rootScope: ensure $watchCollection correctly handles arrayLike objects (6452707d)
-
date filter: correctly format dates with more than 3 sub-second digits (4f2e3606)
-
jqLite: pass a dummy event into triggerHandler (0401a7f5)
-
Directives:
-
scenario runner: correct bootstrap issue on IE (ab755a25)
-
Breaking Changes
-
$animator/ngAnimate: due to 11f712bc, css transition classes changed from
foo-setup/foo-starttofoo/foo-activeThe CSS transition classes have changed suffixes. To migrate rename
.foo-setup {...} to .foo {...} .foo-start {...} to .foo-active {...}or for type: enter, leave, move, show, hide
.foo-type-setup {...} to .foo-type {...} .foo-type-start {...} to .foo-type-active {...} -
$resource: due to 53061363, a
/followed by a., in the last segment of the URL template is now collapsed into a single.delimiter.For example:
users/.jsonwill becomeusers.json. If your server relied upon this sequence then it will no longer work. In this case you can now escape the/.sequence with/\.
1.0.7 monochromatic-rainbow (2013-05-22)
Bug Fixes
-
$browser: should use first value for a cookie. (3952d35a, #2635)
-
$cookieStore: $cookieStore.get now parses blank string as blank string (cf4729fa)
-
$location: back-button should fire $locationChangeStart (dc9a5806, #2109)
-
$parse: Fix context access and double function call (7812ae75, #2496)
-
dateFilter: correctly format ISODates on Android<=2.1 (f046f6f7, #2277)
-
jqLite: correct implementation of mouseenter/mouseleave event (06f2b2a8, #2131)
-
angular.copy/angular.extend: do not copy $$hashKey in copy/extend functions. (6d0b325f, #1875)
-
i18n: escape all chars above \u007f in locale files (695c54c1, #2417)
-
Directives:
- ngPluralize: handle the empty string as a valid override (67a4a25b, #2575)
- select: ensure empty option is not lost in IE9 (4622af3f, #2150)
- ngModel: use paste/cut events in IE to support context menu (363e4cbf, #1462)
- ngClass: should remove classes when object is the same but property has changed (0ac969a5)
-
PhoneCat Tutorial: renamed Testacular to Karma (angular-phonecat)
1.1.4 quantum-manipulation (2013-04-03)
Note: 1.1.x releases are considered unstable. They pass all tests but we reserve the right to change new features/apis in between minor releases. Check them out and please give us feedback.
Note: This release also contains all bug fixes available in 1.0.6.
Features
-
$compile:
-
$q:
$q.all()now accepts hash (e27bb6eb) -
$resource: ability to override url in resource actions (60f1f099)
-
$route: add
caseInsensitiveMatchoption for url matching (5e18a15f) -
http:
-
JQLite:
ready()now supportsdocument.readyState=='complete'(753fc9e5) -
Scenario: autodisable animations when running e2e tests (fec4ef38)
-
Scope: add
$watchCollectionmethod for observing collections (5eb96855) -
angular.bootstrap: support deferred bootstrap (mainly useful for tools like test runners and Batarang) (603fe0d1)
-
ngMobile: add ngMobile module with mobile-specific ngClick (707c65d5)
-
Directives:
Breaking Changes
-
$route: due to 6f71e809, in $routeChangeStart event, nextRoute.$route property is gone. Use the nextRoute object itself instead of nextRoute.$route.
-
ngRepeat: due to 61f2767c, it is now considered an error to have two identical items (identified by the new "track by" expression) in a collection that is fed into the repeater. This behavior was previously tolerated.
-
ngSwitch: due to e88d6179, elements not in the ng-switch were rendered after the ng-switch elements. Now they are rendered in-place.
Templates with ngSwitch directives and nested non-ngSwitchWhen elements should be updated to preserve render order.
For example: The following was previously rendered with
<li>1</li>after<li>2</li>:<ul ng-switch="select"> <li>1</li> <li ng-switch-when="option">2</li> </ul>To keep the old behaviour, use:
<ul ng-switch="select"> <li ng-switch-when="1">2</li> <li>1</li> </ul>
1.0.6 universal-irreversibility (2013-04-04)
Bug Fixes
- $compile:
- $http: don't encode URL query substring "null" to "+" (86d191ed)
- $httpBackend: prevent DOM err due to dereferencing .responseText (509ec745, #1922)
- $location:
- $route: make nextRoute.$route private (6f71e809, #1907)
- mocks: prevent NPE when module definition outside of it. (5c735eb4)
- dateFilter: correct timezone date filter for 1/2 hour offsets (1c1cd4fd)
1.1.3 radioactive-gargle (2013-02-20)
Note: 1.1.x releases are considered unstable. They pass all tests but we reserve the right to change new features/apis in between minor releases. Check them out and please give us feedback.
Note: This release also contains all bug fixes available in 1.0.5.
Bug Fixes
- $compile:
- $http:
- do not encode special characters
@$:,in params (288b69a3)
- do not encode special characters
- $resource:
- params should expand array values properly (2a212344)
Features
- $http: allow overriding the XSRF header and cookie name (8155c3a2)
- $parse: added
constantandliteralproperties (1ed63858) - $resource: expose promise based api via $then and $resolved (dba6bc73)
- $routeProvider: add support to catch-all parameters in routes (7eafbb98)
- Scope:
- angular.noConflict: added api to restore previous angular namespace reference (12ba6cec)
- Directives:
- Filters:
Breaking Changes
- $http: due to 288b69a3,
$http now follows RFC3986 and does not encode special characters like
$@,:in params. If your application needs to encode these characters, encode them manually, before sending the request. - $resource: due to 2a212344, if the server relied on the buggy behavior of serializing arrays as http query arguments then either the backend should be fixed or a simple serialization of the array should be done on the client before calling the resource service.
1.0.5 flatulent-propulsion (2013-02-20)
Bug Fixes
- $compile:
- $cookies: set cookies on Safari&IE when
base[href]is undefined (70909245, #1190) - $http:
- $resource:
- update RegExp to allow urlParams with out leading slash (b7e1fb05)
- Directives:
- Filters:
- scenario runner: include error messages in XML output (d46fe3c2)
- Misc:
1.1.2 tofu-animation (2013-01-22)
Note: 1.1.x releases are considered unstable. They pass all tests but we reserve the right to change new features/apis in between minor releases. Check them out and please give us feedback.
Note: This release also contains all bug fixes available in 1.0.4.
Features
- $compile: support modifying the DOM structure in postlink fn (cdf6fb19)
- $log: add $log.debug() (9e991ddb, #1592)
- $parse: allow strict equality in angular expressions (a179a9a9, #908)
- $resource:
- $route: allow using functions as template params in 'when' (faf02f0c)
- $timeout-mock: add verifyNoPendingTasks method (f0c6ebc0, #1245)
- directive:
- limitTo filter: limitTo filter accepts strings (9e96d983, #653)
- scenario:
Breaking Changes
- date: due to cc821502, string input without timezone info is now parsed as local time/date
1.0.4 bewildering-hair (2013-01-22)
Bug Fixes
- $compile:
- $injector:
- $resource:
- $route:
- Scope: ensure that a scope is destroyed only once (d6da505f, #1627)
- angular.equals:
- date filter: parse string input as local time unless TZ is specified (cc821502, #847)
- jqLite:
- scenario: don't trigger input events on IE9 (8b9e6c35)
- Directives:
Features
- $compile: support modifying the DOM structure in postlink fn (cdf6fb19)
1.1.1 pathological-kerning (2012-11-26)
Note: 1.1.x releases are considered unstable. They pass all tests but we reserve the right to change new features/apis in between minor releases. Check them out and please give us feedback.
Note: This release also contains all bug fixes available in 1.0.3.
Features
- $cacheFactory: cache.put now returns the added value (168db339)
- $http: Allow setting withCredentials on defaults (209b67df, #1095)
- $resource: support custom headers per action (fbdab513, #736)
- $sanitize: support telephone links (04450c48)
- FormController: add ability to reset a form to pristine state (733a97ad, #856)
- jqLite: add triggerHandler() (650fd933)
- linky filter: allow optional 'target' argument (610927d7, #1443)
- angular-mocks: support mocha in angular mocks (92558fe4)
- ngModel: support ngTrim attribute on input (d519953a)
- scenario: add dblclick method to the ngScenario dsl (8cb9c99e)
- CSP: update to the latest CSP api (af7e0bd0, #1577)
Bug Fixes
- $http:
- config.param should expand array values properly (see breaking change notes below) (79af2bad, #1363)
- prevent CORS preflight checks by removing
X-Requested-Withfrom header defaults (see breaking change notes below) (3a75b112, #1004) - prevent CORS preflight checks by not setting
X-XSFR-TOKENheader for cross domain requests (see breaking change notes below) (fce100a4, #1096)
Refactorings
- $evalAsync: have only one global async queue (331cd5a8)
Breaking Changes
-
Due to fix for #1363 it's possible but unlikely that $http will start generating different URLs for requests. This affects only cases when a request is made with a parameter, value of which is an array. If the server relied on the buggy behavior then either the backend should be fixed or a simple serialization of the array should be done on the client before calling the $http service.
-
Due to fix for #1004 the
X-Requested-Withheader is not set by $http service any more. If anyone actually uses this header it's quite easy to add it back via:myAppModule.config(['$httpProvider', function($httpProvider) { $httpProvider.defaults.headers.common["X-Requested-With"] = 'XMLHttpRequest'; }]); -
Due to fix for #1096
X-XSFR-TOKENheader is no longer send for cross domain requests. This shouldn't affect any known production service. If we are wrong, please let us know ;-)
1.0.3 bouncy-thunder (2012-11-26)
Bug Fixes
- $cacheFactory: return undefined when removing non-existent entry (55d15806, #1497)
- $compile:
- $injector: more conservative annotation parsing
- $location: reset $location.$$replace with every watch call (a32bc40f, #1111) (d9eff86e)
- $parser: string concatination with undefined model (42c38b29, #988)
- $resource:
- Scope:
- $route: support inline annotation on .resolve (b0a05a75)
- FormController: propagate dirty state to parent forms (04329151)
- a: prevent Opera from incorrectly navigating on link click (c81d8176)
- jqLite:
- Filters
- Directives
- ngClass: works with class interpolation (cebd015f, #1016)
- ngClassOdd/ngClassEven: support shrinking/reordering in repeaters (d859dcec, 6c67719d, #1076)
- ngModel: sync ngModel state with scope state (e6d9bea4, #933)
- ngRepeat: now works better with primitive types (e6d9bea4, #933)
- ngSrc: don't set src if value is empty string (b6e4a711)
- select: select option with a label of 0 is not shown (b3cae4f4, #1401)
- scenario:
Docs
- add plunkr support (7c67b2fb)
- various small documentation fixes and improvements
Refactorings
1.1.0 increase-gravatas (2012-08-31)
Note: 1.1.x releases unlike 1.0.x are considered unstable. More info
This release also contains all bug fixes available in 1.0.2.
Features
- $http: support custom reponseType (e0a54f6b, #1013)
- $interpolate:
- $sniffer: auto detect CSP mode (currently requires Chrome on dev channel) (167aa0c2)
1.0.2 debilitating-awesomeness (2012-08-31)
Bug Fixes
- $compile: denormalize directive templates (dfe99836)
- $interpolate: $interpolateProvider.endSymbol() returns startSymbol (20348717)
- jqLite: better support for xhtml (d3fa7a2e, #1301)
- mocks: free up memory after every spec (1a8642aa)
- e2e test runner: Adding meta tag to avoid cache issues (5318588d)
- Directives:
Docs
- Conceptual Overview of AngularJS (high level overview of how things work): http://docs.angularjs.org/guide/concepts (7a5f25f6)
- Lots of spelling, grammar and other fixes: 9a710c78, 847d2da0, dbefd671, cab5e1d9, f00b6cca, 2e365168, 536de148, a1107e81, 5ef9ed87, 8c81a0f3, bde931af, 6553fe68, 13b5fd1b, 17209d5b, 31c82560, ab6937e2, fbfda241, 206371b7, b6b92bd8, 79f2d843, 64a9cd8f, 7f6e1326, 1fd2b3d4, d56d69cc, 01e726b2, 16136216, 92a3d282, 4c585019, c076fe08, 2473412b, 1f2d5000, 5026315d, f0a090dd, 6d9313a6) and more!
1.0.1 thorium-shielding (2012-06-25)
Bug Fixes
- $location: don't throw exception while url rewriting if element was removed (3da4194f, #1058)
- $location: prevent ie from getting into redirect loop (ffb27013, #1075, #1079, #1085)
1.0.0 temporal-domination (2012-06-13)
Bug Fixes
- $location:
1.0.0rc12 regression-extermination (2012-06-12)
Bug Fixes
Cleanup
1.0.0rc11 promise-resolution (2012-06-10)
Features
- $route:
- $compile: simplify isolate scope bindings and introduce true two-way data-binding between parent scope and isolate scope (c3a41ff9)
- $injector: provide API for retrieving function annotations (4361efb0)
- $location: add $locatonChange[start|success] event - since events are cancelable, it's now possible to cancel route and location changes. (92a2e180)
- $rootElement: expose application root element as $rootElement service (85632cb4)
Bug Fixes
- $compile: correctly merge class attr for replace directives (contributed by Max Martinsson, fb99b539, #1006)
- $http: add utf-8 to default Content-Type header (post/put) (10f80d7d)
- $timeout: allow calling $timeout.cancel() with undefined (contributed by Ali Mills, 1904596e)
- jqLite: don't eat event exceptions (416a7830)
Breaking Changes
-
$beforeRouteChange and $afterRouteChange events were renamed to $routeChangeStart and $routeChangeSuccess
This was done to make the naming consistent with $location events and also get events to categorize and order nicely just by alphabetical sorting.
(7c242821)
-
templateoption in $route definition was renamed totemplateUrlThe
templateoptions in $route definition now represents the actual template string. To provide the template url usetemplateUrloption instead. This was done to unify the directive and $route definitions.To migrate just rename
templatetotemplateUrl. (0a6e464a) -
isolate scope bindings definition has changed
To migrate the code follow the example below:
Before:
scope: { myAttr: 'attribute', myBind: 'bind', myExpression: 'expression', myEval: 'evaluate', myAccessor: 'accessor' }After:
scope: { myAttr: '@', myBind: '@', myExpression: '&', // myEval - usually not useful, but in cases where the expression is assignable, you can use '=' myAccessor: '=' // in directive's template change myAccessor() to myAccessor } -
the inject option for the directive controller injection was removed
The removed
injectwasn't generally useful for directives so there should be no code using it. (c3a41ff9)
1.0.0rc10 tesseract-giftwrapping (2012-05-23)
Features
- $timeout: add
$timeoutservice that supersedes$defer(4511d39c, #704, #532) - scope: add
event.preventDefault()andevent.defaultPrevented(84542d24)
Bug Fixes
- ngRepeat: expose
$first,$middleand$lastinstead of$position(1d388676, #912) - jqLite: use the same expando store structure as jQuery (acf095d1)
- $rootScope: infinite digest exception does not clear $$phase (5989a1ed, #979)
Breaking Changes
-
ngRepeat -
$positionis not exposed in repeater scopes any moreTo update, search for
/\$position/and replace it with one of$first,$middleor$last. (1d388676) -
scope event's
cancelmethod was renamed tostopPropagationThe name was corrected in order to align better with DOM terminology. To update, search for
/\.\s*cancel\s*(/and replace it with.stopPropagation(or.preventDefault((or both) depending on what you actually need. (91db9920)
Deprecation Warnings
-
$deferservice has been deprecated in favor of$timeoutserviceThe
$deferservice will be removed before 1.0 final, so please migrate your code. (4511d39c)
1.0.0rc9 eggplant-teleportation (2012-05-14)
Bug Fixes
- $location:
- docs app: get docs app to work on IE8 (aa025348)
1.0.0rc8 blooming-touch (2012-05-06)
Features
- jqLite: support data() getter and data(obj) setter (ee579a07)
Bug Fixes
- $compile:
- have $observe return registration function (7f0eb151)
- ignore ws when checking if template has single root (9c0418cf, #910)
- fix replaceWith (b431ee38)
- attach scope to the directive element when templateUrl and replace=true (705f4bbf)
- prevent duplicate directive controller instantiation (843f762c, #876)
- $parse: support methods on falsy primitive types (499a76a0)
- ngModel: use keydown/change events on IE9 instead of input (49dfdf8f, #879)
- ngSrc,ngHref: binding should set element prop as well as attr (b24cc63b, #935)
- scenario: make browser().location() working if ng-app on other than <html> (5bcb749a)
- select: don't interfere with selection if not databound (3bd3cc57, #926)
Docs
- Brand new bootstrap-based skin for api docs: http://docs.angularjs.org/
1.0.0rc7 rc-generation (2012-04-30)
Features
Bug Fixes
- jqlite:
Docs
- Tutorial has been finally updated to AngularJS v1.0! Check it out and provide feedback to make it even better: http://docs.angularjs.org/tutorial
- http://docs-next.angularjs.org now redirects to http://docs.angularjs.org
v1.0.0rc6 runny-nose (2012-04-20)
Bug Fixes
- select: properly handle empty & unknown options without ngOptions (904b69c7)
- compiler: reading comment throws error in ie (46bb08a9)
- document: accidental clobbering of document.getAttribute (eafe15f5, #877)
- script: Incorrectly reading script text on ie (94dd6857)
Features
1.0.0rc5 reality-distortion (2012-04-12)
Bug Fixes
- $location: properly rewrite urls in html5 mode with base url set + don't rewrite links to different base paths (6d7e7fde, 0a5050eb)
- e2eRunner: $browser.location should delegate to apps $location (df72852f)
- input.radio: support 2-way binding in a repeater (93d62860, #869)
- ngBindHtml: clear contents when model is falsy (10daefc6, #864)
- lots of doc fixes
Features
- $http: expose the defaults config as $http.defaults (dceafd32)
- docs: steps 0-4 of the Tutorial have been updated and improved
Breaking Changes
-
ng-ext-linkdirective was removed because it's unnecessary (6d7e7fde)apps that relied on ng-ext-link should simply replace it with
target="_self" -
$browser.addCsswas removed - it was never meant to be a public api (13d5528a)apps the depend on this functionality should write a simple utility function specific to the app (see this diff for hints).
-
$browser.addJsmethod was removed - it was never meant to be a public api (fbaa1968)apps that depended on this functionality should either use many of the existing script loaders or create a simple helper method specific to the app.
-
$sanitizeservice,ngBindHtmldirective andlinkyfilter were moved to thengSanitizemodule (5bcd7198)apps that depend on any of these will need to load
angular-sanitize.jsand includengSanitizein their dependency list:var myApp = angular.module('myApp', ['ngSanitize']);
1.0.0rc4 insomnia-induction (2012-04-05)
Bug Fixes
- $compile: relax the restriction that directives can not add siblings (7e86eacf)
- $location: search setter should not double-encode the value (59fa40ec, #751)
- $q: $q.reject should forward callbacks if missing (c0b78478, #845)
- build: move
'use strict';flag into the angular closure (637817e3) - Directives:
- ngModel: update model on each key stroke (revert ngModelInstant) (06d09550)
- booleanAttrs: always convert the model to boolean before setting the element property (dcb8e076)
- form: preperly clean up when invalid widget is removed (21b77ad5)
- ngHref: copy even if no binding (2f5dba48)
- ngInclude: fire $includeContentLoaded on proper (child) scope (199ac269)
Features
- $http: add
withCredentialsconfig option (86182a94) - $route: allow chaining of whens and otherwise (15ecc6f3)
- ngInclude: allow ngInclude as css class (428f2b56)
Docs
- reintroduced the tutorial docs - currently only steps 0-3 are up to date and the code is not split up into step specific commits yet. See this branch instead.
- various other doc fixes
Breaking Changes
We removed two useless features:
- $routeProvider.when used to return the route definition object but now it returns self (15ecc6f3)
- ngInclude does not have scope attribute anymore (5f70d615)
- ngModelInstant directive is no more and ngModel behaves just as ngModelInstant used to. This doesn't really break anything, just remember to remove all ngModelInstant references from your template as they serve no purpose now. (06d09550)
1.0.0rc3 barefoot-telepathy (2012-03-29)
Bug Fixes
- $compile:
- angular.forEach: should ignore prototypically inherited properties (8d7e6948, #813)
- initialization: use jQuery#ready for initialization if available (cb2ad9ab, #818)
- $q: resolve all of nothing to nothing (ac75079e)
Features
- $compile: do not interpolate boolean attribute directives, rather evaluate them (a08cbc02)
- $controller: support controller registration via $controllerProvider (d54dfecb)
- $http:
- TzDate: add support for toISOString method (da9f4dfc)
- jqLite: make injector() and scope() work with the document object (5fdab52d)
- ngValue: directive that allows radio inputs to have non string values (09e175f0, #816)
Breaking Changes
$resource,$cookiesand$cookieStoreservices are now distributed as separate modules, seeangular-resource.jsandangular-cookies.js. (798bca62, 7b22d59b)- angular.fromJson doesn't deserialize date strings into date objects. (ac4318a2)
- angular.toJson always use native JSON.parse and JSON.stringify - this might break code that consumes the output in whitespace-sensitive way (35125d25)
- IE7 and older have are now required to polyfill the JSON global object (87f5c6e5)
- boolean attr directives (ng-disabled, ng-required, etc) are evaluated rather than interpolated (a08cbc02)
ng-bind-attrdirective removed (55027132)- any app that depends on $sniffer service should use Modernizr instead (aaedefb9)
1.0.0rc2 silence-absorption (2012-03-20)
Features
- $route: when matching consider trailing slash as optional (a4fe51da)
- jqLite: add .controller() method (6c5a05ad)
- scope.$eval: allow passing locals to the expression (192ff61f)
- input[type=radio]: allow the value attribute to be interpolated (ade6c452)
Bug Fixes
- $http: don't send Content-Type header when no data (1a5bebd9, #749)
- $resource: support escaping of ':' in resource url (6d6f8753)
- $compile:
- $log: avoid console.log.apply calls in IE (15213ec2, #805)
- json: added support for iso8061 timezone (5ac14f63)
- e2e runner: fix typo that caused errors on IE8 (ee5a5352, #806)
- directives:
1.0.0rc1 moiré-vision (2012-03-13)
$compile rewrite
The compiler was completely rewritten from scratch using ideas from this design document. Please check out the $compile and $compileProvider.directive docs. The biggest improvements and changes are listed below.
-
the compiler now transparently supports several directive syntaxes. For example while before there was just one way to use
ng:includedirective:<ng:include src="someSrc"></ng:include>. The new compiler treats all of the following as equivalent:<ng:include src="someSrc"></ng:include><ng-include src="someSrc"></ng-include><x-ng-include src="someSrc"></x-ng-include><div ng:include src="someSrc"></div><div ng-include src="someSrc"></div><div data-ng-include src="someSrc"></div><div ng:include="someSrc"></div><div ng-include="someSrc"></div><div data-ng-include="someSrc"></div><div class="ng-include: someSrc"></div>
This will give template creators great flexibility to consider the tradeoffs between html code validity and code conciseness and pick the syntax that works the best for them.
-
we are switching all of our code/docs/examples to use
ng-foodirective name style instead ofng:foo. The new compiler doesn't distinguish between these and other name styles (all of them are equally supported), the main difference is thatng-foois easier to select with css selectors. Check out the Internet Explorer Compatibility doc to learn about various IE-related requirements for different directive naming styles. -
angular.directive,angular.widget,angular.attrWidgetwere merged into a single concept: adirectivewhich is registered via myModule.directive or $compileProvider.directive. You can control execution priority of multiple directives on the same element (previously the main difference between a attribute widget and a directive) via a directive priority setting. -
previously the linking functions of directives were called top to bottom following the DOM tree, to enable a linking fn to work child DOM nodes that were already processed by child linking fns the order was changed as follows: compile functions run top to bottom following the DOM tree, but linking functions run bottom-up following the DOM tree. In some rare cases it is desirable for linking fns to be called top to bottom and for these it is possible to register "prelinking" functions (check out the docs for the return value of the compile function).
-
angular.markupandangular.attrMarkupwere replaced with interpolation via$interpolateservice.-
In the past
{{foo}}markup was getting translated to<span ng-bind="foo"></span>during the early stage of template compilation. Addition of this extra node was in some cases undesirable and caused problems. The new compiler with the help of the $interpolate service removes the need for these artificial nodes. -
As a side-effect of not using artificial nodes available for all bindings, the
htmlfilter which used to innerHTML (sanitized) html into the artificial node was converted into a directive. So instead of{{ someRawHtml | html }}use<div ng-bind-html="someRawHtml"></div>and instead of{{ someRawHtml | html:"unsafe" }}use<div ng-bind-html-unsafe="someRawHtml"></div>. Please check out the ng-bind-html and ng-bind-html-unsafe directive docs. -
Custom markup has been used by developers only to switch from
{{ }}markup to(( ))or something similar in order to avoid conflicts with server-side templating libraries. We made it easier to do this kind of customization by making the start and end symbol of the interpolation configurable via $interpolateProvider.
-
-
template loader loads template fragments from script elements and populates the $templateCache with them. Templates loaded in this way can be then used with
ng-include,ng-viewas well as directive templates (see thetemplateUrlproperty of the directive config object).
Forms / input controls / two-way data binding
The implementation of forms and input bindings was modified to address issues around composability, ease of adding custom validation and formatting. Please check out the forms dev guide article to learn about forms, form control bindings and input validation. The biggest changes are listed below.
-
any directive can add formatter/parser (validators, convertors) to an input type. This allows better composability of input types with custom validators and formatters. So instead of creating new custom input type for everything, it's now possible to take existing input type and add an additional formatter and/or validator to it via a custom directive.
-
inputs propagates changes only on the blur event by default (use new
ng-model-instantdirective if you want to propagate changes on each keystroke). -
no more custom input types, use directives to customize existing types.
-
removed $formFactory.
-
removed parallel scope hierarchy (forms, widgets).
-
removed
listinput type (useng-listdirective instead). -
removed integer input type.
Controller-scope separation
Controllers are now standalone objects, created using the "new" operator, and not mixed with scope object anymore. This addresses many issues including: #321 and #425.
The design doc explains the reasoning for this major change and how it solves many issues.
Before:
function MyCtrl() {
var self = this;
this.model = 'some model of any type';
this.fnUsedFromTemplate = function() {
someApiThatTakesCallback(function callbackFn() {
self.model = 'updatedModel';
});
};
}
After:
function MyCtrl($scope) {
$scope.model = 'some model of any type';
$scope.fnUsedFromTemplate = function() {
someApiThatTakesCallback(function() {
$scope.model = 'updatedModel';
});
}
}
Temporary backwards compatibility: Load the following module in your app to recreate the previous behavior and migrate your controllers one at a time: https://gist.github.com/1649788
$route service changes
-
As advertised in the past we moved the $route configuration from the run phase of the application to the config phase. This means that instead of defining routes via
$route.when/$route.otherwiseyou should use$routeProvider.when/$routeProvider.otherwiseinstead. -
route scope is now being created by the
ng-viewrather than by$route, this resolved many issues we've previously faced. For more info, read the commit message. -
removed
$route.parent()- it's unnecessary because the scope is properly created in the scope hierarchy byng-view. -
new
$viewContentLoadedand$includeContentLoadedevents which directives can use to be notified when a template content is (re)loaded. -
ng-viewnow hasonloadattribute which behaves similarly to the one onng-include.
Directives
ng-modelbinding on select[multiple] element should support binding to an array (commit)- event object is now accessible as
$eventinng-clickand other directives (commit, issue #259 ng-classdirective now support map of classnames and conditions e.g.<div ng-class="{'hide': !visible, 'warning': isAlert()}"...(contributed by Kai Groner) (commit)
Scope changes
-
scope.$emit/$broadcastreturn the event object, add cancelled property (commit) -
scope.$new()takes one argument - a boolean indicating if the newly-created child scope should be isolated (not prototypically inheriting from the current scope). Previously the first argument was reference to the controller constructor, but because of the scope/controller separation the controllers should be instantiated via the$controllerservice. (commit) -
fn signature change for change listener functions registered via
scope.$watch- this means that the scope object can be listed in the arguments list only if its needed and skipped otherwise. (commit)- before:
scope.$watch('someModel', function(scope, newVal, oldVal) {}) - after:
scope.$watch('someModel', function(newVal, oldVal, scope) {})
- before:
-
scope.$watchnow compares object by reference and only if extra boolean flag is passed comparison by equality is used. This was done to avoid unintended performance issues. (commit)- before:
scope.$watch('expression', function(scope, newVal, oldVal) {}) - after:
scope.$watch('expression', function(newVal, oldVal, scope) {}, true)
- before:
-
scope.$destroydoesn't cause the$destroyevent to be emitted any more - this event was primarily used by the old forms implementation and is not needed any more. We are considering broadcasting this event in the future, which could then be used by directives and child scopes to be notified of their scope destruction.
New directives:
$injector / modules
$injector.instantiateshould return the object returned from constructor if one was returned (commit)$injector.instantiateshould support array annotations for Type argument (e.g. instantiate(['dep1', 'dep2', Type])) (commit)- quickly fail if circular dependencies are detected during instantiation (commit)
- added $provide.constant to enable registration of constants that are available in both the config and run phase (commit)
$provide.servicewas renamed to $provide.provider (commit)$provide.servicetakes a constructor fn and creates a service instance by using $injector.instantiate
New services:
jqLite (angular.element)
- added
contents()(commit) - added
wrap()(commit) - fix memory leaking in IE8 (remove monkey patched methods on Event) (commit, commit)
Docs
Small bug fixes
- fix incorrect comparison of dates by angular.equals (commit)
scope.$watchsupport watching functions (commit, commit)$httpshould not json-serialize File objects, instead just send them raw (commit)$compileshould ignore content of style and script elements (commit, commit)TzDate#getDay()should take into account the timezone offset (contributed by Stephane Bisson) (commit)
Small features
$parseservice now supports local vars in expressions (commit)
0.10.6 bubblewrap-cape (2012-01-17)
Features:
- Dependency injection subsystem rewrite. This is a huge change to the Angular core that was necessary for many reasons. Please read the full design doc to understand the changes and reasoning behind them.
- Added angular.bootstrap for manual bootstrapping of the app. Also see Initializing Angular App doc.
- Helper functions inject and module that make testing with DI and jasmine a lot easier.
- jqLite and jQuery were extended with helper method
injector()that simplifies the access to the application injector during debugging. - Rewrite of $xhr service and its dependencies, which was replaced with $http service. The $browser.xhr and its mock were replaced by $httpBackend and its unit testing and end-to-end testing mocks. The $resource service api and functionality was preserved, with the exception of caching, which is not happening automatically as it used it in the past (verifyCache has no effect).
- $q - Q-like deferred/promise implementation (commit)
- Transparent data-binding to promises in templates. Example (commit)
- New $anchorScroll service that watches url hash and navigates to the html anchor even if the content was loaded via ng:view (for ng:include you have to opt into this behavior using autoscroll attribute)
- New LRU cache factory - $cacheFactory service
- jQuery 1.7 compatibility
Bug Fixes:
- Directive names are now case insensitive (commit)
- $location#url setter fix (Issue #648)
- ng:include - prevent race conditions by ignoring stale http callbacks (commit)
- ng:repeat - support repeating over array with null (commit)
- angular.copy - throw Error if source and destination are identical (commit)
- Forms should not prevent POST submission if the action attribute is present (commit)
Breaking Changes:
- App bootstrapping works differently (see angular.bootstrap and ng:app and bootstrapping)
- scope.$service is no more (because injector creates scope and not the other way around), if you really can't get services injected and need to fetch them manually then, get hold of $injector service and call $injector.get('serviceId')
- angular.service style service registration was replaced with module system, please see angular.module api and DI documentation for more info.
- the $xhr service was replaced with $http with promise based apis.
- unit-testing $httpBackend's expect method (the replacement for $browser.xhr.expect) is stricter - the order of requests matters and a single request expectation can handle only a single request.
- compiler
- compiler is a service, so use $compile instead of angular.compile to compile templates
- $compile (nee angular.compile) returns the linking function which takes one mandatory argument - the scope. previously this argument was optional and if missing, the compiler would create a new root scope, this was a source of bugs and was removed
- filters
- filters need to be registered either via moduleName.filter or $filterProvider.filter
- filters don't have access to the dom element
- currency filter doesn't make negative values red
- json filter doesn't print out stuff in monospace
- type augmentation via angular.Array, and angular.Object is gone. As a replacement use filters (filter, limitTo, orderBy), ES5 apis (e.g. Array#indexOf), or create custom filters (e.g. as a replacement for $count and $sum).
- $browser.defer.flush now throws an exception when queue is empty (commit)
- scope.$apply and scope.$digest throws an exception if called while $apply or $digest is already in progress (this is a programming error, you should never need to do this) (commit)
0.10.5 steel-fist (11-11-08)
Features:
- ng:autobind: drop angular.js file name restrictions (commit)
- Scope: better logging of infinite digest error (commit, issue #621)
- enable widget styling in IE8 and below using html5shiv-like approach (commit, issue #584)
- ng:style: compatibility + perf improvements (commit)
Bug Fixes:
- ng:view: ignore stale xhr callbacks - fixes issues caused by race-conditions which occured when user navigated to a new route before the current route finished loading (issue #619)
- ng:form should always be a block level (css) element (commit)
- Fixes for e2e test runner's
$locationdsl (commit) - ng:repeat when iterating over arrays ignore non-array properties + when iterating over objects sort keys alphabetically (commit)
Docs:
- experimental disqus.com integration for all docs-next.angularjs.org pages (commit, contributed by Dan Doyon)
- e2e test runner docs were moved to the dev guide
0.10.4 human-torch (2011-10-22)
Features:
- New validation options for
input widgets:
ng:minlengthandng:maxlength(commit) (contributed by Konstantin Stepanov) - HTML sanitizer was updated to recognize all safe HTML5 elements (Issue #89)
- ng:options' blank option is now compiled and data-bound as any other template (Issue #562) (contributed by tehek)
- $defer service now exposes
cancelmethod for task cancellation (commit)
Bug Fixes:
- ng:options should select correct element when '?'-option (invalid value) was previously selected (Issue #599) (contributed by Tehek)
- Fix data-binding of radio button's value property (Issue #316)
- Input with type
passwordshould no be turned into a readable text field (commit) (contributed by Konstantin Stepanov) - ng:repeat should ignore object properties starting with
$(commit) - Correctly parse out inlined regexp from the input field's
ng:patternattribute. (commit) - $location service in html5 mode should correctly rewrite links that contain nested elements (commit)
Breaking Changes:
- the date filter now uses 'mediumDate' format if none is specified. This was done to deal with browser inconsistencies (each browser used to use different format) (Issue #605, commit, commit)
- calling the linker function returned by angular.compile doesn't automatically run
$digeston the linked scope any more. This behavior was briefly introduced in 0.10.3 but was causing issues and inefficiencies in production apps so we reverted it. See: commit
0.10.3 shattering-heartbeat (2011-10-13)
Features:
-
New forms, validation, support for HTML5 input widgets. Please check out:
-
ng:repeat now has element-model affinity, which makes it more friendly to third-party code that is not aware of angular's DOM manipulation. This is also the pre-requisite for supporting animations. (commit)
Bug Fixes:
- The select widget with ng:options directive now correctly displays selected option (regression from 0.10.2).
- Fix for jqLite's removeClass, which under certain circumstances could clobber class names. (commit)
- Other small fixes and documentation improvements.
Breaking Changes:
- Due to changes in how forms and validation works the following were replaced with new apis:
angular.formatter- useangular.inputTypeor form's$createWidgetangular.validator- useangular.inputTypeor form's$createWidget- changes to
<input>and<select>elementsng:modeldirective is now required for data-binding to kick in- the
nameattribute is now optional and is used only as an alias when accessing the input widget via the form object. - view can't affect the model without a user interaction, so the
valueattribute of the<input>element andselectedattribute of the<option>element if specified in the template is ignored.
- Removed decoration of DOM elements when:
- an exception occurs - when an exception happens, it will be passed to the $exceptionHandler service, which can decide what to do with it.
- an input widget contains invalid input - in this case the forms validation apis can be used to display a customized error message.
- The $hover service was removed (it was needed only for the DOM decoration described above).
0.10.2 sneaky-seagull (2011-10-08)
Features:
Bug Fixes:
- Added support for short-circuiting of && and || operators in in angular expressions (Issue #433)
- Fix for $limitTo to properly handle excessive limits (contributed by tehek) (Issue #571)
- jqLite's css() method now converts dash-separated css property names to camelCase in order to support dash-separated properties on Firefox (Issue #569)
- action defaults for $resources now take precedence over resource defaults (contributed by Marcello Nuccio) (commit)
- Fixed escaping issues in $route matcher (commit)
- Fixed two issues in $browser.defer.cancel mock (commit, commit)
- Fix for ng:options, which under certain circumstances didn't select the right option element (commit)
Docs:
Breaking Changes
- If Angular is being used with jQuery older than 1.6, some features might not work properly. Please upgrade to jQuery version 1.6.4.
Breaking Changes
- ng:repeat no longer has ng:repeat-index property. This is because the elements now have affinity to the underlying collection, and moving items around in the collection would move ng:repeat-index property rendering it meaningless.
0.10.1 inexorable-juggernaut (2011-09-09)
Features
- complete rewrite of the $location service with HTML5 support, many API and semantic changes.
Please see:
- $location service API docs
- $location service dev guide article
- location.js source file
- breaking changes section of this changelog
Bug Fixes
- $xhr should not covert HTTP status 0 to 200 (commit)
- fixed several doc examples that were broken on IE
- ng:change should be called after the new val is set (Issue #547)
- currency filter should return an empty string for non-numbers
Breaking Changes
- $location related changes - for complete list of api changes see:
Migrating from earlier AngularJS releases
-
$location api changes:
- $location.href -> $location.absUrl()
- $location.hash -> $location.url()
- $location.hashPath -> $location.path()
- $location.hashSearch -> $location.search()
- $location.search -> no equivalent, use $window.location.search (this is so that we can work in hashBang and html5 mode at the same time, check out the docs)
- $location.update() / $location.updateHash() -> use $location.url()
- n/a -> $location.replace() - new api for replacing history record instead of creating a new one
-
$location semantic changes:
- all url pieces are always in sync ($location.path(), $location.url(), $location.search(), ...) - this was previously true only if you used update* methods instead of direct assignment ($location.hashPath = 'foo')
- we now use (window.history.pushState || onHashChange event || polling) for detecting url changes in the browser (we use the best one available).
-
0.10.0 chicken-hands (2011-09-02)
Features
- complete rewrite of the Scope implementation with several API and semantic changes. Please see:
- angular.scope API docs
- scopes dev guide article
- scope.js source file
- breaking changes section of this changelog
- added event system to scopes (see $on, $emit and $broadcast)
- added i18n and l10n support for date, currency and number filters see i18n docs for more info
- added localizable ng:pluralize widget
- added ng:cloak directive for hiding uncompiled templates
Bug Fixes
- make ng:class friendly towards other code adding/removing classes (commit)
- several jqLite bugfixes and improvements
- ng:href, ng:src and friends now work properly when no expression is present in the attribute value. (Issue #534)
- expose missing lowercase, uppercase and isDate APIs.
Docs
- many (but not all just yet) api docs were proof-read and improved
Breaking Changes:
- many scope related changes:
- $onEval is no more (use $watch with a fn as the only param if you really miss it)
- $eval without params doesn't trigger model mutation observations (use $apply/$digest instead)
- $digest propagates through the scope tree automatically (this is the desired behavior anyway)
- $watch various API changes
- scope is now the first argument passed into the $watch listener
thisin the $watch listener is undefined instead of current scope- objects and arrays are watched and compared by equality and not just identity
- the initial execution of the $watch listener now executes asynchronously with respect to the code registering it via $watch
- exceptionHandler argument is no more
- initRun argument is no more
- angular.scope does not create child scopes by taking parent as the first argument - use $new instead
- scope.$set and scope.$get were removed, use direct property assignment instead or $eval
- $route.onChange was removed and replaced with $beforeRouteChange, $afterRouteChange and $routeUpdate events that can be used together with the new $routeParams service
angular.equals()now uses===instead of==when comparing primitives
0.9.19 canine-psychokinesis (2011-08-20)
Features
- added error handling support for JSONP requests (see error callback param of the $xhr service) (commit)
- exposed http response headers in the $xhr and $resource callbacks (commit contributed by Karl Seamon)
- added
reloadOnSearch$route param support to prevent unnecessary controller reloads and resulting flicker (commit)
Bug Fixes
- fixed memory leak found in ng:options directive (commit)
- make ng:class-even/odd compatible with ng:class (Issue #508)
- fixed error handling for resources that didn't work in certain situations (commit contributed by Karl Seamon)
Docs
- jsFiddle integration for all docs.angularjs.org examples (contributed by Dan Doyon).
Breaking Changes
- removed jqLite show/hide support. See the
commit
message for details. Developers should use jquery or jqLite's
css('display', 'none')andcss('display', 'block'/'inline'/..)instead
0.9.18 jiggling-armfat (2011-07-29)
Features
- ECMAScript 5 Strict Mode compliance
- jqLite
- added
show(),hide()andeq()methods to jqlite (commit)
- added
- added $defer.cancel to support cancelation of tasks defered via the $defer service
- date filter
- added support for
full,long,mediumandshortdate-time format flags (commit) - added support for
zflag, which stands for short string timezone identifier, e.g. PST - internal improvements to enable localization of date filter output
- added support for
- number filter
- internal improvements to enable localization of number filter output
- currency filter
- support for custom currency symbols via an optional param
- internal improvements to enable localization of number filter output
- added angular.version for exposing the version of the loaded angular.js file
- updated angular.js and angular.min.js file headers with angular version and shorter & updated license info
- ng:options
- $xhr and $resource support for per-request error callbacks (Issue #408) (contributed by Karl Seamon)
Bug Fixes
- make injector compatible with Rhino (HtmlUnit) (contributed by Mårten Dolk) commit
ie-compat.jsfixes and improvements related to fetching this file on the fly on legacy browsers- jqLite
- improved implementation of ng:show and ng:hide directives by using jqLite/jQuery hide and show methods
- ng:options
- fix incorrect re-growing of options on datasource change (Issue #464)
Docs
- added full offline support for docs (click on the link in the footer of docs.angularjs.org)
- many content improvements and corrections across all docs (reference api, tutorial, dev guide)
- many small design improvements
Other
- doubled our e2e test suite by running all angular e2e tests with jqLite in addition to jQuery
Breaking changes
- commit
removed support for the
MMMMM(long month name), useMMMMinstead. This was done to align Angular with Unicode Technical Standard #35 used by Closure, as well as, future DOM apis currently being proposed to w3c. $xhr.error'srequestargument has nocallbackproperty anymore, usesuccessinstead
0.9.17 vegetable-reanimation (2011-06-30)
New Features
- New ng:options directive to better bind a model to
<select>and<option>elements. - New ng:disabled, ng:selected, ng:checked, ng:multiple and ng:readonly directives.
- Added support for string representation of month and day in date filter.
- Added support for
prepend()to jqLite. - Added support for configurable HTTP header defaults for the $xhr service.
Bug Fixes
- Number filter would return incorrect value when fractional part had leading zeros.
- Issue #338: Show error when template with with multiple DOM roots is being compiled.
- Issue #399: return unsorted array if no predicate.
- Fixed issues with incorrect value of $position in ng:repeat when collection size changes.
- Fixed JSONP support in $xhr which didn't work without jquery since v0.9.13.
Documentation
- various small fixes and improvements
Breaking changes
- $service now has $service.invoke for method injection ($service(self, fn) no longer works)
- injection name inference no longer supports method curry and linking functions. Both must be explicitly specified using $inject property.
- Dynamic iteration (ng:repeat) on
<option>elements is no longer supported. Use ng:options - Removal of index formatter (
ng:format="index") since its only use was with repeated<options>(see above). - Calling $orderBy without a predicate now returns the original unsorted array, instead of ordering by natural order.
0.9.16 weather-control (2011-06-07)
Features
- JsTD Scenario Adapter for running scenario tests with jstd (from command line and in multiple browsers)
Documentation
- brand new template for http://docs.angularjs.org/
- brand new tutorial that describes how to build a typical angular app http://docs.angularjs.org/#!/tutorial
- lots of new content for the dev guide (still work in progress) http://docs.angularjs.org/#!/guide
Bug Fixes
- ng:href produces unclickable links on IE7 #352
- IE 8 in compatibility mode breaks routing #353
- IE translates a 204 response code to 1223 #357
- Fixed unit test in IE7 #360
- Fixed unit tests on FF4, Opera #364
- Fixed opera date.toISOString issue #367
Breaking changes
- html scenario runner requires ng:autotest script attribute to start tests automatically (example)
0.9.15 lethal-stutter (2011-04-11)
Features
- IE9 support
Bug Fixes
- reverted ng:view sync cache fix due to regression in the order of initialization of parent
and child controllers. (commits
9bd2c396and3d388498) - $resource success callback is now executed whenever the http status code is
<200,300>
Docs
- fixed intentation code that caused some of the snippets on docs.angularjs.org to be mangled.
- many small improvements of the api docs.
0.9.14 key-maker (2011-04-01)
Performance
- ng:repeat grows (adds children) significantly faster. (commit
15ec78f5) - $xhr.cache optionally executes callbacks synchronously. (commit
c06c5a36) - ng:view and ng:include use sync $xhr.cache
Bug Fixes
House cleaning
- code cleanup
- better minification (min is now 2.5% or almost 1kb smaller)
- minor documentation fixes
- JsTestDriver 1.3.2 upgrade with fixed coverage support
0.9.13 curdling-stare (2011-03-13)
New Features
- Added XSRF protection for the $xhr service. (commit
c578f8c3) - Targeted auto-bootstrap – ng:autobind now takes an optional value which specifies an element id
to be compiled instead of compiling the entire html document. (commit
9d5c5337)
Bug Fixes
- Fixed IE7 regression which prevented angular from bootstrapping in this browser.
- Cookies which contain unescaped '=' are now visible via the $cookies service. (commit
26bad2bf) - $xhr service now executes "success" callback for all 2xx responses, not just 200.
(commit
5343deb3) - Always remove the script tag after successful JSONP request. (commit
0084cb5c) - Removal of all
document.writestatements to make angular compabile with async script loaders. (commit3224862a)
Breaking changes
- The
postparameter of [$browser.xhr][$browser] is now non-optional. Since everyone should be using the $xhr service instead of $browser.xhr, this should not break anyone. If you do use $browser.xhr then just add null for the post value argument where post was not passed in.
0.9.12 thought-implanter (2011-03-03)
API
- Added a delay parameter to the $defer service. (commit
edbe9d8c) - Added
scope()method to angular.element (jQuery) instances to retrieve a scope associated with a given DOM element. (commit0a5c00ab) - Added inference of DI dependencies from function signature. This feature is experimental, check
out dependency injection docs. (commit
7d4aee31)
New Features
- Angular now correctly recognizes and uses jQuery even if it was loaded after angular's script.
More info at angular.element. (commit
a004d487) - All built-in angular services are now lazy-loaded. (commit
a070ff5a) - To make styling of custom html tags created via widgets and directives
easier, all of these elements now contain a css class with name in form of
<namespace>-<directive/widget name>, e.g.<ng:include class="ng-include">. (commitc7998f5f) - $xhr service now automatically detects and strips google-style JSON security prefix from http
responses. (commit
cd139f57)
Bug Fixes
- Rewrite of JQuery lite implementation for better supports operations on multiple nodes when
matched by a selector and remove other bugs. (commit
00cc9eb3) - Corrected an issue where properties inherited from __proto__ show up in ng:repeat.
(commit
9e67da42) - Fixed url encoding issue affecting $resource service. (commits
e9ce2259+9e30baad) - Removed
$eval()call from the $cookies factory function, which was causing duplicate instances of singleton services to be created. (commit65585a2d)
Docs
- New docs contribution guidelines.
- New description of release artifacts.
- Lots of improvements and other new content.
Breaking changes
-
Removed the
$init()method that used to be called after compilation of a template. This should affect only fraction of angular apps because the api was primarily being used by low level widgets tests.The old way of compiling the DOM element was angular.compile(element).$init(); The $init was there to allow the users to do any work to the scope before the view would be bound. This is a left over from not having proper MVC. The new recommended way to deal with initializing scope is to put it in the root constructor controller. To migrate simply remove the call to $init() and move any code you had before $init() to the root controller.
(commit
23b255a8) -
Changed angular.compile API from
angular.compile(element[, scope])toangular.compile(element)([scope], [cloneAttachFn])(commitsef4bb28b+945056b1) -
Removed ng:watch directives since it encourages logic in the UI. (commit
87cbf9f5)
0.9.11 snow-maker (2011-02-08)
Documentation
- completed migration of docs from the wiki site to http://docs.angularjs.org/
- many, but by far not all, docs were updated, improved and cleaned up
Features
- $route service now supports these features:
- route not found handling via
#otherwise() - redirection support via
#when('/foo', {redirectTo: '/bar'})(including param interpolation) - setting the parent scope for scopes created by the service via
#parent() - reloading the current route via
#reload()
- route not found handling via
API
- added
angular.element(...).scope()method to retrieve scope for a given element.
Bug Fixes
- value attribute gets clobbered when the element contains new line character(s).
- ng:view widget now works when nested inside an ng:include widget
- other various small fixes
Breaking changes
- mock
$browsernow throws an exception if theflush()method is called when there are no requests to be flushed. If you experienceNo xhr requests to be flushed!errors in your tests, it's because you called$browser.xhr.flush()unexpectedly. To make the error go away, either make sure your code makes a request via the$xhrservice or remove all unneededflush()calls.
0.9.10 flea-whisperer (2011-01-26)
Features
- new
ng:viewwidget to simplify integration with the$routeservice - the content of all standard HTML widgets is now being processed
(e.g.
<button>{{foo}}</button>works now) (commit1d7b9d56) - new
$logand$exceptionHandlerservice mocks now part ofangular-mocks.js(commitf5d08963)
Bug Fixes
- (one/multiple) could not chose from a list of objects (commit
347be5ae) null and other falsy values should not be rendered in the view (issue #242) Docs rewrite of several major portions of angular.service., angular.Array., angular.Object.* docs added support for [sitemap]((http://docs.angularjs.org/sitemap.xml) to make the docs indexable by search crawlers transition of Developer Guide docs from the wiki into docs.angularjs.org lots of improvements related to formatting of the content of docs.anguarjs.org 0.9.9 time-shift (2011-01-13) Security Added a just in case security check for JSON parsing. (commit5f080193) Completed security review with the Google Security Team. Performance $location and $cookies services are now lazily initialized to avoid the polling overhead when not needed. $location service now listens for onhashchange events (if supported by browser) instead of constant polling. (commit16086aa3) input widgets known listens on keydown events instead of keyup which improves perceived performance (commit47c454a3) angular boots significantly sooner by listening for DOMContentLoaded event instead of window.load when supported by browser (commitc79aba92) new service $updateView which may be used in favor of $root.$eval() to run a complete eval on the entire document. This service bulks and throttles DOM updates to improve performance. (commit47c454a3) Docs Major improvements to the doc parser (commit4f22d686) Docs now offline enabled (all dependencies are bundled in the tarball) (commit4f5d5029) Added support for navigating the docs app with keyboard shortcuts (tab and ctrl+alt+s) Bugfixes angular.Object.equals now properly handless comparing an object with a null (commitb0be87f6) Several issues were addressed in the $location service (commit23875cb3) angular.filter.date now properly handles some corner-cases (issue #159 - fix contributed by Vojta) Breaking changes API for accessing registered services — scope.$inject — was renamed to scope.$service. (commitb2631f61) Support for eager-published services was removed. This change was done to make explicit dependency declaration always required in order to allow making relatively expensive services lazily initialized (e.g. $cookie, $location), as well as remove 'magic' and reduce unnecessary scope namespace pollution. (commit3ea5941f) Complete list of affected services: $location $route $cookies $window $document $exceptionHandler $invalidWidgets To temporarily preserve the 'eager-published' status for these services, you may use ng:init (e.g. ng:init="$location = $service('$location'), ...) in the view or more correctly create a service like this: angular.service('published-svc-shim', function($location, $route, $cookies, $window, $document, $exceptionHandler, $invalidWidgets) { this.$location = $location; this.$route = $route; this.$cookies = $cookies; this.$window = $window; this.$document = $document; this.$exceptionHandler = $exceptionHandler; this.$invalidWidgets = $invalidWidgets; }, {$inject: ['$location', '$route', '$cookies', '$window', '$document', '$exceptionHandler', '$invalidWidgets'], $eager: true}); In the light of the eager-published change, to complete the cleanup we renamed $creation property of services to $eager with its value being a boolean. To transition, please rename all $creation: 'eager' declarations to $eager: true. (commit1430c6d6) angular.foreach was renamed to angular.forEach to make the api consistent. (commit0a6cf70d) The toString method of the angular.service.$location service was removed. (commit23875cb3) 0.9.8 astral-projection (2010-12-23) Docs/Getting started angular-seed project to get you hacking on an angular apps quickly https://github.com/angular/angular-seed Performance Delegate JSON parsing to native parser (JSON.parse) if available Bug Fixes Ignore input widgets which have no name (issue #153) 0.9.7 sonic-scream (2010-12-10) Bug Fixes $defer service should always call $eval on the root scope after a callback runs (issue #189) fix for failed assignments of form obj[0].name=value (issue #169) significant parser improvements that resulted in lower memory usage (commit23fc73081f) Docs small docs improvements (mainly docs for the $resource service) Breaking changes Angular expressions in the view used to support regular expressions. This feature was rarely used and added unnecessary complexity. It not a good idea to have regexps in the view anyway, so we removed this support. If you had any regexp in your views, you will have to move them to your controllers. (commite5e69d9b90) 0.9.6 night-vision (2010-12-06) Security several improvements in the HTML sanitizer code to prevent code execution via hrefs and other attributes. Commits:41d59388832bbced212eDocs set up http://docs.angularjs.org domain, the docs for the latest release will from now on be deployed here. docs app UI polishing with dual scrolling and other improvements Bug Fixes select widget now behaves correctly when it's option items are created via ng:repeat (issue #170) fix for async xhr cache issue #152 by adding $browser.defer and $defer service Breaking Changes Fix for issue #152 might break some tests that were relying on the incorrect behavior. The breakage will usually affect code that tests resources, xhr or services/widgets build on top of these. All that is typically needed to resolve the issue is adding a call to $browser.defer.flush() in your test just before the point where you expect all cached resource/xhr requests to return any results. Please see011fa39c2afor more info. The HTML sanitizer is slightly more strinct now. Please see info in the "Security" section above. 0.9.5 turkey-blast (2010-11-25) Docs 99% of the content from the angular wiki is now in the docs Api added angular.Array.limitTo to make it easy to select first or last few items of an array 0.9.4 total-recall (2010-11-18) Docs searchable docs UI improvements we now have ~85% of the wiki docs migrated to ng docs some but not all docs were updated along the way Api ng:include now supports onload attribute (commitcc749760) Misc Better error handling - compilation exception now contain stack trace (commitb2d63ac4) 0.9.3 cold-resistance (2010-11-10) Docs prettier docs app with syntax highlighting for examples, etc added documentation, examples and scenario tests for many more apis including: all directives all formatters all validators some widgets Api date filter now accepts strings that angular.String.toDate can convert to Date objects angular.String.toDate supports ISO8061 formated strings with all time fractions being optional ng:repeat now exposes $position with values set to 'first', 'middle' or 'last' ng:switch now supports ng:switch-default as fallback switch option Breaking changes we now support ISO 8601 extended format datetime strings (YYYY-MM-DDTHH:mm:ss.SSSZ) as defined in EcmaScript 5 throughout angular. This means that the following apis switched from YYYY-MM-DDTHH:mm:ssZ to YYYY-MM-DDTHH:mm:ss.SSSZ (note the added millis) when representing dates: angular.Date.toString angular.String.fromDate JSON serialization and deserialization (used by json filter, $xhr and $resource) removed SSN validator. It's unlikely that most people will need it and if they do, it can be added simple RegExp validator. 0.9.2 faunal-mimicry (2010-11-03) Docs created documentation framework based on jsdoc syntax (commit659af29a) jsdoc parser template generator json generator angular doc viewer app scenario runner for all example code documentation for all angular filters (commits1fe7e3a1&1ba8c2a33) docs example code scenario tests for example code Testability Scenario Runner binding DSL in Scenario can now match bindings without specifying filters dsl statements now accept a label argument to make test output more readable (issue #94) dsl element() statement now implements most of the jQuery API (issue #106) new browser() dsl statement for getting info about the emulated browser running the app (issue #109) scenario runner is now compatible with IE8 (issue #93) scenarior runner checks if URL would return a non-success status code (issue #100) binding() DSL now accepts regular expressions new textarea() scenario runner DSL for entering text into textareas Misc lots of small bugfixes Breaking changes Scenario Runner navigating to about:blank is no longer supported. It results in a sandbox error navigateTo() is now browser().navigateTo(). Old code must be updated file:// URLs are no longer supported for running a scenario. You must use a web server that implements HEAD 0.9.1 repulsion-field (2010-10-26) Security added html sanitizer to fix the last few known security issues (issues #33 and #34) API new ng:submit directive for creating onSubmit handlers on forms (issue #76) the date filter now accepts milliseconds as well as date strings (issue #78) the html filter now supports 'unsafe' option to bypass html sanitization Testability lots of improvements related to the scenario runner (commit40d7e66f) Demo added a new demo application: Personal Log (src example/personalLog) Chores lots of fixes to get all tests pass on IE added TzDate type to allow us to create timezone idependent tests (issue #88) Breaking changes $cookieStore service is not globally published any more, if you use it, you must request it via $inject as any other non-global service html filter now sanitizes html content for XSS attacks which may result in different behavior 0.9.0 dragon-breath (2010-10-20) Security angular.fromJson not safer (issue #57) readString consumes invalid escapes (issue #56) use new Function instead of eval (issue #52) Speed css cleanup + inline all css and images in the main js (issue #64) Testability initial version of the built-in end-to-end scenario runner (issues #50, #67, #70) API allow ng:controller nesting (issue #39) new built-in date format filter (issue #45) $location needs method you call on updates (issue #32) Chores release versioning + file renaming (issue #69) Breaking changes $location.parse was replaced with $location.update all css and img files were inlined into the main js file, to support IE7 and older app must host angular-ie-compat.js file Big Thanks to Our Community Contributors Vojta Jina