docs: clarify npm/yarn commands, add blank lines to mix md/html in table (#21606)
PR Close #21606
This commit is contained in:
Judy Bogart
Alex Rickabaugh
parent
1940b18124
commit
9d3326caa7
|
|
@ -6,147 +6,92 @@ Angular supports most recent browsers. This includes the following specific vers
|
|||
|
||||
<tr>
|
||||
|
||||
<th>
|
||||
<th>
|
||||
Browser
|
||||
</th>
|
||||
|
||||
<th>
|
||||
Supported versions
|
||||
</th>
|
||||
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
|
||||
<td>
|
||||
Chrome
|
||||
</th>
|
||||
</td>
|
||||
|
||||
<th>
|
||||
<td>
|
||||
latest
|
||||
</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
|
||||
<td>
|
||||
Firefox
|
||||
</th>
|
||||
</td>
|
||||
|
||||
<th>
|
||||
<td>
|
||||
latest
|
||||
</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
|
||||
<td>
|
||||
Edge
|
||||
</th>
|
||||
</td>
|
||||
|
||||
<th>
|
||||
<td>
|
||||
2 most recent major versions
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
IE
|
||||
</th>
|
||||
|
||||
<th>
|
||||
Safari
|
||||
</th>
|
||||
|
||||
<th>
|
||||
iOS
|
||||
</th>
|
||||
|
||||
<th>
|
||||
Android
|
||||
</th>
|
||||
|
||||
<th>
|
||||
</td>
|
||||
<td>
|
||||
11<br>10<br>9
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<tr>
|
||||
<td>
|
||||
IE Mobile
|
||||
</th>
|
||||
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
|
||||
<td>
|
||||
latest
|
||||
</td>
|
||||
|
||||
<td>
|
||||
latest
|
||||
</td>
|
||||
|
||||
<td>
|
||||
2 most recent major versions
|
||||
</td>
|
||||
|
||||
<td>
|
||||
11
|
||||
</td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
2 most recent major versions
|
||||
Safari
|
||||
</td>
|
||||
|
||||
<td>
|
||||
2 most recent major versions
|
||||
</td>
|
||||
|
||||
<td>
|
||||
Nougat (7.0)<br>Marshmallow (6.0)
|
||||
</td>
|
||||
|
||||
<td>
|
||||
11
|
||||
</td>
|
||||
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
|
||||
<td>
|
||||
|
||||
iOS
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
||||
2 most recent major versions
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
||||
</td>
|
||||
|
||||
<td>
|
||||
10
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
||||
</td>
|
||||
|
||||
<td>
|
||||
Lollipop<br>(5.0, 5.1)
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
||||
</td>
|
||||
|
||||
</tr>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
|
||||
<td>
|
||||
|
||||
Android
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
||||
Nougat (7.0)<br>Marshmallow (6.0)<br>Lollipop (5.0, 5.1)<br>KitKat (4.4)
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
||||
</td>
|
||||
|
||||
<td>
|
||||
9
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
||||
</td>
|
||||
|
||||
<td>
|
||||
KitKat<br>(4.4)
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
||||
</td>
|
||||
|
||||
</tr>
|
||||
</tr>
|
||||
|
||||
</table>
|
||||
|
||||
|
|
@ -184,12 +129,11 @@ This file incorporates the mandatory and many of the optional polyfills as JavaS
|
|||
|
||||
The npm packages for the _mandatory_ polyfills (such as `zone.js`) were installed automatically for you when you created your project and their corresponding `import` statements are ready to go. You probably won't touch these.
|
||||
|
||||
But if you need an optional polyfill, you'll have to install its npm package with `npm` or `yarn`.
|
||||
For example, [if you need the web animations polyfill](http://caniuse.com/#feat=web-animation), you could install it with either of the following commands:
|
||||
But if you need an optional polyfill, you'll have to install its npm package.
|
||||
For example, [if you need the web animations polyfill](http://caniuse.com/#feat=web-animation), you could install it with `npm`, using the following command (or the `yarn` equivalent):
|
||||
|
||||
<code-example language="sh" class="code-shell">
|
||||
npm install --save web-animations-js
|
||||
yarn add web-animations-js
|
||||
</code-example>
|
||||
|
||||
Then open the `polyfills.ts` file and un-comment the corresponding `import` statement as in the following example:
|
||||
|
|
@ -240,7 +184,9 @@ These are the polyfills required to run an Angular application on each supported
|
|||
</td>
|
||||
|
||||
<td>
|
||||
|
||||
[ES7/reflect](guide/browser-support#core-es7-reflect) (JIT only)
|
||||
|
||||
</td>
|
||||
|
||||
</tr>
|
||||
|
|
@ -252,7 +198,9 @@ These are the polyfills required to run an Angular application on each supported
|
|||
</td>
|
||||
|
||||
<td>
|
||||
|
||||
[ES6](guide/browser-support#core-es6)
|
||||
|
||||
</td>
|
||||
|
||||
</tr>
|
||||
|
|
@ -264,7 +212,9 @@ These are the polyfills required to run an Angular application on each supported
|
|||
</td>
|
||||
|
||||
<td>
|
||||
|
||||
[ES6<br>classList](guide/browser-support#classlist)
|
||||
|
||||
</td>
|
||||
|
||||
</tr>
|
||||
|
|
@ -302,12 +252,16 @@ Here are the features which may require additional polyfills:
|
|||
<tr style="vertical-align: top">
|
||||
|
||||
<td>
|
||||
|
||||
[JIT compilation](guide/aot-compiler).
|
||||
|
||||
Required to reflect for metadata.
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
||||
[ES7/reflect](guide/browser-support#core-es7-reflect)
|
||||
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
|
@ -320,11 +274,15 @@ Here are the features which may require additional polyfills:
|
|||
<tr style="vertical-align: top">
|
||||
|
||||
<td>
|
||||
|
||||
[Animations](guide/animations)
|
||||
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
||||
[Web Animations](guide/browser-support#web-animations)
|
||||
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
|
@ -336,11 +294,24 @@ Here are the features which may require additional polyfills:
|
|||
<tr style="vertical-align: top">
|
||||
|
||||
<td>
|
||||
If you use the following deprecated i18n pipes: [date](api/common/DeprecatedDatePipe), [currency](api/common/DeprecatedCurrencyPipe), [decimal](api/common/DeprecatedDecimalPipe) and [percent](api/common/DeprecatedPercentPipe)
|
||||
|
||||
If you use the following deprecated i18n pipes:
|
||||
|
||||
|
||||
[date](api/common/DeprecatedDatePipe),
|
||||
|
||||
[currency](api/common/DeprecatedCurrencyPipe),
|
||||
|
||||
[decimal](api/common/DeprecatedDecimalPipe),
|
||||
|
||||
[percent](api/common/DeprecatedPercentPipe)
|
||||
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
||||
[Intl API](guide/browser-support#intl)
|
||||
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
|
@ -352,11 +323,16 @@ Here are the features which may require additional polyfills:
|
|||
<tr style="vertical-align: top">
|
||||
|
||||
<td>
|
||||
[NgClass](api/common/NgClass) on SVG elements
|
||||
|
||||
[NgClass](api/common/NgClass)
|
||||
|
||||
on SVG elements
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
||||
[classList](guide/browser-support#classlist)
|
||||
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
|
@ -368,13 +344,20 @@ Here are the features which may require additional polyfills:
|
|||
<tr style="vertical-align: top">
|
||||
|
||||
<td>
|
||||
[Http](guide/http) when sending and receiving binary data
|
||||
|
||||
[Http](guide/http)
|
||||
|
||||
when sending and receiving binary data
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
||||
[Typed Array](guide/browser-support#typedarray)<br>
|
||||
|
||||
[Blob](guide/browser-support#blob)<br>
|
||||
|
||||
[FormData](guide/browser-support#formdata)
|
||||
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
|
@ -412,7 +395,9 @@ Below are the polyfills which are used to test the framework itself. They are a
|
|||
<tr>
|
||||
|
||||
<td>
|
||||
|
||||
<a id='core-es7-reflect' href="https://github.com/zloirock/core-js/blob/master/es7/reflect.js">ES7/reflect</a>
|
||||
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
|
@ -428,7 +413,9 @@ Below are the polyfills which are used to test the framework itself. They are a
|
|||
<tr>
|
||||
|
||||
<td>
|
||||
|
||||
<a id='core-es6' href="https://github.com/zloirock/core-js">ES6</a>
|
||||
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
|
@ -444,7 +431,9 @@ Below are the polyfills which are used to test the framework itself. They are a
|
|||
<tr>
|
||||
|
||||
<td>
|
||||
|
||||
<a id='classlist' href="https://github.com/eligrey/classList.js">classList</a>
|
||||
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
|
@ -460,7 +449,9 @@ Below are the polyfills which are used to test the framework itself. They are a
|
|||
<tr>
|
||||
|
||||
<td>
|
||||
|
||||
<a id='intl' href="https://github.com/andyearnshaw/Intl.js">Intl</a>
|
||||
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
|
@ -476,7 +467,9 @@ Below are the polyfills which are used to test the framework itself. They are a
|
|||
<tr>
|
||||
|
||||
<td>
|
||||
|
||||
<a id='web-animations' href="https://github.com/web-animations/web-animations-js">Web Animations</a>
|
||||
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
|
@ -492,7 +485,9 @@ Below are the polyfills which are used to test the framework itself. They are a
|
|||
<tr>
|
||||
|
||||
<td>
|
||||
|
||||
<a id='typedarray' href="https://github.com/inexorabletash/polyfill/blob/master/typedarray.js">Typed Array</a>
|
||||
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
|
@ -508,7 +503,9 @@ Below are the polyfills which are used to test the framework itself. They are a
|
|||
<tr>
|
||||
|
||||
<td>
|
||||
|
||||
<a id='blob' href="https://github.com/eligrey/Blob.js">Blob</a>
|
||||
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
|
@ -524,7 +521,9 @@ Below are the polyfills which are used to test the framework itself. They are a
|
|||
<tr>
|
||||
|
||||
<td>
|
||||
|
||||
<a id='formdata' href="https://github.com/francois2metz/html5-formdata">FormData</a>
|
||||
|
||||
</td>
|
||||
|
||||
<td>
|
||||
|
|
@ -546,7 +545,7 @@ computed with the <a href="http://closure-compiler.appspot.com/home">closure com
|
|||
{@a non-cli}
|
||||
## Polyfills for non-CLI users
|
||||
|
||||
If you aren't using the CLI, you should add your polyfill scripts directly to the host web page (`index.html`), perhaps like this.
|
||||
If you are not using the CLI, you should add your polyfill scripts directly to the host web page (`index.html`), perhaps like this.
|
||||
|
||||
<code-example title="src/index.html">
|
||||
<!-- pre-zone polyfills -->
|
||||
|
|
|
|||
Loading…
Reference in New Issue