Skip to content
This repository has been archived by the owner on Apr 12, 2024. It is now read-only.

Commit

Permalink
chore(*): prep for 1.8.0
Browse files Browse the repository at this point in the history
  • Loading branch information
petebacondarwin committed Jun 4, 2020
1 parent 59b5651 commit 78ab691
Show file tree
Hide file tree
Showing 8 changed files with 51 additions and 26 deletions.
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ please provide the *STEPS TO REPRODUCE* and if possible a *MINIMAL DEMO* of the
https://plnkr.co or similar (you can use this template as a starting point: http://plnkr.co/edit/tpl:yBpEi4).
-->

**AngularJS version:** 1.7.x
**AngularJS version:** 1.8.x
<!-- Check whether this is still an issue in the most recent stable or in the snapshot AngularJS
version (https://code.angularjs.org/snapshot/) -->

Expand Down
24 changes: 24 additions & 0 deletions docs/content/guide/migration.ngdoc
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,30 @@ which drives many of these changes.
* Several new features, especially animations, would not be possible without a few changes.
* Finally, some outstanding bugs were best fixed by changing an existing API.

## Migrating from 1.7 to 1.8

Generally updating to 1.8.0 from 1.7.x should be a straightforward process and is highly recommended.
AngularJS 1.8 is a breaking change release from 1.7 to mitigate a security issue.

JqLite no longer turns XHTML-like strings like `<div /><span />` to sibling elements when not in XHTML
mode: `<div></div><span></span>`.
Instead it will leave the elements alone. In non-XHTML mode the browser will convert these to nested
elements: `<div><span></span></div>`.

This is a security fix to avoid an XSS vulnerability if a new jqLite element is created from a
user-controlled HTML string. If you must have this functionality and understand the risk involved
then it is posible to restore the original behavior by calling

```js
angular.UNSAFE_restoreLegacyJqLiteXHTMLReplacement();
```

But you should adjust your code for this change and remove your use of this function as soon as
possible.

Note that this only patches jqLite. If you use jQuery 3.5.0 or newer, please read the
[jQuery 3.5 upgrade guide](https://jquery.com/upgrade-guide/3.5/) for more details about the workarounds.


## Migrating from 1.6 to 1.7

Expand Down
5 changes: 3 additions & 2 deletions docs/content/misc/faq.ngdoc
Original file line number Diff line number Diff line change
Expand Up @@ -174,8 +174,9 @@ Yes, AngularJS can use [jQuery](http://jquery.com/) if it's present in your app
application is being bootstrapped. If jQuery is not present in your script path, AngularJS falls back
to its own implementation of the subset of jQuery that we call {@link angular.element jQLite}.

AngularJS 1.3 only supports jQuery 2.1 or above. jQuery 1.7 and newer might work correctly with AngularJS
but we don't guarantee that.
For AngularJS 1.8 we support jQuery 2.1+ but we suggest jQuery 3.5.1 or above to avoid a potential
security issue. Earlier versions of jQuery might work correctly with AngularJS but we don't guarantee
that.


### What is testability like in AngularJS?
Expand Down
10 changes: 5 additions & 5 deletions docs/content/misc/version-support-status.ngdoc
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ This page describes the support status of the significant versions of AngularJS.
On July 1, 2018 AngularJS entered a 3 year Long Term Support period.
</div>

Any version branch not shown in the following table (e.g. 1.6.x) is no longer being developed.
Any version branch not shown in the following table (e.g. 1.7.x) is no longer being developed.

<table class="dev-status table table-bordered">
<thead>
Expand All @@ -23,7 +23,7 @@ Any version branch not shown in the following table (e.g. 1.6.x) is no longer be
<td>Last version to provide IE 8 support</td>
</tr>
<tr class="stable">
<td><span>1.7.x</span></td>
<td><span>1.8.x</span></td>
<td>Long Term Support</td>
<td>See {@link version-support-status#long-term-support Long Term Support} section below.</td>
</tr>
Expand All @@ -36,9 +36,9 @@ On July 1st 2018, AngularJS entered a Long Term Support period.

We now focus exclusively on providing fixes to bugs that satisfy at least one of the following criteria:

* A security flaw is detected in the 1.7.x branch of the framework
* One of the major browsers releases a version that will cause current production applications using AngularJS 1.7.x to stop working
* The jQuery library releases a version that will cause current production applications using AngularJS 1.7.x to stop working.
* A security flaw is detected in the 1.8.x branch of the framework
* One of the major browsers releases a version that will cause current production applications using AngularJS 1.8.x to stop working
* The jQuery library releases a version that will cause current production applications using AngularJS 1.8.x to stop working.

AngularJS 1.2.x will get a new version if and only if a new severe security issue is discovered.

Expand Down
8 changes: 4 additions & 4 deletions docs/content/tutorial/step_09.ngdoc
Original file line number Diff line number Diff line change
Expand Up @@ -34,16 +34,16 @@ Since we are using [npm][npm] to install client-side dependencies, this step upd
"name": "angular-phonecat",
...
"dependencies": {
"angular": "1.7.x",
"angular-route": "1.7.x",
"angular": "1.8.x",
"angular-route": "1.8.x",
"bootstrap": "3.3.x"
},
...
}
```

The new dependency `"angular-route": "1.7.x"` tells npm to install a version of the angular-route
module that is compatible with version 1.7.x of AngularJS. We must tell npm to download and install
The new dependency `"angular-route": "1.8.x"` tells npm to install a version of the angular-route
module that is compatible with version 1.8.x of AngularJS. We must tell npm to download and install
this dependency.

```
Expand Down
10 changes: 5 additions & 5 deletions docs/content/tutorial/step_13.ngdoc
Original file line number Diff line number Diff line change
Expand Up @@ -32,17 +32,17 @@ Since we are using [npm][npm] to install client-side dependencies, this step upd
"name": "angular-phonecat",
...
"dependencies": {
"angular": "1.7.x",
"angular-resource": "1.7.x",
"angular-route": "1.7.x",
"angular": "1.8.x",
"angular-resource": "1.8.x",
"angular-route": "1.8.x",
"bootstrap": "3.3.x"
},
...
}
```

The new dependency `"angular-resource": "1.7.x"` tells npm to install a version of the
angular-resource module that is compatible with version 1.7.x of AngularJS. We must tell npm to
The new dependency `"angular-resource": "1.8.x"` tells npm to install a version of the
angular-resource module that is compatible with version 1.8.x of AngularJS. We must tell npm to
download and install this dependency.

```
Expand Down
16 changes: 8 additions & 8 deletions docs/content/tutorial/step_14.ngdoc
Original file line number Diff line number Diff line change
Expand Up @@ -36,20 +36,20 @@ Since we are using [npm][npm] to install client-side dependencies, this step upd
"name": "angular-phonecat",
...
"dependencies": {
"angular": "1.7.x",
"angular-animate": "1.7.x",
"angular-resource": "1.7.x",
"angular-route": "1.7.x",
"angular": "1.8.x",
"angular-animate": "1.8.x",
"angular-resource": "1.8.x",
"angular-route": "1.8.x",
"bootstrap": "3.3.x",
"jquery": "3.3.x"
"jquery": "^3.5.1"
},
...
}
```

* `"angular-animate": "1.7.x"` tells npm to install a version of the angular-animate module that
is compatible with version 1.7.x of AngularJS.
* `"jquery": "3.3.x"` tells npm to install the latest patch release of the 3.3 version of jQuery.
* `"angular-animate": "1.8.x"` tells npm to install a version of the angular-animate module that
is compatible with version 1.8.x of AngularJS.
* `"jquery": "^3.5.1"` tells npm to install a version of jQuery that is compatible with 3.5.x and at least 3.5.1.
Note that this is not an AngularJS library; it is the standard jQuery library. We can use npm to
install a wide range of 3rd party libraries.

Expand Down
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"name": "angular",
"license": "MIT",
"branchVersion": "^1.7.0",
"branchPattern": "1.7.*",
"branchPattern": "1.8.*",
"distTag": "next",
"repository": {
"type": "git",
Expand Down

0 comments on commit 78ab691

Please sign in to comment.