honeymoose
/
angular-cn
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

fix: polyfills 译为腻子脚本

This commit is contained in:
Zhicheng Wang 2018-02-28 13:17:39 +08:00
parent c08a3830df
commit f248973faa
5 changed files with 36 additions and 36 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

56
aio/content/guide/browser-support.md
View File

@ -123,7 +123,7 @@ Angular 在持续集成过程中，对每一个提交都会使用 <a href="https
## Polyfills ## Polyfills
## 填充库 (polyfill) ## 腻子脚本 (polyfill)
Angular is built on the latest standards of the web platform. Angular is built on the latest standards of the web platform.
Targeting such a wide range of browsers is challenging because they do not support all features of modern browsers. Targeting such a wide range of browsers is challenging because they do not support all features of modern browsers.
@ -134,8 +134,8 @@ Angular 构建于 Web 平台的最新标准之上。
You compensate by loading polyfill scripts ("polyfills") for the browsers that you must support. You compensate by loading polyfill scripts ("polyfills") for the browsers that you must support.
The [table below](#polyfill-libs) identifies most of the polyfills you might need. The [table below](#polyfill-libs) identifies most of the polyfills you might need.
我们可以通过加载填充脚本("polyfills")来为想要支持的浏览器弥补这些特性。 我们可以通过加载腻子脚本("polyfills")来为想要支持的浏览器弥补这些特性。
[下表](#polyfill-libs) 列出了可能用到的大多数填充脚本。 [下表](#polyfill-libs) 列出了可能用到的大多数腻子脚本。
<div class="alert is-important"> <div class="alert is-important">
@ -143,34 +143,34 @@ The suggested polyfills are the ones that run full Angular applications.
You may need additional polyfills to support features not covered by this list. You may need additional polyfills to support features not covered by this list.
Note that polyfills cannot magically transform an old, slow browser into a modern, fast one. Note that polyfills cannot magically transform an old, slow browser into a modern, fast one.
这些建议的填充库是运行完整 Angular 应用所需的。 这些建议的腻子脚本是运行完整 Angular 应用所需的。
你可能还会需要另一些的填充库来支持没有出现在此列表中的哪些特性。 你可能还会需要另一些的腻子脚本来支持没有出现在此列表中的哪些特性。
注意，这些填充库并没有神奇的魔力来把老旧、慢速的浏览器变成现代、快速的浏览器，它只是填充了 API。 注意，这些腻子脚本并没有神奇的魔力来把老旧、慢速的浏览器变成现代、快速的浏览器，它只是填充了 API。
</div> </div>
## Enabling polyfills ## Enabling polyfills
## 启用填充脚本 ## 启用腻子脚本
[Angular CLI](https://github.com/angular/angular-cli/wiki) users enable polyfills through the `src/polyfills.ts` file that [Angular CLI](https://github.com/angular/angular-cli/wiki) users enable polyfills through the `src/polyfills.ts` file that
the CLI created with your project. the CLI created with your project.
[Angular CLI](https://github.com/angular/angular-cli/wiki) 的用户可以通过自动创建的 `src/polyfills.ts` 文件来启用这些填充脚本。 [Angular CLI](https://github.com/angular/angular-cli/wiki) 的用户可以通过自动创建的 `src/polyfills.ts` 文件来启用这些腻子脚本。
This file incorporates the mandatory and many of the optional polyfills as JavaScript `import` statements. This file incorporates the mandatory and many of the optional polyfills as JavaScript `import` statements.
这个文件把强制的和很多可选的填充脚本组织成 JavaScript 的 `import` 语句。 这个文件把强制的和很多可选的腻子脚本组织成 JavaScript 的 `import` 语句。
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. 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.
**强制性** 填充脚本（如`zone.js`）的npm 包在创建工程时就已经自动安装了，相应的 `import` 语句也都加好了。我们一般不用动它们。 **强制性** 腻子脚本（如`zone.js`）的npm 包在创建工程时就已经自动安装了，相应的 `import` 语句也都加好了。我们一般不用动它们。
But if you need an optional polyfill, you'll have to install its npm package. 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): 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):
但是如果要用一个可选的填充库，就要通过 `npm` 或 `yarn` 来安装它们的 npm 包了。 但是如果要用一个可选的腻子脚本，就要通过 `npm` 或 `yarn` 来安装它们的 npm 包了。
比如，[如果你需要 web 动画的填充脚本](http://caniuse.com/#feat=web-animation)，就要通过下列命令之一来安装它： 比如，[如果你需要 web 动画的腻子脚本](http://caniuse.com/#feat=web-animation)，就要通过下列命令之一来安装它：
<code-example language="sh" class="code-shell"> <code-example language="sh" class="code-shell">
# note that the web-animations-js polyfill is only here as an example # note that the web-animations-js polyfill is only here as an example
@ -193,7 +193,7 @@ Then open the `polyfills.ts` file and un-comment the corresponding `import` stat
If you can't find the polyfill you want in `polyfills.ts`, If you can't find the polyfill you want in `polyfills.ts`,
add it yourself, following the same pattern: add it yourself, following the same pattern:
如果在 `polyfills.ts` 中找不到要使用的填充脚本，就可以仿照下列模式自行添加它： 如果在 `polyfills.ts` 中找不到要使用的腻子脚本，就可以仿照下列模式自行添加它：
1. install the npm package 1. install the npm package
@ -216,11 +216,11 @@ Non-CLI users should follow the instructions [below](#non-cli).
### Mandatory polyfills ### Mandatory polyfills
### 强制性填充库 ### 强制性腻子脚本
These are the polyfills required to run an Angular application on each supported browser: These are the polyfills required to run an Angular application on each supported browser:
下表中的填充库是每个浏览器都要用到的： 下表中的腻子脚本是每个浏览器都要用到的：
<table> <table>
@ -245,7 +245,7 @@ These are the polyfills required to run an Angular application on each supported
</p> </p>
<p> <p>
需要的填充库 需要的腻子脚本
</p> </p>
</th> </th>
@ -299,20 +299,20 @@ These are the polyfills required to run an Angular application on each supported
### Optional browser features to polyfill ### Optional browser features to polyfill
### 可选浏览器特性的填充库 ### 可选浏览器特性的腻子脚本
Some features of Angular may require additional polyfills. Some features of Angular may require additional polyfills.
有些 Angular 特性可能需要额外的填充库。 有些 Angular 特性可能需要额外的腻子脚本。
For example, the animations library relies on the standard web animation API, which is only available in Chrome and Firefox today. For example, the animations library relies on the standard web animation API, which is only available in Chrome and Firefox today.
(note that the dependency of web-animations-js in Angular is only necessary if `AnimationBuilder` is used.) (note that the dependency of web-animations-js in Angular is only necessary if `AnimationBuilder` is used.)
例如，动画库依赖于标准的 web 动画 API，目前它只在 Chrome 和 Firefox 上可用。你可能需要一个填充库来在其它浏览器上使用动画功能。 例如，动画库依赖于标准的 web 动画 API，目前它只在 Chrome 和 Firefox 上可用。你可能需要一个腻子脚本来在其它浏览器上使用动画功能。
Here are the features which may require additional polyfills: Here are the features which may require additional polyfills:
下列特性可能需要更多填充库： 下列特性可能需要更多腻子脚本：
<table> <table>
@ -329,7 +329,7 @@ Here are the features which may require additional polyfills:
<th> <th>
Polyfill Polyfill
填充库 腻子脚本
</th> </th>
@ -380,7 +380,7 @@ Here are the features which may require additional polyfills:
<br>Only if `Animation Builder` is used within the application--standard <br>Only if `Animation Builder` is used within the application--standard
animation support in Angular doesn't require any polyfills (as of NG6). animation support in Angular doesn't require any polyfills (as of NG6).
<br>只有在应用中用到了 `Animation Builder` 时才需要；Angular 标准的动画支持是不需要任何填充库的（截至 NG6）。 <br>只有在应用中用到了 `Animation Builder` 时才需要；Angular 标准的动画支持是不需要任何腻子脚本的（截至 NG6）。
</td> </td>
@ -395,7 +395,7 @@ Here are the features which may require additional polyfills:
<p>If AnimationBuilder is used then the polyfill will enable scrubbing <p>If AnimationBuilder is used then the polyfill will enable scrubbing
support for IE/Edge and Safari (Chrome and Firefox support this natively).</p> support for IE/Edge and Safari (Chrome and Firefox support this natively).</p>
<p>如果使用了AnimationBuilder，那么填充库将为 IE/Edge 和 Safari 启用擦除（scrubbing）支持（Chrome 和 Firefox 原生支持此特性）</p> <p>如果使用了AnimationBuilder，那么腻子脚本将为 IE/Edge 和 Safari 启用擦除（scrubbing）支持（Chrome 和 Firefox 原生支持此特性）</p>
</td> </td>
</tr> </tr>
@ -490,11 +490,11 @@ Here are the features which may require additional polyfills:
### Suggested polyfills ## ### Suggested polyfills ##
### 建议的填充库 ## ### 建议的腻子脚本 ##
Below are the polyfills which are used to test the framework itself. They are a good starting point for an application. Below are the polyfills which are used to test the framework itself. They are a good starting point for an application.
下表中是用来测试框架本身的填充库，它们是应用程序的优质起点。 下表中是用来测试框架本身的腻子脚本，它们是应用程序的优质起点。
<table> <table>
@ -508,7 +508,7 @@ Below are the polyfills which are used to test the framework itself. They are a
</p> </p>
<p> <p>
填充库 腻子脚本
</p> </p>
</th> </th>
@ -698,11 +698,11 @@ computed with the <a href="http://closure-compiler.appspot.com/home" >closure co
{@a non-cli} {@a non-cli}
## Polyfills for non-CLI users ## Polyfills for non-CLI users
## 不使用 CLI 的用户的填充库 ## 不使用 CLI 的用户的腻子脚本
If you are not 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.
如果你不使用 CLI，就要直接把填充库添加到宿主页（`index.html`）中，就像这样： 如果你不使用 CLI，就要直接把腻子脚本添加到宿主页（`index.html`）中，就像这样：
<code-example title="src/index.html"> <code-example title="src/index.html">
&lt;!-- pre-zone polyfills --> &lt;!-- pre-zone polyfills -->

8
aio/content/guide/npm-packages.md
View File

@ -95,7 +95,7 @@ The `dependencies` section of `package.json` contains:
* **Polyfill packages**: Polyfills plug gaps in a browser's JavaScript implementation. * **Polyfill packages**: Polyfills plug gaps in a browser's JavaScript implementation.
**填充库**：填充库负责抹平不同浏览器的 JavaScript 实现之间的差异。 **腻子脚本**：腻子脚本负责抹平不同浏览器的 JavaScript 实现之间的差异。
### Angular Packages ### Angular Packages
@ -160,7 +160,7 @@ using the [JIT compiler](guide/aot-compiler).
### Polyfill packages ### Polyfill packages
### 填充包 ### 腻子脚本包
Many browsers lack native support for some features in the latest HTML standards, Many browsers lack native support for some features in the latest HTML standards,
features that Angular requires. features that Angular requires.
@ -169,8 +169,8 @@ The [Browser Support](guide/browser-support) guide explains which browsers need
how you can add them. how you can add them.
很多浏览器欠缺对 Angular 所需的某些最新 HTML 标准、特性的原生支持。 很多浏览器欠缺对 Angular 所需的某些最新 HTML 标准、特性的原生支持。
[填充库](https://en.wikipedia.org/wiki/Polyfill) 可以模拟这些缺失的特性。 [腻子脚本](https://en.wikipedia.org/wiki/Polyfill) 可以模拟这些缺失的特性。
[浏览器支持](guide/browser-support)一章中解释了哪些浏览器分别需要哪些填充库，以及如何添加它们。 [浏览器支持](guide/browser-support)一章中解释了哪些浏览器分别需要哪些腻子脚本，以及如何添加它们。
The default `package.json` installs the **[core-js](https://github.com/zloirock/core-js)** package The default `package.json` installs the **[core-js](https://github.com/zloirock/core-js)** package
which polyfills missing features for several popular browser. which polyfills missing features for several popular browser.

2
aio/content/guide/quickstart.md
View File

@ -476,7 +476,7 @@ Any files outside of this folder are meant to support building your app.
the [Browser Support guide](guide/browser-support) for more information. the [Browser Support guide](guide/browser-support) for more information.
不同的浏览器对Web标准的支持程度也不同。 不同的浏览器对Web标准的支持程度也不同。
填充库（polyfill）能帮我们把这些不同点进行标准化。 腻子脚本（polyfill）能帮我们把这些不同点进行标准化。
你只要使用`core-js` 和 `zone.js`通常就够了，不过你也可以查看[浏览器支持指南](guide/browser-support)以了解更多信息。 你只要使用`core-js` 和 `zone.js`通常就够了，不过你也可以查看[浏览器支持指南](guide/browser-support)以了解更多信息。
</td> </td>

4
aio/content/guide/upgrade.md
View File

@ -1864,7 +1864,7 @@ Now you can load Angular via SystemJS. You'll add the Angular polyfills and the
SystemJS config to the end of the `<head>` section, and then you'll use `System.import` SystemJS config to the end of the `<head>` section, and then you'll use `System.import`
to load the actual application: to load the actual application:
现在我们可以通过SystemJS加载Angular了。我们将把Angular的填充库(polyfills) 现在我们可以通过SystemJS加载Angular了。我们将把Angular的腻子脚本(polyfills)
和SystemJS的配置加到`<head>`区的末尾，然后，我们就用`System.import`来加载实际的应用： 和SystemJS的配置加到`<head>`区的末尾，然后，我们就用`System.import`来加载实际的应用：
@ -2430,7 +2430,7 @@ as well:
These files need to be copied together with the polyfills. The files the application These files need to be copied together with the polyfills. The files the application
needs at runtime, like the `.json` phone lists and images, also need to be copied. needs at runtime, like the `.json` phone lists and images, also need to be copied.
这些文件要带着相应的填充库复制到一起。应用运行时需要的文件，比如电话列表`.json`和图片，也需要复制过去。 这些文件要带着相应的腻子脚本复制到一起。应用运行时需要的文件，比如电话列表`.json`和图片，也需要复制过去。
Install `fs-extra` via `npm install fs-extra --save-dev` for better file copying, and change Install `fs-extra` via `npm install fs-extra --save-dev` for better file copying, and change
`copy-dist-files.js` to the following: `copy-dist-files.js` to the following:

2
aio/content/guide/webpack.md
View File

@ -453,7 +453,7 @@ Open a terminal window and install the npm packages.
### Polyfills ### Polyfills
### Polyfills 填充库 ### Polyfills 腻子脚本
You'll need polyfills to run an Angular application in most browsers as explained You'll need polyfills to run an Angular application in most browsers as explained
in the [Browser Support](guide/browser-support) guide. in the [Browser Support](guide/browser-support) guide.