diff --git a/public/docs/ts/latest/glossary.jade b/public/docs/ts/latest/glossary.jade index 50bb3b02b4..943172a641 100644 --- a/public/docs/ts/latest/glossary.jade +++ b/public/docs/ts/latest/glossary.jade @@ -13,14 +13,14 @@ block includes Most Angular terms are everyday English words with a specific meaning within the Angular system. - Angular 2有自己的词汇表。 - 虽然大多数的Angular 2短语都是日常用语，但是在Angular体系中，它们有特别的含义。 + Angular 有自己的词汇表。 + 虽然大多数 Angular 短语都是日常用语，但是在 Angular 体系中，它们有特别的含义。 This glossary lists the most prominent terms and a few less familiar ones that have unusual or unexpected definitions. - 该词汇表列出了常用词和少量具有独特或反直觉含义的罕用词。 + 本词汇表列出了常用术语和少量具有独特或反直觉含义的罕用术语。 [A](#A) [B](#B) [C](#C) [D](#D) [E](#E) [F](#F) [G](#G) [H](#H) [I](#I) [J](#J) [K](#K) [L](#L) [M](#M) [N](#N) [O](#O) [P](#P) [Q](#Q) [R](#R) @@ -32,7 +32,7 @@ a#aot :marked ## Ahead-of-Time (AoT) compilation - ## 预（ahead-of-time, AoT）编译 + ## 预 (ahead-of-time, AoT) 编译 .l-sub-section :marked @@ -41,72 +41,83 @@ a#aot to a module factory, meaning you don't need to include the Angular compiler in your JavaScript bundle. Ahead-of-time compiled applications also benefit from decreased load time and increased performance. - 开发者可以在构造时(build-time)编译Angular应用程序。通过`Compiler-cli` - `ngc`编译应用程序，应用可以从一个模块工厂(Module Factory)直接启动，意思是不再需要把Angular编译器添加到JavaScript包中。预编译的应用程序将加载迅速，并具有更高的性能。 + 开发者可以在构造时 (build-time) 编译 Angular 应用程序。 + 通过`Compiler-cli` - `ngc`编译应用程序，应用可以从一个模块工厂直接启动， + 意味着不再需要把 Angular 编译器添加到 JavaScript 包中。 + 预编译的应用程序加载迅速，具有更高的性能。 +ifDocsFor('ts') :marked ## Angular module - ## Angular模块 + ## Angular 模块 + .l-sub-section :marked Helps you organize an application into cohesive blocks of functionality. An Angular module identifies the components, directives, and pipes that the application uses along with the list of external Angular modules that the application needs, such as `FormsModule`. - 帮助我们将一个应用程序组织成拼合的功能模块群。一个Angular模块标识了被应用程序使用的组件、指令和管道等，它同时包含了应用程序需要的外来Angular模块的列表，比如`FormsModule`。 + 帮助我们将一个应用程序组织成内聚的功能模块群。 + 一个 Angular 模块标识应用程序使用的组件、指令和管道等，还包含应用程序需要的外部 Angular 模块的列表，例如`FormsModule`。 Every Angular application has an application root module class. By convention, the class is called `AppModule` and resides in a file named `app.module.ts`. - 每个Angular应用程序都有一个应用程序根模块类。按规约这个类的名字为`AppModule`，存放在名为`app.module.ts`的文件。 + 每个 Angular 应用程序都有一个应用程序根模块类。按规约这个类的名字为`AppModule`，存放在名为`app.module.ts`的文件。 For details and examples, see the [Angular Module](!{docsLatest}/guide/ngmodule.html) page. - 要了解详情和范例，参见[Angular模块](!{docsLatest}/guide/ngmodule.html)页。 + 要了解详情和范例，参见 [Angular 模块](!{docsLatest}/guide/ngmodule.html)。 +ifDocsFor('ts|dart') :marked ## Annotation - ## 注解（annotation） + + ## 注解 (annotation) + .l-sub-section block annotation-defn :marked In practice, a synonym for [Decoration](#decorator). - [装饰器(Decoration)](#decorator)在实践中的同义词。 + 实际上，是[装饰 (decoration)](#decorator) 的同义词。 :marked ## Attribute directive - ## 属性型指令（attribute directive） + + ## 属性型指令 (attribute directive) + .l-sub-section :marked A category of [directive](#directive) that can listen to and modify the behavior of other HTML elements, attributes, properties, and components. They are usually represented as HTML attributes, hence the name. - [指令(Directive)](#directive)分类中的一种。它允许监听或修改其它HTML元素、属性、组件的行为。它们通常用作HTML属性，就像它的名字所暗示的那样。 + [指令 (directive)](#directive)的一种。可以监听或修改其它 HTML 元素、特性 (attribute)、属性 (property)、组件的行为。通常用作 HTML 属性，就像它的名字所暗示的那样。 A good example of an attribute directive is the `ngClass` directive for adding and removing CSS class names. - `ngClass`指令就是典型的属性型指令。它可以添加或移除CSS类名。 + `ngClass`指令就是典型的属性型指令。它可以添加或移除 CSS 类名。 .l-main-section#B +ifDocsFor('ts|js') :marked ## Barrel - ## 封装桶（barrel） + + ## 封装桶 (barrel) + .l-sub-section :marked A barrel is a way to *rollup exports* from several ES2015 modules into a single convenient ES2015 module. The barrel itself is an ES2015 module file that re-exports *selected* exports of other ES2015 modules. - 封装桶是把一系列模块中的*导出结果*归纳进一个单一的快捷模块的一种方式。 - 封装桶本身是一个模块文件，它重新导出*选中的*导出，这些导入来自其它文件。 + 封装桶是把多个模块的*导出结果*汇总到单一的 ES2015 模块的一种方式。 + 封装桶本身是一个 ES2015 模块文件，它重新导出*选中的*导出，这些导入来自其它 ES2015 模块。 Imagine three ES2015 modules in a `heroes` folder: - 设想在`heroes`目录下有三个ES2015的模块： + 设想在`heroes`目录下有三个 ES2015 模块： code-example. // heroes/hero.component.ts @@ -120,7 +131,7 @@ a#aot :marked Without a barrel, a consumer would need three import statements: - 假如没有封装桶，消费者就需要三条import语句： + 如果没有封装桶，消费者需要三条导入语句： code-example. import { HeroComponent } from '../heroes/hero.component.ts'; @@ -129,7 +140,7 @@ a#aot :marked You can add a barrel to the `heroes` folder (called `index`, by convention) that exports all of these items: - 在`heroes`目录下添加一个封装桶(按规约叫做`index`)，它导出所有这三条： + 在`heroes`目录下添加一个封装桶（按约定叫做`index`），它导出所有这三项： code-example. export * from './hero.model.ts'; // re-export all of its exports @@ -145,42 +156,48 @@ a#aot :marked The Angular [scoped packages](#scoped-package) each have a barrel named `index`. - Angular的每个[范围化包(Scoped Package)](#scoped-package)都有一个叫做`index`的封装桶。 + Angular 的每个[范围化包 (scoped package)](#scoped-package) 都有一个名为`index`的封装桶。 .alert.is-important :marked Note that you can often achieve this using [Angular modules](#angular-module) instead. - 注意，你可以利用[Angular模块](#angular-module)达到同样的目的。 + 注意，你可以利用 [Angular 模块](#angular-module)达到同样的目的。 :marked ## Binding - ## 绑定（binding） + + ## 绑定 (binding) + .l-sub-section :marked Almost always refers to [Data Binding](#data-binding) and the act of binding an HTML object property to a data object property. - 几乎都是指的[数据绑定(Data Binding)](#data-binding)和将一个HTML对象属性绑定到一个数据对象属性的行为。 + 几乎都是指的[数据绑定 (data binding)](#data-binding) 和将 HTML 对象属性绑定到数据对象属性的行为。 May refer to a [dependency injection](#dependency-injection) binding between a "token", also referred to as a "key", and a dependency [provider](#provider). This more rare usage should be clear in context. - 有可能指的是[依赖注入(Dependency Injection)](#dependency-injection)在一个令牌(Token)（也叫键值Key）和一个依赖的[提供商(Provider)](#provider)之间的绑定。 + 也可能指的是在“令牌”（也称为键）和依赖[提供商 (provider)](#provider) + 之间的[依赖注入 (dependency injection)](#dependency-injection) 绑定。 这种用法很少，而且一般都会在上下文中写清楚。 :marked ## Bootstrap - ## 启动/引导（bootstrap） + + ## 启动/引导 (bootstrap) + .l-sub-section block bootstrap-defn-top :marked You launch an Angular application by "bootstrapping" it using the application root Angular module (`AppModule`). Bootstrapping identifies an application's top level "root" [component](#component), which is the first component that is loaded for the application. For more information, see the [Setup](!{docsLatest}/guide/setup.html) page. - 通过一个名叫`bootstrap`的方法来引导Angular应用程序。这个`bootstrap`方法会识别应用程序的顶级“根”[组件(Component)](#component)，也就是应用加载的第一个组件。 - 要了解详情，参见[搭建本地开发环境](!{docsLatest}/setup.html)页。 + 通过应用程序根 Angular 模块来启动 Angular 应用程序。 + 启动过程标识应用的顶级“根”[组件 (component)](#component)，也就是应用加载的第一个组件。 + 更多信息，见[设置](!{docsLatest}/guide/setup.html)。 :marked You can bootstrap multiple apps in the same `index.html`, each with its own top level root. @@ -189,142 +206,166 @@ a#aot .l-main-section#C :marked ## camelCase - ## 驼峰式命名法（camelCase） + + ## 驼峰式命名法 (camelCase) + .l-sub-section :marked The practice of writing compound words or phrases such that each word or abbreviation begins with a capital letter _except the first letter, which is lowercase_. - 驼峰式命名法是指除了首字母要小写外，每个单词或缩写都以大写字母开头的形式来书写复合词或短语的一种实践。 + 驼峰式命名法是书写复合词或短语的一种形式，除首字母要小写外，每个单词或缩写都以大写字母开头。 Function, property, and method names are typically spelled in camelCase. Examples include: `square`, `firstName` and `getHeroes`. Notice that `square` is an example of how you write a single word in camelCase. - 函数、属性和方法命名一般都使用驼峰式拼写法。比如`square`, `firstName` 和 `getHeroes`等。注意这里的`square`只是一个例子，用来示范如何用驼峰式命名法表示单一词。 + 通常，函数、属性和方法命名使用驼峰式拼写法。例如，`square`, `firstName` 和 `getHeroes`。注意这里的`square`是如何用驼峰式命名法表示单一词的例子。 This form is also known as **lower camel case**, to distinguish it from **upper camel case**, which is [PascalCase](#pascalcase). When you see "camelCase" in this documentation it always means *lower camel case*. - 这种形式也被叫做**小驼峰式命名法(lower camel case)**，以区分于**大驼峰式命名法**(也叫[Pascal命名法(PascalCase)](#pascalcase))。 - 在文档中提到“驼峰式命名法(camelCase)”的时候，我们所指的都是小驼峰命名法。 + 这种形式也被叫做**小写驼峰式命名法 (lower camel case)**，以区分于**大写驼峰式命名法**，也称 [Pascal 命名法 (PascalCase)](#pascalcase)。 + 在文档中提到“驼峰式命名法 (camelCase) ”的时候，我们所指的都是小驼峰命名法。 :marked ## Component - ## 组件（component） + + ## 组件 (component) + .l-sub-section :marked An Angular class responsible for exposing data to a [view](#view) and handling most of the view’s display and user-interaction logic. - 组件是一种用来把数据展示到[视图(View)](#view)，并处理几乎所有的视图显示和交互逻辑的Angular类。 + 组件是一个 Angular 类，用于把数据展示到[视图 (view)](#view)，并处理几乎所有的视图显示和交互逻辑。 The *component* is one of the most important building blocks in the Angular system. It is, in fact, an Angular [directive](#directive) with a companion [template](#template). - 组件是Angular系统中最重要的基本构造块之一。 - 它其实是一个拥有[模板(Template)](#template)的[指令(Directive)](#directive)。 + *组件*是 Angular 系统中最重要的基本构造块之一。 + 它其实是一个拥有[模板 (template)](#template)的[指令 (directive)](#directive)。 You apply the `!{_at}Component` !{_decoratorLink} to the component class, thereby attaching to the class the essential component metadata that Angular needs to create a component instance and render it with its template as a view. - 开发人员使用`#{_at}Component`!{decoratorCn}来装饰一个组件类，也就是把这个核心组件的元数据附加到类上。 - Angular会利用这个元数据信息创建一个组件实例，并把组件的模板作为视图渲染出来。 + 需要将`#{_at}Component`装饰器应用到一个组件类，从而把必要的组件元数据附加到类上。 + Angular 会需要元数据来创建一个组件实例，并把组件的模板作为视图渲染出来。 Those familiar with "MVC" and "MVVM" patterns will recognize the component in the role of "controller" or "view model". - 如果你熟悉 "MVC" 和 "MVVM" 架构模式，就会意识到“组件”充当了“控制器(Controller)”和“视图模型(View Model)”的角色。 + 如果你熟悉 "MVC" 和 "MVVM" 模式，就会意识到组件充当了“控制器 (controller) ”和“视图模型 (view model) ”的角色。 // #enddocregion b-c .l-main-section#D :marked ## dash-case - ## 中线命名法（dash-case） + + ## 中线命名法 (dash-case) + .l-sub-section :marked The practice of writing compound words or phrases such that each word is separated by a dash or hyphen (`-`). This form is also known as [kebab-case](#kebab-case). - 使用中线(`-`)分隔每个单词来书写词汇或短语的方法叫做中线命名法。 - 这种命名法也被称为[烤串命名法(kebab-case)](#kebab-case)。 + 中线命名法是书写复合词或短语的一种形式，使用中线 (`-`) 分隔每个单词。 + 这种形式也称为[烤串命名法 (kebab-case)](#kebab-case)。 [Directive](#directive) selectors (like `my-app`) and the root of filenames (such as `hero-list.component.ts`) are often spelled in dash-case. - [指令](#directive)的选择器（例如`my-app`）和文件名（比如``hero-list.component.ts`）通常都是通过中线命名法来命名的。 + [指令](#directive)的选择器（例如`my-app`）和文件名（例如`hero-list.component.ts`）通常是用中线命名法来命名。 :marked ## Data binding - ## 数据绑定（data binding） + + ## 数据绑定 (data binding) + .l-sub-section :marked Applications display data values to a user and respond to user actions (clicks, touches, keystrokes). - 应用程序会将数据展示给用户，并对用户的操作(点击、触屏、按键)做出回应。 + 应用程序会将数据展示给用户，并对用户的操作（点击、触屏、按键）做出回应。 Instead of manually pushing application data values into HTML, attaching event listeners, pulling changed values from the screen, and updating application data values, you can use data binding by declaring the relationship between an HTML widget and data source and let the framework handle the details. - 以前的手动操作是：将数据推送到HTML页面中、添加事件监听器、从屏幕获取变化后的数据，并更新应用中的值。 - 现在，你可以声明HTML小部件和数据源之间的关系，并让框架来处理各种细节。 + 以前的手动操作是：将数据推送到 HTML 页面中、添加事件监听器、从屏幕获取变化后的数据，并更新应用中的值。 + 现在，你可以声明 HTML 小部件和数据源之间的关系，并让框架来处理所有细节。 Angular has a rich data binding framework with a variety of data binding operations and supporting declaration syntax. - Angular有一个非常强大的数据绑定框架，它带有很多种数据绑定操作，并支持声明式语法。 + Angular 有一个非常强大的数据绑定框架，具有各种数据绑定操作，并支持声明式语法。 Read about the forms of binding in the [Template Syntax](!{docsLatest}/guide/template-syntax.html#data-binding) page: - 到[模板语法](!{docsLatest}/guide/template-syntax.html#data-binding)页了解更多的绑定形式： + 更多的绑定形式，见[模板语法](!{docsLatest}/guide/template-syntax.html#data-binding)： * [Interpolation](!{docsLatest}/guide/template-syntax.html#interpolation). - * [插值表达式(Interpolation)](!{docsLatest}/guide/template-syntax.html#interpolation)。 + + [插值表达式 (interpolation)](!{docsLatest}/guide/template-syntax.html#interpolation)。 + * [Property binding](!{docsLatest}/guide/template-syntax.html#property-binding). - * [属性绑定(Property Binding)](!{docsLatest}/guide/template-syntax.html#property-binding)。 + + [property 绑定 (property binding)](!{docsLatest}/guide/template-syntax.html#property-binding)。 + * [Event binding](!{docsLatest}/guide/template-syntax.html#event-binding). - * [事件绑定(Event Binding)](!{docsLatest}/guide/template-syntax.html#event-binding)。 + + [事件绑定 (event binding)](!{docsLatest}/guide/template-syntax.html#event-binding)。 + * [Attribute binding](!{docsLatest}/guide/template-syntax.html#attribute-binding). - * [Attribute绑定(Attribute Binding)](!{docsLatest}/guide/template-syntax.html#attribute-binding)。 + + [attribute 绑定 (attribute binding)](!{docsLatest}/guide/template-syntax.html#attribute-binding)。 + * [Class binding](!{docsLatest}/guide/template-syntax.html#class-binding). - * [CSS类绑定(Class Binding)](!{docsLatest}/guide/template-syntax.html#class-binding)。 + + [CSS 类绑定 (class binding)](!{docsLatest}/guide/template-syntax.html#class-binding)。 + * [Style binding](!{docsLatest}/guide/template-syntax.html#style-binding). - * [样式绑定(Style Binding)](!{docsLatest}/guide/template-syntax.html#style-binding)。 + + [样式绑定 (style binding)](!{docsLatest}/guide/template-syntax.html#style-binding)。 + * [Two-way data binding with ngModel](!{docsLatest}/guide/template-syntax.html#ngModel). - * [基于ngModel的双向数据绑定(Two-way data binding with ngModel)](!{docsLatest}/guide/template-syntax.html#ngModel)。 + + [基于 ngModel 的双向数据绑定 (Two-way data binding with ngModel)](!{docsLatest}/guide/template-syntax.html#ngModel)。 +ifDocsFor('ts|dart') a#decorator a#decoration :marked ## Decorator | decoration - ## 装饰器（decorator | decoration） + + ## 装饰器 (decorator | decoration) + .l-sub-section block decorator-defn :marked A decorator is a **function** that adds metadata to a class, its members (properties, methods) and function arguments. - 装饰器是一个**函数**，这个函数将元数据添加到类、类成员(属性、方法)和函数上。 + 装饰器是一个**函数**，它将元数据添加到类、类成员（属性、方法）和函数参数。 Decorators are a JavaScript language [feature](https://github.com/wycats/javascript-decorators), implemented in TypeScript and proposed for ES2016 (AKA ES7). - 装饰器是一个JavaScript的语言[特性](https://github.com/wycats/javascript-decorators)，装饰器在TypeScript里面已经采纳并实现了，并被推荐到了ES2016(也就是ES7)。 + 装饰器是一个 JavaScript 的语言[特性](https://github.com/wycats/javascript-decorators)，装饰器在 TypeScript 里已经实现，并被推荐到了ES2016（也就是ES7）。 To apply a decorator, position it immediately above or to the left of the thing it decorates. - 要想应用装饰器，就把装饰器放到被装饰对象的上面或左边。 + 要想应用装饰器，把它放到被装饰对象的上面或左边。 Angular has its own set of decorators to help it interoperate with your application parts. Here is an example of a `@Component` decorator that identifies a class as an Angular [component](#component) and an `@Input` decorator applied to the `name` property of that component. The elided object argument to the `@Component` decorator would contain the pertinent component metadata. - Angular使用自己的一套装饰器来实现应用程序各部分之间的相互操作。 - 下面的例子中使用了`@Component`装饰器来将一个类标记为一个Angular[组件(Component)](#component)，并用`@Input`装饰器来装饰该组件的`name`属性。 - `@Component`装饰器中省略的参数对象还可以包含和组件有关的元数据。 + Angular 使用自己的一套装饰器来实现应用程序各部件之间的相互操作。 + 下面的例子中使用了`@Component`装饰器来将一个类标记为 Angular [组件 (component)](#component)， + 并将`@Input`装饰器来应用到组件的`name`属性。 + `@Component`装饰器中省略的参数对象会包含与组件有关的元数据。 ``` @Component({...}) @@ -338,7 +379,8 @@ a#aot that it decorates. None of the decorations shown here will "leak" to other classes appearing below it in the file. - 一个装饰器的作用域会被限制在它所装饰的东西上，这是一个语言级特性。在上面这个例子中，就算别的类在同一个文件中紧跟着上面的类也不会有任何装饰器“泄露”到其它类。 + 装饰器的作用域会被限制在它所装饰的语言特性。 + 在同一文件中，装饰器不会“泄露”到它后面的其它类。 .alert.is-important :marked @@ -348,94 +390,107 @@ a#aot :marked ## Dependency injection - ## 依赖注入(dependency injection） + + ## 依赖注入 (dependency injection) .l-sub-section :marked Dependency injection is both a design pattern and a mechanism for creating and delivering parts of an application to other parts of an application that request them. - 依赖注入既是设计模式，同时又是一种机制：当应用程序的一些部件需要另一些部件的时候，使用依赖注入机制来创建被请求的部件并将其注入到发出请求的部件中。 + 依赖注入既是设计模式，同时又是一种机制：当应用程序的一些部件需要另一些部件时， + 利用依赖注入来创建被请求的部件，并将它们注入到发出请求的部件中。 Angular developers prefer to build applications by defining many simple parts that each do one thing well and then wiring them together at runtime. - Angular开发者构建应用程序时的首选方法是：定义许多精简的小部件，每个小部件只做一件事并做好它，然后在运行期把这些精简小部件装配在一起组成应用程序。 + Angular 开发者构建应用程序时的首选方法是：定义许多简单部件， + 每个部件只做一件事并做好它，然后在运行时把它们装配在一起组成应用程序。 These parts often rely on other parts. An Angular [component](#component) part might rely on a service part to get data or perform a calculation. When part "A" relies on another part "B", you say that "A" depends on "B" and that "B" is a dependency of "A". - 这些小部件通常会依赖其它小部件。一个Angular[组件(Component)](#component)可能依赖一个“服务”部件来获取数据或处理运算。如果部件A要靠另一个部件B才能工作，那么A“依赖于”B，B是A的“依赖”。 + 这些部件通常会依赖其它部件。一个 Angular [组件 (component)](#component) + 可能依赖一个服务部件来获取数据或执行运算。 + 如果部件 “A” 要靠另一个部件 “B” 才能工作，我们称 “A” 依赖 “B” ，“B” 是 “A” 的依赖。 You can ask a "dependency injection system" to create "A" for us and handle all the dependencies. If "A" needs "B" and "B" needs "C", the system resolves that chain of dependencies and returns a fully prepared instance of "A". - 我们可以要求“依赖注入系统”为我们创建一个部件A并处理所有A的“依赖”。如果A需要B，B需要C，这个系统便解析这个依赖链，返回一个完全准备好的A实例。 + 可以要求“依赖注入系统”为我们创建 “A” 并处理所有依赖。如果 “A” 需要 “B” ，“B” 需要 “C ”， + 系统将解析这个依赖链，返回一个完全准备好的 “A” 实例。 Angular provides and relies upon its own sophisticated [dependency injection](dependency-injection.html) system to assemble and run applications by "injecting" application parts into other application parts where and when needed. - Angular提供并使用自己精心设计的[依赖注入(Dependency Injection)](dependency-injection.html)系统来组装和运行应用程序：在要用时，将一些部件“注入”到另一些部件里面。 + Angular 提供并使用自己精心设计的[依赖注入 (dependency injection)](dependency-injection.html)系统来组装和运行应用程序，在需要的地方和时刻，将一些部件“注入”到另一些部件里面。 At the core there is an [`injector`](#injector) that returns dependency values on request. The expression `injector.get(token)` returns the value associated with the given token. - 在Angular内核中有一个[注入器(Injector)](#injector)，这个注入器根据需要返回被依赖部件。`injector.get(token)`方法返回与该token(令牌)参数相关的依赖部件。 + 在 Angular 内核中有一个[注入器 (injector)](#injector)，当请求时返回依赖值。 + 表达式`injector.get(token)`返回与该token（令牌）参数相关的值。 A token is an Angular type (`OpaqueToken`). You rarely deal with tokens directly; most methods accept a class name (`Foo`) or a string ("foo") and Angular converts it to a token. When you write `injector.get(Foo)`, the injector returns the value associated with the token for the `Foo` class, typically an instance of `Foo` itself. - 令牌是一个Angular中的类型(`OpaqueToken`)。我们很少需要直接接触令牌。绝大多数类方法都接受类名(`Foo`)或字符串("foo")，Angular会把这些类名称和字符串转换成令牌。 + 令牌是一个 Angular 中的类型 (`OpaqueToken`)。我们很少直接处理令牌。 + 绝大多数方法都接受类名 (`Foo`) 或字符串 ("foo")， Angular 会把这些类名称和字符串转换成令牌。 当调用`injector.get(Foo)`时，注入器返回用`Foo`类生成的令牌所对应的依赖值，该依赖值通常是`Foo`类的实例。 During many of its operations, Angular makes similar requests internally, such as when it creates a [`component`](#component) for display. - Angular在创建[组件(Component)](#component)以供显示的过程中，会在内部执行很多类似的依赖注入请求。 + Angular 在内部执行很多类似的依赖注入请求，例如，在创建用于显示的[组件 (component)](#component)。 The `Injector` maintains an internal map of tokens to dependency values. If the `Injector` can't find a value for a given token, it creates a new value using a `Provider` for that token. - 注入器(`Injector`)维护一个令牌与相应依赖值的对照表(map)。如果注入器不能找到一个令牌对应的依赖值，它就会使用提供商(`Provider`)来创建一个依赖值。 + 注入器 (`Injector`) 维护一个令牌到依赖值的映射表。 + 如果注入器找不到给定令牌对应的依赖值，它会使用提供商 (`Provider`) 创建一个依赖值。 A [provider](#provider) is a recipe for creating new instances of a dependency value associated with a particular token. - [提供商(Provider)](#provider)是创建依赖实例的“菜谱”之一，这个实例会与一个特定的令牌关联起来。 + [提供商 (provider)](#provider)是一个“菜谱”，用于创建特定令牌对应的依赖实例。 An injector can only create a value for a given token if it has a `provider` for that token in its internal provider registry. Registering providers is a critical preparatory step. - 只有当注入器内部的提供商注册表中存在与令牌对应的提供商时，注入器才能为这个令牌创建一个依赖值。所以注册提供商是一个非常关键的准备步骤。 + 只有当注入器内部提供商注册表中存在与令牌对应的提供商时， + 注入器才能为这个令牌创建一个依赖值。所以注册提供商是一个非常关键的准备步骤。 Angular registers some of its own providers with every injector. We can register our own providers. - Angular会为每个注册器注册很多Angular内置提供商。我们也可以注册自己的提供商。通常注册提供商的最佳时间是在应用程序开始[引导(Bootstrap)](#bootstrap)的时候。 - 当然，我们也有其它很多机会注册提供商。 + Angular 会为每个注册器注册很多内置提供商。 + 我们也可以注册自己的提供商。 Read more in the [Dependency Injection](!{docsLatest}/guide/dependency-injection.html) page. - 要了解关于依赖注入的更多知识，请参见[依赖注入(Dependency Injection)](!{docsLatest}/guide/dependency-injection.html)页。 + 更多信息，见[依赖注入 (dependency injection)](!{docsLatest}/guide/dependency-injection.html)。 :marked ## Directive - ## 指令（directive） + + ## 指令 (directive) + .l-sub-section :marked An Angular class responsible for creating, reshaping, and interacting with HTML elements in the browser DOM. Directives are Angular's most fundamental feature. - 指令是一个Angular类，这个类负责创建和重塑浏览器DOM中的HTML元素，同时负责与HTML元素的互动。指令是Angular中最基本的特性之一。 + 指令是一个 Angular 类，负责创建和重塑浏览器 DOM 中的 HTML 元素，并与之互动。 + 指令是 Angular 中最基本的特性之一。 A Directive is almost always associated with an HTML element or attribute. We often refer to such an element or attribute as the directive itself. @@ -443,48 +498,60 @@ a#aot it creates the matching directive class instance and gives the instance control over that portion of the browser DOM. - 指令几乎都是关联到HTML元素或属性(Attribute)的。我们通常把这些关联到的HTML元素或者属性(Attribute)当做指令本身。 - 当Angular在HTML模板中遇到一个指令的时候，它就会找出一个与该指令相匹配的类，创建此类的实例，然后把浏览器中这部分DOM的控制权交给它。 + 指令几乎总与 HTML 元素或属性 (attribute) 相关。 + 我们通常把这些关联到的 HTML 元素或者属性 (attribute) 当做指令本身。 + 当 Angular 在 HTML 模板中遇到一个指令的时候， + 它会创建匹配的指令类的实例，并把浏览器中这部分 DOM 的控制权交给它。 You can invent custom HTML markup (for example, ``) to associate with your custom directives. You add this custom markup to HTML templates as if you were writing native HTML. In this way, directives become extensions of HTML itself. - 你可以为自定义指令指定自定义的HTML标签(比如``)，然后，就可以像写原生HTML一样把这些自定义标签放到HTML模板里了。 - 这样，指令就变成了HTML本身的拓展。 + 你可以自定义 HTML 标签（例如``）来关联自定义指令。 + 然后，可以像写原生 HTML 一样把这些自定义标签放到 HTML 模板里。 + 这样，指令就变成了 HTML 本身的拓展。 Directives fall into one of three categories: - 指令包括了一下三个类别： + 指令分为三类： 1. [Components](#component) that combine application logic with an HTML template to render application [views]. Components are usually represented as HTML elements. They are the building blocks of an Angular application and the developer can expect to write a lot of them. - 1. [组件(Component)](#component): 用来把程序逻辑和HTML模板组合起来，渲染出应用程序的视图。组件一般表示成HTML元素的形式，它们是构建Angular应用程序的基本单元。可以预见，开发人员将会写很多很多组件。 + + [组件 (component)](#component): 用于组合程序逻辑和 HTML 模板，渲染出应用程序的视图。 + 组件一般表示成 HTML 元素的形式，它们是构建 Angular 应用程序的基本单元。 + 可以预见，开发人员将会写很多很多组件。 1. [Attribute directives](#attribute-directive) that can listen to and modify the behavior of other HTML elements, attributes, properties, and components. They are usually represented as HTML attributes, hence the name. - 1. [属性型指令(Attribute Directive)](#attribute-directive)：可以监控和修改其它HTML元素、HTML属性(Attribute)、DOM属性(Property)、组件等行为等等。它们一般表示为HTML元素的属性(Attibute)，故名。 + + [属性型指令 (attribute directive)](#attribute-directive)：可以监控和修改其它 HTML 元素、 + HTML 属性 (attribute)、 DOM 属性 (property)、组件等行为等等。它们通常表示为 HTML 属性 (attibute)，故名。 1. [Structural directives](#structural-directive), a directive responsible for shaping or reshaping HTML layout, typically by adding, removing, or manipulating elements and their children. - 1. [结构型指令(Structural Directive)](#structural-directive)：负责塑造或重塑HTML布局。这一般是通过添加、删除或者操作HTML元素及其子元素来实现的。 + + [结构型指令 (structural directive)](#structural-directive)：负责塑造或重塑 HTML + 布局。这一般是通过添加、删除或者操作 HTML 元素及其子元素来实现的。 // #enddocregion d2 .l-main-section#E :marked ## ECMAScript + ## ECMAScript + .l-sub-section :marked The [official JavaScript language specification](https://en.wikipedia.org/wiki/ECMAScript). - [官方JavaScript语言规范](https://en.wikipedia.org/wiki/ECMAScript) + [官方 JavaScript 语言规范](https://en.wikipedia.org/wiki/ECMAScript) The latest approved version of JavaScript is [ECMAScript 2016](http://www.ecma-international.org/ecma-262/7.0/) @@ -492,44 +559,52 @@ a#aot either in this version of the language or a dialect that strives to be compatible with it, such as [TypeScript](#typescript). - 最新的被认可的JavaScript版本是[ECMAScript 2015](http://www.ecma-international.org/ecma-262/6.0/)，(也叫“ES2015”或“ES6”)。Angular 2的开发者要么使用这个版本的JavaScript，要么使用与这个版本兼容的语言，比如[TypeScript](#typesScript)。 + 最新批准的 JavaScript 版本是[ECMAScript 2016](http://www.ecma-international.org/ecma-262/7.0/)（也称“ES2016”或“ES7”）。 + Angular 的开发人员要么使用这个版本的语言，要么使用与之兼容的方言，例如 [TypeScript](#typesScript)。 Most modern browsers today only support the much older "ECMAScript 5" (AKA ES5) standard. Applications written in ES2016, ES2015 or one of their dialects must be "[transpiled](#transpile)" to ES5 JavaScript. - 目前，几乎所有现代游览器都只支持上老版本的“ECMAScript 5” (也就是ES5)标准。使用ES2015，ES2016或者其它兼容语言开发的应用程序，都必须被“[转译(Transpile)](#transpile)”成ES5 JavaScript。 + 目前，几乎所有现代游览器只支持很老的“ECMAScript 5” （也称ES5）标准。 + 使用ES2016、ES2015或者其它方言开发的应用程序，必须“[转译 (transpile)](#transpile)”成 ES5 JavaScript。 Angular developers may choose to write in ES5 directly. - Angular的开发者也可以选择直接使用ES5编程。 + Angular 的开发人员也可以选择直接使用 ES5 编程。 :marked ## ES2015 + ## ES2015 + .l-sub-section :marked Short hand for [ECMAScript](#ecmascript) 2015. - [ECMAScript](#ecmascript) 2015的缩写。 + [ECMAScript](#ecmascript) 2015 的缩写。 :marked ## ES6 + ## ES6 + .l-sub-section :marked Short hand for [ECMAScript](#ecmascript) 2015. - [ECMAScript](#ecmascript) 2015的简写。 + [ECMAScript](#ecmascript) 2015 的简写。 :marked ## ES5 + ## ES5 + .l-sub-section :marked Short hand for [ECMAScript](#ecmascript) 5, the version of JavaScript run by most modern browsers. See [ECMAScript](#ecmascript). - “ECMAScript 5”的简写，大部分现代浏览器使用的JavaScript版本。参见[ECMAScript](#ecmascript)。 + “ECMAScript 5”的简写，大部分现代浏览器使用的 JavaScript 版本。参见[ECMAScript](#ecmascript)。 // #enddocregion e2 a#F @@ -538,17 +613,20 @@ a#H .l-main-section#I :marked ## Injector - ## 注入器（injector） + + ## 注入器 (injector) .l-sub-section :marked An object in the Angular [dependency injection system](#dependency-injection) that can find a named "dependency" in its cache or create such a thing with a registered [provider](#provider). - Angular[依赖注入系统(Dependency Injection System)](#dependency-injection)中的一个对象，它可以在自己的缓存中找到一个“有名字的依赖”或者利用一个已注册的[提供商(Provider)](#provider)来创建这样一个依赖。 + Angular [依赖注入系统 (Dependency Injection System)](#dependency-injection)中的一个对象， + 它可以在自己的缓存中找到一个命名的“依赖”或者利用已注册的[提供商 (provider)](#provider) 创建这样一个依赖。 :marked ## Input - ## 输入属性（input） + + ## 输入属性 (input) .l-sub-section :marked A directive property that can be the ***target*** of a @@ -556,15 +634,18 @@ a#H Data values flow *into* this property from the data source identified in the template expression to the right of the equal sign. - 指令属性可以作为[属性绑定](!{docsLatest}/guide/template-syntax.html#property-binding)的目标。数据值会从模板表达式等号右侧的数据源中，流入这个属性。 + 输入属性是一个指令属性，可以作为[属性绑定 (property binding)](!{docsLatest}/guide/template-syntax.html#property-binding)的目标。 + 数据值会从模板表达式等号右侧的数据源流入这个属性。 See the [Input and output properties](!{docsLatest}/guide/template-syntax.html#inputs-outputs) section of the [Template Syntax](!{docsLatest}/guide/template-syntax.html) page. - 参见[模板语法](!{docsLatest}/guide/template-syntax.html)页的[输入与输出属性](!{docsLatest}/guide/template-syntax.html#inputs-outputs)部分。 + 见[模板语法](!{docsLatest}/guide/template-syntax.html)中的[输入与输出属性](!{docsLatest}/guide/template-syntax.html#inputs-outputs)。 :marked ## Interpolation - ## 插值表达式（interpolation） + + ## 插值表达式 (interpolation) + .l-sub-section :marked A form of [property data binding](#data-binding) in which a @@ -573,7 +654,8 @@ a#H before it is assigned to an element property or displayed between element tags, as in this example. - [属性数据绑定(Property Data Binding)](#data-binding) 的形式之一：位于双大括号中的[模板表达式(Template Expression)](#template-expression)会被渲染成文本。在被赋值给元素属性或者显示在元素标签中之前，这些文本可能会先与周边的文本合并，参见下面的例子。 + [属性数据绑定 (property data binding)](#data-binding) 的一种形式，位于双大括号中的[模板表达式 (template expression)](#template-expression)会被渲染成文本。 + 在被赋值给元素属性或者显示在元素标签中之前，这些文本可能会先与周边的文本合并，参见下面的例子。 code-example(language="html" escape="html"). @@ -582,7 +664,7 @@ a#H Read more about [interpolation](!{docsLatest}/guide/template-syntax.html#interpolation) in the [Template Syntax](!{docsLatest}/guide/template-syntax.html) page. - 要学习关于插值表达式的更多知识，参见[模板语法](/docs/ts/latest/guide/template-syntax.html#interpolation)一章。 + 更多信息，见[模板语法](!{docsLatest}/guide/template-syntax.html)中的[插值表达式](!{docsLatest}/guide/template-syntax.html#interpolation)。 .l-main-section#J @@ -590,7 +672,7 @@ a#jit :marked ## Just-in-Time (JiT) compilation - ## 即时（just-in-time, JiT）编译 + ## 即时 (just-in-time, JiT) 编译 .l-sub-section :marked @@ -598,111 +680,132 @@ a#jit and launch the application dynamically. This is a good choice during development. Consider using the [ahead-of-time](#aot) mode for production apps. - Angular的即时编译在浏览器中启动并编译所有的组件和模块，并动态运行应用程序。它很适合在开发期使用。但是在产品发布时， - 推荐采用[预编译（Ahead of Time）](#aot)模式。 + Angular 的即时编译在浏览器中启动并编译所有的组件和模块，动态运行应用程序。 + 它很适合在开发过程中使用。但是在产品发布时，推荐采用[预编译 (ahead-of-time)](#aot) 模式。 .l-main-section#K :marked ## kebab-case - ## 烤串命名法(kebab-case) + + ## 烤串命名法 (kebab-case) + .l-sub-section :marked See [dash-case](#dash-case). - 参见[中线命名法(dash-case)](#dash-case)。 + 见[中线命名法 (dash-case)](#dash-case)。 .l-main-section#L :marked ## Lifecycle hooks - ## 生命周期钩子（lifecycle hook） + + ## 生命周期钩子 (lifecycle hook) + .l-sub-section :marked [Directives](#directive) and [components](#component) have a lifecycle managed by Angular as it creates, updates, and destroys them. - [指令(Directive)](#directive)和[组件(Component)](#component)具有生命周期，它们由Angular在创建、更新和销毁它们的过程中进行管理。 + [指令 (directive)](#directive) 和[组件 (component)](#component) 具有生命周期，由 Angular 在创建、更新和销毁它们的过程中进行管理。 You can tap into key moments in that lifecycle by implementing one or more of the lifecycle hook interfaces. - 你可以通过实现一个或多个“生命周期钩子”接口，切入到生命周期中的关键时间点。 + 你可以通过实现一个或多个生命周期钩子接口，切入到生命周期中的关键时间点。 Each interface has a single hook method whose name is the interface name prefixed with `ng`. For example, the `OnInit` interface has a hook method named `ngOnInit`. - 每个接口只有一个钩子方法，方法名一般是接口的名字加前缀 `ng`。比如，`OnInit`接口的钩子类的方法名为 `ngOnInit`。 + 每个接口只有一个钩子方法，方法名是接口名加前缀 `ng`。例如，`OnInit`接口的钩子方法名为 `ngOnInit`。 Angular calls these hook methods in the following order: - Angular会按照下面的顺序调用钩子类方法： + Angular 会按以下顺序调用钩子方法： * `ngOnChanges` - when an [input](#input)/[output](#output) binding value changes. - * `ngOnChanges` - 在[输入属性(Input)](#input)/[输出属性(Output)](#output)的绑定值发生变化的时候调用。 + + `ngOnChanges` - 在[输入属性 (input)](#input)/[输出属性 (output)](#output)的绑定值发生变化时调用。 + * `ngOnInit` - after the first `ngOnChanges`. - * `ngOnInit` - 在第一轮`ngOnChanges`完成后调用。 + + `ngOnInit` - 在第一次`ngOnChanges`完成后调用。 + * `ngDoCheck` - developer's custom change detection. - * `ngDoCheck` - 开发者自定义变化监测器。 + + `ngDoCheck` - 开发者自定义变更检测。 + * `ngAfterContentInit` - after component content initialized. - * `ngAfterContentInit` - 在组件初始化以后调用。 + + `ngAfterContentInit` - 在组件内容初始化后调用。 + * `ngAfterContentChecked` - after every check of component content. - * `ngAfterContentChecked` - 在检查每个组件内容后调用。 + + `ngAfterContentChecked` - 在组件内容每次检查后调用。 + * `ngAfterViewInit` - after component's view(s) are initialized. - * `ngAfterViewInit` - 在组件视图初始化后调用。 + + `ngAfterViewInit` - 在组件视图初始化后调用。 + * `ngAfterViewChecked` - after every check of a component's view(s). - * `ngAfterViewChecked` - 在检查每个组件视图后调用 + + `ngAfterViewChecked` - 在组件视图每次检查后调用。 + * `ngOnDestroy` - just before the directive is destroyed. - * `ngOnDestroy` - 在指令销毁前调用。 + + `ngOnDestroy` - 在指令销毁前调用。 Read more in the [Lifecycle Hooks](!{docsLatest}/guide/lifecycle-hooks.html) page. - 要了解更多，参见[生命周期钩子(Lifecycle Hook)](!{docsLatest}/guide/lifecycle-hooks.html)一章。 + 更多信息，见[生命周期钩子 (lifecycle hook)](!{docsLatest}/guide/lifecycle-hooks.html)。 // #enddocregion f-l .l-main-section#M :marked ## Module - ## 模块（module） + + ## 模块 (module) + .l-sub-section block module-defn .alert.is-important :marked In Angular, there are two types of modules: - 在Angular里有两种模块： + Angular 有两种模块： - [Angular modules](#angular-module). For details and examples, see the [Angular Modules](!{docsLatest}/guide/ngmodule.html) page. - - [Angular 模块](#angular-module)。到[Angular Module](!{docsLatest}/guide/ngmodule.html)页查看详情和例子。 + [Angular 模块](#angular-module)，见[Angular 模块](!{docsLatest}/guide/ngmodule.html)。 - ES2015 modules, as described in this section. - - 本节描述的ES2015模块。 + 本节描述的 ES2015 模块。 :marked Angular apps are modular. - Angular应用程序是模块化的。 + Angular 应用程序是模块化的。 In general, you assemble your application from many modules, both the ones you write and the ones you acquire from others. - 一般来说，我们用模块来组装应用程序，这些模块包含我们自己编写的模块和从其它地方获取的模块。 + 一般来说，我们用模块来组装应用程序，这些模块包含自己编写的模块和从其它地方获取的模块。 A typical module is a cohesive block of code dedicated to a single purpose. - 典型的模块，是具有单一用途的内聚代码块。 + 典型的模块是具有单一用途的内聚代码块。 A module **exports** something of value in that code, typically one thing such as a class. A module that needs that thing, **imports** it. - 模块代码中通常会**导出(export)**一些东西，最典型的就是类。 - 模块如果需要什么东西，那就**导入(import)**它。 + 模块会**导出 (export) **代码中的某些值，最典型的就是类。 + 模块如果需要什么东西，那就**导入 (import) **它。 The structure of Angular modules and the import/export syntax is based on the [ES2015 module standard](http://www.2ality.com/2014/09/es6-modules-final.html). - Angular的模块结构和输出/导入语法是基于[ES2015模块化标准](http://www.2ality.com/2014/09/es6-modules-final.html)的。 + Angular 的模块结构和导入/导出语法是基于 [ES2015 模块标准](http://www.2ality.com/2014/09/es6-modules-final.html)的。 An application that adheres to this standard requires a module loader to load modules on request, and resolve inter-module dependencies. @@ -710,19 +813,20 @@ a#jit for any particular 3rd party library (although most examples use SystemJS). You may pick any module library that conforms to the standard. - 采用这个标准的应用程序需要一个模块加载器来按需加载模块并解析模块的依赖关系。Angular不包含任何模块加载器，也不偏爱哪一个第三方库(虽然几乎所有例子都使用SystemJS)。 - 你可以自行选择任何与这个标准兼容的模块化库。 + 采用这个标准的应用程序需要一个模块加载器来按需加载模块，并解析模块间的依赖关系。 + Angular 不附带模块加载器，也不偏爱任何第三方库（虽然大多数例子使用SystemJS）。 + 你可以选择任何与这个标准兼容的模块化库。 Modules are typically named after the file in which the exported thing is defined. The Angular [DatePipe](https://github.com/angular/angular/blob/master/modules/@angular/common/src/pipes/date_pipe.ts) class belongs to a feature module named `date_pipe` in the file `date_pipe.ts`. - 模块一般与它定义导出物的文件同名。比如, Angular的[日期管道(DatePipe)](https://github.com/angular/angular/blob/master/modules/angular2/src/common/pipes/date_pipe.ts)类属于名叫`date_pipe`的特性模块，位于文件`date_pipe.ts`中。 + 模块一般与它定义导出物的文件同名。例如，Angular 的 [DatePipe](https://github.com/angular/angular/blob/master/modules/angular2/src/common/pipes/date_pipe.ts) 类属于名叫`date_pipe`的特性模块，位于`date_pipe.ts`文件中。 You rarely access Angular feature modules directly. You usually import them from one of the Angular [scoped packages](#scoped-package) such as `@angular/core`. - 你很少需要直接访问Angular的特性模块。 - 而通常会从一个Angular的[范围化包(Scoped Package)](#scoped-package)中导入它们，比如`@angular/core`。 + 你很少需要直接访问 Angular 的特性模块。 + 而通常会从一个 Angular [范围化包 (scoped package)](#scoped-package)中导入它们，例如`@angular/core`。 a#N .l-main-section#O @@ -730,25 +834,30 @@ a#N +ifDocsFor('ts|js') :marked ## Observable - ## 可观察对象（observable） + + ## 可观察对象 (observable) + .l-sub-section :marked You can think of an observable as an array whose items arrive asynchronously over time. Observables help you manage asynchronous data, such as data coming from a backend service. Observables are used within Angular itself, including Angular's event system and its http client service. - 一个`Observable`是一个数组，它包含的元素在一段时间内异步到达。`Observable`帮助我们管理异步数据，比如来自后台服务的数据。 - Angular自身使用了`Observable`，包括Angular的事件系统和它的http客户端服务。 + 一个`Observable`是一个数组，其中的元素随着时间的流逝异步地到达。 + `Observable`帮助我们管理异步数据，例如来自后台服务的数据。 + Angular 自身使用了`Observable`，包括 Angular 的事件系统和它的 http 客户端服务。 To use observables, Angular uses a third-party library called Reactive Extensions (RxJS). Observables are a proposed feature for ES 2016, the next version of JavaScript. - 为了利用`Observable`，Angular使用了名为Reactive Extensions (RxJS)的第三方包。 - 在下个版本的JavaScript - ES 2016中，`Observable`是建议的功能之一。 + 为了使用`Observable`， Angular 采用了名为 Reactive Extensions (RxJS) 的第三方包。 + 在下个版本的 JavaScript - ES 2016 中，`Observable`是建议的特性之一。 :marked ## Output - ## 输出属性（output） + + ## 输出属性 (output) + .l-sub-section :marked A directive property that can be the ***target*** of @@ -756,8 +865,8 @@ a#N Events stream *out* of this property to the receiver identified in the template expression to the right of the equal sign. - 输出属性是指令的一种属性，它可作为[事件绑定](/docs/ts/latest/guide/template-syntax.html#property-binding)的 **目标** 。 - 事件流可以通过这个属性，流出到接收者(模板表达式等号的右边就是接收者)。 + 输出属性是一个指令属性，可作为[事件绑定](/docs/ts/latest/guide/template-syntax.html#property-binding)的 **目标** 。 + 事件流从这个属性流*出*到模板表达式等号的右边的接收者。 See the [Input and output properties](!{docsLatest}/guide/template-syntax.html#inputs-outputs) section of the [Template Syntax](!{docsLatest}/guide/template-syntax.html) page. @@ -767,21 +876,26 @@ a#N :marked ## PascalCase - ## Pascal命名法（PascalCase） + + ## Pascal 命名法 (PascalCase) + .l-sub-section :marked The practice of writing individual words, compound words, or phrases such that each word or abbreviation begins with a capital letter. Class names are typically spelled in PascalCase. Examples include: `Person` and `HeroDetailComponent`. - 遵循“每个单词都用大写开头”的规则的书写单词、复合词或短语的命名方法叫做Pascal命名法。类名一般都采用Pascal命名法。比如`Person`和`Customer` + Pascal 命名法是书写单词、复合词或短语的一种形式，每个单词或缩写都以大写开头。 + 类名一般都采用 Pascal 命名法。例如`Person`和`HeroDetailComponent`。 This form is also known as **upper camel case** to distinguish it from **lower camel case**, which is simply called [camelCase](#camelcase). In this documentation, "PascalCase" means *upper camel case* and "camelCase" means *lower camel case*. - 这种命名法也叫**大驼峰式命名法**，以区别于 **小驼峰式命名法”或[驼峰式命名法(camelCase)](#camelCase)** 。 - 在本教程中，“Pascal命名法”都是指的*大驼峰式命名法”，“驼峰式命名法”指的都是“小驼峰式命名法” + 这种形式也称**大写驼峰式命名法**，以区别于**小写驼峰式命名法”或[驼峰式命名法 (camelCase)](#camelCase)** 。 + 在本文档中，“Pascal 命名法”都是指的*大写驼峰式命名法*，“驼峰式命名法”指的都是*小写驼峰式命名法*。 :marked ## Pipe - ## 管道（pipe） + + ## 管道 (pipe) + .l-sub-section :marked An Angular pipe is a function that transforms input values to output values for @@ -789,29 +903,35 @@ a#N to associate the pipe function with a name. You then use that name in your HTML to declaratively transform values on screen. - Angular的管道是一个函数，用于把输入值转换成输出值以供[视图(View)](#view)显示。使用`#{atSym}Pipe`!{decoratorCn}来把管道函数关联到它的名字上。 - 然后，就可以在HTML中用它的名字来声明该如何把输入值转换为显示值了。 + Angular 管道是一个函数，用于把输入值转换成输出值以供[视图 (view)](#view)显示。 + 使用`#{atSym}Pipe`装饰器把管道函数关联一个名字。 + 然后，就可以在 HTML 中用这个名字，进行声明式地转换。 Here's an example that uses the built-in `currency` pipe to display a numeric value in the local currency. - 下面这个例子中就用内置的`currency`管道把数字值显示成了本地货币格式。 + 下面这个例子中，用内置的`currency`管道把数字值显示为本地货币格式。 code-example(language="html" escape="html"). {{product.price | currency}} :marked Read more in the page on [pipes](!{docsLatest}/guide/pipes.html). + 更多信息，见[管道](!{docsLatest}/guide/pipes.html)。 + :marked ## Provider - ## 提供商（provider） + + ## 提供商 (provider) + .l-sub-section :marked A _provider_ creates a new instance of a dependency for the [dependency injection](#dependency-injection) system. It relates a lookup token to code—sometimes called a "recipe"—that can create a dependency value. - 依赖注入系统依靠提供商来创建依赖的实例。它把一个供查阅用的令牌和代码(有时也叫“配方”)关联到一起，以便创建依赖值。 + 依赖注入系统依靠提供商来创建依赖的实例。 + 它把一个查找令牌和代码（有时也叫“配方”）关联到一起，以便创建依赖值。 a#Q .l-main-section#R @@ -819,41 +939,46 @@ a#Q +ifDocsFor('ts|js') :marked ## Reactive forms - ## 动态表格（reactive forms） + + ## 响应式表单 (reactive forms) + .l-sub-section :marked A technique for building Angular forms through code in a component. The alternate technique is [Template-Driven Forms](#template-driven-forms). - 通过组件代码来构建Angular表单的方法。 + 通过组件中代码构建 Angular 表单的一种技术。 + 另一种技术是[模板驱动表单](#template-driven-forms) When building reactive forms: - 构建动态表单是： + 构建响应式表单时： - The "source of truth" is the component. The validation is defined using code in the component. - - “真理来源”于组件。表单验证在组件代码中定义。 + 组件是“真理之源”。表单验证在组件代码中定义。 - Each control is explicitly created in the component class with `new FormControl()` or with `FormBuilder`. - - 每个控制器都是在组件类中使用`new FormControl()`或者`FormBuilder`显性的创建的。 + 在组件类中，使用`new FormControl()`或者`FormBuilder`显性地创建每个控件。 - The template input elements do *not* use `ngModel`. - - 模板中的`input`元素**不**使用`ngModel`。 + 模板中的`input`元素**不**使用`ngModel`。 - The associated Angular directives are all prefixed with `Form` such as `FormGroup`, `FormControl`, and `FormControlName`. - - 相关联的Angular指令全部以`Form`开头，比如`FormGroup`、`FormControl`和`FormControlName`。 + 相关联的 Angular 指令全部以`Form`开头，例如`FormGroup`、`FormControl`和`FormControlName`。 Reactive forms are powerful, flexible, and great for more complex data entry form scenarios such as dynamic generation of form controls. - 动态表单非常强大、灵活，它在复杂数据输入的场景下尤其好用，比如动态的生成表单控制器。 + 动态表单非常强大、灵活，它在复杂数据输入的场景下尤其好用，例如动态的生成表单控制器。 :marked ## Router - ## 路由器（router） + + ## 路由器 (router) + .l-sub-section :marked Most applications consist of many screens or [views](#view). @@ -861,12 +986,13 @@ a#Q and performing other similar actions that cause the application to replace one view with another. - 大部分应用程序包含多个屏或[视图(View)](#view)。用户通过点击链接、按钮和其它类似动作，在它们之间穿梭，这样应用程序就会从一个视图变换到另一个视图。 + 大多数应用程序包含多个屏幕或[视图 (view)](#view)。 + 用户通过点击链接、按钮和其它类似动作，在它们之间导航，使应用程序从一个视图切换到另一个视图。 The Angular [component router](!{docsLatest}/guide/router.html) is a richly featured mechanism for configuring and managing the entire view navigation process including the creation and destruction of views. - Angular的[路由器(Component Router)](!{docsLatest}/guide/router.html)是一个特性丰富的机制，它可以配置和管理整个导航过程，包括建立和销毁视图。 + Angular 的[组件路由器 (component router)](!{docsLatest}/guide/router.html)是一个特性丰富的机制，可以配置和管理整个导航过程，包括建立和销毁视图。 +ifDocsFor('ts|js') :marked @@ -878,73 +1004,82 @@ a#Q A [routing component's](#routing-component) template has a `RouterOutlet` element where it can display views produced by the router. - [路由组件](#routing-component)的模板中带有一个`RouterOutlet`元素，它用来显示由路由器生成的视图。 + [路由组件](#routing-component)的模板中带有一个`RouterOutlet`元素，那是显示路由器生成的视图的地方。 Other views in the application likely have anchor tags or buttons with `RouterLink` directives that users can click to navigate. - 应用中的其它视图中某些A标签或按钮上带有`RouterLink`指令，用户可以点击它们来导航到这里。 + 应用中的其它视图中某些锚标签或按钮上带有`RouterLink`指令，用户可以点击它们进行导航。 For more information, see the [Routing & Navigation](!{docsLatest}/guide/router.html) page. - 要了解更多，请参见[路由与导航](!{docsLatest}/guide/router.html)页。 + 更多信息，见[路由与导航](!{docsLatest}/guide/router.html)。 +ifDocsFor('ts|js') :marked ## Router module - ## 路由器模块（router module） + + ## 路由器模块 (router module) + .l-sub-section :marked A separate [Angular module](#angular-module) that provides the necessary service providers and directives for navigating through application views. - 一个独立的[Angular模块](#angular-module)是用来提供导航时所需的必备服务提供商和指令的。 + 一个独立的 [Angular 模块](#angular-module)，用来提供导航所需的服务提供商和指令。 For more information, see the [Routing & Navigation](!{docsLatest}/guide/router.html) page. - 要了解更多，请参见[路由与导航](!{docsLatest}/guide/router.html)页。 + 更多信息，见[路由与导航](!{docsLatest}/guide/router.html)。 :marked ## Routing component - ## 路由组件（Routing Component） + + ## 路由组件 (routing component) + .l-sub-section :marked An Angular [component](#component) with a `RouterOutlet` that displays views based on router navigations. - 带有RouterOutlet的Angular[组件](#component)基于路由器导航来显示视图。For more information, see the [Routing & Navigation](!{docsLatest}/guide/router.html) page. + 一个带有 RouterOutlet 的 Angular [组件](#component)，根据路由器导航来显示视图。 - 要了解更多，请参见[路由与导航](!{docsLatest}/guide/router.html)页。 + For more information, see the [Routing & Navigation](!{docsLatest}/guide/router.html) page. + + 更多信息，见[路由与导航](!{docsLatest}/guide/router.html)。 .l-main-section#S +ifDocsFor('ts|js') :marked ## Scoped package - ## 范围化包（scoped package） + + ## 范围化包 (scoped package) + .l-sub-section :marked Angular modules are delivered within *scoped packages* such as `@angular/core`, `@angular/common`, `@angular/platform-browser-dynamic`, `@angular/http`, and `@angular/router`. - Angular模块是用一系列*范围化包*的形式发布的，比如`@angular/core`、`@angular/common`、`@angular/platform-browser-dynamic`、 + Angular 模块是用一系列*范围化包*的形式发布的，例如`@angular/core`、`@angular/common`、`@angular/platform-browser-dynamic`、 `@angular/http`和`@angular/router`。 A [*scoped package*](https://docs.npmjs.com/misc/scope) is a way to group related *npm* packages. - [*范围化包(Scoped Package)*](https://docs.npmjs.com/misc/scope)是对相关*npm*包进行分组的一种方式。 + [*范围化包 (scoped package)*](https://docs.npmjs.com/misc/scope)是对相关 *npm* 包进行分组的一种方式。 You import a scoped package the same way that you'd import a *normal* package. The only difference, from a consumer perspective, is that the *scoped package* name begins with the Angular *scope name*, `@angular`. - 使用和导入*普通*包相同的方式导入范围化包。 - 从消费者的视角看，唯一的不同是那些包的名字是用Angular的*范围化包名*`@angular`开头的。 + 导入范围化包与导入*普通*包方式相同。 + 从消费者的视角看，唯一的不同是那些包的名字是用 Angular 的*范围化包名*`@angular`开头的。 +makeExcerpt('architecture/ts/app/app.component.ts', 'import', '') a#snake-case :marked ## snake_case - ## 下划线命名法（snake_case） + + ## 蛇形命名法 (snake_case) .l-sub-section block snake-case-defn @@ -952,72 +1087,85 @@ a#snake-case The practice of writing compound words or phrases such that an underscore (`_`) separates one word from the next. This form is also known as **underscore case**. - 用下划线分隔复合词或词组的命名方法称为**下划线命名法**。 + 蛇形命名法是书写复合词或短语的一种形式，用下划线分隔每个单词，也称**下划线命名法**。 :marked ## Service - ## 服务（service） + + ## 服务 (service) + .l-sub-section :marked For data or logic that is not associated with a specific view or that you want to share across components, build services. - 组件很强大很好...但是，我们该如何处理那些不与任何特定视图相关的数据和逻辑？又如何在组件之间共享这些数据和逻辑？我们创建服务！ + 服务用于封装不与任何特定视图相关的数据和逻辑，或者用于在组件之间共享数据和逻辑。 Applications often require services such as a hero data service or a logging service. - 应用程序经常需要服务，比如英雄数据服务或者日志服务。组件依赖这些服务来做一些繁重的工作。 + 应用程序经常需要服务，例如英雄数据服务或者日志服务。 A service is a class with a focused purpose. We often create a service to implement features that are independent from any specific view, provide shared data or logic across components, or encapsulate external interactions. - 服务是一个具有特定功能的类。我们经常创建服务来实现不依赖任何特定视图的特征、在组件之间提供共享数据或逻辑，或者封装外部互动等。 + 服务是一个具有特定功能的类。 + 我们经常创建服务来实现不依赖任何特定视图的特征， + 在组件之间提供共享数据或逻辑，或者封装外部的交互。 For more information, see the [Services](!{docsLatest}/tutorial/toh-pt4.html) page of the [Tour of Heroes](!{docsLatest}/tutorial/) tutorial. - 要了解更多，参见[英雄指南](!{docsLatest}/tutorial/)教程中的[服务](!{docsLatest}/tutorial/toh-pt4.html)页。 + 更多信息，见[英雄指南](!{docsLatest}/tutorial/)中的[服务](!{docsLatest}/tutorial/toh-pt4.html)。 :marked ## Structural directive - ## 结构型指令（structural directive） + + ## 结构型指令 (structural directive) + .l-sub-section :marked A category of [directive](#directive) that can shape or reshape HTML layout, typically by adding, removing, or manipulating elements and their children; for example, the `ngIf` "conditional element" directive and the `ngFor` "repeater" directive. - 结构型指令是一种可以通过添加、删除或操作元素和其各级子元素来塑造或重塑HTML布局的[指令(Directive)](#directive)， + 结构型指令是[指令 (directive)](#directive)一种， + 可以通过添加、删除或操作元素和其各级子元素来塑造或重塑 HTML 布局。 + 例如，`ngIf`是"条件化元素"指令，`ngFor`是“重复器”指令。 Read more in the [Structural Directives](!{docsLatest}/guide/structural-directives.html) page. - 要了解更多，请参见[结构型指令](!{docsLatest}/guide/structural-directives.html)页。 + 更多信息，见[结构型指令](!{docsLatest}/guide/structural-directives.html)。 // #enddocregion n-s-2 .l-main-section#T :marked ## Template - ## 模板（template） + + ## 模板 (template) + .l-sub-section :marked A template is a chunk of HTML that Angular uses to render a [view](#view) with the support and continuing guidance of an Angular [directive](#directive), most notably a [component](#component). - 模板是一大块HTML。Angular会在[指令(Directive)](#directive)特别是[组件(Component)](#component)的支持和持续指导下，用它来渲染[视图(View)](#view)。 + 模板是一大块 HTML。Angular 会在[指令 (directive)](#directive) 特别是[组件 (component)](#component) + 的支持和持续指导下，用它来渲染[视图 (view)](#view)。 +ifDocsFor('ts|js') :marked ## Template-driven forms - ## 模板驱动表单（template-driven forms） + + ## 模板驱动表单 (template-driven forms) + .l-sub-section :marked A technique for building Angular forms using HTML forms and input elements in the view. The alternate technique is [Reactive Forms](#reactive-forms). - 这是一项在视图中使用HTML表单和输入类元素构建Angular表单的技术。 + 一项在视图中使用 HTML 表单和输入类元素构建 Angular 表单的技术。 它的替代方案是[响应式表单](#reactive-forms)。 When building template-driven forms: @@ -1026,38 +1174,40 @@ a#snake-case - The "source of truth" is the template. The validation is defined using attributes on the individual input elements. - - “信任之源”是模板。验证规则是用属性（Attribute）的形式定义在独立输入控件上的。 + 模板是“真理之源”。使用属性 (attribute) 在单个输入元素上定义验证规则。 - [Two-way binding](#data-binding) with `ngModel` keeps the component model in synchronization with the user's entry into the input elements. - - 使用`ngModel`的[双向绑定](#data-binding)负责组件模型和用户输入之间的同步。 + 使用`ngModel`进行[双向绑定](#data-binding)，保持组件模型和用户输入之间的同步。 - Behind the scenes, Angular creates a new control for each input element, provided you have set up a `name` attribute and two-way binding for each input. - - 在幕后，Angular为每个带有`name`属性和双向绑定的input元素创建了一个新的控件。 + 在幕后，Angular 为每个带有`name`属性和双向绑定的输入元素创建了一个新的控件。 - The associated Angular directives are all prefixed with `ng` such as `ngForm`, `ngModel`, and `ngModelGroup`. - - 相关的Angular指令都带有`ng`前缀，比如`ngForm`、`ngModel`和`ngModelGroup`。 + 相关的 Angular 指令都带有`ng`前缀，例如`ngForm`、`ngModel`和`ngModelGroup`。 Template-driven forms are convenient, quick, and simple. They are a good choice for many basic data entry form scenarios. - 模板驱动的表单便捷、快速、简单，是很多基础型数据输入表单的最佳选择。 + 模板驱动表单便捷、快速、简单，是很多基础型数据输入表单的最佳选择。 Read about how to build template-driven forms in the [Forms](!{docsLatest}/guide/forms.html) page. - 要学习如何构建模板驱动型表单，请参见[表单](!{docsLatest}/guide/forms.html)页。 + 更多信息，见[表单](!{docsLatest}/guide/forms.html)。 :marked ## Template expression - ## 模板表达式（template expression） + + ## 模板表达式 (template expression) + .l-sub-section :marked An expression is a !{_Lang}-like syntax that Angular evaluates within a [data binding](#data-binding). - Angular用来在[数据绑定(Data Binding)](#data-binding)内求值的、**类似**JavaScript语法的表达式。 + Angular 用来在[数据绑定 (data binding)](#data-binding)内求值的、**类似**JavaScript语法的表达式。 Read about how to write template expressions in the [Template Syntax](!{docsLatest}/guide/template-syntax.html#template-expressions) page. @@ -1067,37 +1217,44 @@ a#snake-case // #docregion t2 :marked ## Transpile + ## 转译（transpile) + .l-sub-section :marked The process of transforming code written in one form of JavaScript (for example, TypeScript) into another form of JavaScript (for example, [ES5](#es5)). - 把用JavaScript的某种形态(比如TypeScript)编写的程序转换成另一个形式的JavaScript(例如[ES5](#es5))的过程。 + 把一种形式的 JavaScript（例如 TypeScript）转换成另一种形式的 JavaScript（例如 [ES5](#es5)）的过程。 :marked ## TypeScript + + ## TypeScript + .l-sub-section :marked A version of JavaScript that supports most [ECMAScript 2015](#es2015) language features such as [decorators](#decorator). - 一种支持了几乎所有[ECMAScript 2015](#ecmascript=2015)语言特性和一些未来版本可能有的特性(比如[装饰器(Decorator)](#decorator))的JavaScript语言。 + JavaScript 的一个版本，支持了几乎所有 [ECMAScript 2015](#ecmascript=2015) 语言特性，例如[装饰器 (decorator)](#decorator))。 TypeScript is also noteable for its optional typing system, which gives us compile-time type checking and strong tooling support (for example, "intellisense", code completion, refactoring, and intelligent search). Many code editors and IDEs support TypeScript either natively or with plugins. - TypeScript还以它的可选类型系统而著称。该类型系统提供了编译期类型检查和强大的工具支持(比如“Intellisense”， 自动代码补齐，重构和智能搜索等)。许多程序编辑器和开发环境都自带了TypeScript支持或通过插件提供支持。 + TypeScript 还以它的可选类型系统而著称。 + 该类型系统提供了编译时类型检查和强大的工具支持（例如 “Intellisense”，代码补齐，重构和智能搜索等）。 + 许多代码编辑器和 IDE 都原生支持 TypeScript 或通过插件提供支持。 TypeScript is the preferred language for Angular development although you can use other JavaScript dialects such as [ES5](#es5). - TypeScript是Angular的首选语言，当然，我们也欢迎你使用其它JavaScript语言，比如[ES5](#es5)。 + TypeScript 是 Angular 的首选语言，当然，你可以使用其它 JavaScript 方言，例如[ES5](#es5)。 Read more about TypeScript at [typescript.org](http://www.typescriptlang.org/). - 到TypeScript[官方网站](http://www.typescriptlang.org/)了解更多知识。 + 更多信息，见[typescript.org](http://www.typescriptlang.org/)。 // #enddocregion t2 @@ -1106,27 +1263,31 @@ a#U :marked ## View - ## 视图（view） + + ## 视图 (view) + .l-sub-section :marked A view is a portion of the screen that displays information and responds to user actions such as clicks, mouse moves, and keystrokes. - 视图是屏幕中一小块，用来显示信息并回应用户动作，比如点击、移动鼠标和按键等。 + 视图是屏幕中一小块，用来显示信息并响应用户动作，例如点击、移动鼠标和按键。 Angular renders a view under the control of one or more [directives](#directive), especially [component](#component) directives and their companion [templates](#template). The component plays such a prominent role that it's often convenient to refer to a component as a view. - Angular在一个或多个[指令(Directive)](#directive)的控制下渲染视图，尤其是[组件(Component)](#component)型指令及其[模板(Template)](#template)。 - 组件扮演着非常重要的角色，我们甚至经常会为了方便, 直接用“视图”作为组件的代名词。 + Angular 在一个或多个[指令 (directive)](#directive) 的控制下渲染视图， + 尤其是[组件 (component)](#component) 指令及其[模板 (template)](#template)。 + 组件扮演着非常重要的角色，我们甚至经常会为了方便, 直接用视图作为组件的代名词。 Views often contain other views and any view might be loaded and unloaded dynamically as the user navigates through the application, typically under the control of a [router](#router). - 视图一般包含其它视图，在用户在应用程序中导航的时候，任何视图都可能被动态加载或卸载，这一般会在[路由器(Router)](#router)的控制下进行。 + 视图一般包含其它视图，在用户在应用程序中导航时， + 任何视图都可能被动态加载或卸载，这一般会在[路由器 (router)](#router) 的控制下进行。 a#W a#X @@ -1135,14 +1296,16 @@ a#Y :marked ## Zone - ## 区域（zone） + + ## 区域 (zone) + .l-sub-section block zone-defn :marked Zones are a mechanism for encapsulating and intercepting a JavaScript application's asynchronous activity. - 区域是一种用来封装和截听JavaScript应用程序异步动作的机制。 + 区域是一种用来封装和截听 JavaScript 应用程序异步活动的机制。 The browser DOM and JavaScript have a limited number of asynchronous activities, activities such as DOM events (for example, clicks), @@ -1150,8 +1313,9 @@ a#Y [XHR](https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest) calls to remote servers. - 浏览器中的DOM和JavaScript之间常会有一些数量有限的异步活动，比如DOM事件(如点击)、[承诺(Promise)](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ - Promise)、和通过[XHR](https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest)查询远程服务等。 + 浏览器中的 DOM 和 JavaScript 之间常会有一些数量有限的异步活动， + 例如 DOM 事件（例如点击）、[承诺 (promise)](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) + 和通过 [XHR](https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest) 调用远程服务。 Zones intercept all of these activities and give a "zone client" the opportunity to take action before and after the async activity finishes. @@ -1162,9 +1326,9 @@ a#Y asynchronous events by checking for data changes, and updating the information it displays via [data bindings](#data-binding). - Angular会在一个 Zone 区域中运行应用程序，在这个区域中，它可以对异步事件做出反应，可以通过检查数据变更、利用[数据绑定(Data Bindings)](#data-binding)来更新信息显示。 + Angular 会在一个 Zone 区域中运行应用程序，在这个区域中，它可以对异步事件做出反应，可以通过检查数据变更、利用[数据绑定 (data bindings)](#data-binding) 来更新信息显示。 Learn more about zones in this [Brian Ford video](https://www.youtube.com/watch?v=3IqtmUscE_U). - 到[Brian Ford的视频](https://www.youtube.com/watch?v=3IqtmUscE_U)学习更多关于区域的知识。 + 更多信息，见 [Brian Ford 的视频](https://www.youtube.com/watch?v=3IqtmUscE_U)。