From 545d4b6c696dbc27dc81b8791128ee4c95a84c2a Mon Sep 17 00:00:00 2001 From: Zhicheng Wang Date: Tue, 20 Mar 2018 17:09:18 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E8=87=AA=E5=8A=A8=E5=9C=A8=E4=B8=AD?= =?UTF-8?q?=E8=8B=B1=E6=96=87=E4=B9=8B=E9=97=B4=E6=B7=BB=E5=8A=A0=E7=A9=BA?= =?UTF-8?q?=E6=A0=BC=EF=BC=8C=E4=BB=A5=E6=94=B9=E5=96=84=E6=8E=92=E7=89=88?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- aio/content/guide/ajs-quick-reference.md | 270 ++-- aio/content/guide/animations.md | 90 +- aio/content/guide/aot-compiler.md | 34 +- aio/content/guide/architecture.md | 114 +- aio/content/guide/attribute-directives.md | 116 +- aio/content/guide/bootstrapping.md | 4 +- aio/content/guide/browser-support.md | 6 +- aio/content/guide/change-log.md | 136 +- aio/content/guide/cheatsheet.md | 8 +- aio/content/guide/component-interaction.md | 80 +- aio/content/guide/component-styles.md | 60 +- .../guide/dependency-injection-in-action.md | 318 ++--- .../guide/dependency-injection-pattern.md | 56 +- aio/content/guide/dependency-injection.md | 124 +- aio/content/guide/deployment.md | 72 +- aio/content/guide/displaying-data.md | 64 +- aio/content/guide/dynamic-component-loader.md | 70 +- aio/content/guide/dynamic-form.md | 46 +- aio/content/guide/form-validation.md | 52 +- aio/content/guide/forms.md | 174 +-- aio/content/guide/glossary.md | 96 +- .../hierarchical-dependency-injection.md | 54 +- aio/content/guide/http.md | 38 +- aio/content/guide/i18n.md | 68 +- aio/content/guide/language-service.md | 28 +- aio/content/guide/lifecycle-hooks.md | 222 ++-- aio/content/guide/module-types.md | 6 +- aio/content/guide/ngmodule-api.md | 6 +- aio/content/guide/ngmodule-faq.md | 262 ++-- aio/content/guide/ngmodule-vs-jsmodule.md | 4 +- aio/content/guide/ngmodules.md | 2 +- aio/content/guide/npm-packages.md | 22 +- aio/content/guide/pipes.md | 184 +-- aio/content/guide/quickstart.md | 100 +- aio/content/guide/reactive-forms.md | 450 +++---- aio/content/guide/router.md | 1110 ++++++++--------- aio/content/guide/security.md | 146 +-- aio/content/guide/set-document-title.md | 30 +- aio/content/guide/setup-systemjs-anatomy.md | 26 +- aio/content/guide/setup.md | 32 +- aio/content/guide/sharing-ngmodules.md | 2 +- aio/content/guide/singleton-services.md | 12 +- aio/content/guide/structural-directives.md | 210 ++-- aio/content/guide/styleguide.md | 202 +-- aio/content/guide/template-syntax.md | 476 +++---- aio/content/guide/testing.md | 356 +++--- aio/content/guide/typescript-configuration.md | 74 +- aio/content/guide/upgrade.md | 834 ++++++------- aio/content/guide/user-input.md | 70 +- aio/content/guide/visual-studio-2015.md | 112 +- aio/content/guide/webpack.md | 218 ++-- aio/content/marketing/docs.md | 2 +- aio/content/translations/cn/about.md | 48 +- aio/content/translations/cn/home.md | 20 +- aio/content/translations/cn/news.md | 10 +- aio/content/translations/cn/nice-angular.md | 14 +- aio/content/tutorial/toh-pt1.md | 12 +- aio/content/tutorial/toh-pt2.md | 6 +- aio/content/tutorial/toh-pt3.md | 2 +- aio/content/tutorial/toh-pt4.md | 4 +- aio/content/tutorial/toh-pt5.md | 4 +- aio/content/tutorial/toh-pt6.md | 16 +- aio/tools/translator/bin/add-spaces-all.ts | 19 + 63 files changed, 3761 insertions(+), 3742 deletions(-) create mode 100644 aio/tools/translator/bin/add-spaces-all.ts diff --git a/aio/content/guide/ajs-quick-reference.md b/aio/content/guide/ajs-quick-reference.md index eefbf49e8e..ac799d9105 100644 --- a/aio/content/guide/ajs-quick-reference.md +++ b/aio/content/guide/ajs-quick-reference.md @@ -7,12 +7,12 @@ _Angular_ is the name for the Angular of today and tomorrow. _AngularJS_ is the name for all v1.x versions of Angular. -*Angular*这个名字专指现在和未来的Angular版本，而*AngularJS*专指Angular的所有v1.x版本。 +*Angular*这个名字专指现在和未来的 Angular 版本，而*AngularJS*专指 Angular 的所有 v1.x 版本。 This guide helps you transition from AngularJS to Angular by mapping AngularJS syntax to the equivalent Angular syntax. -本章提供了一个快速的参考指南，指出一些常用的AngularJS语法及其在Angular中的等价物。 +本章提供了一个快速的参考指南，指出一些常用的 AngularJS 语法及其在 Angular 中的等价物。 **See the Angular syntax in this **. @@ -25,7 +25,7 @@ by mapping AngularJS syntax to the equivalent Angular syntax. Templates are the user-facing part of an Angular application and are written in HTML. The following table lists some of the key AngularJS template features with their equivalent Angular template syntax. -模板是Angular应用中的门面部分，它是用HTML写的。下表中是一些AngularJS中的关键模板特性及其在Angular中的等价语法。 +模板是 Angular 应用中的门面部分，它是用 HTML 写的。下表中是一些 AngularJS 中的关键模板特性及其在 Angular 中的等价语法。 @@ -71,14 +71,14 @@ The following table lists some of the key AngularJS template features with their This binds the value of the element to a property in the controller associated with this template. - 在AngularJS中，花括号中的表达式代表单向绑定。 + 在 AngularJS 中，花括号中的表达式代表单向绑定。 它把元素的值绑定到了与模板相关控制器的属性上。 When using the `controller as` syntax, the binding is prefixed with the controller alias (`vm` or `$ctrl`) because you have to be specific about the source of the binding. - 当使用`controller as`语法时，该绑定需要用控制器的别名(`vm`)为前缀，这是因为我们不得不通过它来指定绑定源。 + 当使用 `controller as` 语法时，该绑定需要用控制器的别名(`vm`)为前缀，这是因为我们不得不通过它来指定绑定源。 @@ -95,7 +95,7 @@ The following table lists some of the key AngularJS template features with their The context of the binding is implied and is always the associated component, so it needs no reference variable. - 在Angular中，花括号中的模板表达式同样代表单向绑定。 + 在 Angular 中，花括号中的模板表达式同样代表单向绑定。 它把元素的值绑定到了组件的属性上。 它绑定的上下文变量是隐式的，并且总是关联到组件。 所以，它不需要一个引用变量。 @@ -125,11 +125,11 @@ The following table lists some of the key AngularJS template features with their To filter output in AngularJS templates, use the pipe character (|) and one or more filters. - 要在AngularJS中过滤输出，使用管道字符(|)以及一个或多个过滤器。 + 要在 AngularJS 中过滤输出，使用管道字符(|)以及一个或多个过滤器。 This example filters the `title` property to uppercase. - 这个例子中把`title`属性过滤成了大写形式。 + 这个例子中把 `title` 属性过滤成了大写形式。 @@ -145,8 +145,8 @@ The following table lists some of the key AngularJS template features with their Many (but not all) of the built-in filters from AngularJS are built-in pipes in Angular. - 在Angular中，我们使用相似的语法 —— 用管道字符(|)来过滤输出，但是现在直接把它叫做**管道**了。 - 很多(但不是所有)AngularJS中的内置过滤器也成了Angular中的内置管道。 + 在 Angular 中，我们使用相似的语法 —— 用管道字符(|)来过滤输出，但是现在直接把它叫做**管道**了。 + 很多(但不是所有)AngularJS 中的内置过滤器也成了 Angular 中的内置管道。 For more information, see [Filters/pipes](guide/ajs-quick-reference#filters-pipes) below. @@ -174,7 +174,7 @@ The following table lists some of the key AngularJS template features with their Here, `movie` is a user-defined local variable. - 这里的`movie`是一个用户定义的局部变量 + 这里的 `movie` 是一个用户定义的局部变量 @@ -188,12 +188,12 @@ The following table lists some of the key AngularJS template features with their Angular has true template input variables that are explicitly defined using the `let` keyword. - Angular 有了真正的模板输入变量，它需要使用`let`关键字进行明确定义。 + Angular 有了真正的模板输入变量，它需要使用 `let` 关键字进行明确定义。 For more information, see the [ngFor micro-syntax](guide/template-syntax#microsyntax) section of the [Template Syntax](guide/template-syntax) page. - 要了解更多信息，请参见[模板语法](guide/template-syntax)中的[ngFor微语法](guide/template-syntax#microsyntax)部分。 + 要了解更多信息，请参见[模板语法](guide/template-syntax)中的[ngFor 微语法](guide/template-syntax#microsyntax)部分。 @@ -211,7 +211,7 @@ The following are some of the key AngularJS built-in directives and their equiva AngularJS 为模板提供了七十多个内置指令。 在 Angular 中，它们很多都已经不需要了，因为 Angular 有了一个更加强大、快捷的绑定系统。 -下面是一些AngularJS 中的关键指令及其在 Angular 中的等价物。 +下面是一些 AngularJS 中的关键指令及其在 Angular 中的等价物。
@@ -259,8 +259,8 @@ AngularJS 为模板提供了七十多个内置指令。 many applications bootstrap declaratively with the `ng-app` directive, giving it the name of the application's module (`movieHunter`). - 虽然可以从代码中引导Angular应用， - 但很多应用都是通过`ng-app`指令进行声明式引导的，只要给它一个应用模块的名字(`movieHunter`)就可以了。 + 虽然可以从代码中引导 Angular 应用， + 但很多应用都是通过 `ng-app` 指令进行声明式引导的，只要给它一个应用模块的名字(`movieHunter`)就可以了。 @@ -282,7 +282,7 @@ AngularJS 为模板提供了七十多个内置指令。 and the application's root component (`AppComponent`) in `app.module.ts`. Angular 没有引导指令。 - 总是要通过显式调用一个`bootstrap`函数，并传入应用模块的名字(`AppComponent`)来启动应用。 + 总是要通过显式调用一个 `bootstrap` 函数，并传入应用模块的名字(`AppComponent`)来启动应用。 @@ -307,12 +307,12 @@ AngularJS 为模板提供了七十多个内置指令。 key of the object defined as a CSS class name, and each value defined as a template expression that evaluates to a Boolean value. - 在AngularJS中，`ng-class`指令会基于一个表达式来包含/排除某些CSS类。该表达式通常是一个“键-值”型的控制对象， - 对象中的每一个键代表一个CSS类名，每一个值定义为一个返回布尔值的模板表达式。 + 在 AngularJS 中，`ng-class` 指令会基于一个表达式来包含/排除某些 CSS 类。该表达式通常是一个“键-值”型的控制对象， + 对象中的每一个键代表一个 CSS 类名，每一个值定义为一个返回布尔值的模板表达式。 In the first example, the `active` class is applied to the element if `isActive` is true. - 在第一个例子中，如果`isActive`为真，则`active`类被应用到那个元素上。 + 在第一个例子中，如果 `isActive` 为真，则 `active` 类被应用到那个元素上。 You can specify multiple classes, as shown in the second example. @@ -329,12 +329,12 @@ AngularJS 为模板提供了七十多个内置指令。 In Angular, the `ngClass` directive works similarly. It includes/excludes CSS classes based on an expression. - 在Angular中，`ngClass`指令用类似的方式工作。 - 它根据一个表达式包含/排除某些CSS类。 + 在 Angular 中，`ngClass` 指令用类似的方式工作。 + 它根据一个表达式包含/排除某些 CSS 类。 In the first example, the `active` class is applied to the element if `isActive` is true. - 在第一个例子中，如果`isActive`为真，则`active`类被应用到那个元素上。 + 在第一个例子中，如果 `isActive` 为真，则 `active` 类被应用到那个元素上。 You can specify multiple classes, as shown in the second example. @@ -343,12 +343,12 @@ AngularJS 为模板提供了七十多个内置指令。 Angular also has **class binding**, which is a good way to add or remove a single class, as shown in the third example. - Angular还有**类绑定**，它是单独添加或移除一个类的好办法 —— 就像第三个例子中展示的。 + Angular 还有**类绑定**，它是单独添加或移除一个类的好办法 —— 就像第三个例子中展示的。 For more information see the [Attribute, class, and style bindings](guide/template-syntax#other-bindings) section of the [Template Syntax](guide/template-syntax) page. - 要了解更多信息，参见[模板语法](guide/template-syntax)中的[属性、CSS类和样式绑定](guide/template-syntax#other-bindings)部分。 + 要了解更多信息，参见[模板语法](guide/template-syntax)中的[属性、CSS 类和样式绑定](guide/template-syntax#other-bindings)部分。 @@ -369,16 +369,16 @@ AngularJS 为模板提供了七十多个内置指令。 In AngularJS, the `ng-click` directive allows you to specify custom behavior when an element is clicked. - 在AngularJS中，`ng-click`指令指定当元素被点击时的自定义行为。 + 在 AngularJS 中，`ng-click` 指令指定当元素被点击时的自定义行为。 In the first example, when the user clicks the button, the `toggleImage()` method in the controller referenced by the `vm` `controller as` alias is executed. - 在第一个例子中，如果用户点击了这个按钮，那么控制器的`toggleImage()`方法就会被执行，这个控制器是被`controller as`中指定的`vm`别名所引用的。 + 在第一个例子中，如果用户点击了这个按钮，那么控制器的 `toggleImage()` 方法就会被执行，这个控制器是被 `controller as` 中指定的 `vm` 别名所引用的。 The second example demonstrates passing in the `$event` object, which provides details about the event to the controller. - 第二个例子演示了传入`$event`对象，它提供了事件的详情，并被传到控制器。 + 第二个例子演示了传入 `$event` 对象，它提供了事件的详情，并被传到控制器。 @@ -386,14 +386,14 @@ AngularJS 为模板提供了七十多个内置指令。 ### Bind to the `click` event - ### 绑定到`click`事件 + ### 绑定到 `click` 事件 AngularJS event-based directives do not exist in Angular. Rather, define one-way binding from the template view to the component using **event binding**. - AngularJS基于事件的指令在Angular中已经不存在了。 + AngularJS 基于事件的指令在 Angular 中已经不存在了。 不过，可以使用**事件绑定**来定义从模板视图到组件的单向数据绑定。 For event binding, define the name of the target event within parenthesis and @@ -402,20 +402,20 @@ AngularJS 为模板提供了七十多个内置指令。 executes the template statement. 要使用事件绑定，把目标事件的名字放在圆括号中，并且使用等号右侧引号中的模板语句对它赋值。 - 然后Angular为这个目标时间设置事件处理器。当事件被触发时，这个处理器就会执行模板语句。 + 然后 Angular 为这个目标时间设置事件处理器。当事件被触发时，这个处理器就会执行模板语句。 In the first example, when a user clicks the button, the `toggleImage()` method in the associated component is executed. - 在第一个例子中，当用户点击此按钮时，相关组件中的`toggleImage()`方法就被执行了。 + 在第一个例子中，当用户点击此按钮时，相关组件中的 `toggleImage()` 方法就被执行了。 The second example demonstrates passing in the `$event` object, which provides details about the event to the component. - 第二个例子演示了如何传入`$event`对象，它为组件提供了此事件的详情。 + 第二个例子演示了如何传入 `$event` 对象，它为组件提供了此事件的详情。 For a list of DOM events, see: https://developer.mozilla.org/en-US/docs/Web/Events. - 要查看DOM事件的列表，请参见[网络事件](https://developer.mozilla.org/en-US/docs/Web/Events)。 + 要查看 DOM 事件的列表，请参见[网络事件](https://developer.mozilla.org/en-US/docs/Web/Events)。 For more information, see the [Event binding](guide/template-syntax#event-binding) section of the [Template Syntax](guide/template-syntax) page. @@ -442,8 +442,8 @@ AngularJS 为模板提供了七十多个内置指令。 Using the `ng-controller` (or defining the controller as part of the routing) ties the view to the controller code associated with that view. - 在AngularJS中，`ng-controller`指令把控制器附加到视图上。 - 使用`ng-controller`(或把控制器定义为路由的一部分)把视图及其控制器的代码联系在一起。 + 在 AngularJS 中，`ng-controller` 指令把控制器附加到视图上。 + 使用 `ng-controller`(或把控制器定义为路由的一部分)把视图及其控制器的代码联系在一起。 @@ -458,7 +458,7 @@ AngularJS 为模板提供了七十多个内置指令。 In Angular, the template no longer specifies its associated controller. Rather, the component specifies its associated template as part of the component class decorator. - 在Angular中，模板不用再指定它相关的控制器。 + 在 Angular 中，模板不用再指定它相关的控制器。 反过来，组件会在组件类的装饰器中指定与它相关的模板。 For more information, see [Architecture Overview](guide/architecture#components). @@ -478,7 +478,7 @@ AngularJS 为模板提供了七十多个内置指令。 In AngularJS, the `ng-hide` directive shows or hides the associated HTML element based on an expression. For more information, see [ng-show](guide/ajs-quick-reference#ng-show). - 在AngularJS中，`ng-hide`指令会基于一个表达式显示或隐藏相关的HTML元素。 + 在 AngularJS 中，`ng-hide` 指令会基于一个表达式显示或隐藏相关的 HTML 元素。 参见[ng-show](guide/ajs-quick-reference#ng-show)了解更多。 @@ -487,12 +487,12 @@ AngularJS 为模板提供了七十多个内置指令。 ### Bind to the `hidden` property - ### 绑定到`hidden`属性 + ### 绑定到 `hidden` 属性 In Angular, you use property binding; there is no built-in *hide* directive. For more information, see [ng-show](guide/ajs-quick-reference#ng-show). - 在Angular中，并没有一个内置的*hide*指令，可以改用属性绑定。 + 在 Angular 中，并没有一个内置的*hide*指令，可以改用属性绑定。 参见[ng-show](guide/ajs-quick-reference#ng-show)了解更多。 @@ -515,11 +515,11 @@ AngularJS 为模板提供了七十多个内置指令。 can replace the binding expression with the appropriate URL before the browser fetches from that URL. - `ng-href`指令允许AngularJS对`href`属性进行预处理，以便它能在浏览器获取那个URL之前，使用一个返回适当URL的绑定表达式替换它。 + `ng-href` 指令允许 AngularJS 对 `href` 属性进行预处理，以便它能在浏览器获取那个 URL 之前，使用一个返回适当 URL 的绑定表达式替换它。 In AngularJS, the `ng-href` is often used to activate a route as part of navigation. - 在AngularJS 中，`ng-href`通常用来作为导航的一部分，激活一个路由。 + 在 AngularJS 中，`ng-href` 通常用来作为导航的一部分，激活一个路由。 @@ -529,7 +529,7 @@ AngularJS 为模板提供了七十多个内置指令。 Routing is handled differently in Angular. - 路由在Angular中的处理方式不同。 + 路由在 Angular 中的处理方式不同。 @@ -537,15 +537,15 @@ AngularJS 为模板提供了七十多个内置指令。 ### Bind to the `href` property - ### 绑定到`href`属性 + ### 绑定到 `href` 属性 Angular uses property binding; there is no built-in *href* directive. Place the element's `href` property in square brackets and set it to a quoted template expression. - 在Angular中，并没有内置的*href*指令，改用属性绑定。 - 我们把元素的`href`属性放在方括号中，并把它设成一个引号中的模板表达式。 + 在 Angular 中，并没有内置的*href*指令，改用属性绑定。 + 我们把元素的 `href` 属性放在方括号中，并把它设成一个引号中的模板表达式。 For more information see the [Property binding](guide/template-syntax#property-binding) section of the [Template Syntax](guide/template-syntax) page. @@ -554,14 +554,14 @@ AngularJS 为模板提供了七十多个内置指令。 In Angular, `href` is no longer used for routing. Routing uses `routerLink`, as shown in the following example. - 在Angular中，`href`不再用作路由，而是改用第三个例子中所展示的`routerLink`指令。 + 在 Angular 中，`href` 不再用作路由，而是改用第三个例子中所展示的 `routerLink` 指令。 For more information on routing, see the [RouterLink binding](guide/router#router-link) section of the [Routing & Navigation](guide/router) page. - 要了解关于路由的更多信息，请参见[路由与导航](guide/router)的[RouterLink绑定](guide/router#router-link)部分。 + 要了解关于路由的更多信息，请参见[路由与导航](guide/router)的[RouterLink 绑定](guide/router#router-link)部分。 @@ -582,11 +582,11 @@ AngularJS 为模板提供了七十多个内置指令。 In AngularJS, the `ng-if` directive removes or recreates a portion of the DOM, based on an expression. If the expression is false, the element is removed from the DOM. - 在AngularJS中，`ng-if`指令会根据一个表达式来移除或重建DOM中的一部分。如果表达式为假，元素就会被从DOM中移除。 + 在 AngularJS 中，`ng-if` 指令会根据一个表达式来移除或重建 DOM 中的一部分。如果表达式为假，元素就会被从 DOM 中移除。 In this example, the `
` element is removed from the DOM unless the `movies` array has a length greater than zero. - 在这个例子中，除非`movies`数组的长度大于0，否则`
`元素就会被从DOM中移除。 + 在这个例子中，除非 `movies` 数组的长度大于 0，否则 `
` 元素就会被从 DOM 中移除。 @@ -599,17 +599,17 @@ AngularJS 为模板提供了七十多个内置指令。 The `*ngIf` directive in Angular works the same as the `ng-if` directive in AngularJS. It removes or recreates a portion of the DOM based on an expression. - Angular中的`*ngIf`指令与AngularJS中的`ng-if`指令一样， - 它根据表达式的值移除或重建DOM中的一部分。 + Angular 中的 `*ngIf` 指令与 AngularJS 中的 `ng-if` 指令一样， + 它根据表达式的值移除或重建 DOM 中的一部分。 In this example, the `
` element is removed from the DOM unless the `movies` array has a length. - 在这个例子中，除非`movies`数组的长度大于0，否则`
`元素就会被从DOM中移除。 + 在这个例子中，除非 `movies` 数组的长度大于 0，否则 `
` 元素就会被从 DOM 中移除。 The (*) before `ngIf` is required in this example. For more information, see [Structural Directives](guide/structural-directives). - 在这个例子中`ngIf`前的星号(*)是必须的。 + 在这个例子中 `ngIf` 前的星号(*)是必须的。 要了解更多信息，参见[结构型指令](guide/structural-directives)。 @@ -631,7 +631,7 @@ AngularJS 为模板提供了七十多个内置指令。 In AngularJS, the `ng-model` directive binds a form control to a property in the controller associated with the template. This provides **two-way binding**, whereby any change made to the value in the view is synchronized with the model, and any change to the model is synchronized with the value in the view. - 在Angular1中，`ng-model`指令把一个表单控件绑定到了模板相关控制器的一个属性上。 + 在 Angular1 中，`ng-model` 指令把一个表单控件绑定到了模板相关控制器的一个属性上。 这提供了**双向绑定**功能，因此，任何对视图中值的改动，都会同步到模型中，对模型的改动，也会同步到视图中。 @@ -645,14 +645,14 @@ AngularJS 为模板提供了七十多个内置指令。 In Angular, **two-way binding** is denoted by `[()]`, descriptively referred to as a "banana in a box". This syntax is a shortcut for defining both property binding (from the component to the view) and event binding (from the view to the component), thereby providing two-way binding. - 在Angular中，**双向绑定**使用[()]标记出来，它被形象的比作“盒子中的香蕉”。 + 在 Angular 中，**双向绑定**使用[()]标记出来，它被形象的比作“盒子中的香蕉”。 这种语法是一个简写形式，用来同时定义一个属性绑定(从组件到视图)和一个事件绑定(从视图到组件)，因此，我们得到了双向绑定。 For more information on two-way binding with `ngModel`, see the [NgModel—Two-way binding to form elements with `[(ngModel)]`](../guide/template-syntax.html#ngModel) section of the [Template Syntax](guide/template-syntax) page. - 要了解使用ngModel进行双向绑定的更多知识，参见[模板语法](guide/template-syntax)中的[NgModel—使用`[(ngModel)]`进行双向绑定](../guide/template-syntax.html#ngModel)部分。 + 要了解使用 ngModel 进行双向绑定的更多知识，参见[模板语法](guide/template-syntax)中的[NgModel—使用 `[(ngModel)]` 进行双向绑定](../guide/template-syntax.html#ngModel)部分。 @@ -673,11 +673,11 @@ AngularJS 为模板提供了七十多个内置指令。 In AngularJS, the `ng-repeat` directive repeats the associated DOM element for each item in the specified collection. - 在Angular1中，`ng-repeat`指令会为指定集合中的每一个条目重复渲染相关的DOM元素。 + 在 Angular1 中，`ng-repeat` 指令会为指定集合中的每一个条目重复渲染相关的 DOM 元素。 In this example, the table row (``) element repeats for each movie object in the collection of movies. - 在这个例子中，对`movies`集合中的每一个`movie`对象重复渲染了这个表格行元素(``)。 + 在这个例子中，对 `movies` 集合中的每一个 `movie` 对象重复渲染了这个表格行元素(``)。 @@ -692,9 +692,9 @@ AngularJS 为模板提供了七十多个内置指令。 More accurately, it turns the defined element (`` in this example) and its contents into a template and uses that template to instantiate a view for each item in the list. - Angular中的`*ngFor`指令类似于AngularJS中的`ng-repeat`指令。 - 它为指定集合中的每一个条目重复渲染了相关的DOM元素。 - 更准确的说，它把被界定出来的元素(这个例子中是``)及其内容转成了一个模板，并使用那个模板来为列表中的每一个条目实例化一个视图。 + Angular 中的 `*ngFor` 指令类似于 AngularJS 中的 `ng-repeat` 指令。 + 它为指定集合中的每一个条目重复渲染了相关的 DOM 元素。 + 更准确的说，它把被界定出来的元素(这个例子中是 ``)及其内容转成了一个模板，并使用那个模板来为列表中的每一个条目实例化一个视图。 Notice the other syntax differences: The (*) before `ngFor` is required; @@ -702,7 +702,7 @@ AngularJS 为模板提供了七十多个内置指令。 the list preposition is `of`, not `in`. 请注意其它语法上的差异： - 在`ngFor`前面的星号(*)是必须的；`let`关键字把`movie`标记成一个输入变量；列表中使用的介词是`of`，而不再是`in`。 + 在 `ngFor` 前面的星号(*)是必须的；`let` 关键字把 `movie` 标记成一个输入变量；列表中使用的介词是 `of`，而不再是 `in`。 For more information, see [Structural Directives](guide/structural-directives). @@ -729,11 +729,11 @@ AngularJS 为模板提供了七十多个内置指令。 In AngularJS, the `ng-show` directive shows or hides the associated DOM element, based on an expression. - 在AngularJS中，`ng-show`指令根据一个表达式来显示或隐藏相关的DOM元素。 + 在 AngularJS 中，`ng-show` 指令根据一个表达式来显示或隐藏相关的 DOM 元素。 In this example, the `
` element is shown if the `favoriteHero` variable is truthy. - 在这个例子中，如果`favoriteHero`变量为真，`
`元素就会显示出来。 + 在这个例子中，如果 `favoriteHero` 变量为真，`
` 元素就会显示出来。 @@ -741,24 +741,24 @@ AngularJS 为模板提供了七十多个内置指令。 ### Bind to the `hidden` property - ### 绑定到`hidden`属性 + ### 绑定到 `hidden` 属性 Angular uses property binding; there is no built-in *show* directive. For hiding and showing elements, bind to the HTML `hidden` property. - 在Angular中，并没有内置的*show*指令，可以改用属性绑定。 - 要隐藏或显示一个元素，绑定到它的`hidden`属性就可以了。 + 在 Angular 中，并没有内置的*show*指令，可以改用属性绑定。 + 要隐藏或显示一个元素，绑定到它的 `hidden` 属性就可以了。 To conditionally display an element, place the element's `hidden` property in square brackets and set it to a quoted template expression that evaluates to the *opposite* of *show*. - 要想有条件的显示一个元素，就把该元素的`hidden`属性放到一个方括号里，并且把它设置为引号中的模板表达式，它的结果应该是与*显示*时*相反*的值。 + 要想有条件的显示一个元素，就把该元素的 `hidden` 属性放到一个方括号里，并且把它设置为引号中的模板表达式，它的结果应该是与*显示*时*相反*的值。 In this example, the `
` element is hidden if the `favoriteHero` variable is not truthy. - 在这个例子中，如果`favoriteHero`变量不是真值，`
`元素就会被隐藏。 + 在这个例子中，如果 `favoriteHero` 变量不是真值，`
` 元素就会被隐藏。 For more information on property binding, see the [Property binding](guide/template-syntax#property-binding) section of the [Template Syntax](guide/template-syntax) page. @@ -785,7 +785,7 @@ AngularJS 为模板提供了七十多个内置指令。 can replace the binding expression with the appropriate URL before the browser fetches from that URL. - `ng-src`指令允许AngularJS对`src`属性进行预处理，以便它能够在浏览器获取此URL之前，用一个返回适当URL的绑定表达式替换它。 + `ng-src` 指令允许 AngularJS 对 `src` 属性进行预处理，以便它能够在浏览器获取此 URL 之前，用一个返回适当 URL 的绑定表达式替换它。 @@ -793,15 +793,15 @@ AngularJS 为模板提供了七十多个内置指令。 ### Bind to the `src` property - ### 绑定到`src`属性 + ### 绑定到 `src` 属性 Angular uses property binding; there is no built-in *src* directive. Place the `src` property in square brackets and set it to a quoted template expression. - 在Angular中，并没有一个内置的*src*指令，可以使用属性绑定。 - 把`src`属性放到方括号中，并且把它设为一个引号中的绑定表达式。 + 在 Angular 中，并没有一个内置的*src*指令，可以使用属性绑定。 + 把 `src` 属性放到方括号中，并且把它设为一个引号中的绑定表达式。 For more information on property binding, see the [Property binding](guide/template-syntax#property-binding) section of the [Template Syntax](guide/template-syntax) page. @@ -829,12 +829,12 @@ AngularJS 为模板提供了七十多个内置指令。 key of the object defined as a CSS property, and each value defined as an expression that evaluates to a value appropriate for the style. - 在AngularJS中，`ng-style`指令根据一个绑定表达式设置一个HTML元素的CSS样式。 - 该表达式通常是一个“键-值”形式的控制对象，对象的每个键都是一个CSS属性，每个值都是一个能计算为此样式的合适值的表达式。 + 在 AngularJS 中，`ng-style` 指令根据一个绑定表达式设置一个 HTML 元素的 CSS 样式。 + 该表达式通常是一个“键-值”形式的控制对象，对象的每个键都是一个 CSS 属性，每个值都是一个能计算为此样式的合适值的表达式。 In the example, the `color` style is set to the current value of the `colorPreference` variable. - 在这个例子中，`color`样式被设置为`colorPreference`变量的当前值。 + 在这个例子中，`color` 样式被设置为 `colorPreference` 变量的当前值。 @@ -846,15 +846,15 @@ AngularJS 为模板提供了七十多个内置指令。 In Angular, the `ngStyle` directive works similarly. It sets a CSS style on an HTML element based on an expression. - 在Angular中，`ngStyle`指令的工作方式与此类似。它根据一个表达式设置HTML元素上的CSS样式。 + 在 Angular 中，`ngStyle` 指令的工作方式与此类似。它根据一个表达式设置 HTML 元素上的 CSS 样式。 In the first example, the `color` style is set to the current value of the `colorPreference` variable. - 在第一个例子中，`color`样式被设置成了`colorPreference`变量的当前值。 + 在第一个例子中，`color` 样式被设置成了 `colorPreference` 变量的当前值。 Angular also has **style binding**, which is good way to set a single style. This is shown in the second example. - Angular还有**样式绑定**语法，它是单独设置一个样式的好方法。它展示在第二个例子中。 + Angular 还有**样式绑定**语法，它是单独设置一个样式的好方法。它展示在第二个例子中。 For more information on style binding, see the [Style binding](guide/template-syntax#style-binding) section of the [Template Syntax](guide/template-syntax) page. @@ -864,7 +864,7 @@ AngularJS 为模板提供了七十多个内置指令。 For more information on the `ngStyle` directive, see [NgStyle](guide/template-syntax#ngStyle) section of the [Template Syntax](guide/template-syntax) page. - 要了解关于`ngStyle`指令的更多知识，参见[模板语法](guide/template-syntax)中的[NgStyle](guide/template-syntax#ngStyle)部分。 + 要了解关于 `ngStyle` 指令的更多知识，参见[模板语法](guide/template-syntax)中的[NgStyle](guide/template-syntax#ngStyle)部分。 @@ -896,17 +896,17 @@ AngularJS 为模板提供了七十多个内置指令。 In AngularJS, the `ng-switch` directive swaps the contents of an element by selecting one of the templates based on the current value of an expression. - 在Angular1中，`ng-switch`指令根据一个表达式的当前值把元素的内容替换成几个模板之一。 + 在 Angular1 中，`ng-switch` 指令根据一个表达式的当前值把元素的内容替换成几个模板之一。 In this example, if `favoriteHero` is not set, the template displays "Please enter ...". If `favoriteHero` is set, it checks the movie hero by calling a controller method. If that method returns `true`, the template displays "Excellent choice!". If that methods returns `false`, the template displays "No movie, sorry!". - 在这个例子中，如果`favoriteHero`没有设置，则模板显示“Please enter ...”。 - 如果`favoriteHero`设置过，它就会通过调用一个控制其方法来检查它是否电影里的英雄。 - 如果该方法返回`true`，模板就会显示“Excellent choice!”。 - 如果该方法返回`false`，该模板就会显示“No movie, sorry!”。 + 在这个例子中，如果 `favoriteHero` 没有设置，则模板显示“Please enter ...”。 + 如果 `favoriteHero` 设置过，它就会通过调用一个控制其方法来检查它是否电影里的英雄。 + 如果该方法返回 `true`，模板就会显示“Excellent choice!”。 + 如果该方法返回 `false`，该模板就会显示“No movie, sorry!”。 @@ -919,8 +919,8 @@ AngularJS 为模板提供了七十多个内置指令。 In Angular, the `ngSwitch` directive works similarly. It displays an element whose `*ngSwitchCase` matches the current `ngSwitch` expression value. - 在Angular中，`ngSwitch`指令的工作方式与此类似。 - 它会显示那个与`ngSwitch`表达式的当前值匹配的那个`*ngSwitchCase`所在的元素。 + 在 Angular 中，`ngSwitch` 指令的工作方式与此类似。 + 它会显示那个与 `ngSwitch` 表达式的当前值匹配的那个 `*ngSwitchCase` 所在的元素。 In this example, if `favoriteHero` is not set, the `ngSwitch` value is `null` and `*ngSwitchDefault` displays, "Please enter ...". @@ -928,20 +928,20 @@ AngularJS 为模板提供了七十多个内置指令。 If that method returns `true`, the app selects `*ngSwitchCase="true"` and displays: "Excellent choice!" If that methods returns `false`, the app selects `*ngSwitchCase="false"` and displays: "No movie, sorry!" - 在这个例子中，如果`favoriteHero`没有设置，则`ngSwitch`的值是`null`，我们会看到 - `*ngSwitchDefault`中的段落“Please enter ...”。 - 如果`favoriteHero`被设置了，它就会通过调用一个组件方法来检查电影英雄。 - 如果该方法返回`true`，我们就会看到“Excellent choice!”。 - 如果该方法返回`false`，我们就会看到“No movie, sorry!”。 + 在这个例子中，如果 `favoriteHero` 没有设置，则 `ngSwitch` 的值是 `null`，我们会看到 + `*ngSwitchDefault` 中的段落“Please enter ...”。 + 如果 `favoriteHero` 被设置了，它就会通过调用一个组件方法来检查电影英雄。 + 如果该方法返回 `true`，我们就会看到“Excellent choice!”。 + 如果该方法返回 `false`，我们就会看到“No movie, sorry!”。 The (*) before `ngSwitchCase` and `ngSwitchDefault` is required in this example. - 在这个例子中，`ngSwitchCase`和`ngSwitchDefault`前面的星号(*)是必须的。 + 在这个例子中，`ngSwitchCase` 和 `ngSwitchDefault` 前面的星号(*)是必须的。 For more information, see [The NgSwitch directives](guide/template-syntax#ngSwitch) section of the [Template Syntax](guide/template-syntax) page. - 要了解更多信息，参见[模板语法](guide/template-syntax)中的[NgSwitch指令](guide/template-syntax#ngSwitch)部分。 + 要了解更多信息，参见[模板语法](guide/template-syntax)中的[NgSwitch 指令](guide/template-syntax#ngSwitch)部分。 @@ -959,8 +959,8 @@ Angular **pipes** provide formatting and transformation for data in the template Many of the built-in filters in AngularJS have corresponding pipes in Angular. For more information on pipes, see [Pipes](guide/pipes). -Angular中的**管道**为模板提供了格式化和数据转换功能，类似于AngularJS中的**过滤器**。 -AngularJS中的很多内置过滤器在Angular中都有对应的管道。 +Angular 中的**管道**为模板提供了格式化和数据转换功能，类似于 AngularJS 中的**过滤器**。 +AngularJS 中的很多内置过滤器在 Angular 中都有对应的管道。 要了解管道的更多信息，参见[Pipes](guide/pipes)。
@@ -1015,7 +1015,7 @@ AngularJS中的很多内置过滤器在Angular中都有对应的管道。 The Angular `currency` pipe is similar although some of the parameters have changed. - Angular的`currency`管道和1中很相似，只是有些参数变化了。 + Angular 的 `currency` 管道和 1 中很相似，只是有些参数变化了。 @@ -1047,7 +1047,7 @@ AngularJS中的很多内置过滤器在Angular中都有对应的管道。 The Angular `date` pipe is similar. - Angular的`date`管道和它很相似。 + Angular 的 `date` 管道和它很相似。 @@ -1079,7 +1079,7 @@ AngularJS中的很多内置过滤器在Angular中都有对应的管道。 For performance reasons, no comparable pipe exists in Angular. Do all your filtering in the component. If you need the same filtering code in several templates, consider building a custom pipe. - 在Angular中，出于性能的考虑，并没有一个类似的管道。 + 在 Angular 中，出于性能的考虑，并没有一个类似的管道。 过滤逻辑应该在组件中用代码实现。 如果它将被复用在几个模板中，可以考虑构建一个自定义管道。 @@ -1101,7 +1101,7 @@ AngularJS中的很多内置过滤器在Angular中都有对应的管道。 Converts a JavaScript object into a JSON string. This is useful for debugging. - 把一个JavaScript对象转换成一个JSON字符串。这对调试很有用。 + 把一个 JavaScript 对象转换成一个 JSON 字符串。这对调试很有用。 @@ -1113,7 +1113,7 @@ AngularJS中的很多内置过滤器在Angular中都有对应的管道。 The Angular `json` pipe does the same thing. - Angular的`json`管道做完全相同的事。 + Angular 的 `json` 管道做完全相同的事。 @@ -1149,9 +1149,9 @@ AngularJS中的很多内置过滤器在Angular中都有对应的管道。 The first parameter is the starting index; the second is the limit. As in AngularJS, coding this operation within the component instead could improve performance. - `SlicePipe`做同样的事，但是*两个参数的顺序是相反的*，以便于JavaScript中的`slice`方法保持一致。 + `SlicePipe` 做同样的事，但是*两个参数的顺序是相反的*，以便于 JavaScript 中的 `slice` 方法保持一致。 第一个参数是起始索引号，第二个参数是限制的数量。 - 和AngularJS中一样，如果们改用组件中的代码实现此操作，性能将会提升。 + 和 AngularJS 中一样，如果们改用组件中的代码实现此操作，性能将会提升。 @@ -1183,7 +1183,7 @@ AngularJS中的很多内置过滤器在Angular中都有对应的管道。 The Angular `lowercase` pipe does the same thing. - Angular的`lowercase`管道和1中的功能完全相同。 + Angular 的 `lowercase` 管道和 1 中的功能完全相同。 @@ -1217,13 +1217,13 @@ AngularJS中的很多内置过滤器在Angular中都有对应的管道。 It provides more functionality when defining the decimal places, as shown in the second example above. - Angular的`number`管道很相似。 + Angular 的 `number` 管道很相似。 但在指定小数点位置时，它提供了更多的功能，如第二个范例所示。 Angular also has a `percent` pipe, which formats a number as a local percentage as shown in the third example. - Angular还有一个`percent`管道，它把一个数组格式化为本地化的(local)百分比格式，如第三个范例所示。 + Angular 还有一个 `percent` 管道，它把一个数组格式化为本地化的(local)百分比格式，如第三个范例所示。 @@ -1245,7 +1245,7 @@ AngularJS中的很多内置过滤器在Angular中都有对应的管道。 In this example, the movie title orders the `movieList`. 使用表达式中所指定的方式对集合进行排序。 - 在这个例子中，`movieList`被根据movie的title排序了。 + 在这个例子中，`movieList` 被根据 movie 的 title 排序了。 @@ -1258,7 +1258,7 @@ AngularJS中的很多内置过滤器在Angular中都有对应的管道。 For performance reasons, no comparable pipe exists in Angular. Instead, use component code to order or sort results. If you need the same ordering or sorting code in several templates, consider building a custom pipe. - 在Angular中，出于性能的考虑，并没有一个类似的管道。 + 在 Angular 中，出于性能的考虑，并没有一个类似的管道。 排序逻辑应该在组件中用代码实现。 如果它将被复用在几个模板中，可以考虑构建一个自定义管道。 @@ -1276,18 +1276,18 @@ AngularJS中的很多内置过滤器在Angular中都有对应的管道。 In both AngularJS and Angular, modules help you organize your application into cohesive blocks of functionality. -无论在AngularJS还是Angular中，我们都要借助“模块”来把应用拆分成一些紧密相关的功能块。 +无论在 AngularJS 还是 Angular 中，我们都要借助“模块”来把应用拆分成一些紧密相关的功能块。 In AngularJS, you write the code that provides the model and the methods for the view in a **controller**. In Angular, you build a **component**. -在AngularJS中，我们在**控制器**中写代码，来为视图提供模型和方法。 -在Angular中，我们创建**组件**。 +在 AngularJS 中，我们在**控制器**中写代码，来为视图提供模型和方法。 +在 Angular 中，我们创建**组件**。 Because much AngularJS code is in JavaScript, JavaScript code is shown in the AngularJS column. The Angular code is shown using TypeScript. -因为很多AngularJS的代码是用JavaScript写的，所以在AngularJS列显示的是JavaScript代码，而Angular列显示的是TypeScript代码。 +因为很多 AngularJS 的代码是用 JavaScript 写的，所以在 AngularJS 列显示的是 JavaScript 代码，而 Angular 列显示的是 TypeScript 代码。
@@ -1332,7 +1332,7 @@ The Angular code is shown using TypeScript. In AngularJS, an immediately invoked function expression (or IIFE) around controller code keeps it out of the global namespace. - 在AngularJS中，用立即调用的函数表达式(IIFE)来包裹控制器代码可以让控制器代码不会污染全局命名空间。 + 在 AngularJS 中，用立即调用的函数表达式(IIFE)来包裹控制器代码可以让控制器代码不会污染全局命名空间。 @@ -1345,7 +1345,7 @@ The Angular code is shown using TypeScript. This is a nonissue in Angular because ES 2015 modules handle the namespacing for you. - 在Angular中我们不用担心这个问题，因为使用ES 2015的模块，模块会替我们处理命名空间问题。 + 在 Angular 中我们不用担心这个问题，因为使用 ES 2015 的模块，模块会替我们处理命名空间问题。 For more information on modules, see the [Modules](guide/architecture#modules) section of the [Architecture Overview](guide/architecture). @@ -1362,7 +1362,7 @@ The Angular code is shown using TypeScript. ### Angular modules - ### Angular模块 + ### Angular 模块 @@ -1373,7 +1373,7 @@ The Angular code is shown using TypeScript. In AngularJS, an Angular module keeps track of controllers, services, and other code. The second argument defines the list of other modules that this module depends upon. - 在AngularJS中，Angular模块用来对控制器、服务和其它代码进行跟踪。第二个参数定义该模块依赖的其它模块列表。 + 在 AngularJS 中，Angular 模块用来对控制器、服务和其它代码进行跟踪。第二个参数定义该模块依赖的其它模块列表。 @@ -1385,7 +1385,7 @@ The Angular code is shown using TypeScript. NgModules, defined with the `NgModule` decorator, serve the same purpose: - Angular的模块用`NgModule`装饰器进行定义，有如下用途： + Angular 的模块用 `NgModule` 装饰器进行定义，有如下用途： * `imports`: specifies the list of other modules that this module depends upon @@ -1424,7 +1424,7 @@ The Angular code is shown using TypeScript. AngularJS has code in each controller that looks up an appropriate Angular module and registers the controller with that module. - 在AngularJS中，在每个控制器中都有一些代码，用于找到合适的Angular模块并把该控制器注册进去。 + 在 AngularJS 中，在每个控制器中都有一些代码，用于找到合适的 Angular 模块并把该控制器注册进去。 The first argument is the controller name. The second argument defines the string names of all dependencies injected into this controller, and a reference to the controller function. @@ -1445,8 +1445,8 @@ The Angular code is shown using TypeScript. The `@Component` decorator declares that the class is a component and provides metadata about that component such as its selector (or tag) and its template. - 在Angular中，我们往组件类上添加了一个装饰器，以提供任何需要的元数据。 - `@Component`装饰器把该类声明为组件，并提供了关于该组件的元数据，比如它的选择器(或标签)和模板。 + 在 Angular 中，我们往组件类上添加了一个装饰器，以提供任何需要的元数据。 + `@Component` 装饰器把该类声明为组件，并提供了关于该组件的元数据，比如它的选择器(或标签)和模板。 This is how you associate a template with logic, which is defined in the component class. @@ -1478,7 +1478,7 @@ The Angular code is shown using TypeScript. In AngularJS, you write the code for the model and methods in a controller function. - 在Angular1中，我们在控制器函数中写模型和方法的代码。 + 在 Angular1 中，我们在控制器函数中写模型和方法的代码。 @@ -1492,11 +1492,11 @@ The Angular code is shown using TypeScript. In Angular, you create a component class. - 在Angular中，我们写组件类。 + 在 Angular 中，我们写组件类。 NOTE: If you are using TypeScript with AngularJS, you must use the `export` keyword to export the component class. - 注意：如果你正在用TypeScript写AngularJS，那么必须用`export`关键字来导出组件类。 + 注意：如果你正在用 TypeScript 写 AngularJS，那么必须用 `export` 关键字来导出组件类。 For more information, see the [Components](guide/architecture#components) section of the [Architecture Overview](guide/architecture) page. @@ -1526,13 +1526,13 @@ The Angular code is shown using TypeScript. In AngularJS, you pass in any dependencies as controller function arguments. This example injects a `MovieService`. - 在AngularJS中，我们把所有依赖都作为控制器函数的参数。 - 在这个例子中，我们注入了一个`MovieService`。 + 在 AngularJS 中，我们把所有依赖都作为控制器函数的参数。 + 在这个例子中，我们注入了一个 `MovieService`。 To guard against minification problems, tell Angular explicitly that it should inject an instance of the `MovieService` in the first parameter. - 我们还通过在第一个参数明确告诉Angular它应该注入一个`MovieService`的实例，以防止在最小化时出现问题。 + 我们还通过在第一个参数明确告诉 Angular 它应该注入一个 `MovieService` 的实例，以防止在最小化时出现问题。 @@ -1548,9 +1548,9 @@ The Angular code is shown using TypeScript. This example injects a `MovieService`. The first parameter's TypeScript type tells Angular what to inject, even after minification. - 在Angular中，我们把依赖作为组件构造函数的参数传入。 - 在这个例子中，我们注入了一个`MovieService`。 - 即使在最小化之后，第一个参数的TypeScript类型也会告诉Angular它该注入什么。 + 在 Angular 中，我们把依赖作为组件构造函数的参数传入。 + 在这个例子中，我们注入了一个 `MovieService`。 + 即使在最小化之后，第一个参数的 TypeScript 类型也会告诉 Angular 它该注入什么。 For more information, see the [Dependency injection](guide/architecture#dependency-injection) section of the [Architecture Overview](guide/architecture). @@ -1577,9 +1577,9 @@ In Angular, you can still define style sheets for your entire application. But n also encapsulate a style sheet within a specific component. 样式表美化我们的应用程序。 -在AngularJS中，我们为整个应用程序指定样式表。 +在 AngularJS 中，我们为整个应用程序指定样式表。 当应用程序成长一段时间之后，应用程序中很多部分的样式会被合并，导致无法预计的后果。 -在Angular中，我们仍然会为整个应用程序定义样式，不过现在也可以把样式表封装在特定的组件中。 +在 Angular 中，我们仍然会为整个应用程序定义样式，不过现在也可以把样式表封装在特定的组件中。
@@ -1613,7 +1613,7 @@ also encapsulate a style sheet within a specific component. ### Link tag - ### Link标签 + ### Link 标签 @@ -1624,7 +1624,7 @@ also encapsulate a style sheet within a specific component. AngularJS, uses a `link` tag in the head section of the `index.html` file to define the styles for the application. - 在AngularJS中，我们在`index.html`的`head`区使用`link`标签来为应用程序定义样式。 + 在 AngularJS 中，我们在 `index.html` 的 `head` 区使用 `link` 标签来为应用程序定义样式。 @@ -1647,7 +1647,7 @@ also encapsulate a style sheet within a specific component. In Angular, you can use the `styles` or `styleUrls` property of the `@Component` metadata to define a style sheet for a particular component. - 在Angular中，我们可以在`@Component`的元数据中使用`styles`或`styleUrls`属性来为一个特定的组件定义样式表。 + 在 Angular 中，我们可以在 `@Component` 的元数据中使用 `styles` 或 `styleUrls` 属性来为一个特定的组件定义样式表。 diff --git a/aio/content/guide/animations.md b/aio/content/guide/animations.md index 9eee85859e..edc49b01c2 100644 --- a/aio/content/guide/animations.md +++ b/aio/content/guide/animations.md @@ -7,8 +7,8 @@ user interfaces transition smoothly between states with engaging animations that call attention where it's needed. Well-designed animations can make a UI not only more fun but also easier to use. -动画是现代Web应用设计中一个很重要的方面。我们希望用户界面能在不同的状态之间更平滑的转场。如果需要，还可以用适当的动画来吸引注意力。 -设计良好的动画不但会让UI更有趣，还会让它更容易使用。 +动画是现代 Web 应用设计中一个很重要的方面。我们希望用户界面能在不同的状态之间更平滑的转场。如果需要，还可以用适当的动画来吸引注意力。 +设计良好的动画不但会让 UI 更有趣，还会让它更容易使用。 ## Overview @@ -18,7 +18,7 @@ Angular's animation system lets you build animations that run with the same kind performance found in pure CSS animations. You can also tightly integrate your animation logic with the rest of your application code, for ease of control. -Angular的动画系统赋予了制作各种动画效果的能力，以构建出与原生CSS动画性能相同的动画。 +Angular 的动画系统赋予了制作各种动画效果的能力，以构建出与原生 CSS 动画性能相同的动画。 我们也获得了额外的让动画逻辑与其它应用代码紧紧集成在一起的能力，这让动画可以被更容易的触发与控制。
@@ -26,7 +26,7 @@ Angular的动画系统赋予了制作各种动画效果的能力，以构建出 Angular animations are built on top of the standard [Web Animations API](https://w3c.github.io/web-animations/) and run natively on [browsers that support it](http://caniuse.com/#feat=web-animation). -Angular动画是基于标准的[Web动画API(Web Animations API)](https://w3c.github.io/web-animations/)构建的，它们在[支持此API的浏览器中](http://caniuse.com/#feat=web-animation)会用原生方式工作。 +Angular 动画是基于标准的[Web 动画 API(Web Animations API)](https://w3c.github.io/web-animations/)构建的，它们在[支持此 API 的浏览器中](http://caniuse.com/#feat=web-animation)会用原生方式工作。 As of Angular 6, If the Web Animations API is not supported natively by the browser, then Angular will use CSS keyframes as a fallback instead (automatically). This means that the polyfill is no longer required unless any @@ -94,7 +94,7 @@ driven by a model attribute. Animations can be defined inside `@Component` metadata. -动画会被定义在`@Component`元数据中。 +动画会被定义在 `@Component` 元数据中。 @@ -102,7 +102,7 @@ With these, you can define an *animation trigger* called `heroState` in the comp metadata. It uses animations to transition between two states: `active` and `inactive`. When a hero is active, the element appears in a slightly larger size and lighter color. -通过这些，可以在组件元数据中定义一个名叫`heroState`的*动画触发器*。它在两个状态`active`和`inactive`之间进行转场。 +通过这些，可以在组件元数据中定义一个名叫 `heroState` 的*动画触发器*。它在两个状态 `active` 和 `inactive` 之间进行转场。 当英雄处于激活状态时，它会把该元素显示得稍微大一点、亮一点。 @@ -112,14 +112,14 @@ hero is active, the element appears in a slightly larger size and lighter color. In this example, you are defining animation styles (color and transform) inline in the animation metadata. -在这个例子中，我们在元数据中用内联的方式定义了动画样式(`color`和`transform`)。在即将到来的一个Angular版本中，还将支持从组件的CSS样式表中提取样式。 +在这个例子中，我们在元数据中用内联的方式定义了动画样式(`color` 和 `transform`)。在即将到来的一个 Angular 版本中，还将支持从组件的 CSS 样式表中提取样式。
Now, using the `[@triggerName]` syntax, attach the animation that you just defined to one or more elements in the component's template. -我们刚刚定义了一个动画，但它还没有被用到任何地方。要想使用它，可以在模板中用`[@triggerName]`语法来把它附加到一个或多个元素上。 +我们刚刚定义了一个动画，但它还没有被用到任何地方。要想使用它，可以在模板中用 `[@triggerName]` 语法来把它附加到一个或多个元素上。 @@ -127,8 +127,8 @@ Here, the animation trigger applies to every element repeated by an `ngFor`. Eac the repeated elements animates independently. The value of the attribute is bound to the expression `hero.state` and is always either `active` or `inactive`. -这里，我们把该动画触发器添加到了由`ngFor`重复出来的每一个元素上。每个重复出来的元素都有独立的动画效果。 -然后把`@triggerName`属性(Attribute)的值设置成表达式`hero.state`。这个值应该或者是`inactive`或者是`active`，因为我们刚刚为它们俩定义过动画状态。 +这里，我们把该动画触发器添加到了由 `ngFor` 重复出来的每一个元素上。每个重复出来的元素都有独立的动画效果。 +然后把 `@triggerName` 属性(Attribute)的值设置成表达式 `hero.state`。这个值应该或者是 `inactive` 或者是 `active`，因为我们刚刚为它们俩定义过动画状态。 With this setup, an animated transition appears whenever a hero object changes state. Here's the full component implementation: @@ -144,7 +144,7 @@ Here's the full component implementation: Angular animations are defined as logical **states** and **transitions** between states. -Angular动画是由**状态**和**状态之间的转场效果**所定义的。 +Angular 动画是由**状态**和**状态之间的转场效果**所定义的。 An animation state is a string value that you define in your application code. In the example above, the states `'active'` and `'inactive'` are based on the logical state of @@ -152,7 +152,7 @@ hero objects. The source of the state can be a simple object attribute, as it wa or it can be a value computed in a method. The important thing is that you can read it into the component's template. -动画状态是一个由程序代码中定义的字符串值。在上面的例子中，基于英雄对象的逻辑状态,我们使用了`'active'`和`'inactive'`这两种状态。 +动画状态是一个由程序代码中定义的字符串值。在上面的例子中，基于英雄对象的逻辑状态,我们使用了 `'active'` 和 `'inactive'` 这两种状态。 状态的来源可以是像本例中这样简单的对象属性，也可以是由方法计算出来的值。重点是，我们得能从组件模板中读取它。 You can define *styles* for each animation state: @@ -165,7 +165,7 @@ These `state` definitions specify the *end styles* of each state. They are applied to the element once it has transitioned to that state, and stay *as long as it remains in that state*. In effect, you're defining what styles the element has in different states. -这些`state`具体定义了每个状态的*最终样式*。一旦元素转场到那个状态，该样式就会被应用到此元素上，*当它留在此状态时*，这些样式也会一直保持着。 +这些 `state` 具体定义了每个状态的*最终样式*。一旦元素转场到那个状态，该样式就会被应用到此元素上，*当它留在此状态时*，这些样式也会一直保持着。 从这个意义上讲，这里其实并不只是在定义动画，而是在定义该元素在不同状态时应该具有的样式。 After you define states, you can define *transitions* between the states. Each transition @@ -182,14 +182,14 @@ controls the timing of switching between one set of styles and the next: If several transitions have the same timing configuration, you can combine them into the same `transition` definition: -如果多个转场都有同样的时间线配置，就可以把它们合并进同一个`transition`定义中： +如果多个转场都有同样的时间线配置，就可以把它们合并进同一个 `transition` 定义中： When both directions of a transition have the same timing, as in the previous example, you can use the shorthand syntax `<=>`: -如果要对同一个转场的两个方向都使用相同的时间线（就像前面的例子中那样），就可以使用`<=>`这种简写语法： +如果要对同一个转场的两个方向都使用相同的时间线（就像前面的例子中那样），就可以使用 `<=>` 这种简写语法： @@ -199,8 +199,8 @@ the element receives one set of styles immediately and is then animated to the n When the transition finishes, none of these styles are kept because they're not defined in a `state`. -有时希望一些样式只在动画期间生效，但在结束后并不保留它们。这时可以把这些样式内联在`transition`中进行定义。 -在这个例子中，该元素会立刻获得一组样式，然后动态转场到下一个状态。当转场结束时，这些样式并不会被保留，因为它们并没有被定义在`state`中。 +有时希望一些样式只在动画期间生效，但在结束后并不保留它们。这时可以把这些样式内联在 `transition` 中进行定义。 +在这个例子中，该元素会立刻获得一组样式，然后动态转场到下一个状态。当转场结束时，这些样式并不会被保留，因为它们并没有被定义在 `state` 中。 @@ -215,11 +215,11 @@ transitions that apply regardless of which state the animation is in. For exampl * The `active => *` transition applies when the element's state changes from `active` to anything else. - 当该元素的状态从`active`变成任何其它状态时，`active => *`转场都会生效。 + 当该元素的状态从 `active` 变成任何其它状态时，`active => *` 转场都会生效。 * The `* => *` transition applies when *any* change between two states takes place. - 当在*任意*两个状态之间切换时，`* => *`转场都会生效。 + 当在*任意*两个状态之间切换时，`* => *` 转场都会生效。
The wildcard state can be used to match many different transitions at once @@ -227,20 +227,20 @@ transitions that apply regardless of which state the animation is in. For exampl ### The `void` state -### `void`状态 +### `void` 状态 The special state called `void` can apply to any animation. It applies when the element is *not* attached to a view, perhaps because it has not yet been added or because it has been removed. The `void` state is useful for defining enter and leave animations. -有一种叫做`void`的特殊状态，它可以应用在任何动画中。它表示元素*没有*被附加到视图。这种情况可能是由于它尚未被添加进来或者已经被移除了。 -`void`状态在定义“进场”和“离场”的动画时会非常有用。 +有一种叫做 `void` 的特殊状态，它可以应用在任何动画中。它表示元素*没有*被附加到视图。这种情况可能是由于它尚未被添加进来或者已经被移除了。 +`void` 状态在定义“进场”和“离场”的动画时会非常有用。 For example the `* => void` transition applies when the element leaves the view, regardless of what state it was in before it left. -比如当一个元素离开视图时，`* => void`转场就会生效，而不管它在离场以前是什么状态。 +比如当一个元素离开视图时，`* => void` 转场就会生效，而不管它在离场以前是什么状态。
The void state can be used for enter and leave transitions @@ -248,7 +248,7 @@ regardless of what state it was in before it left. The wildcard state `*` also matches `void`. -`*`通配符状态也能匹配`void`。 +`*` 通配符状态也能匹配 `void`。 ## Example: Entering and leaving @@ -259,7 +259,7 @@ The wildcard state `*` also matches `void`. Using the `void` and `*` states you can define transitions that animate the entering and leaving of elements: -使用`void`和`*`状态，可以定义元素进场与离场时的转场动画： +使用 `void` 和 `*` 状态，可以定义元素进场与离场时的转场动画： * Enter: `void => *` @@ -272,7 +272,7 @@ entering and leaving of elements: For example, in the `animations` array below there are two transitions that use the `void => *` and `* => void` syntax to animate the element in and out of the view. -例如，在下面的`animations`数组中，这两个转场语句使用`void => *`和`* => void`语法来让该元素以动画形式进入和离开当前视图。 +例如，在下面的 `animations` 数组中，这两个转场语句使用 `void => *` 和 `* => void` 语法来让该元素以动画形式进入和离开当前视图。 @@ -281,7 +281,7 @@ transition definitions, and not in a separate `state(void)` definition. Thus, th are different on enter and leave: the element enters from the left and leaves to the right. -注意，在这个例子中，这些样式在转场定义中被直接应用到了`void`状态，但并没有一个单独的`state(void)`定义。 +注意，在这个例子中，这些样式在转场定义中被直接应用到了 `void` 状态，但并没有一个单独的 `state(void)` 定义。 这么做是因为希望在进场与离场时使用不一样的转换效果：元素从左侧进场，从右侧离开。
@@ -348,7 +348,7 @@ borders, and many others. The W3C maintains [a list of animatable properties](https://www.w3.org/TR/css3-transitions/#animatable-properties) on its [CSS Transitions page](https://www.w3.org/TR/css3-transitions). -由于Angular的动画支持是基于Web Animations标准的，所以也能支持浏览器认为可以*参与动画*的任何属性。这些属性包括位置(position)、大小(size)、变换(transform)、颜色(color)、边框(border)等很多属性。W3C维护着 +由于 Angular 的动画支持是基于 Web Animations 标准的，所以也能支持浏览器认为可以*参与动画*的任何属性。这些属性包括位置(position)、大小(size)、变换(transform)、颜色(color)、边框(border)等很多属性。W3C 维护着 [一个“可动”属性列表](https://www.w3.org/TR/css3-transitions/#animatable-properties)。 For positional properties that have a numeric value, you can define a unit by providing @@ -368,7 +368,7 @@ If you don't provide a unit when specifying dimension, Angular assumes the defau * `50` is the same as saying `'50px'` - `50`相当于`'50px'` + `50` 相当于 `'50px'` ## Automatic property calculation @@ -381,17 +381,17 @@ For example, elements often have widths and heights that depend on their content and the screen size. These properties are often tricky to animate with CSS. -有时候，我们想在动画中使用的尺寸类样式，它的值在开始运行之前都是不可知的。比如，元素的宽度和高度往往依赖于它们的内容和屏幕的尺寸。处理这些属性对CSS动画而言通常是相当棘手的。 +有时候，我们想在动画中使用的尺寸类样式，它的值在开始运行之前都是不可知的。比如，元素的宽度和高度往往依赖于它们的内容和屏幕的尺寸。处理这些属性对 CSS 动画而言通常是相当棘手的。 In these cases, you can use a special `*` property value so that the value of the property is computed at runtime and then plugged into the animation. -如果用Angular动画，就可以用一个特殊的`*`属性值来处理这种情况。该属性的值将会在运行期被计算出来，然后插入到这个动画中。 +如果用 Angular 动画，就可以用一个特殊的 `*` 属性值来处理这种情况。该属性的值将会在运行期被计算出来，然后插入到这个动画中。 In this example, the leave animation takes whatever height the element has before it leaves and animates from that height to zero: -这个例子中的“离场”动画会取得该元素在离场前的高度，并且把它从这个高度用动画转场到0高度： +这个例子中的“离场”动画会取得该元素在离场前的高度，并且把它从这个高度用动画转场到 0 高度： @@ -438,7 +438,7 @@ following the duration. It also has the same format options as the duration: * Wait for 100ms and then run for 200ms: `'0.2s 100ms'` - 等待100毫秒，然后运行200毫秒：`'0.2s 100ms'`。 + 等待 100 毫秒，然后运行 200 毫秒：`'0.2s 100ms'`。 ### Easing @@ -450,15 +450,15 @@ the animation to begin relatively slowly but pick up speed as it progresses. You can control the easing by adding it as a *third* value in the string after the duration and the delay (or as the *second* value when there is no delay): -[缓动函数](http://easings.net/)用于控制动画在运行期间如何加速和减速。比如：使用`ease-in`函数意味着动画开始时相对缓慢，然后在进行中逐步加速。可以通过在这个字符串中的持续时间和延迟后面添加*第三个*值来控制使用哪个缓动函数(如果没有定义延迟就作为*第二个*值)。 +[缓动函数](http://easings.net/)用于控制动画在运行期间如何加速和减速。比如：使用 `ease-in` 函数意味着动画开始时相对缓慢，然后在进行中逐步加速。可以通过在这个字符串中的持续时间和延迟后面添加*第三个*值来控制使用哪个缓动函数(如果没有定义延迟就作为*第二个*值)。 * Wait for 100ms and then run for 200ms, with easing: `'0.2s 100ms ease-out'` - 等待100毫秒，然后运行200毫秒，并且带缓动：`'0.2s 100ms ease-out'` + 等待 100 毫秒，然后运行 200 毫秒，并且带缓动：`'0.2s 100ms ease-out'` * Run for 200ms, with easing: `'0.2s ease-in-out'` - 运行200毫秒，并且带缓动：`'0.2s ease-in-out'` + 运行 200 毫秒，并且带缓动：`'0.2s ease-in-out'` Animations with specific timings @@ -470,7 +470,7 @@ Here are a couple of custom timings in action. Both enter and leave last for 200 milliseconds, that is `0.2s`, but they have different easings. The leave begins after a slight delay of 10 milliseconds as specified in `'0.2s 10 ease-out'`: -这里是两个自定义时间线的动态演示。“进场”和“离场”都持续200毫秒，也就是`0.2s`，但它们有不同的缓动函数。“离场”动画会在100毫秒的延迟之后开始，也就是`'0.2s 10 ease-out'`： +这里是两个自定义时间线的动态演示。“进场”和“离场”都持续 200 毫秒，也就是 `0.2s`，但它们有不同的缓动函数。“离场”动画会在 100 毫秒的延迟之后开始，也就是 `'0.2s 10 ease-out'`： @@ -489,7 +489,7 @@ For each keyframe, you specify an *offset* that defines at which point in the animation that keyframe applies. The offset is a number between zero, which marks the beginning of the animation, and one, which marks the end. -每个关键帧都可以被指定一个*偏移量*，用来定义该关键帧将被用在动画期间的哪个时间点。偏移量是一个介于0(表示动画起点)和1(表示动画终点)之间的数组。 +每个关键帧都可以被指定一个*偏移量*，用来定义该关键帧将被用在动画期间的哪个时间点。偏移量是一个介于 0(表示动画起点)和 1(表示动画终点)之间的数组。 This example adds some "bounce" to the enter and leave animations with keyframes: @@ -502,13 +502,13 @@ Note that the offsets are *not* defined in terms of absolute time. They are rela measures from zero to one. The final timeline of the animation is based on the combination of keyframe offsets, duration, delay, and easing. -注意，这个偏移量并*不是*用绝对数字定义的时间段，而是在0到1之间的相对值（百分比）。动画的最终时间线会基于关键帧的偏移量、持续时间、延迟和缓动函数计算出来。 +注意，这个偏移量并*不是*用绝对数字定义的时间段，而是在 0 到 1 之间的相对值（百分比）。动画的最终时间线会基于关键帧的偏移量、持续时间、延迟和缓动函数计算出来。 Defining offsets for keyframes is optional. If you omit them, offsets with even spacing are automatically assigned. For example, three keyframes without predefined offsets receive offsets `0`, `0.5`, and `1`. -为关键帧定义偏移量是可选的。如果省略它们，偏移量会自动根据帧数平均分布出来。例如，三个未定义过偏移量的关键帧会分别获得偏移量：`0`、`0.5`和`1`。 +为关键帧定义偏移量是可选的。如果省略它们，偏移量会自动根据帧数平均分布出来。例如，三个未定义过偏移量的关键帧会分别获得偏移量：`0`、`0.5` 和 `1`。 ## Parallel animation groups @@ -519,13 +519,13 @@ offsets receive offsets `0`, `0.5`, and `1`. You've seen how to animate multiple style properties at the same time: just put all of them into the same `style()` definition. -我们已经知道该如何在同一时间段进行多个样式的动画了：只要把它们都放进同一个`style()`定义中就行了！ +我们已经知道该如何在同一时间段进行多个样式的动画了：只要把它们都放进同一个 `style()` 定义中就行了！ But you may also want to configure different *timings* for animations that happen in parallel. For example, you may want to animate two CSS properties but use a different easing function for each one. -但我们也可能会希望为同时发生的几个动画配置不同的*时间线*。比如，同时对两个CSS属性做动画，但又得为它们定义不同的缓动函数。 +但我们也可能会希望为同时发生的几个动画配置不同的*时间线*。比如，同时对两个 CSS 属性做动画，但又得为它们定义不同的缓动函数。 For this you can use animation *groups*. In this example, using groups both on enter and leave allows for two different timing configurations. Both @@ -538,7 +538,7 @@ are applied to the same element in parallel, but run independently of each other One group animates the element transform and width; the other group animates the opacity. -其中一个动画组对元素的`transform`和`width`做动画，另一个组则对`opacity`做动画。 +其中一个动画组对元素的 `transform` 和 `width` 做动画，另一个组则对 `opacity` 做动画。 ## Animation callbacks @@ -551,14 +551,14 @@ A callback is fired when an animation is started and also when it is done. In the keyframes example, you have a `trigger` called `@flyInOut`. You can hook those callbacks like this: -对于例子中的这个关键帧，我们有一个叫做`@flyInOut`的`trigger`。在那里我们可以挂钩到那些回调，比如： +对于例子中的这个关键帧，我们有一个叫做 `@flyInOut` 的 `trigger`。在那里我们可以挂钩到那些回调，比如： The callbacks receive an `AnimationEvent` that contains useful properties such as `fromState`, `toState` and `totalTime`. -这些回调接收一个`AnimationTransitionEvent`参数，它包含一些有用的属性，例如`fromState`，`toState`和`totalTime`。 +这些回调接收一个 `AnimationTransitionEvent` 参数，它包含一些有用的属性，例如 `fromState`，`toState` 和 `totalTime`。 Those callbacks will fire whether or not an animation is picked up. diff --git a/aio/content/guide/aot-compiler.md b/aio/content/guide/aot-compiler.md index a968fead9e..eccbef9d31 100644 --- a/aio/content/guide/aot-compiler.md +++ b/aio/content/guide/aot-compiler.md @@ -12,7 +12,7 @@ This guide explains how to build with the AOT compiler using different compiler Watch compiler author Tobias Bosch explain the Angular Compiler at AngularConnect 2016. - 观看编译器作者Tobias Bosch在AngularConnect 2016大会里，对Angular编译器的演讲。 + 观看编译器作者 Tobias Bosch 在 AngularConnect 2016 大会里，对Angular 编译器的演讲。
@@ -66,7 +66,7 @@ See the [CLI documentation](https://github.com/angular/angular-cli/wiki) for det ## Why compile with AOT? -## 为什么需要AOT编译？ +## 为什么需要 AOT 编译？ *Faster rendering* @@ -75,7 +75,7 @@ See the [CLI documentation](https://github.com/angular/angular-cli/wiki) for det With AOT, the browser downloads a pre-compiled version of the application. The browser loads executable code so it can render the application immediately, without waiting to compile the app first. -使用AOT，浏览器下载预编译版本的应用程序。 +使用 AOT，浏览器下载预编译版本的应用程序。 浏览器直接加载运行代码，所以它可以立即渲染该应用，而不用等应用完成首次编译。 *Fewer asynchronous requests* @@ -85,18 +85,18 @@ The browser loads executable code so it can render the application immediately, The compiler _inlines_ external HTML templates and CSS style sheets within the application JavaScript, eliminating separate ajax requests for those source files. -编译器把外部HTML模板和CSS样式表内联到了该应用的JavaScript中。 -消除了用来下载那些源文件的Ajax请求。 +编译器把外部 HTML 模板和 CSS 样式表内联到了该应用的 JavaScript 中。 +消除了用来下载那些源文件的 Ajax 请求。 *Smaller Angular framework download size* -**需要下载的Angular框架体积更小** +**需要下载的 Angular 框架体积更小** There's no need to download the Angular compiler if the app is already compiled. The compiler is roughly half of Angular itself, so omitting it dramatically reduces the application payload. -如果应用已经编译过了，自然不需要再下载Angular编译器了。 -该编译器差不多占了Angular自身体积的一半儿，所以，省略它可以显著减小应用的体积。 +如果应用已经编译过了，自然不需要再下载 Angular 编译器了。 +该编译器差不多占了 Angular 自身体积的一半儿，所以，省略它可以显著减小应用的体积。 *Detect template errors earlier* @@ -105,7 +105,7 @@ The compiler is roughly half of Angular itself, so omitting it dramatically redu The AOT compiler detects and reports template binding errors during the build step before users can see them. -AOT编译器在构建过程中检测和报告模板绑定错误，避免用户遇到这些错误。 +AOT 编译器在构建过程中检测和报告模板绑定错误，避免用户遇到这些错误。 *Better security* @@ -115,8 +115,8 @@ AOT compiles HTML templates and components into JavaScript files long before the With no templates to read and no risky client-side HTML or JavaScript evaluation, there are fewer opportunities for injection attacks. -AOT编译远在HTML模版和组件被服务到客户端之前，将它们编译到JavaScript文件。 -没有模版可以阅读，没有高风险客户端HTML或JavaScript可利用，所以注入攻击的机会较少。 +AOT 编译远在 HTML 模版和组件被服务到客户端之前，将它们编译到 JavaScript 文件。 +没有模版可以阅读，没有高风险客户端 HTML 或 JavaScript 可利用，所以注入攻击的机会较少。 {@a compiler-options} @@ -370,11 +370,11 @@ The next sections elaborate on these points. It helps to think of the AOT compiler as having two phases: a code analysis phase in which it simply records a representation of the source; and a code generation phase in which the compiler's `StaticReflector` handles the interpretation as well as places restrictions on what it interprets. -我们可以把 AOT 编译器看做两个阶段：在代码分析阶段，它只记录源代码，而在代码生成阶段，编译器的`StaticReflector`会解释这些结果，并为这些结果加上限制。 +我们可以把 AOT 编译器看做两个阶段：在代码分析阶段，它只记录源代码，而在代码生成阶段，编译器的 `StaticReflector` 会解释这些结果，并为这些结果加上限制。 ## Phase 1: analysis -## 阶段1：分析 +## 阶段 1：分析 The TypeScript compiler does some of the analytic work of the first phase. It emits the `.d.ts` _type definition files_ with type information that the AOT compiler needs to generate application code. @@ -382,11 +382,11 @@ TypeScript 编译器会做一些初步的分析工作，它会生成**类型定 At the same time, the AOT **_collector_** analyzes the metadata recorded in the Angular decorators and outputs metadata information in **`.metadata.json`** files, one per `.d.ts` file. -同时，AOT **收集器（collector）** 会记录 Angular 装饰器中的元数据，并把它们输出到**`.metadata.json`**文件中，和每个`.d.ts`文件相对应。 +同时，AOT **收集器（collector）** 会记录 Angular 装饰器中的元数据，并把它们输出到**`.metadata.json`**文件中，和每个 `.d.ts` 文件相对应。 You can think of `.metadata.json` as a diagram of the overall structure of a decorator's metadata, represented as an [abstract syntax tree (AST)](https://en.wikipedia.org/wiki/Abstract_syntax_tree). -我们可以把`.metadata.json`文件看做一个包括全部装饰器的元数据的全景图，就像[抽象语法树 (AST) ](https://en.wikipedia.org/wiki/Abstract_syntax_tree)一样。 +我们可以把 `.metadata.json` 文件看做一个包括全部装饰器的元数据的全景图，就像[抽象语法树 (AST) ](https://en.wikipedia.org/wiki/Abstract_syntax_tree)一样。
@@ -430,13 +430,13 @@ Parentheses | `(a + b)` If an expression uses unsupported syntax, the _collector_ writes an error node to the `.metadata.json` file. The compiler later reports the error if it needs that piece of metadata to generate the application code. -如果表达式使用了不支持的语法，**收集器**就会往`.metadata.json`文件中写入一个错误节点。稍后，如果编译器用到元数据中的这部分内容来生成应用代码，它就会报告这个错误。 +如果表达式使用了不支持的语法，**收集器**就会往 `.metadata.json` 文件中写入一个错误节点。稍后，如果编译器用到元数据中的这部分内容来生成应用代码，它就会报告这个错误。
If you want `ngc` to report syntax errors immediately rather than produce a `.metadata.json` file with errors, set the `strictMetadataEmit` option in `tsconfig`. - 如果你希望`ngc`立即汇报这些语法错误，而不要生成带有错误信息的`.metadata.json`文件，可以到`tsconfig`中设置 `strictMetadataEmit` 选项。 + 如果你希望 `ngc` 立即汇报这些语法错误，而不要生成带有错误信息的 `.metadata.json` 文件，可以到 `tsconfig` 中设置 `strictMetadataEmit` 选项。 ``` diff --git a/aio/content/guide/architecture.md b/aio/content/guide/architecture.md index 118856b887..315ba82cbf 100644 --- a/aio/content/guide/architecture.md +++ b/aio/content/guide/architecture.md @@ -64,7 +64,7 @@ NgModules 很重要。这里只是简单介绍，在 [NgModules](guide/ngmodules Every Angular app has at least one NgModule class, [the _root module_](guide/bootstrapping "Bootstrapping"), conventionally named `AppModule`. -每个 Angular 应用至少有一个模块（[_根模块_](guide/bootstrapping "引导启动")），习惯上命名为`AppModule`。 +每个 Angular 应用至少有一个模块（[_根模块_](guide/bootstrapping "引导启动")），习惯上命名为 `AppModule`。 While the _root module_ may be the only module in a small application, most apps have many more _feature modules_, each a cohesive block of code dedicated to an application domain, @@ -74,7 +74,7 @@ _根模块_在一些小型应用中可能是唯一的模块，大多数应用会 An NgModule, whether a _root_ or _feature_, is a class with an `@NgModule` decorator. -Angular 模块（无论是_根模块_还是_特性模块_）都是一个带有`@NgModule`装饰器的类。 +Angular 模块（无论是_根模块_还是_特性模块_）都是一个带有 `@NgModule` 装饰器的类。
@@ -93,7 +93,7 @@ Angular 有很多装饰器，它们负责把元数据附加到类上，以了解 `NgModule` is a decorator function that takes a single metadata object whose properties describe the module. The most important properties are: -`NgModule`是一个装饰器函数，它接收一个用来描述模块属性的元数据对象。其中最重要的属性是： +`NgModule` 是一个装饰器函数，它接收一个用来描述模块属性的元数据对象。其中最重要的属性是： * `declarations` - the _view classes_ that belong to this module. Angular has three kinds of view classes: [components](guide/architecture#components), [directives](guide/architecture#directives), and [pipes](guide/pipes). @@ -116,7 +116,7 @@ the global collection of services; they become accessible in all parts of the ap * `bootstrap` - the main application view, called the _root component_, that hosts all other app views. Only the _root module_ should set this `bootstrap` property. - `bootstrap` - 指定应用的主视图（称为_根组件_），它是所有其它视图的宿主。只有_根模块_才能设置`bootstrap`属性。 + `bootstrap` - 指定应用的主视图（称为_根组件_），它是所有其它视图的宿主。只有_根模块_才能设置 `bootstrap` 属性。 Here's a simple root module: @@ -128,7 +128,7 @@ Here's a simple root module: The `export` of `AppComponent` is just to show how to use the `exports` array to export a component; it isn't actually necessary in this example. A root module has no reason to _export_ anything because other components don't need to _import_ the root module. - `AppComponent`的`export`语句只是用于演示如何导出的，它在这个例子中并不是必须的。根模块不需要_导出_任何东西，因为其它组件不需要导入根模块。 + `AppComponent` 的 `export` 语句只是用于演示如何导出的，它在这个例子中并不是必须的。根模块不需要_导出_任何东西，因为其它组件不需要导入根模块。
@@ -136,7 +136,7 @@ Launch an application by _bootstrapping_ its root module. During development you're likely to bootstrap the `AppModule` in a `main.ts` file like this one. 我们通过_引导_根模块来启动应用。 -在开发期间，你通常在一个`main.ts`文件中引导`AppModule`，就像这样： +在开发期间，你通常在一个 `main.ts` 文件中引导 `AppModule`，就像这样： @@ -146,7 +146,7 @@ During development you're likely to bootstrap the `AppModule` in a `main.ts` fil The NgModule — a class decorated with `@NgModule` — is a fundamental feature of Angular. -NgModule（一个带`@NgModule`装饰器的类）是 Angular 的基础特性之一。 +NgModule（一个带 `@NgModule` 装饰器的类）是 Angular 的基础特性之一。 JavaScript also has its own module system for managing collections of JavaScript objects. It's completely different and unrelated to the NgModule system. @@ -159,7 +159,7 @@ The module declares some objects to be public by marking them with the `export` Other JavaScript modules use *import statements* to access public objects from other modules. JavaScript 中，每个_文件_是一个模块，文件中定义的所有对象都从属于那个模块。 -通过`export`关键字，模块可以把它的某些对象声明为公共的。 +通过 `export` 关键字，模块可以把它的某些对象声明为公共的。 其它 JavaScript 模块可以使用*import 语句*来访问这些公共对象。 @@ -190,17 +190,17 @@ Angular 提供了一组 JavaScript 模块。可以把它们看做库模块。 Each Angular library name begins with the `@angular` prefix. -每个 Angular 库的名字都带有`@angular`前缀。 +每个 Angular 库的名字都带有 `@angular` 前缀。 You install them with the **npm** package manager and import parts of them with JavaScript `import` statements. -用 **npm** 包管理工具安装它们，用 JavaScript 的`import`语句导入其中某些部件。 +用 **npm** 包管理工具安装它们，用 JavaScript 的 `import` 语句导入其中某些部件。
For example, import Angular's `Component` decorator from the `@angular/core` library like this: -例如，象下面这样，从`@angular/core`库中导入`Component`装饰器： +例如，象下面这样，从 `@angular/core` 库中导入 `Component` 装饰器： @@ -212,7 +212,7 @@ You also import NgModules from Angular _libraries_ using JavaScript import state In the example of the simple root module above, the application module needs material from within that `BrowserModule`. To access that material, add it to the `@NgModule` metadata `imports` like this. -在上面那个简单的根模块的例子中，应用模块需要`BrowserModule`的某些素材。要访问这些素材，就得把它加入`@NgModule`元数据的`imports`中，就像这样： +在上面那个简单的根模块的例子中，应用模块需要 `BrowserModule` 的某些素材。要访问这些素材，就得把它加入 `@NgModule` 元数据的 `imports` 中，就像这样： @@ -273,8 +273,8 @@ For example, this `HeroListComponent` has a `heroes` property that returns an ar that it acquires from a service. `HeroListComponent` also has a `selectHero()` method that sets a `selectedHero` property when the user clicks to choose a hero from that list. -例如，`HeroListComponent`有一个`heroes`属性，它返回一个英雄数组，这个数组从一个服务获得。 -`HeroListComponent`还有一个当用户从列表中点选一个英雄时设置`selectedHero`属性的`selectHero()`方法。 +例如，`HeroListComponent` 有一个 `heroes` 属性，它返回一个英雄数组，这个数组从一个服务获得。 +`HeroListComponent` 还有一个当用户从列表中点选一个英雄时设置 `selectedHero` 属性的 `selectHero()` 方法。 @@ -282,7 +282,7 @@ Angular creates, updates, and destroys components as the user moves through the Your app can take action at each moment in this lifecycle through optional [lifecycle hooks](guide/lifecycle-hooks), like `ngOnInit()` declared above. 当用户在这个应用中漫游时， Angular 会创建、更新和销毁组件。 -应用可以通过[生命周期钩子](guide/lifecycle-hooks)在组件生命周期的各个时间点上插入自己的操作，例如上面声明的`ngOnInit()`。 +应用可以通过[生命周期钩子](guide/lifecycle-hooks)在组件生命周期的各个时间点上插入自己的操作，例如上面声明的 `ngOnInit()`。
@@ -300,33 +300,33 @@ that tells Angular how to render the component. A template looks like regular HTML, except for a few differences. Here is a template for our `HeroListComponent`: -多数情况下，模板看起来很像标准 HTML，当然也有一点不同的地方。下面是`HeroListComponent`组件的一个模板： +多数情况下，模板看起来很像标准 HTML，当然也有一点不同的地方。下面是 `HeroListComponent` 组件的一个模板： Although this template uses typical HTML elements like `

` and `

`, it also has some differences. Code like `*ngFor`, `{{hero.name}}`, `(click)`, `[hero]`, and `` uses Angular's [template syntax](guide/template-syntax). -模板除了可以使用像`

`和`

`这样的典型的 HTML 元素，还能使用其它元素。 -例如，像`*ngFor`、`{{hero.name}}`、`(click)`、`[hero]`和``这样的代码使用了 Angular 的[模板语法](guide/template-syntax)。 +模板除了可以使用像 `

` 和 `

` 这样的典型的 HTML 元素，还能使用其它元素。 +例如，像 `*ngFor`、`{{hero.name}}`、`(click)`、`[hero]` 和 `` 这样的代码使用了 Angular 的[模板语法](guide/template-syntax)。 In the last line of the template, the `` tag is a custom element that represents a new component, `HeroDetailComponent`. -在模板的最后一行，``标签就是一个用来表示新组件`HeroDetailComponent`的自定义元素。 +在模板的最后一行，`` 标签就是一个用来表示新组件 `HeroDetailComponent` 的自定义元素。 The `HeroDetailComponent` is a *different* component than the `HeroListComponent` you've been reviewing. The `HeroDetailComponent` (code not shown) presents facts about a particular hero, the hero that the user selects from the list presented by the `HeroListComponent`. The `HeroDetailComponent` is a **child** of the `HeroListComponent`. -`HeroDetailComponent`跟以前见到过的`HeroListComponent`是*不同*的组件。 -`HeroDetailComponent`（代码未显示）用于展现一个特定英雄的情况，这个英雄是用户从`HeroListComponent`列表中选择的。 -`HeroDetailComponent`是`HeroListComponent`的*子组件*。 +`HeroDetailComponent` 跟以前见到过的 `HeroListComponent` 是*不同*的组件。 +`HeroDetailComponent`（代码未显示）用于展现一个特定英雄的情况，这个英雄是用户从 `HeroListComponent` 列表中选择的。 +`HeroDetailComponent` 是 `HeroListComponent` 的*子组件*。 Metadata Notice how `` rests comfortably among native HTML elements. Custom components mix seamlessly with native HTML in the same layouts. -注意到了吗？``舒适地躺在原生 HTML 元素之间。 +注意到了吗？`` 舒适地躺在原生 HTML 元素之间。 自定义组件和原生 HTML 在同一布局中融合得天衣无缝。

@@ -346,46 +346,46 @@ Metadata tells Angular how to process a class. [Looking back at the code](guide/architecture#component-code) for `HeroListComponent`, you can see that it's just a class. There is no evidence of a framework, no "Angular" in it at all. -[回头看看](guide/architecture#component-code)`HeroListComponent`就会明白：它只是一个类。 +[回头看看](guide/architecture#component-code)`HeroListComponent` 就会明白：它只是一个类。 一点框架的痕迹也没有，里面完全没有出现 "Angular" 的字样。 In fact, `HeroListComponent` really is *just a class*. It's not a component until you *tell Angular about it*. -实际上，`HeroListComponent`真的*只是一个类*。直到我们*告诉 Angular* 它是一个组件。 +实际上，`HeroListComponent` 真的*只是一个类*。直到我们*告诉 Angular* 它是一个组件。 To tell Angular that `HeroListComponent` is a component, attach **metadata** to the class. -要告诉 Angular `HeroListComponent`是个组件，只要把**元数据**附加到这个类。 +要告诉 Angular `HeroListComponent` 是个组件，只要把**元数据**附加到这个类。 In TypeScript, you attach metadata by using a **decorator**. Here's some metadata for `HeroListComponent`: -在TypeScript中，我们用**装饰器 (decorator) **来附加元数据。 -下面就是`HeroListComponent`的一些元数据。 +在 TypeScript 中，我们用**装饰器 (decorator) **来附加元数据。 +下面就是 `HeroListComponent` 的一些元数据。 Here is the `@Component` decorator, which identifies the class immediately below it as a component class. -这里看到`@Component`装饰器，它把紧随其后的类标记成了组件类。 +这里看到 `@Component` 装饰器，它把紧随其后的类标记成了组件类。 The `@Component` decorator takes a required configuration object with the information Angular needs to create and present the component and its view. -`@Component`装饰器能接受一个配置对象， Angular 会基于这些信息创建和展示组件及其视图。 +`@Component` 装饰器能接受一个配置对象， Angular 会基于这些信息创建和展示组件及其视图。 Here are a few of the most useful `@Component` configuration options: -`@Component`的配置项包括： +`@Component` 的配置项包括： * `selector`: CSS selector that tells Angular to create and insert an instance of this component where it finds a `` tag in *parent* HTML. For example, if an app's HTML contains ``, then Angular inserts an instance of the `HeroListComponent` view between those tags. - `selector`： CSS 选择器，它告诉 Angular 在*父级* HTML 中查找``标签，创建并插入该组件。 - 例如，如果应用的 HTML 包含``， Angular 就会把`HeroListComponent`的一个实例插入到这个标签中。 + `selector`： CSS 选择器，它告诉 Angular 在*父级* HTML 中查找 `` 标签，创建并插入该组件。 + 例如，如果应用的 HTML 包含 ``， Angular 就会把 `HeroListComponent` 的一个实例插入到这个标签中。 * `templateUrl`: module-relative address of this component's HTML template, shown [above](guide/architecture#templates). @@ -396,13 +396,13 @@ This is one way to tell Angular that the component's constructor requires a `Her so it can get the list of heroes to display. `providers` - 组件所需服务的*依赖注入提供商*数组。 -这是在告诉 Angular：该组件的构造函数需要一个`HeroService`服务，这样组件就可以从服务中获得英雄数据。 +这是在告诉 Angular：该组件的构造函数需要一个 `HeroService` 服务，这样组件就可以从服务中获得英雄数据。 Metadata The metadata in the `@Component` tells Angular where to get the major building blocks you specify for the component. -`@Component`里面的元数据会告诉 Angular 从哪里获取你为组件指定的主要的构建块。 +`@Component` 里面的元数据会告诉 Angular 从哪里获取你为组件指定的主要的构建块。 The template, metadata, and component together describe a view. @@ -412,7 +412,7 @@ Apply other metadata decorators in a similar fashion to guide Angular behavior. `@Injectable`, `@Input`, and `@Output` are a few of the more popular decorators. 其它元数据装饰器用类似的方式来指导 Angular 的行为。 -例如`@Injectable`、`@Input`和`@Output`等是一些最常用的装饰器。 +例如 `@Injectable`、`@Input` 和 `@Output` 等是一些最常用的装饰器。
@@ -458,23 +458,23 @@ The `HeroListComponent` [example](guide/architecture#templates) template has thr * The `{{hero.name}}` [*interpolation*](guide/displaying-data#interpolation) displays the component's `hero.name` property value within the `
  • ` element. - `{{hero.name}}`[*插值表达式*](guide/displaying-data#interpolation)在`
  • `标签中显示组件的`hero.name`属性的值。 + `{{hero.name}}`[*插值表达式*](guide/displaying-data#interpolation)在 `
  • ` 标签中显示组件的 `hero.name` 属性的值。 * The `[hero]` [*property binding*](guide/template-syntax#property-binding) passes the value of `selectedHero` from the parent `HeroListComponent` to the `hero` property of the child `HeroDetailComponent`. - `[hero]`[*属性绑定*](guide/template-syntax#property-binding)把父组件`HeroListComponent`的`selectedHero`的值传到子组件`HeroDetailComponent`的`hero`属性中。 + `[hero]`[*属性绑定*](guide/template-syntax#property-binding)把父组件 `HeroListComponent` 的 `selectedHero` 的值传到子组件 `HeroDetailComponent` 的 `hero` 属性中。 * The `(click)` [*event binding*](guide/user-input#click) calls the component's `selectHero` method when the user clicks a hero's name. - `(click)` [*事件绑定*](guide/user-input#click)在用户点击英雄的名字时调用组件的`selectHero`方法。 + `(click)` [*事件绑定*](guide/user-input#click)在用户点击英雄的名字时调用组件的 `selectHero` 方法。 **Two-way data binding** is an important fourth form that combines property and event binding in a single notation, using the `ngModel` directive. Here's an example from the `HeroDetailComponent` template: -**双向数据绑定**是重要的第四种绑定形式，它使用`ngModel`指令组合了属性绑定和事件绑定的功能。 -下面是`HeroDetailComponent`模板的范例： +**双向数据绑定**是重要的第四种绑定形式，它使用 `ngModel` 指令组合了属性绑定和事件绑定的功能。 +下面是 `HeroDetailComponent` 模板的范例： @@ -522,7 +522,7 @@ A directive is a class with a `@Directive` decorator. A component is a *directive-with-a-template*; a `@Component` decorator is actually a `@Directive` decorator extended with template-oriented features. -组件是一个*带模板的指令*；`@Component`装饰器实际上就是一个`@Directive`装饰器，只是扩展了一些面向模板的特性。 +组件是一个*带模板的指令*；`@Component` 装饰器实际上就是一个 `@Directive` 装饰器，只是扩展了一些面向模板的特性。
    @@ -555,11 +555,11 @@ The [example template](guide/architecture#templates) uses two built-in structura * [`*ngFor`](guide/displaying-data#ngFor) tells Angular to stamp out one `
  • ` per hero in the `heroes` list. - [`*ngFor`](guide/displaying-data#ngFor)告诉 Angular 为`heroes`列表中的每个英雄生成一个`
  • `标签。 + [`*ngFor`](guide/displaying-data#ngFor)告诉 Angular 为 `heroes` 列表中的每个英雄生成一个 `
  • ` 标签。 * [`*ngIf`](guide/displaying-data#ngIf) includes the `HeroDetail` component only if a selected hero exists. - [`*ngIf`](guide/displaying-data#ngIf)表示只有在选择的英雄存在时，才会包含`HeroDetail`组件。 + [`*ngIf`](guide/displaying-data#ngIf)表示只有在选择的英雄存在时，才会包含 `HeroDetail` 组件。 **Attribute** directives alter the appearance or behavior of an existing element. In templates they look like regular HTML attributes, hence the name. @@ -572,8 +572,8 @@ an example of an attribute directive. `ngModel` modifies the behavior of an existing element (typically an ``) by setting its display value property and responding to change events. -`ngModel`指令就是属性型指令的一个例子，它实现了双向数据绑定。 -`ngModel`修改现有元素（一般是``）的行为：设置其显示属性值，并响应 change 事件。 +`ngModel` 指令就是属性型指令的一个例子，它实现了双向数据绑定。 +`ngModel` 修改现有元素（一般是 ``）的行为：设置其显示属性值，并响应 change 事件。 @@ -588,7 +588,7 @@ Angular 还有少量指令，它们或者修改结构布局（例如 [ngSwitch]( Of course, you can also write your own directives. Components such as `HeroListComponent` are one kind of custom directive. -当然，我们也能编写自己的指令。像`HeroListComponent`这样的组件就是一种自定义指令。 +当然，我们也能编写自己的指令。像 `HeroListComponent` 这样的组件就是一种自定义指令。 @@ -655,8 +655,8 @@ Here's an example of a service class that logs to the browser console: Here's a `HeroService` that uses a [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) to fetch heroes. The `HeroService` depends on the `Logger` service and another `BackendService` that handles the server communication grunt work. -下面是`HeroService`类，用于获取英雄数据，并通过一个已解析的[承诺 (Promise)](http://exploringjs.com/es6/ch_promises.html) 返回它们。 -`HeroService`还依赖于`Logger`服务和另一个用于处理服务器通讯的`BackendService`服务。 +下面是 `HeroService` 类，用于获取英雄数据，并通过一个已解析的[承诺 (Promise)](http://exploringjs.com/es6/ch_promises.html) 返回它们。 +`HeroService` 还依赖于 `Logger` 服务和另一个用于处理服务器通讯的 `BackendService` 服务。 @@ -711,7 +711,7 @@ Angular can tell which services a component needs by looking at the types of its For example, the constructor of your `HeroListComponent` needs a `HeroService`: Angular 通过查看构造函数的参数类型得知组件需要哪些服务。 -例如，`HeroListComponent`组件的构造函数需要一个`HeroService`服务： +例如，`HeroListComponent` 组件的构造函数需要一个 `HeroService` 服务： @@ -734,7 +734,7 @@ This is *dependency injection*. The process of `HeroService` injection looks a bit like this: -`HeroService`注入的过程差不多是这样的： +`HeroService` 注入的过程差不多是这样的：
    Service @@ -742,13 +742,13 @@ The process of `HeroService` injection looks a bit like this: If the injector doesn't have a `HeroService`, how does it know how to make one? -如果注入器还没有`HeroService`，它怎么知道该如何创建一个呢？ +如果注入器还没有 `HeroService`，它怎么知道该如何创建一个呢？ In brief, you must have previously registered a **provider** of the `HeroService` with the injector. A provider is something that can create or return a service, typically the service class itself. -简单点说，我们必须先用注入器（injector）为`HeroService`注册一个**提供商（provider）**。 -提供商用来创建或返回服务，通常就是这个服务类本身（相当于`new HeroService()`）。 +简单点说，我们必须先用注入器（injector）为 `HeroService` 注册一个**提供商（provider）**。 +提供商用来创建或返回服务，通常就是这个服务类本身（相当于 `new HeroService()`）。 You can register providers in modules or in components. @@ -763,7 +763,7 @@ the same instance of a service is available everywhere. Alternatively, register at a component level in the `providers` property of the `@Component` metadata: -或者，也可以在`@Component`元数据中的`providers`属性中把它注册在组件层： +或者，也可以在 `@Component` 元数据中的 `providers` 属性中把它注册在组件层： @@ -896,11 +896,11 @@ by implementing the lifecycle hook interfaces. > > It displays a price of 42.33 as `$42.33`. -> [**管道**](guide/pipes)：在模板中使用管道转换成用于显示的值，以增强用户体验。例如，`currency`管道表达式： +> [**管道**](guide/pipes)：在模板中使用管道转换成用于显示的值，以增强用户体验。例如，`currency` 管道表达式： > > > `price | currency:'USD':true` > -> 它把价格“42.33”显示为`$42.33`。 +> 它把价格“42.33”显示为 `$42.33`。 > [**Router**](guide/router): Navigate from page to page within the client application and never leave the browser. diff --git a/aio/content/guide/attribute-directives.md b/aio/content/guide/attribute-directives.md index 02578e33af..1584d7cd14 100644 --- a/aio/content/guide/attribute-directives.md +++ b/aio/content/guide/attribute-directives.md @@ -61,7 +61,7 @@ An attribute directive minimally requires building a controller class annotated the attribute. The controller class implements the desired directive behavior. -属性型指令至少需要一个带有`@Directive`装饰器的控制器类。该装饰器指定了一个用于标识属性的选择器。 +属性型指令至少需要一个带有 `@Directive` 装饰器的控制器类。该装饰器指定了一个用于标识属性的选择器。 控制器类实现了指令需要的指令行为。 This page demonstrates building a simple _appHighlight_ attribute @@ -90,25 +90,25 @@ ng generate directive highlight The CLI creates `src/app/highlight.directive.ts`, a corresponding test file (`.../spec.ts`, and _declares_ the directive class in the root `AppModule`. -CLI 会创建`src/app/highlight.directive.ts`及相应的测试文件（`.../spec.ts`），并且在根模块`AppModule`中声明这个指令类。 +CLI 会创建 `src/app/highlight.directive.ts` 及相应的测试文件（`.../spec.ts`），并且在根模块 `AppModule` 中声明这个指令类。
    _Directives_ must be declared in [Angular Modules](guide/ngmodules) in the same manner as _components_. -和**组件**一样，这些**指令**也必须在[Angular模块](guide/ngmodules)中进行声明。 +和**组件**一样，这些**指令**也必须在[Angular 模块](guide/ngmodules)中进行声明。
    The generated `src/app/highlight.directive.ts` is as follows: -生成的`src/app/highlight.directive.ts`文件如下： +生成的 `src/app/highlight.directive.ts` 文件如下： The imported `Directive` symbol provides the Angular the `@Directive` decorator. -这里导入的`Directive`符号提供了 Angular 的 `@Directive` 装饰器。 +这里导入的 `Directive` 符号提供了 Angular 的 `@Directive` 装饰器。 The `@Directive` decorator's lone configuration property specifies the directive's [CSS attribute selector](https://developer.mozilla.org/en-US/docs/Web/CSS/Attribute_selectors), `[appHighlight]`. @@ -144,8 +144,8 @@ The CLI added the `app` prefix for you. Make sure you do **not** prefix the `highlight` directive name with **`ng`** because that prefix is reserved for Angular and using it could cause bugs that are difficult to diagnose. -确认你**没有**给`highlight`指令添加**`ng`**前缀。 -那个前缀属于 Angular，使用它可能导致难以诊断的 bug。例如，这个简短的前缀`my`可以帮助你区分自定义指令。 +确认你**没有**给 `highlight` 指令添加**`ng`**前缀。 +那个前缀属于 Angular，使用它可能导致难以诊断的 bug。例如，这个简短的前缀 `my` 可以帮助你区分自定义指令。

    • @@ -153,23 +153,23 @@ After the `@Directive` metadata comes the directive's controller class, called `HighlightDirective`, which contains the (currently empty) logic for the directive. Exporting `HighlightDirective` makes the directive accessible. -紧跟在`@Directive`元数据之后的就是该指令的控制器类，名叫`HighlightDirective`，它包含了该指令的逻辑（目前为空逻辑）。然后导出`HighlightDirective`，以便它能在别处访问到。 +紧跟在 `@Directive` 元数据之后的就是该指令的控制器类，名叫 `HighlightDirective`，它包含了该指令的逻辑（目前为空逻辑）。然后导出 `HighlightDirective`，以便它能在别处访问到。 Now edit the generated `src/app/highlight.directive.ts` to look as follows: -现在，把刚才生成的`src/app/highlight.directive.ts`编辑成这样： +现在，把刚才生成的 `src/app/highlight.directive.ts` 编辑成这样： The `import` statement specifies an additional `ElementRef` symbol from the Angular `core` library: -`import`语句还从 Angular 的 `core` 库中导入了一个 `ElementRef` 符号。 +`import` 语句还从 Angular 的 `core` 库中导入了一个 `ElementRef` 符号。 You use the `ElementRef`in the directive's constructor to [inject](guide/dependency-injection) a reference to the host DOM element, the element to which you applied `appHighlight`. -我们可以在指令的构造函数中注入`ElementRef`，来引用宿主 DOM 元素， +我们可以在指令的构造函数中注入 `ElementRef`，来引用宿主 DOM 元素， `ElementRef` grants direct access to the host DOM element through its `nativeElement` property. @@ -194,7 +194,7 @@ To use the new `HighlightDirective`, add a paragraph (`

    `) element to the temp Now run the application to see the `HighlightDirective` in action. -运行这个应用以查看`HighlightDirective`的实际效果。 +运行这个应用以查看 `HighlightDirective` 的实际效果。 @@ -207,9 +207,9 @@ It created an instance of the `HighlightDirective` class and injected a reference to the `

    ` element into the directive's constructor which sets the `

    ` element's background style to yellow. -总结：Angular 在**宿主**元素`

    `上发现了一个`appHighlight`属性。 -然后它创建了一个`HighlightDirective`类的实例，并把所在元素的引用注入到了指令的构造函数中。 -在构造函数中，我们把`

    `元素的背景设置为了黄色。 +总结：Angular 在**宿主**元素 `

    ` 上发现了一个 `appHighlight` 属性。 +然后它创建了一个 `HighlightDirective` 类的实例，并把所在元素的引用注入到了指令的构造函数中。 +在构造函数中，我们把 `

    ` 元素的背景设置为了黄色。 {@a respond-to-user} @@ -222,33 +222,33 @@ The directive could be more dynamic. It could detect when the user mouses into or out of the element and respond by setting or clearing the highlight color. -当前，`appHighlight`只是简单的设置元素的颜色。 +当前，`appHighlight` 只是简单的设置元素的颜色。 这个指令应该在用户鼠标悬浮一个元素时，设置它的颜色。 Begin by adding `HostListener` to the list of imported symbols. -先把`HostListener`加进导入列表中，同时再添加`Input`符号，因为我们很快就要用到它。 +先把 `HostListener` 加进导入列表中，同时再添加 `Input` 符号，因为我们很快就要用到它。 Then add two eventhandlers that respond when the mouse enters or leaves, each adorned by the `HostListener` decorator. -然后使用`HostListener`装饰器添加两个事件处理器，它们会在鼠标进入或离开时进行响应。 +然后使用 `HostListener` 装饰器添加两个事件处理器，它们会在鼠标进入或离开时进行响应。 The `@HostListener` decorator lets you subscribe to events of the DOM element that hosts an attribute directive, the `

    ` in this case. -`@HostListener`装饰器引用属性型指令的宿主元素，在这个例子中就是`

    `。 +`@HostListener` 装饰器引用属性型指令的宿主元素，在这个例子中就是 `

    `。

    Of course you could reach into the DOM with standard JavaScript and attach event listeners manually. There are at least three problems with _that_ approach: -当然，你可以通过标准的JavaScript方式手动给宿主 DOM 元素附加一个事件监听器。 +当然，你可以通过标准的 JavaScript 方式手动给宿主 DOM 元素附加一个事件监听器。 但这种方法至少有三个问题： 1. You have to write the listeners correctly. @@ -267,7 +267,7 @@ There are at least three problems with _that_ approach: The handlers delegate to a helper method that sets the color on the host DOM element, `el`. -这些处理器委托了一个辅助方法来为DOM元素（`el`）设置颜色。 +这些处理器委托了一个辅助方法来为 DOM 元素（`el`）设置颜色。 The helper method, `highlight`, was extracted from the constructor. The revised constructor simply declares the injected `el: ElementRef`. @@ -286,7 +286,7 @@ Here's the updated directive in full: Run the app and confirm that the background color appears when the mouse hovers over the `p` and disappears as it moves out. -运行本应用并确认：当把鼠标移到`p`上的时候，背景色就出现了，而移开的时候，它消失了。 +运行本应用并确认：当把鼠标移到 `p` 上的时候，背景色就出现了，而移开的时候，它消失了。
    Second Highlight @@ -306,13 +306,13 @@ In this section, you give the developer the power to set the highlight color whi Begin by adding `Input` to the list of symbols imported from `@angular/core`. -我们先从`@angular/core`中导入`Input`。 +我们先从 `@angular/core` 中导入 `Input`。 Add a `highlightColor` property to the directive class like this: -然后把`highlightColor`属性添加到指令类中，就像这样： +然后把 `highlightColor` 属性添加到指令类中，就像这样： @@ -324,23 +324,23 @@ Add a `highlightColor` property to the directive class like this: Notice the `@Input` decorator. It adds metadata to the class that makes the directive's `highlightColor` property available for binding. -注意看`@Input`装饰器。它往类上添加了一些元数据，从而让该指令的`highlightColor`能用于绑定。 +注意看 `@Input` 装饰器。它往类上添加了一些元数据，从而让该指令的 `highlightColor` 能用于绑定。 It's called an *input* property because data flows from the binding expression _into_ the directive. Without that input metadata, Angular rejects the binding; see [below](guide/attribute-directives#why-input "Why add @Input?") for more about that. 它之所以称为*输入*属性，是因为数据流是从绑定表达式流向指令内部的。 -如果没有这个元数据，Angular就会拒绝绑定，参见[稍后](guide/attribute-directives#why-input "为什么要添加@Input?")了解更多。 +如果没有这个元数据，Angular 就会拒绝绑定，参见[稍后](guide/attribute-directives#why-input "为什么要添加@Input?")了解更多。 Try it by adding the following directive binding variations to the `AppComponent` template: -试试把下列指令绑定变量添加到`AppComponent`的模板中： +试试把下列指令绑定变量添加到 `AppComponent` 的模板中： Add a `color` property to the `AppComponent`. -把`color`属性添加到`AppComponent`中： +把 `color` 属性添加到 `AppComponent` 中： @@ -361,19 +361,19 @@ and sets the directive's highlight color with a property binding. You're re-using the directive's attribute selector (`[appHighlight]`) to do both jobs. That's a crisp, compact syntax. -`[appHighlight]`属性同时做了两件事：把这个高亮指令应用到了`

    `元素上，并且通过属性绑定设置了该指令的高亮颜色。 -我们复用了该指令的属性选择器`[appHighlight]`来同时完成它们。 +`[appHighlight]` 属性同时做了两件事：把这个高亮指令应用到了 `

    ` 元素上，并且通过属性绑定设置了该指令的高亮颜色。 +我们复用了该指令的属性选择器 `[appHighlight]` 来同时完成它们。 这是清爽、简约的语法。 You'll have to rename the directive's `highlightColor` property to `appHighlight` because that's now the color property binding name. -我们还要把该指令的`highlightColor`改名为`myHighlight`，因为它是颜色属性目前的绑定名。 +我们还要把该指令的 `highlightColor` 改名为 `myHighlight`，因为它是颜色属性目前的绑定名。 This is disagreeable. The word, `appHighlight`, is a terrible property name and it doesn't convey the property's intent. -这可不好。因为`appHighlight`是一个糟糕的属性名，而且不能反映该属性的意图。 +这可不好。因为 `appHighlight` 是一个糟糕的属性名，而且不能反映该属性的意图。 {@a input-alias} @@ -387,14 +387,14 @@ Fortunately you can name the directive property whatever you want _and_ **_alias Restore the original property name and specify the selector as the alias in the argument to `@Input`. -恢复原始属性名，并在`@Input`的参数中把选择器`myHighlight`指定为别名。 +恢复原始属性名，并在 `@Input` 的参数中把选择器 `myHighlight` 指定为别名。 _Inside_ the directive the property is known as `highlightColor`. _Outside_ the directive, where you bind to it, it's known as `appHighlight`. -在指令内部，该属性叫`highlightColor`，在外部，当我们绑定到它时，它叫`appHighlight`。 +在指令内部，该属性叫 `highlightColor`，在外部，当我们绑定到它时，它叫 `appHighlight`。 You get the best of both worlds: the property name you want and the binding syntax you want: @@ -405,8 +405,8 @@ You get the best of both worlds: the property name you want and the binding synt Now that you're binding via the alias to the `highlightColor`, modify the `onMouseEnter()` method to use that property. If someone neglects to bind to `appHighlightColor`, highlight the host element in red: -现在，我们绑定到了`highlightColor`属性，并修改`onMouseEnter()`方法来使用它。 -如果有人忘了绑定到`appHighlightColor`，那就用红色进行高亮。 +现在，我们绑定到了 `highlightColor` 属性，并修改 `onMouseEnter()` 方法来使用它。 +如果有人忘了绑定到 `appHighlightColor`，那就用红色进行高亮。 @@ -425,17 +425,17 @@ In this section, you'll turn `AppComponent` into a harness that lets you pick the highlight color with a radio button and bind your color choice to the directive. 凭空想象该指令如何工作可不容易。 -在本节，我们将把`AppComponent`改成一个测试程序，它让你可以通过单选按钮来选取高亮颜色，并且把你选取的颜色绑定到指令中。 +在本节，我们将把 `AppComponent` 改成一个测试程序，它让你可以通过单选按钮来选取高亮颜色，并且把你选取的颜色绑定到指令中。 Update app.component.html as follows: -把`app.component.html`修改成这样： +把 `app.component.html` 修改成这样： Revise the `AppComponent.color` so that it has no initial value. -修改`AppComponent.color`，让它不再有初始值。 +修改 `AppComponent.color`，让它不再有初始值。 @@ -465,34 +465,34 @@ Let the template developer set the default color. Add a second **input** property to `HighlightDirective` called `defaultColor`: -把第二个名叫`defaultColor`的**输入**属性添加到`HighlightDirective`中： +把第二个名叫 `defaultColor` 的**输入**属性添加到 `HighlightDirective` 中： Revise the directive's `onMouseEnter` so that it first tries to highlight with the `highlightColor`, then with the `defaultColor`, and falls back to "red" if both properties are undefined. -修改该指令的`onMouseEnter`，让它首先尝试使用`highlightColor`进行高亮，然后用`defaultColor`，如果它们都没有指定，那就用红色作为后备。 +修改该指令的 `onMouseEnter`，让它首先尝试使用 `highlightColor` 进行高亮，然后用 `defaultColor`，如果它们都没有指定，那就用红色作为后备。 How do you bind to a second property when you're already binding to the `appHighlight` attribute name? -当已经绑定过`appHighlight`属性时，要如何绑定到第二个属性呢？ +当已经绑定过 `appHighlight` 属性时，要如何绑定到第二个属性呢？ As with components, you can add as many directive property bindings as you need by stringing them along in the template. The developer should be able to write the following template HTML to both bind to the `AppComponent.color` and fall back to "violet" as the default color. 像组件一样，你也可以绑定到指令的很多属性，只要把它们依次写在模板中就行了。 -开发者可以绑定到`AppComponent.color`，并且用紫罗兰色作为默认颜色，代码如下： +开发者可以绑定到 `AppComponent.color`，并且用紫罗兰色作为默认颜色，代码如下： Angular knows that the `defaultColor` binding belongs to the `HighlightDirective` because you made it _public_ with the `@Input` decorator. -Angular之所以知道`defaultColor`绑定属于`HighlightDirective`，是因为我们已经通过`@Input`装饰器把它设置成了*公共*属性。 +Angular 之所以知道 `defaultColor` 绑定属于 `HighlightDirective`，是因为我们已经通过 `@Input` 装饰器把它设置成了*公共*属性。 Here's how the harness should work when you're done coding. @@ -554,7 +554,7 @@ You can also experience and download the @@ -568,13 +568,13 @@ Either way, the `@Input` decorator tells Angular that this property is _public_ and available for binding by a parent component. Without `@Input`, Angular refuses to bind to the property. -无论哪种方式，`@Input`装饰器都告诉Angular，该属性是*公共的*，并且能被父组件绑定。 -如果没有`@Input`，Angular就会拒绝绑定到该属性。 +无论哪种方式，`@Input` 装饰器都告诉 Angular，该属性是*公共的*，并且能被父组件绑定。 +如果没有 `@Input`，Angular 就会拒绝绑定到该属性。 You've bound template HTML to component properties before and never used `@Input`. What's different? -但我们以前也曾经把模板HTML绑定到组件的属性，而且从来没有用过`@Input`。 +但我们以前也曾经把模板 HTML 绑定到组件的属性，而且从来没有用过 `@Input`。 差异何在？ The difference is a matter of trust. @@ -584,9 +584,9 @@ Therefore, the component's own template may bind to _any_ property of that compo with or without the `@Input` decorator. 差异在于信任度不同。 -Angular把组件的模板看做*从属于*该组件的。 +Angular 把组件的模板看做*从属于*该组件的。 组件和它的模板默认会相互信任。 -这也就是意味着，组件自己的模板可以绑定到组件的*任意*属性，无论是否使用了`@Input`装饰器。 +这也就是意味着，组件自己的模板可以绑定到组件的*任意*属性，无论是否使用了 `@Input` 装饰器。 But a component or directive shouldn't blindly trust _other_ components and directives. The properties of a component or directive are hidden from binding by default. @@ -596,23 +596,23 @@ Only then can it be bound by some other component or directive. 但组件或指令不应该盲目的信任其它组件或指令。 因此组件或指令的属性默认是不能被绑定的。 -从Angular绑定机制的角度来看，它们是*私有*的，而当添加了`@Input`时，它们变成了*公共*的 +从 Angular 绑定机制的角度来看，它们是*私有*的，而当添加了 `@Input` 时，它们变成了*公共*的 只有这样，它们才能被其它组件或属性绑定。 You can tell if `@Input` is needed by the position of the property name in a binding. -你可以根据属性名在绑定中出现的位置来判定是否要加`@Input`。 +你可以根据属性名在绑定中出现的位置来判定是否要加 `@Input`。 * When it appears in the template expression to the ***right*** of the equals (=), it belongs to the template's component and does not require the `@Input` decorator. - 当它出现在等号***右侧***的模板表达式中时，它属于模板所在的组件，不需要`@Input`装饰器。 + 当它出现在等号***右侧***的模板表达式中时，它属于模板所在的组件，不需要 `@Input` 装饰器。 * When it appears in **square brackets** ([ ]) to the **left** of the equals (=), the property belongs to some _other_ component or directive; that property must be adorned with the `@Input` decorator. - 当它出现在等号**左边**的**方括号（[ ]）**中时，该属性属于*其它*组件或指令，它必须带有`@Input` 装饰器。 + 当它出现在等号**左边**的**方括号（[ ]）**中时，该属性属于*其它*组件或指令，它必须带有 `@Input` 装饰器。 Now apply that reasoning to the following example: @@ -624,12 +624,12 @@ Now apply that reasoning to the following example: The template and its component trust each other. The `color` property doesn't require the `@Input` decorator. - `color`属性位于右侧的绑定表达式中，它属于模板所在的组件。 - 该模板和组件相互信任。因此`color`不需要`@Input`装饰器。 + `color` 属性位于右侧的绑定表达式中，它属于模板所在的组件。 + 该模板和组件相互信任。因此 `color` 不需要 `@Input` 装饰器。 * The `appHighlight` property on the left refers to an _aliased_ property of the `HighlightDirective`, not a property of the template's component. There are trust issues. Therefore, the directive property must carry the `@Input` decorator. - `appHighlight`属性位于左侧，它引用了`HighlightDirective`中一个*带别名的*属性，它不是模板所属组件的一部分，因此存在信任问题。 -所以，该属性必须带`@Input`装饰器。 + `appHighlight` 属性位于左侧，它引用了 `HighlightDirective` 中一个*带别名的*属性，它不是模板所属组件的一部分，因此存在信任问题。 +所以，该属性必须带 `@Input` 装饰器。 diff --git a/aio/content/guide/bootstrapping.md b/aio/content/guide/bootstrapping.md index a83e64a779..c7aa6d8101 100644 --- a/aio/content/guide/bootstrapping.md +++ b/aio/content/guide/bootstrapping.md @@ -82,7 +82,7 @@ The `@NgModule` decorator identifies `AppModule` as an `NgModule` class. * **_bootstrap_**—the _root_ component that Angular creates and inserts into the `index.html` host web page. - **_bootstrap_** —— *根*组件，Angular 创建它并插入`index.html`宿主页面。 + **_bootstrap_** —— *根*组件，Angular 创建它并插入 `index.html` 宿主页面。 The default CLI application only has one component, `AppComponent`, so it is in both the `declarations` and the `bootstrap` arrays. @@ -279,7 +279,7 @@ root module's `bootstrap` array. ## More about Angular Modules -## 关于Angular模块的更多知识 +## 关于 Angular 模块的更多知识 For more on NgModules you're likely to see frequently in apps, see [Frequently Used Modules](#). diff --git a/aio/content/guide/browser-support.md b/aio/content/guide/browser-support.md index 36c83e5b3b..762f28020b 100644 --- a/aio/content/guide/browser-support.md +++ b/aio/content/guide/browser-support.md @@ -224,7 +224,7 @@ 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. -**强制性** 腻子脚本（如`zone.js`）的npm 包在创建项目时就已经自动安装了，相应的 `import` 语句也都加好了。我们一般不用动它们。 +**强制性** 腻子脚本（如 `zone.js`）的 npm 包在创建项目时就已经自动安装了，相应的 `import` 语句也都加好了。我们一般不用动它们。 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): @@ -465,7 +465,7 @@ Here are the features which may require additional polyfills:

    If AnimationBuilder is used then the polyfill will enable scrubbing support for IE/Edge and Safari (Chrome and Firefox support this natively).

    -

    如果使用了AnimationBuilder，那么腻子脚本将为 IE/Edge 和 Safari 启用擦除（scrubbing）支持（Chrome 和 Firefox 原生支持此特性）

    +

    如果使用了 AnimationBuilder，那么腻子脚本将为 IE/Edge 和 Safari 启用擦除（scrubbing）支持（Chrome 和 Firefox 原生支持此特性）

    @@ -477,7 +477,7 @@ Here are the features which may require additional polyfills: If you use the following deprecated i18n pipes: - 如果你使用下列已废弃的i18n管道： + 如果你使用下列已废弃的 i18n 管道： [date](api/common/DeprecatedDatePipe), diff --git a/aio/content/guide/change-log.md b/aio/content/guide/change-log.md index 8365684771..52e4808f7c 100644 --- a/aio/content/guide/change-log.md +++ b/aio/content/guide/change-log.md @@ -5,7 +5,7 @@ The Angular documentation is a living document with continuous improvements. This log calls attention to recent significant changes. -我们将持续不断的更新和改进Angular文档。本日志记录了近期最重要的变更。 +我们将持续不断的更新和改进 Angular 文档。本日志记录了近期最重要的变更。 ## Updated to Angular 4.0. Documentation for Angular 2.x can be found at [v2.angular.io](https://v2.angular.io). @@ -13,19 +13,19 @@ This log calls attention to recent significant changes. ## All mention of moduleId removed. "Component relative paths" guide deleted (2017-03-13) -## 移除了所有的moduleId引用。移除了“组件相对路径” 的烹饪书。(2017-03-13) +## 移除了所有的 moduleId 引用。移除了“组件相对路径” 的烹饪书。(2017-03-13) We added a new SystemJS plugin (systemjs-angular-loader.js) to our recommended SystemJS configuration. This plugin dynamically converts "component-relative" paths in templateUrl and styleUrls to "absolute paths" for you. -我们往建议的SystemJS配置中新增了一个SystemJS插件 (systemjs-angular-loader.js) 。 -这个插件可以帮你把templateUrl和styleUrls中的组件相对路径动态转换为绝对路径。 +我们往建议的 SystemJS 配置中新增了一个 SystemJS 插件 (systemjs-angular-loader.js) 。 +这个插件可以帮你把 templateUrl 和 styleUrls 中的组件相对路径动态转换为绝对路径。 We strongly encourage you to only write component-relative paths. That is the only form of URL discussed in these docs. You no longer need to write @Component({ moduleId: module.id }), nor should you. 我们强烈建议你只写组件相对路径。 -这也是本文档中所使用的唯一形式。你不必再写`@Component({ moduleId: module.id })`，而且也不应该再这么写。 +这也是本文档中所使用的唯一形式。你不必再写 `@Component({ moduleId: module.id })`，而且也不应该再这么写。 ## NEW: Downloadable examples for each guide (2017-02-28) @@ -47,20 +47,20 @@ Discusses ``. Revised samples are more clear and cover all topics discussed. 对[模板语法](guide/template-syntax) 和 [结构型指令](guide/structural-directives)这两篇指南做了大幅修改，来让它们更加清晰、准确，并符合当前的最佳实践。 -讨论了``。 +讨论了 ``。 修改了例子，来让它们更清晰，并且涵盖了所有讨论到的主题。 ## NEW: Samples re-structured with `src/` folder (2017-02-02) -## 新增：调整了范例程序的结构，移到了`src/`文件夹 (2017-02-02) +## 新增：调整了范例程序的结构，移到了 `src/` 文件夹 (2017-02-02) All documentation samples have been realigned with the default folder structure of the Angular CLI. That's a step along the road to basing the sample in the Angular CLI. But it's also good in its own right. It helps clearly separate app code from setup and configuration files. -所有的文档范例都已经向Angular CLI的默认文件夹结构看齐了。 -这是把范例迁移到Angular CLI过程中的一步。 +所有的文档范例都已经向 Angular CLI 的默认文件夹结构看齐了。 +这是把范例迁移到 Angular CLI 过程中的一步。 不过也不仅是为了迁移，它确实能帮我们把应用代码从环境代码和配置代码中分离出来。 All samples now have a `src/` folder at the project root. @@ -69,9 +69,9 @@ Read about moving your existing project to this structure in the QuickStart repo update instructions. -我们已经把所有范例改成了使用项目根目录下的`src/`文件夹。 -也就是把以前的`app/`文件夹移到了`src/`文件夹下面。 -要了解如何对你的现有项目进行这种迁移，请参阅QuickStart中的迁移指南。 +我们已经把所有范例改成了使用项目根目录下的 `src/` 文件夹。 +也就是把以前的 `app/` 文件夹移到了 `src/` 文件夹下面。 +要了解如何对你的现有项目进行这种迁移，请参阅QuickStart 中的迁移指南。 Notably: @@ -79,23 +79,23 @@ Notably: * `app/main.ts` moved to `src/main.ts`. - 把`app/main.ts`移到`src/main.ts`。 + 把 `app/main.ts` 移到 `src/main.ts`。 * `app/` moved to `src/app/`. - 把`app/`移到`src/app/`。 + 把 `app/` 移到 `src/app/`。 * `index.html`, `styles.css` and `tsconfig.json` moved inside `src/`. - 把`index.html`、`styles.css`和`tsconfig.json`移到`src/`中。 + 把 `index.html`、`styles.css` 和 `tsconfig.json` 移到 `src/` 中。 * `systemjs.config.js` now imports `main.js` instead of `app`. - `systemjs.config.js`现在要导入`main.js`而不是`app`。 + `systemjs.config.js` 现在要导入 `main.js` 而不是 `app`。 * Added `lite-server` configuration (`bs-config.json`) to serve `src/`. - 新增了一个`lite-server`配置(`bs-config.json`)以便在`src/`下启动开发服务器。 + 新增了一个 `lite-server` 配置(`bs-config.json`)以便在 `src/` 下启动开发服务器。 ## NEW: Reactive Forms guide (2017-01-31) @@ -131,7 +131,7 @@ It includes important advice on optimizing for production. Closes issue #3086. Revised samples are clearer and cover all topics discussed. -[多级依赖注入](guide/hierarchical-dependency-injection)做了显著修改。关闭了issue #3086。修改过的范例更加清晰，而且涵盖了讨论到的全部主题。 +[多级依赖注入](guide/hierarchical-dependency-injection)做了显著修改。关闭了 issue #3086。修改过的范例更加清晰，而且涵盖了讨论到的全部主题。 ## Miscellaneous (2017-01-05) @@ -145,11 +145,11 @@ added (optional) instructions on how to remove _non-essential_ files. * No longer consolidate RxJS operator imports in `rxjs-extensions` file; each file should import what it needs. - 不再在`rxjs-extensions`文件中统一导入RxJS的操作符，每个文件应该各自导入它自己所需的。 + 不再在 `rxjs-extensions` 文件中统一导入 RxJS 的操作符，每个文件应该各自导入它自己所需的。 * All samples prepend template/style URLs with `./` as a best practice. - 所有范例都在模板/样式的URL之前添加`./`前缀 …… 而且你在实际开发中也应该这么做。 + 所有范例都在模板/样式的 URL 之前添加 `./` 前缀 …… 而且你在实际开发中也应该这么做。 * [Style Guide](guide/styleguide): copy edits and revised rules. @@ -175,37 +175,37 @@ HTTP guide. ## Testing: added component test plunkers (2016-12-02) -## 测试：添加了组件测试的plunker范例 (2016-12-02) +## 测试：添加了组件测试的 plunker 范例 (2016-12-02) Added two plunkers that each test _one simple component_ so you can write a component test plunker of your own: one for the QuickStart seed's `AppComponent` and another for the Testing guide's `BannerComponent`. Linked to these plunkers in "Testing" and "Setup anatomy" guides. -添加了两个plunker例子，每个都测试一个简单的组件，以便你可以自己在plunker中写组件测试：一个用于测试快速起步中的`AppComponent`，另一个用于测试“测试”章节的`BannerComponent`。 +添加了两个 plunker 例子，每个都测试一个简单的组件，以便你可以自己在 plunker 中写组件测试：一个用于测试快速起步中的 `AppComponent`，另一个用于测试“测试”章节的 `BannerComponent`。 并在“测试”和“环境设置剖析”中链接到它们。 ## Internationalization: pluralization and _select_ (2016-11-30) -## 国际化：单复数和`select` (2016-11-30) +## 国际化：单复数和 `select` (2016-11-30) The [Internationalization (i18n)](guide/i18n) guide explains how to handle pluralization and translation of alternative texts with `select`. The sample demonstrates these features too. -[国际化 (i18n)](guide/i18n)解释了如何处理单复数问题，和如何使用`select`来翻译候选内容。 +[国际化 (i18n)](guide/i18n)解释了如何处理单复数问题，和如何使用 `select` 来翻译候选内容。 例子中也演示了这些特性。 ## Testing: karma file updates (2016-11-30) -## 测试：更新了karma文件 (2016-11-30) +## 测试：更新了 karma 文件 (2016-11-30) * `karma.config` + `karma-test-shim` can handle multiple spec source paths; see quickstart issue: [angular/quickstart#294](https://github.com/angular/quickstart/issues/294). - `karma.config` + `karma-test-shim`可以处理多个测试源文件路径了，参见[angular/quickstart#294](https://github.com/angular/quickstart/issues/294)。 + `karma.config` + `karma-test-shim` 可以处理多个测试源文件路径了，参见[angular/quickstart#294](https://github.com/angular/quickstart/issues/294)。 * Displays Jasmine Runner output in the karma-launched browser. - 在启动了karma的浏览器中显示Jasmine的输出。 + 在启动了 karma 的浏览器中显示 Jasmine 的输出。 ## QuickStart Rewrite (2016-11-18) @@ -224,15 +224,15 @@ You are no longer asked to copy-and-paste code into setup files that were not ex ## Sync with Angular v.2.2.0 (2016-11-14) -## 与Angular v.2.2.0同步(2016-11-14) +## 与 Angular v.2.2.0 同步(2016-11-14) Docs and code samples updated and tested with Angular v.2.2.0. -使用Angular v.2.2.0更新和测试所有文档和代码例子。 +使用 Angular v.2.2.0 更新和测试所有文档和代码例子。 ## UPDATE: NgUpgrade Guide for the AOT friendly _upgrade/static_ module (2016-11-14) -## 更新：用于AoT的_upgrade/static_模块NgUpgrade指南 (2016-11-14) +## 更新：用于 AoT 的_upgrade/static_模块 NgUpgrade 指南 (2016-11-14) The updated [NgUpgrade Guide](guide/upgrade) guide covers the new AOT friendly `upgrade/static` module @@ -240,52 +240,52 @@ released in v.2.2.0, which is the recommended facility for migrating from AngularJS to Angular. The documentation for the version prior to v.2.2.0 has been removed. -更新的[NgUpgrade指南](guide/upgrade)涵盖在v.2.2.0发布的AoT`upgrade/static`模块， -是从AngularJS升级至Angular的推荐工具。 -删除早于v.2.2.0版本的文档。 +更新的[NgUpgrade 指南](guide/upgrade)涵盖在 v.2.2.0 发布的 AoT`upgrade/static` 模块， +是从 AngularJS 升级至 Angular 的推荐工具。 +删除早于 v.2.2.0 版本的文档。 ## ES6 described in "TypeScript to JavaScript" (2016-11-14) -## 在“从TypeScript到JavaScript”增加ES6的描述 (2016-11-14) +## 在“从 TypeScript 到 JavaScript”增加 ES6 的描述 (2016-11-14) The updated TypeScript to JavaScript guide explains how to write apps in ES6/7 by translating the common idioms in the TypeScript documentation examples (and elsewhere on the web) to ES6/7 and ES5. -更新了“从TypeScript到JavaScript”，以解释如何使用ES6/7编写应用。 -将TypeScript文档示例中（以及网站其它地方）的习惯用法翻译成ES6/7和ES5。 +更新了“从 TypeScript 到 JavaScript”，以解释如何使用 ES6/7 编写应用。 +将 TypeScript 文档示例中（以及网站其它地方）的习惯用法翻译成 ES6/7 和 ES5。 This was [removed in August 2017](https://github.com/angular/angular/pull/18694) but can still be viewed in the [v2 documentation](https://v2.angular.io/docs/ts/latest/cookbook/ts-to-js.html). -本章已经 [于2017年8月移除](https://github.com/angular/angular/pull/18694)， +本章已经 [于 2017 年 8 月移除](https://github.com/angular/angular/pull/18694)， 不过仍然可以在[第二版的文档中](https://v2.angular.io/docs/ts/latest/cookbook/ts-to-js.html)看到。 ## Sync with Angular v.2.1.1 (2016-10-21) -## 与Angular v.2.1.1 同步(2016-10-21) +## 与 Angular v.2.1.1 同步(2016-10-21) Docs and code samples updated and tested with Angular v.2.1.1. -使用Angular v.2.1.1更新和测试所有文档和代码例子。 +使用 Angular v.2.1.1 更新和测试所有文档和代码例子。 ## npm _@types_ packages replace _typings_ (2016-10-20) -## 使用npm的_@types_包替换_typings_ (2016-10-20) +## 使用 npm 的_@types_包替换_typings_ (2016-10-20) Documentation samples now get TypeScript type information for 3rd party libraries from npm `@types` packages rather than with the _typings_ tooling. The `typings.json` file is gone. -文档例子现在从npm的`@types`第三方库获取TypeScript类型信息，不再使用_typings_。 -删除`typings.json`文件。 +文档例子现在从 npm 的 `@types` 第三方库获取 TypeScript 类型信息，不再使用_typings_。 +删除 `typings.json` 文件。 The [AngularJS Upgrade](guide/upgrade) guide reflects this change. The `package.json` installs `@types/angular` and several `@types/angular-...` packages in support of upgrade; these are not needed for pure Angular development. -"[从AngularJS升级](guide/upgrade)"指南反映了这个变化。 -`package.json`安装`@types/angular`和一些`@types/angular-...`包来支持升级。它们在纯Angular开发中是不需要的。 +"[从 AngularJS 升级](guide/upgrade)"指南反映了这个变化。 +`package.json` 安装 `@types/angular` 和一些 `@types/angular-...` 包来支持升级。它们在纯 Angular 开发中是不需要的。 ## "Template Syntax" explains two-way data binding syntax (2016-10-20) @@ -294,20 +294,20 @@ packages in support of upgrade; these are not needed for pure Angular developmen Demonstrates how to two-way data bind to a custom Angular component and re-explains `[(ngModel)]` in terms of the basic `[()]` syntax. -展示了如何在自定义Angular组件中双向数据绑定，用基础`[()]`重新解释`[(ngModel)]`。 +展示了如何在自定义 Angular 组件中双向数据绑定，用基础 `[()]` 重新解释 `[(ngModel)]`。 ## BREAKING CHANGE: `in-memory-web-api` (v.0.1.11) delivered as esm umd (2016-10-19) -## 破坏性变化：`in-memory-web-api` (v.0.1.11) 以esm umd的形式发布 (2016-10-19) +## 破坏性变化：`in-memory-web-api` (v.0.1.11) 以 esm umd 的形式发布 (2016-10-19) This change supports ES6 developers and aligns better with typical Angular libraries. It does not affect the module's API but it does affect how you load and import it. See the change note in the `in-memory-web-api` repo. -这个变化支持ES6开发者，并与典型的Angular库看齐。 -它不会影响模块的API，但是它改变了加载和导入它的方式。 -参见`in-memory-web-api`库的变更记录。 +这个变化支持 ES6 开发者，并与典型的 Angular 库看齐。 +它不会影响模块的 API，但是它改变了加载和导入它的方式。 +参见 `in-memory-web-api` 库的变更记录。 ## "Router" _preload_ syntax and _:enter_/_:leave_ animations (2016-10-19) @@ -320,15 +320,15 @@ _before_ the user navigates to them for improved perceived performance. New `:enter` and `:leave` aliases make animation more natural. -新`:enter`和`:leave`语法，让动画更加自然。 +新 `:enter` 和 `:leave` 语法，让动画更加自然。 ## Sync with Angular v.2.1.0 (2016-10-12) -## 与Angular v.2.1.0同步(2016-10-12) +## 与 Angular v.2.1.0 同步(2016-10-12) Docs and code samples updated and tested with Angular v.2.1.0. -使用Angular v.2.1.0更新和测试所有文档和代码例子。 +使用 Angular v.2.1.0 更新和测试所有文档和代码例子。 ## NEW "Ahead of time (AOT) Compilation" guide (2016-10-11) @@ -339,16 +339,16 @@ explains what AOT compilation is and why you'd want it. It demonstrates the basics with a QuickStart app followed by the more advanced considerations of compiling and bundling the Tour of Heroes. -全新[预编译(AoT)](guide/aot-compiler)烹饪书介绍了什么是AoT编译和为何你需要它。 +全新[预编译(AoT)](guide/aot-compiler)烹饪书介绍了什么是 AoT 编译和为何你需要它。 它以**快速上手**应用程序开始讲解，接着介绍了编译和构建**英雄指南**的更高级的注意事项。 ## Sync with Angular v.2.0.2 (2016-10-6) -## 与Angular v.2.0.2同步 (2016-10-6) +## 与 Angular v.2.0.2 同步 (2016-10-6) Docs and code samples updated and tested with Angular v.2.0.2. -使用Angular v.2.0.2更新和测试所有文档和代码例子。 +使用 Angular v.2.0.2 更新和测试所有文档和代码例子。 ## "Routing and Navigation" guide with the _Router Module_ (2016-10-5) @@ -359,13 +359,13 @@ in a _Routing Module_. The _Routing Module_ replaces the previous _routing object_ involving the `ModuleWithProviders`. [Routing and Navigation](guide/router)现在在**路由模块**中设置路由配置。 -**路由模块**替换之前的**路由对象**，使用了`ModuleWithProviders`。 +**路由模块**替换之前的**路由对象**，使用了 `ModuleWithProviders`。 All guided samples with routing use the _Routing Module_ and prose content has been updated, most conspicuously in the [NgModule](guide/ngmodules) guide and [NgModule FAQ](guide/ngmodule-faq) guide. -所有使用路由的例子都使用**路由模块**，相关内容也被更新。更新最多的是[Angular模块（NgModule）](guide/ngmodules)章和[Angular模块常见问题](guide/ngmodule-faq)烹饪书。 +所有使用路由的例子都使用**路由模块**，相关内容也被更新。更新最多的是[Angular 模块（NgModule）](guide/ngmodules)章和[Angular 模块常见问题](guide/ngmodule-faq)烹饪书。 ## New "Internationalization" guide (2016-09-30) @@ -374,7 +374,7 @@ most conspicuously in the Added a new [Internationalization (i18n)](guide/i18n) guide that shows how to use Angular "i18n" facilities to translate template text into multiple languages. -添加了新的[国际化(i18n)](guide/i18n)烹饪书，展示了如何使用Angular的“i18n”工具来讲模板文本翻译到多种语言。 +添加了新的[国际化(i18n)](guide/i18n)烹饪书，展示了如何使用 Angular 的“i18n”工具来讲模板文本翻译到多种语言。 ## "angular-in-memory-web-api" package rename (2016-09-27) @@ -383,7 +383,7 @@ to use Angular "i18n" facilities to translate template text into multiple langua Many samples use the `angular-in-memory-web-api` to simulate a remote server. This library is also useful to you during early development before you have a server to talk to. -许多例子使用了`angular-in-memory-web-api`来模拟远程服务器。 +许多例子使用了 `angular-in-memory-web-api` 来模拟远程服务器。 这个库在你拥有服务器之前的早期开发阶段也很有用。 The package name was changed from "angular2-in-memory-web-api" which is still frozen-in-time on npm. @@ -392,7 +392,7 @@ The new "angular-in-memory-web-api" has new features. 这个包的名字从“angular2-in-memory-web-api”（仍然有效，但不再更新了）重新命名了。 新的“angular-in-memory-web-api”有新的功能。 -到github获得更多详情. +到 github 获得更多详情. ## "Style Guide" with _NgModules_ (2016-09-27) @@ -403,26 +403,26 @@ Barrels now are far less useful and have been removed from the style guide; they remain valuable but are not a matter of Angular style. Also relaxed the rule that discouraged use of the `@Component.host` property. -[StyleGuide](guide/styleguide)解释了我们为Angular模块（NgModule）而推荐的约定。 +[StyleGuide](guide/styleguide)解释了我们为 Angular 模块（NgModule）而推荐的约定。 现在，封装桶不再那么重要，风格指南已经移除了它们。 -它们仍然很有价值，但是它们与Angular风格无关。 -我们同时对**不推荐使用`@Component.host`属性**的规则有所放宽。 +它们仍然很有价值，但是它们与 Angular 风格无关。 +我们同时对**不推荐使用 `@Component.host` 属性**的规则有所放宽。 ## _moduleId: module.id_ everywhere (2016-09-25) -## moduleId：到处添加module.id(2016-09-25) +## moduleId：到处添加 module.id(2016-09-25) Sample components that get their templates or styles with `templateUrl` or `styleUrls` have been converted to _module-relative_ URLs. Added the `moduleId: module.id` property-and-value to their `@Component` metadata. -在所有使用`templateUrl`或者`styleUrls`来获取模板或样式的例子组件都被转换为**相对模块**的URL。 -我们添加了`moduleId: module.id`到它们的`@Component`元数据。 +在所有使用 `templateUrl` 或者 `styleUrls` 来获取模板或样式的例子组件都被转换为**相对模块**的 URL。 +我们添加了 `moduleId: module.id` 到它们的 `@Component` 元数据。 This change is a requirement for compilation with AOT compiler when the app loads modules with SystemJS as the samples currently do. -当应用像例子当前使用的方法一样 - 使用SystemJS加载模块时，本更新是AoT编译器的前提条件。 +当应用像例子当前使用的方法一样 - 使用 SystemJS 加载模块时，本更新是 AoT 编译器的前提条件。 ## "Lifecycle Hooks" guide simplified (2016-09-24) @@ -432,4 +432,4 @@ The [Lifecycle Hooks](guide/lifecycle-hooks) guide is shorter, simpler, and draws more attention to the order in which Angular calls the hooks. -[生命周期钩子](guide/lifecycle-hooks)章现在更加简短，并且对强调了Angular是以什么顺序来调用钩子方法的。 +[生命周期钩子](guide/lifecycle-hooks)章现在更加简短，并且对强调了 Angular 是以什么顺序来调用钩子方法的。 diff --git a/aio/content/guide/cheatsheet.md b/aio/content/guide/cheatsheet.md index e697662fd5..f39074e92c 100644 --- a/aio/content/guide/cheatsheet.md +++ b/aio/content/guide/cheatsheet.md @@ -226,7 +226,7 @@ is available to declarations of this module.

    Binds the presence of the CSS class extra-sparkle on the element to the truthiness of the expression isDelightful.

    -

    根据isDelightful表达式的结果是否为真，决定CSS类extra-sparkle是否出现在当前元素上。

    +

    根据isDelightful表达式的结果是否为真，决定 CSS 类extra-sparkle是否出现在当前元素上。

    @@ -242,7 +242,7 @@ is available to declarations of this module.

    Binds style property width to the result of expression mySize in pixels. Units are optional.

    -

    把CSS样式属性width的px（像素）值绑定到表达式mySize的结果。单位是可选的。

    +

    把 CSS 样式属性width的 px（像素）值绑定到表达式mySize的结果。单位是可选的。

    @@ -258,7 +258,7 @@ is available to declarations of this module.

    Calls method readRainbow when a click event is triggered on this button element (or its children) and passes in the event object.

    -

    当这个按钮元素（及其子元素）上的click事件触发时，调用方法readRainbow，并把这个事件对象作为参数传进去。

    +

    当这个按钮元素（及其子元素）上的 click 事件触发时，调用方法readRainbow，并把这个事件对象作为参数传进去。

    @@ -462,7 +462,7 @@ is available to declarations of this module.

    Turns the li element and its contents into a template, and uses that to instantiate a view for each item in list.

    -

    把li元素及其内容变成一个模板，并使用这个模板为列表中的每一个条目实例化一个视图。

    +

    把 li 元素及其内容变成一个模板，并使用这个模板为列表中的每一个条目实例化一个视图。

    diff --git a/aio/content/guide/component-interaction.md b/aio/content/guide/component-interaction.md index 5102fc8ea6..02549860b9 100644 --- a/aio/content/guide/component-interaction.md +++ b/aio/content/guide/component-interaction.md @@ -27,11 +27,11 @@ in which two or more components share information. * [Intercept input property changes with `ngOnChanges()`](guide/component-interaction#parent-to-child-on-changes) - [使用`ngOnChanges()`拦截输入属性的变化](guide/component-interaction#parent-to-child-on-changes) + [使用 `ngOnChanges()` 拦截输入属性的变化](guide/component-interaction#parent-to-child-on-changes) * [Parent calls an `@ViewChild()`](guide/component-interaction#parent-to-view-child) - [在父组件中调用`@ViewChild()`](guide/component-interaction#parent-to-view-child) + [在父组件中调用 `@ViewChild()`](guide/component-interaction#parent-to-view-child) * [Parent and children communicate via a service](guide/component-interaction#bidirectional-service) @@ -52,7 +52,7 @@ in which two or more components share information. `HeroChildComponent` has two ***input properties***, typically adorned with [@Input decorations](guide/template-syntax#inputs-outputs). -`HeroChildComponent` 有两个***输入型属性***，它们通常带[@Input装饰器](guide/template-syntax#inputs-outputs)。 +`HeroChildComponent` 有两个***输入型属性***，它们通常带[@Input 装饰器](guide/template-syntax#inputs-outputs)。 @@ -60,13 +60,13 @@ typically adorned with [@Input decorations](guide/template-syntax#inputs-outputs The second `@Input` aliases the child component property name `masterName` as `'master'`. -第二个`@Input`为子组件的属性名`masterName`指定一个别名`master`(译者注：不推荐为起别名，请参见风格指南). +第二个 `@Input` 为子组件的属性名 `masterName` 指定一个别名 `master`(译者注：不推荐为起别名，请参见风格指南). The `HeroParentComponent` nests the child `HeroChildComponent` inside an `*ngFor` repeater, binding its `master` string property to the child's `master` alias, and each iteration's `hero` instance to the child's `hero` property. -父组件`HeroParentComponent`把子组件的`HeroChildComponent`放到`*ngFor`循环器中，把自己的`master`字符串属性绑定到子组件的`master`别名上，并把每个循环的`hero`实例绑定到子组件的`hero`属性。 +父组件 `HeroParentComponent` 把子组件的 `HeroChildComponent` 放到 `*ngFor` 循环器中，把自己的 `master` 字符串属性绑定到子组件的 `master` 别名上，并把每个循环的 `hero` 实例绑定到子组件的 `hero` 属性。 @@ -100,16 +100,16 @@ E2E test that all children were instantiated and displayed as expected: ## Intercept input property changes with a setter -## 通过setter截听输入属性值的变化 +## 通过 setter 截听输入属性值的变化 Use an input property setter to intercept and act upon a value from the parent. -使用一个输入属性的setter，以拦截父组件中值的变化，并采取行动。 +使用一个输入属性的 setter，以拦截父组件中值的变化，并采取行动。 The setter of the `name` input property in the child `NameChildComponent` trims the whitespace from a name and replaces an empty value with default text. -子组件`NameChildComponent`的输入属性`name`上的这个setter，会trim掉名字里的空格，并把空值替换成默认字符串。 +子组件 `NameChildComponent` 的输入属性 `name` 上的这个 setter，会 trim 掉名字里的空格，并把空值替换成默认字符串。 @@ -117,7 +117,7 @@ trims the whitespace from a name and replaces an empty value with default text. Here's the `NameParentComponent` demonstrating name variations including a name with all spaces: -下面的`NameParentComponent`展示了各种名字的处理方式，包括一个全是空格的名字。 +下面的 `NameParentComponent` 展示了各种名字的处理方式，包括一个全是空格的名字。 @@ -133,7 +133,7 @@ Here's the `NameParentComponent` demonstrating name variations including a name E2E tests of input property setter with empty and non-empty names: -端到端测试：输入属性的setter，分别使用空名字和非空名字。 +端到端测试：输入属性的 setter，分别使用空名字和非空名字。 @@ -151,23 +151,23 @@ E2E tests of input property setter with empty and non-empty names: Detect and act upon changes to input property values with the `ngOnChanges()` method of the `OnChanges` lifecycle hook interface. -使用`OnChanges`生命周期钩子接口的`ngOnChanges()`方法来监测输入属性值的变化并做出回应。 +使用 `OnChanges` 生命周期钩子接口的 `ngOnChanges()` 方法来监测输入属性值的变化并做出回应。
    You may prefer this approach to the property setter when watching multiple, interacting input properties. -当需要监视多个、交互式输入属性的时候，本方法比用属性的setter更合适。 +当需要监视多个、交互式输入属性的时候，本方法比用属性的 setter 更合适。 Learn about `ngOnChanges()` in the [LifeCycle Hooks](guide/lifecycle-hooks) chapter. -学习关于`ngOnChanges()`的更多知识，参见[生命周期钩子](guide/lifecycle-hooks)一章。 +学习关于 `ngOnChanges()` 的更多知识，参见[生命周期钩子](guide/lifecycle-hooks)一章。
    This `VersionChildComponent` detects changes to the `major` and `minor` input properties and composes a log message reporting these changes: -这个`VersionChildComponent`会监测输入属性`major`和`minor`的变化，并把这些变化编写成日志以报告这些变化。 +这个 `VersionChildComponent` 会监测输入属性 `major` 和 `minor` 的变化，并把这些变化编写成日志以报告这些变化。 @@ -175,7 +175,7 @@ This `VersionChildComponent` detects changes to the `major` and `minor` input pr The `VersionParentComponent` supplies the `minor` and `major` values and binds buttons to methods that change them. -`VersionParentComponent`提供`minor`和`major`值，把修改它们值的方法绑定到按钮上。 +`VersionParentComponent` 提供 `minor` 和 `major` 值，把修改它们值的方法绑定到按钮上。 @@ -196,7 +196,7 @@ Here's the output of a button-pushing sequence: Test that ***both*** input properties are set initially and that button clicks trigger the expected `ngOnChanges` calls and values: -测试确保***这两个***输入属性值都被初始化了，当点击按钮后，`ngOnChanges`应该被调用，属性的值也符合预期。 +测试确保***这两个***输入属性值都被初始化了，当点击按钮后，`ngOnChanges` 应该被调用，属性的值也符合预期。 @@ -215,13 +215,13 @@ the expected `ngOnChanges` calls and values: The child component exposes an `EventEmitter` property with which it `emits` events when something happens. The parent binds to that event property and reacts to those events. -子组件暴露一个`EventEmitter`属性，当事件发生时，子组件利用该属性`emits`(向上弹射)事件。父组件绑定到这个事件属性，并在事件发生时作出回应。 +子组件暴露一个 `EventEmitter` 属性，当事件发生时，子组件利用该属性 `emits`(向上弹射)事件。父组件绑定到这个事件属性，并在事件发生时作出回应。 The child's `EventEmitter` property is an ***output property***, typically adorned with an [@Output decoration](guide/template-syntax#inputs-outputs) as seen in this `VoterComponent`: -子组件的`EventEmitter`属性是一个**输出属性**，通常带有[@Output装饰器](guide/template-syntax#inputs-outputs)，就像在`VoterComponent`中看到的。 +子组件的 `EventEmitter` 属性是一个**输出属性**，通常带有[@Output 装饰器](guide/template-syntax#inputs-outputs)，就像在 `VoterComponent` 中看到的。 @@ -229,12 +229,12 @@ The child's `EventEmitter` property is an ***output property***, Clicking a button triggers emission of a `true` or `false`, the boolean *payload*. -点击按钮会触发`true`或`false`(布尔型*有效载荷*)的事件。 +点击按钮会触发 `true` 或 `false`(布尔型*有效载荷*)的事件。 The parent `VoteTakerComponent` binds an event handler called `onVoted()` that responds to the child event payload `$event` and updates a counter. -父组件`VoteTakerComponent`绑定了一个事件处理器(`onVoted()`)，用来响应子组件的事件(`$event`)并更新一个计数器。 +父组件 `VoteTakerComponent` 绑定了一个事件处理器(`onVoted()`)，用来响应子组件的事件(`$event`)并更新一个计数器。 @@ -243,7 +243,7 @@ payload `$event` and updates a counter. The framework passes the event argument—represented by `$event`—to the handler method, and the method processes it: -框架(Angular)把事件参数(用`$event`表示)传给事件处理方法，这个方法会处理： +框架(Angular)把事件参数(用 `$event` 表示)传给事件处理方法，这个方法会处理：
    Child-to-parent @@ -283,7 +283,7 @@ The following is a child `CountdownTimerComponent` that repeatedly counts down t It has `start` and `stop` methods that control the clock and it displays a countdown status message in its own template. -子组件`CountdownTimerComponent`进行倒计时，归零时发射一个导弹。`start`和`stop`方法负责控制时钟并在模板里显示倒计时的状态信息。 +子组件 `CountdownTimerComponent` 进行倒计时，归零时发射一个导弹。`start` 和 `stop` 方法负责控制时钟并在模板里显示倒计时的状态信息。 @@ -291,7 +291,7 @@ countdown status message in its own template. The `CountdownLocalVarParentComponent` that hosts the timer component is as follows: -让我们来看看计时器组件的宿主组件`CountdownLocalVarParentComponent`。 +让我们来看看计时器组件的宿主组件 `CountdownLocalVarParentComponent`。 @@ -300,7 +300,7 @@ The `CountdownLocalVarParentComponent` that hosts the timer component is as foll The parent component cannot data bind to the child's `start` and `stop` methods nor to its `seconds` property. -父组件不能通过数据绑定使用子组件的`start`和`stop`方法，也不能访问子组件的`seconds`属性。 +父组件不能通过数据绑定使用子组件的 `start` 和 `stop` 方法，也不能访问子组件的 `seconds` 属性。 You can place a local variable, `#timer`, on the tag `` representing the child component. That gives you a reference to the child component and the ability to access @@ -311,7 +311,7 @@ That gives you a reference to the child component and the ability to access This example wires parent buttons to the child's `start` and `stop` and uses interpolation to display the child's `seconds` property. -在这个例子中，我们把父组件的按钮绑定到子组件的`start`和`stop`方法，并用插值表达式来显示子组件的`seconds`属性。 +在这个例子中，我们把父组件的按钮绑定到子组件的 `start` 和 `stop` 方法，并用插值表达式来显示子组件的 `seconds` 属性。 Here we see the parent and child working together. @@ -382,7 +382,7 @@ is solely for the purpose of demonstration. Here is the parent, `CountdownViewChildParentComponent`: -下面是父组件`CountdownViewChildParentComponent`: +下面是父组件 `CountdownViewChildParentComponent`: @@ -394,18 +394,18 @@ It takes a bit more work to get the child view into the parent component *class* First, you have to import references to the `ViewChild` decorator and the `AfterViewInit` lifecycle hook. -首先，你要使用`ViewChild`装饰器导入这个引用，并挂上`AfterViewInit`生命周期钩子。 +首先，你要使用 `ViewChild` 装饰器导入这个引用，并挂上 `AfterViewInit` 生命周期钩子。 Next, inject the child `CountdownTimerComponent` into the private `timerComponent` property via the `@ViewChild` property decoration. -接着，通过`@ViewChild`属性装饰器，将子组件`CountdownTimerComponent`注入到私有属性`timerComponent`里面。 +接着，通过 `@ViewChild` 属性装饰器，将子组件 `CountdownTimerComponent` 注入到私有属性 `timerComponent` 里面。 The `#timer` local variable is gone from the component metadata. Instead, bind the buttons to the parent component's own `start` and `stop` methods and present the ticking seconds in an interpolation around the parent component's `seconds` method. -组件元数据里就不再需要`#timer`本地变量了。而是把按钮绑定到父组件自己的`start`和`stop`方法，使用父组件的`seconds`方法的插值表达式来展示秒数变化。 +组件元数据里就不再需要 `#timer` 本地变量了。而是把按钮绑定到父组件自己的 `start` 和 `stop` 方法，使用父组件的 `seconds` 方法的插值表达式来展示秒数变化。 These methods access the injected timer component directly. @@ -415,19 +415,19 @@ The `ngAfterViewInit()` lifecycle hook is an important wrinkle. The timer component isn't available until *after* Angular displays the parent view. So it displays `0` seconds initially. -`ngAfterViewInit()`生命周期钩子是非常重要的一步。被注入的计时器组件只有在Angular显示了父组件视图之后才能访问，所以我们先把秒数显示为0. +`ngAfterViewInit()` 生命周期钩子是非常重要的一步。被注入的计时器组件只有在 Angular 显示了父组件视图之后才能访问，所以我们先把秒数显示为 0. Then Angular calls the `ngAfterViewInit` lifecycle hook at which time it is *too late* to update the parent view's display of the countdown seconds. Angular's unidirectional data flow rule prevents updating the parent view's in the same cycle. The app has to *wait one turn* before it can display the seconds. -然后Angular会调用`ngAfterViewInit`生命周期钩子，但这时候再更新父组件视图的倒计时就已经太晚了。Angular的单向数据流规则会阻止在同一个周期内更新父组件视图。我们在显示秒数之前会被迫*再等一轮*。 +然后 Angular 会调用 `ngAfterViewInit` 生命周期钩子，但这时候再更新父组件视图的倒计时就已经太晚了。Angular 的单向数据流规则会阻止在同一个周期内更新父组件视图。我们在显示秒数之前会被迫*再等一轮*。 Use `setTimeout()` to wait one tick and then revise the `seconds()` method so that it takes future values from the timer component. -使用`setTimeout()`来等下一轮，然后改写`seconds()`方法，这样它接下来就会从注入的这个计时器组件里获取秒数的值。 +使用 `setTimeout()` 来等下一轮，然后改写 `seconds()` 方法，这样它接下来就会从注入的这个计时器组件里获取秒数的值。

    Test it

    @@ -459,7 +459,7 @@ Components outside this component subtree have no access to the service or their This `MissionService` connects the `MissionControlComponent` to multiple `AstronautComponent` children. -这个`MissionService`把`MissionControlComponent`和多个`AstronautComponent`子组件连接起来。 +这个 `MissionService` 把 `MissionControlComponent` 和多个 `AstronautComponent` 子组件连接起来。 @@ -468,7 +468,7 @@ This `MissionService` connects the `MissionControlComponent` to multiple `Astron The `MissionControlComponent` both provides the instance of the service that it shares with its children (through the `providers` metadata array) and injects that instance into itself through its constructor: -`MissionControlComponent`提供服务的实例，并将其共享给它的子组件(通过`providers`元数据数组)，子组件可以通过构造函数将该实例注入到自身。 +`MissionControlComponent` 提供服务的实例，并将其共享给它的子组件(通过 `providers` 元数据数组)，子组件可以通过构造函数将该实例注入到自身。 @@ -477,7 +477,7 @@ The `MissionControlComponent` both provides the instance of the service that it The `AstronautComponent` also injects the service in its constructor. Each `AstronautComponent` is a child of the `MissionControlComponent` and therefore receives its parent's service instance: -`AstronautComponent`也通过自己的构造函数注入该服务。由于每个`AstronautComponent`都是`MissionControlComponent`的子组件，所以它们获取到的也是父组件的这个服务实例。 +`AstronautComponent` 也通过自己的构造函数注入该服务。由于每个 `AstronautComponent` 都是 `MissionControlComponent` 的子组件，所以它们获取到的也是父组件的这个服务实例。 @@ -490,13 +490,13 @@ This is a memory-leak guard step. There is no actual risk in this app because th lifetime of a `AstronautComponent` is the same as the lifetime of the app itself. That *would not* always be true in a more complex application. -注意，这个例子保存了`subscription`变量，并在`AstronautComponent`被销毁时调用`unsubscribe()`退订。 -这是一个用于防止内存泄漏的保护措施。实际上，在这个应用程序中并没有这个风险，因为`AstronautComponent`的生命期和应用程序的生命期一样长。但在更复杂的应用程序环境中就不一定了。 +注意，这个例子保存了 `subscription` 变量，并在 `AstronautComponent` 被销毁时调用 `unsubscribe()` 退订。 +这是一个用于防止内存泄漏的保护措施。实际上，在这个应用程序中并没有这个风险，因为 `AstronautComponent` 的生命期和应用程序的生命期一样长。但在更复杂的应用程序环境中就不一定了。 You don't add this guard to the `MissionControlComponent` because, as the parent, it controls the lifetime of the `MissionService`. -不需要在`MissionControlComponent`中添加这个保护措施，因为它作为父组件，控制着`MissionService`的生命期。 +不需要在 `MissionControlComponent` 中添加这个保护措施，因为它作为父组件，控制着 `MissionService` 的生命期。
    @@ -504,7 +504,7 @@ The *History* log demonstrates that messages travel in both directions between the parent `MissionControlComponent` and the `AstronautComponent` children, facilitated by the service: -*History*日志证明了：在父组件`MissionControlComponent`和子组件`AstronautComponent`之间，信息通过该服务实现了双向传递。 +*History*日志证明了：在父组件 `MissionControlComponent` 和子组件 `AstronautComponent` 之间，信息通过该服务实现了双向传递。
    bidirectional-service @@ -517,7 +517,7 @@ facilitated by the service: Tests click buttons of both the parent `MissionControlComponent` and the `AstronautComponent` children and verify that the history meets expectations: -测试确保点击父组件`MissionControlComponent`和子组件`AstronautComponent`两个的组件的按钮时，*History*日志和预期的一样。 +测试确保点击父组件 `MissionControlComponent` 和子组件 `AstronautComponent` 两个的组件的按钮时，*History*日志和预期的一样。 diff --git a/aio/content/guide/component-styles.md b/aio/content/guide/component-styles.md index 1431361269..604b20b605 100644 --- a/aio/content/guide/component-styles.md +++ b/aio/content/guide/component-styles.md @@ -37,8 +37,8 @@ One way to do this is to set the `styles` property in the component metadata. The `styles` property takes an array of strings that contain CSS code. Usually you give it one string, as in the following example: -实现方式之一，是在组件的元数据中设置`styles`属性。 -`styles`属性可以接受一个包含 CSS 代码的字符串数组。 +实现方式之一，是在组件的元数据中设置 `styles` 属性。 +`styles` 属性可以接受一个包含 CSS 代码的字符串数组。 通常我们只给它一个字符串就行了，如同下例： @@ -113,7 +113,7 @@ The following sections describe these selectors. Use the `:host` pseudo-class selector to target styles in the element that *hosts* the component (as opposed to targeting elements *inside* the component's template). -使用`:host`伪类选择器，用来选择组件*宿主*元素中的元素（相对于组件模板*内部*的元素）。 +使用 `:host` 伪类选择器，用来选择组件*宿主*元素中的元素（相对于组件模板*内部*的元素）。 @@ -129,11 +129,11 @@ component's own template. The host element is in a parent component's template. Use the *function form* to apply host styles conditionally by including another selector inside parentheses after `:host`. -要把宿主样式作为条件，就要像*函数*一样把其它选择器放在`:host`后面的括号中。 +要把宿主样式作为条件，就要像*函数*一样把其它选择器放在 `:host` 后面的括号中。 The next example targets the host element again, but only when it also has the `active` CSS class. -在下一个例子中，我们又一次把宿主元素作为目标，但是只有当它同时带有`active` CSS 类的时候才会生效。 +在下一个例子中，我们又一次把宿主元素作为目标，但是只有当它同时带有 `active` CSS 类的时候才会生效。 @@ -148,19 +148,19 @@ For example, a CSS theme class could be applied to the document `` element you want to change how your component looks based on that. 有时候，基于某些来自组件视图*外部*的条件应用样式是很有用的。 -例如，在文档的``元素上可能有一个用于表示样式主题 (theme) 的 CSS 类，而我们应当基于它来决定组件的样式。 +例如，在文档的 `` 元素上可能有一个用于表示样式主题 (theme) 的 CSS 类，而我们应当基于它来决定组件的样式。 Use the `:host-context()` pseudo-class selector, which works just like the function form of `:host()`. The `:host-context()` selector looks for a CSS class in any ancestor of the component host element, up to the document root. The `:host-context()` selector is useful when combined with another selector. -这时可以使用`:host-context()`伪类选择器。它也以类似`:host()`形式使用。它在当前组件宿主元素的*祖先节点*中查找 CSS 类， +这时可以使用 `:host-context()` 伪类选择器。它也以类似 `:host()` 形式使用。它在当前组件宿主元素的*祖先节点*中查找 CSS 类， 直到文档的根节点为止。在与其它选择器组合使用时，它非常有用。 The following example applies a `background-color` style to all `

    ` elements *inside* the component, only if some ancestor element has the CSS class `theme-light`. -在下面的例子中，只有当某个祖先元素有 CSS 类`theme-light`时，我们才会把`background-color`样式应用到组件*内部*的所有`

    `元素中。 +在下面的例子中，只有当某个祖先元素有 CSS 类 `theme-light` 时，我们才会把 `background-color` 样式应用到组件*内部*的所有 `

    ` 元素中。 @@ -168,7 +168,7 @@ if some ancestor element has the CSS class `theme-light`. ### (deprecated) `/deep/`, `>>>`, and `::ng-deep` -### 已废弃 `/deep/`、`>>>`和`::ng-deep` +### 已废弃 `/deep/`、`>>>` 和 `::ng-deep` Component styles normally apply only to the HTML in the component's own template. @@ -179,12 +179,12 @@ component tree into all the child component views. The `/deep/` combinator works to any depth of nested components, and it applies to both the view children and content children of the component. -我们可以使用`/deep/`选择器，来强制一个样式对各级子组件的视图也生效，它*不但作用于组件的子视图，也会作用于组件的内容*。 +我们可以使用 `/deep/` 选择器，来强制一个样式对各级子组件的视图也生效，它*不但作用于组件的子视图，也会作用于组件的内容*。 The following example targets all `

    ` elements, from the host element down through this component to all of its child elements in the DOM. -在这个例子中，我们以所有的`

    `元素为目标，从宿主元素到当前元素再到 DOM 中的所有子元素： +在这个例子中，我们以所有的 `

    ` 元素为目标，从宿主元素到当前元素再到 DOM 中的所有子元素： @@ -192,7 +192,7 @@ through this component to all of its child elements in the DOM. The `/deep/` combinator also has the aliases `>>>`, and `::ng-deep`. -`/deep/` 组合器还有两个别名：`>>>`和`::ng-deep`。 +`/deep/` 组合器还有两个别名：`>>>` 和 `::ng-deep`。
    @@ -200,7 +200,7 @@ Use `/deep/`, `>>>` and `::ng-deep` only with *emulated* view encapsulation. Emulated is the default and most commonly used view encapsulation. For more information, see the [Controlling view encapsulation](guide/component-styles#view-encapsulation) section. -`/deep/`和`>>>`选择器只能被用在**仿真 (emulated) **模式下。 +`/deep/` 和 `>>>` 选择器只能被用在**仿真 (emulated) **模式下。 这种方式是默认值，也是用得最多的方式。 更多信息，见[控制视图封装模式](guide/component-styles#view-encapsulation)一节。 @@ -212,9 +212,9 @@ The shadow-piercing descendant combinator is deprecated and [support is being re As such we plan to drop support in Angular (for all 3 of `/deep/`, `>>>` and `::ng-deep`). Until then `::ng-deep` should be preferred for a broader compatibility with the tools. -CSS标准中用于 "刺穿Shadow DOM" 的组合器已经被废弃，并将[这个特性从主流浏览器和工具中移除](https://www.chromestatus.com/features/6750456638341120)。 -因此，我们也将在 Angular 中移除对它们的支持（包括`/deep/`、`>>>` 和 `::ng-deep`）。 -目前，建议先统一使用`::ng-deep`，以便兼容将来的工具。 +CSS 标准中用于 "刺穿 Shadow DOM" 的组合器已经被废弃，并将[这个特性从主流浏览器和工具中移除](https://www.chromestatus.com/features/6750456638341120)。 +因此，我们也将在 Angular 中移除对它们的支持（包括 `/deep/`、`>>>` 和 `::ng-deep`）。 +目前，建议先统一使用 `::ng-deep`，以便兼容将来的工具。
    @@ -230,7 +230,7 @@ There are several ways to add styles to a component: * By setting `styles` or `styleUrls` metadata. - 设置`styles`或`styleUrls`元数据 + 设置 `styles` 或 `styleUrls` 元数据 * Inline in the template HTML. @@ -250,7 +250,7 @@ The scoping rules outlined earlier apply to each of these loading patterns. You can add a `styles` array property to the `@Component` decorator. -我们可以给`@Component`装饰器添加一个`styles`数组型属性。 +我们可以给 `@Component` 装饰器添加一个 `styles` 数组型属性。 Each string in the array defines some CSS for this component. @@ -331,7 +331,7 @@ ng generate component hero-app You can embed CSS styles directly into the HTML template by putting them inside `