烹饪书-组件通讯 二审完毕

This commit is contained in:
Zhicheng Wang 2016-05-17 19:29:00 +08:00
parent 26cdc7ee5c
commit e139c6b561
4 changed files with 84 additions and 83 deletions

View File

@ -5,14 +5,14 @@ include ../_util-fns
This cookbook contains recipes for common component communication scenarios This cookbook contains recipes for common component communication scenarios
in which two or more components share information. in which two or more components share information.
本菜谱包含了常见的组件之间的交互方法,也就是两个或多个组件之间共享信息的方法。 本菜谱包含了常见的组件通讯场景,也就是让两个或多个组件之间共享信息的方法。
//
.l-sub-section
:marked
For an in-depth look at each fundamental concepts in component communication, we can find detailed description and
samples in the [Component Communication]() document.
要深度的了解组件交互的每个基本概念在,我们可以在[组件交互Component Communication]()文档中可以找到详细的描述和例子。 .l-sub-section
:marked
For an in-depth look at each fundamental concepts in component communication, we can find detailed description and
samples in the [Component Communication]() document.
要深入了解组件通讯的各个基本概念,我们可以在[组件通讯Component Communication]()文档中可以找到详细的描述和例子。
<a id="toc"></a> <a id="toc"></a>
:marked :marked
@ -21,31 +21,31 @@ include ../_util-fns
[Pass data from parent to child with input binding](#parent-to-child) [Pass data from parent to child with input binding](#parent-to-child)
[使用输入Input绑定从父级传数据到子级](#parent-to-child) [使用输入型绑定,把数据从父组件传到子组件](#parent-to-child)
[Intercept input property changes with a setter](#parent-to-child-setter) [Intercept input property changes with a setter](#parent-to-child-setter)
[通过setter截听Input属性值的变化](#parent-to-child-setter) [通过setter拦截输入属性值的变化](#parent-to-child-setter)
[Intercept input property changes with *ngOnChanges*](#parent-to-child-on-changes) [Intercept input property changes with *ngOnChanges*](#parent-to-child-on-changes)
[使用*ngOnChanges*截听Input属性值的变化](#parent-to-child-on-changes) [使用*ngOnChanges*拦截输入属性值的变化](#parent-to-child-on-changes)
[Parent listens for child event](#child-to-parent) [Parent listens for child event](#child-to-parent)
[父级监听子级事件](#child-to-parent) [父组件监听子组件的事件](#child-to-parent)
[Parent interacts with child via a *local variable*](#parent-to-child-local-var) [Parent interacts with child via a *local variable*](#parent-to-child-local-var)
[父级与子级通过*本地变量local variable*互动](#parent-to-child-local-var) [父组件与子组件通过*本地变量local variable*互动](#parent-to-child-local-var)
[Parent calls a *ViewChild*](#parent-to-view-child) [Parent calls a *ViewChild*](#parent-to-view-child)
[父调用*ViewChild*](#parent-to-view-child) [父组件调用*ViewChild*](#parent-to-view-child)
[Parent and children communicate via a service](#bidirectional-service) [Parent and children communicate via a service](#bidirectional-service)
[父级和子级通过服务来交互](#bidirectional-service) [父组件和子组件通过服务来通讯](#bidirectional-service)
:marked :marked
**See the [live example](/resources/live-examples/cb-component-communication/ts/plnkr.html)**. **See the [live example](/resources/live-examples/cb-component-communication/ts/plnkr.html)**.
@ -56,27 +56,27 @@ include ../_util-fns
<a id="parent-to-child"></a> <a id="parent-to-child"></a>
:marked :marked
## Pass data from parent to child with input binding ## Pass data from parent to child with input binding
## 通过Input绑定从父级传送数据给子级 ## 通过输入型绑定把数据从父组件传到子组件
`HeroChildComponent` has two ***input properties***, typically adorned with [@Input decorations](../guide/template-syntax.html#inputs-outputs). `HeroChildComponent` has two ***input properties***, typically adorned with [@Input decorations](../guide/template-syntax.html#inputs-outputs).
`HeroChildComponent` 有两个***Input属性***, 通常用[@Input声明](../guide/template-syntax.html#inputs-outputs)来装饰 `HeroChildComponent` 有两个***输入型属性***,它们通常带[@Input装饰器](../guide/template-syntax.html#inputs-outputs)
+makeExample('cb-component-communication/ts/app/hero-child.component.ts') +makeExample('cb-component-communication/ts/app/hero-child.component.ts')
:marked :marked
The second `@Input` aliases the child component property name `masterName` as `'master'`. 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. 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`属性。
+makeExample('cb-component-communication/ts/app/hero-parent.component.ts') +makeExample('cb-component-communication/ts/app/hero-parent.component.ts')
:marked :marked
The running application displays three heroes: The running application displays three heroes:
运行应用程序显示三个英雄: 运行应用程序显示三个英雄:
figure.image-display figure.image-display
img(src="/resources/images/cookbooks/component-communication/parent-to-child.png" alt="Parent-to-child") img(src="/resources/images/cookbooks/component-communication/parent-to-child.png" alt="Parent-to-child")
@ -87,36 +87,36 @@ figure.image-display
E2E test that all children were instantiated and displayed as expected: E2E test that all children were instantiated and displayed as expected:
实施端对端测试,以确认所有子级的初始化和显示与我们预期的一样 端到端测试,用于确保所有的子组件都像我们所期待的那样被初始化并显示出来
+makeExample('cb-component-communication/e2e-spec.js', 'parent-to-child') +makeExample('cb-component-communication/e2e-spec.js', 'parent-to-child')
:marked :marked
[Back to top](#top) [Back to top](#top)
[回到顶部](#top) [回到顶部](#top)
.l-main-section .l-main-section
<a id="parent-to-child-setter"></a> <a id="parent-to-child-setter"></a>
:marked :marked
## Intercept input property changes with a setter ## Intercept input property changes with a setter
## 通过setter截听Input属性值的变化 ## 通过setter截听输入属性值的变化
Use an input property setter to intercept and act upon a value from the parent. Use an input property setter to intercept and act upon a value from the parent.
使用一个Input属性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. 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`的Input属性`name`的setter用来修剪名字里面的空格并替换空值为默认字符串。 子组件`NameChildComponent`的输入属性`name`上的这个setter会trim掉名字里的空格并把空值替换成默认字符串。
+makeExample('cb-component-communication/ts/app/name-child.component.ts') +makeExample('cb-component-communication/ts/app/name-child.component.ts')
:marked :marked
Here's the `NameParentComponent` demonstrating name variations including a name with all spaces: Here's the `NameParentComponent` demonstrating name variations including a name with all spaces:
下面的`NameParentComponent`展示了各种名字的处理,包括一个全是空格的名字。 下面的`NameParentComponent`展示了各种名字的处理方式,包括一个全是空格的名字。
+makeExample('cb-component-communication/ts/app/name-parent.component.ts') +makeExample('cb-component-communication/ts/app/name-parent.component.ts')
@ -125,10 +125,11 @@ figure.image-display
:marked :marked
### Test it ### Test it
### 测试
E2E tests of input property setter with empty and non-empty names: E2E tests of input property setter with empty and non-empty names:
对端测试Input属性的setter使用空名字和非空名字。 到端测试输入属性的setter分别使用空名字和非空名字。
+makeExample('cb-component-communication/e2e-spec.js', 'parent-to-child-setter') +makeExample('cb-component-communication/e2e-spec.js', 'parent-to-child-setter')
@ -141,34 +142,33 @@ figure.image-display
<a id="parent-to-child-on-changes"></a> <a id="parent-to-child-on-changes"></a>
:marked :marked
## Intercept input property changes with *ngOnChanges* ## Intercept input property changes with *ngOnChanges*
## 通过*ngOnChanges*来截听输入属性值的变化
## 通过*ngOnChanges*来截听Input属性值的变化
Detect and act upon changes to input property values with the `ngOnChanges` method of the `OnChanges` lifecycle hook interface. Detect and act upon changes to input property values with the `ngOnChanges` method of the `OnChanges` lifecycle hook interface.
使用`ngOnChanges`函数方法和`OnChanges`生命周期接口来监测Input属性值的变化并做出相应回应。 使用`OnChanges`生命周期钩子接口的`ngOnChanges`方法来监测输入属性值的变化并做出回应。
.l-sub-section .l-sub-section
:marked :marked
May prefer this approach to the property setter when watching multiple, interacting input properties. May prefer this approach to the property setter when watching multiple, interacting input properties.
监视多个互动Input属性的时候本方法比属性setter更合适。 需要监视多个、交互式输入属性的时候,本方法比用属性的setter更合适。
Learn about `ngOnChanges` in the [LifeCycle Hooks](../guide/lifecycle-hooks.html) chapter. Learn about `ngOnChanges` in the [LifeCycle Hooks](../guide/lifecycle-hooks.html) chapter.
[生命周期钩子](../guide/lifecycle-hooks.html)章节学习更多关于`ngOnChanges`的知识 学习关于`ngOnChanges`的更多知识,参见[生命周期钩子](../guide/lifecycle-hooks.html)章。
:marked :marked
This `VersionChildComponent` detects changes to the `major` and `minor` input properties and composes a log message reporting these changes: This `VersionChildComponent` detects changes to the `major` and `minor` input properties and composes a log message reporting these changes:
这个`VersionChildComponent`监测Input属性`major`和`minor`的变化,并根据这些变化编写一个日志报告 这个`VersionChildComponent`会监测输入属性`major`和`minor`的变化,并把这些变化编写成日志以报告这些变化
+makeExample('cb-component-communication/ts/app/version-child.component.ts') +makeExample('cb-component-communication/ts/app/version-child.component.ts')
:marked :marked
The `VersionParentComponent` supplies the `minor` and `major` values and binds buttons to methods that change them. The `VersionParentComponent` supplies the `minor` and `major` values and binds buttons to methods that change them.
`VersionParentComponent`提供`minor`和`major`值,将变换它们值的函数方法绑定到按钮上。 `VersionParentComponent`提供`minor`和`major`值,把修改它们值的方法绑定到按钮上。
+makeExample('cb-component-communication/ts/app/version-parent.component.ts') +makeExample('cb-component-communication/ts/app/version-parent.component.ts')
@ -186,7 +186,7 @@ figure.image-display
Test that ***both*** input properties are set initially and that button clicks trigger the expected `ngOnChanges` calls and values: Test that ***both*** input properties are set initially and that button clicks trigger the expected `ngOnChanges` calls and values:
测试确认***两个***Input属性值都被初始化了并在点击按钮后`ngOnChanges`被调用,属性值的按预期变化 测试确保***这两个***输入属性值都被初始化了,当点击按钮后,`ngOnChanges`应该被调用,属性的值也符合预期
+makeExample('cb-component-communication/e2e-spec.js', 'parent-to-child-onchanges') +makeExample('cb-component-communication/e2e-spec.js', 'parent-to-child-onchanges')
@ -198,33 +198,33 @@ figure.image-display
<a id="child-to-parent"></a> <a id="child-to-parent"></a>
:marked :marked
## Parent listens for child event ## Parent listens for child event
## 父级监听子级事件 ## 父组件监听子组件的事件
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. 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.html#inputs-outputs) as seen in this `VoterComponent`: The child's `EventEmitter` property is an ***output property***, typically adorned with an [@Output decoration](../guide/template-syntax.html#inputs-outputs) as seen in this `VoterComponent`:
级组件的`EventEmitter`属性是一个**Output属性**,通常用[@Output装饰器](../guide/template-syntax.html#inputs-outputs)来装饰,正如在`VoterComponent`中所见 组件的`EventEmitter`属性是一个**输出属性**,通常带有[@Output装饰器](../guide/template-syntax.html#inputs-outputs),就像在`VoterComponent`中看到的
+makeExample('cb-component-communication/ts/app/voter.component.ts') +makeExample('cb-component-communication/ts/app/voter.component.ts')
:marked :marked
Clicking a button triggers emission of a `true` or `false` (the boolean *payload*). Clicking a button triggers emission of a `true` or `false` (the boolean *payload*).
点击按钮触发`true`或`false`的事件(布尔酬载) 点击按钮会触发`true`或`false`(布尔型*有效载荷*)的事件。
The parent `VoteTakerComponent` binds an event handler (`onVoted`) that responds to the child event payload (`$event`) and updates a counter. The parent `VoteTakerComponent` binds an event handler (`onVoted`) that responds to the child event payload (`$event`) and updates a counter.
级`VoteTakerComponent`绑定一个事件处理器(`onVoted`),用来回应子组件时间事件(`$event`)并更新一个计数器。 组件`VoteTakerComponent`绑定了一个事件处理器(`onVoted`),用来响应子组件的事件(`$event`)并更新一个计数器。
+makeExample('cb-component-communication/ts/app/votetaker.component.ts') +makeExample('cb-component-communication/ts/app/votetaker.component.ts')
:marked :marked
The framework passes the event argument &mdash; represented by `$event` &mdash; to the handler method, and the method processes it: The framework passes the event argument &mdash; represented by `$event` &mdash; to the handler method, and the method processes it:
框架Angular传递利用`$event`把事件参数传给事件处理函数方法,由这个函数方法来处理: 框架Angular把事件参数(用`$event`表示)传给事件处理方法,这个方法会处理:
figure.image-display figure.image-display
img(src="/resources/images/cookbooks/component-communication/child-to-parent.gif" alt="Child-to-parent") img(src="/resources/images/cookbooks/component-communication/child-to-parent.gif" alt="Child-to-parent")
@ -235,7 +235,7 @@ figure.image-display
Test that clicking the *Agree* and *Disagree* buttons update the appropriate counters: Test that clicking the *Agree* and *Disagree* buttons update the appropriate counters:
测试验证点击*Agree*和*Disagree*按钮时,计数器更新是否正确 测试确保点击*Agree*和*Disagree*按钮时,计数器被正确更新
+makeExample('cb-component-communication/e2e-spec.js', 'child-to-parent') +makeExample('cb-component-communication/e2e-spec.js', 'child-to-parent')
@ -249,16 +249,17 @@ parent-to-child-local-var
<a id="parent-to-child-local-var"></a> <a id="parent-to-child-local-var"></a>
:marked :marked
## Parent interacts with child via *local variable* ## Parent interacts with child via *local variable*
## 父级与子级通过*本地变量*互动 ## 父组件与子组件通过*本地变量*互动
A parent component cannot use data binding to read child properties or invoke child methods. We can do both by creating a template reference variable for the child element and then reference that variable *within the parent template* as seen in the following example. A parent component cannot use data binding to read child properties or invoke child methods. We can do both by creating a template reference variable for the child element and then reference that variable *within the parent template* as seen in the following example.
级组件不能使用数据绑定来读取子级属性或者调用子级函数方法。我们可以在父级模板里,新建一个本地变量来代表子组件,然后利用这个变量来读取子级属性和调用子级函数方法,如下例所示。 组件不能使用数据绑定来读取子组件的属性或调用子组件的方法。但我们可以在父组件模板里,新建一个本地变量来代表子组件,然后利用这个变量来读取子组件的属性和调用子组件的方法,如下例所示。
<a id="countdown-timer-example"></a> <a id="countdown-timer-example"></a>
We have a child `CountdownTimerComponent` that repeatedly counts down to zero and launches a rocket. It has `start` and `stop` methods that control the clock and it displays a countdown status message in its own template. We have a child `CountdownTimerComponent` that repeatedly counts down to zero and launches a rocket. 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`方法负责控制时钟并在模板里显示倒计时的状态信息。
+makeExample('cb-component-communication/ts/app/countdown-timer.component.ts') +makeExample('cb-component-communication/ts/app/countdown-timer.component.ts')
:marked :marked
@ -270,19 +271,19 @@ parent-to-child-local-var
:marked :marked
The parent component cannot data bind to the child's `start` and `stop` methods nor to its `seconds` property. 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`属性。
We can place a local variable (`#timer`) on the tag (`<countdown-timer>`) representing the child component. That gives us a reference to the child component itself and the ability to access *any of its properties or methods* from within the parent template. We can place a local variable (`#timer`) on the tag (`<countdown-timer>`) representing the child component. That gives us a reference to the child component itself and the ability to access *any of its properties or methods* from within the parent template.
我们把本地变量(`#timer`)放到(`<countdown-timer>`)标签中,用来代表子级组件。这样父级组件的模板便获取了子级组件的引用载体,在父级组件模板内访问子级的所有属性和方法。 我们把本地变量(`#timer`)放到(`<countdown-timer>`)标签中,用来代表子组件。这样父组件的模板就得到了子组件的引用,于是可以在父组件的模板中访问子组件的所有属性和方法。
In this example, we wire parent buttons to the child's `start` and `stop` and use interpolation to display the child's `seconds` property. In this example, we wire parent buttons to the child's `start` and `stop` and use interpolation to display the child's `seconds` property.
在这个例子中,我们把父级组件的按钮绑定到子级的`start`和`stop`方法,并用插值表达式来显示子级的`seconds`属性。 在这个例子中,我们把父组件的按钮绑定到子组件的`start`和`stop`方法,并用插值表达式来显示子组件的`seconds`属性。
Here we see the parent and child working together. Here we see the parent and child working together.
下面是父级和子级一起工作的结果。 下面是父组件和子组件一起工作时的效果。
figure.image-display figure.image-display
img(src="/resources/images/cookbooks/component-communication/countdown-timer-anim.gif" alt="countdown timer") img(src="/resources/images/cookbooks/component-communication/countdown-timer-anim.gif" alt="countdown timer")
@ -294,7 +295,7 @@ a(id="countdown-tests")
Test that the seconds displayed in the parent template match the seconds displayed in the child's status message. Test also that clicking the *Stop* button pauses the countdown timer: Test that the seconds displayed in the parent template match the seconds displayed in the child's status message. Test also that clicking the *Stop* button pauses the countdown timer:
测试确认在父级模板中显示的秒钟和子级组件里的状态信息里面的秒钟同步 测试确保在父组件模板中显示的秒数和子组件状态信息里的秒数同步。它还会点击*Stop*按钮来停止倒计时
+makeExample('cb-component-communication/e2e-spec.js', 'countdown-timer-tests') +makeExample('cb-component-communication/e2e-spec.js', 'countdown-timer-tests')
@ -307,75 +308,75 @@ a(id="countdown-tests")
<a id="parent-to-view-child"></a> <a id="parent-to-view-child"></a>
:marked :marked
## Parent calls a *ViewChild* ## Parent calls a *ViewChild*
## 父调用*ViewChild* ## 父组件调用*ViewChild*
The *local variable* approach is simple and easy. But it is limited because the parent-child wiring must be done entirely within the parent template. The parent component *itself* has no access to the child. The *local variable* approach is simple and easy. But it is limited because the parent-child wiring must be done entirely within the parent template. The parent component *itself* has no access to the child.
上面*本地变量*的方法是一个简单和便利的方法。但是它有局限性,因为父级-子级的连接必须要全部都在父级的模板里面进行。父级组件本身对子级没有访问权。 这个*本地变量*方法是个简单便利的方法。但是它也有局限性,因为父组件-子组件的连接必须全部在父组件的模板中进行。父组件本身的代码对子组件没有访问权。
We can't use the *local variable* technique if an instance of the parent component *class* must read or write child component values or must call child component methods. We can't use the *local variable* technique if an instance of the parent component *class* must read or write child component values or must call child component methods.
如果父组件的*类*需要读取子组件的属性值或调用子组件的函数方法,我们就不能使用*本地变量*方法。 如果父组件的*类*需要读取子组件的属性值或调用子组件的方法,我们就不能使用*本地变量*方法
When the parent component *class* requires that kind of access, we ***inject*** the child component into the parent as a *ViewChild*. When the parent component *class* requires that kind of access, we ***inject*** the child component into the parent as a *ViewChild*.
当父组件*类*需要这种访问时,我们把子组件作为*ViewChild****注入***到父组件里面。 当父组件*类*需要这种访问时,我们可以把子组件作为*ViewChild****注入***到父组件里面。
We'll illustrate this technique with the same [Countdown Timer](#countdown-timer-example) example. We won't change its appearance or behavior. The child [CountdownTimerComponent](#countdown-timer-example) is the same as well. We'll illustrate this technique with the same [Countdown Timer](#countdown-timer-example) example. We won't change its appearance or behavior. The child [CountdownTimerComponent](#countdown-timer-example) is the same as well.
我们将会用一样的[倒计时](#countdown-timer-example)例子来解释这个技巧。我们没有变化它的样子或行为。子级[CountdownTimerComponent](#countdown-timer-example)和原来一样。 我们将会用同一个[倒计时](#countdown-timer-example)范例来解释这种技术。我们没有改变它的样子或行为。子组件[CountdownTimerComponent](#countdown-timer-example)和原来一样。
.l-sub-section .l-sub-section
:marked :marked
We are switching from the *local variable* to the *ViewChild* technique solely for the purpose of demonstration. We are switching from the *local variable* to the *ViewChild* technique solely for the purpose of demonstration.
我们由*本地变量*切换到*ViewChild*技巧的唯一目的是做一个示范。 我们由*本地变量*切换到*ViewChild*技术的唯一目的就是做示范。
:marked :marked
Here is the parent, `CountdownViewChildParentComponent`: Here is the parent, `CountdownViewChildParentComponent`:
下面是父`CountdownViewChildParentComponent`: 下面是父组件`CountdownViewChildParentComponent`:
+makeExample('cb-component-communication/ts/app/countdown-parent.component.ts', 'vc') +makeExample('cb-component-communication/ts/app/countdown-parent.component.ts', 'vc')
:marked :marked
It takes a bit more work to get the child view into the parent component classs. It takes a bit more work to get the child view into the parent component classs.
把子级视图插入到父级组件类需要一点额外的工作。 把子组件的视图插入到父组件类需要做一点额外的工作。
We import references to the `ViewChild` decorator and the `AfterViewInit` lifecycle hook. We import references to the `ViewChild` decorator and the `AfterViewInit` lifecycle hook.
我们需要通过`ViewChild`装饰器导入引用,并应用`AfterViewInit`生命周期钩子。 我们需要通过`ViewChild`装饰器导入这个引用,并挂上`AfterViewInit`生命周期钩子。
We inject the child `CountdownTimerComponent` into the private `_timerComponent` property via the `@ViewChild` property decoration. We 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 we 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. The `#timer` local variable is gone from the component metadata. Instead we 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. These methods access the injected timer component directly.
这些函数方法直接访问被注入的计时器组件。 这些方法可以直接访问被注入的计时器组件。
The `ngAfterViewInit` lifecycle hook is an important wrinkle. The timer component isn't available until *after* Angular displays the parent view. So we display `0` seconds initially. The `ngAfterViewInit` lifecycle hook is an important wrinkle. The timer component isn't available until *after* Angular displays the parent view. So we display `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 us from updating the parent view's in the same cycle. We have to *wait one turn* before we can display the seconds. 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 us from updating the parent view's in the same cycle. We have to *wait one turn* before we can display the seconds.
然后Angular调用`ngAfterViewInit`生命周期钩子但是这时候再更新父级视图的倒计时就已经太晚了。Angular的单向数据流动规则防止我们在同一个周期内更新父级视图。我们在显示秒钟之前需要被迫*等待一轮*。 然后Angular会调用`ngAfterViewInit`生命周期钩子但这时候再更新父组件视图的倒计时就已经太晚了。Angular的单向数据流规则会阻止我们在同一个周期内更新父组件视图。我们在显示秒数之前会被迫*再等一轮儿*。
We use `setTimeout` to wait one tick and then revise the `seconds` method so that it takes future values from the timer component. We 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 ### Test it
## 测试 ### 测试
Use [the same countdown timer tests](#countdown-tests) as before. Use [the same countdown timer tests](#countdown-tests) as before.
使用之前[一样的倒计时测试](#countdown-tests)。 使用之前[一样的倒计时测试](#countdown-tests)。
:marked :marked
[Back to top](#top) [Back to top](#top)
@ -386,32 +387,32 @@ a(id="countdown-tests")
<a id="bidirectional-service"></a> <a id="bidirectional-service"></a>
:marked :marked
## Parent and children communicate via a service ## Parent and children communicate via a service
## 父级和子级通过服务来交互 ## 父组件和子组件通过服务来通讯
A parent component and its children share a service whose interface enables bi-directional communication *within the family*. A parent component and its children share a service whose interface enables bi-directional communication *within the family*.
级组件和它的子级组件共享一个服务,利用该服务*在本家庭之内*实现双向交互 组件和它的子组件共享同一个服务,利用该服务*在家庭内部*实现双向通讯
The scope of the service instance is the parent component and its children. Components outside this component subtree have no access to the service or their communications. The scope of the service instance is the parent component and its children. Components outside this component subtree have no access to the service or their communications.
该服务实例的作用范围被限制在父级组件和其子级组件内。在这个组件子树之外的组件无法访问该服务或者它们之间的交互 该服务实例的作用范围被限制在父组件和其子组件内。这个组件子树之外的组件将无法访问该服务或者与它们通讯
This `MissionService` connects the `MissionControlComponent` to multiple `AstronautComponent` children. This `MissionService` connects the `MissionControlComponent` to multiple `AstronautComponent` children.
这个`MissionService`连接`MissionControlComponent`和多个`AstronautComponent`子级 这个`MissionService`把`MissionControlComponent`和多个`AstronautComponent`子组件连接起来
+makeExample('cb-component-communication/ts/app/mission.service.ts') +makeExample('cb-component-communication/ts/app/mission.service.ts')
:marked :marked
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: 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`元数据数组),子组件可以通过构造函数将该实例注入到自身
+makeExample('cb-component-communication/ts/app/missioncontrol.component.ts') +makeExample('cb-component-communication/ts/app/missioncontrol.component.ts')
:marked :marked
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: 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`的子组件,所以它们获取到的也是父组件的这个服务实例。
+makeExample('cb-component-communication/ts/app/astronaut.component.ts') +makeExample('cb-component-communication/ts/app/astronaut.component.ts')
@ -419,16 +420,16 @@ a(id="countdown-tests")
:marked :marked
Notice that we capture the `subscription` and unsubscribe when the `AstronautComponent` is destroyed. This is a memory-leak guard step. There is no actual risk in this app because the 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. Notice that we capture the `subscription` and unsubscribe when the `AstronautComponent` is destroyed. This is a memory-leak guard step. There is no actual risk in this app because the 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`被销毁的时候退订。这是一个防止内存泄漏的保护措施。实际上,在这个应用程序中没有这个风险,因为`AstronautComponent`的生命期和应用程序的生命期一样。但在更复杂的应用程序环境中就不一定了。 注意,我们通过`subscription`服务订阅任务,并在`AstronautComponent`被销毁的时候退订。这是一个用于防止内存泄漏的保护措施。实际上,在这个应用程序中没有这个风险,因为`AstronautComponent`的生命期和应用程序的生命期一样。但在更复杂的应用程序环境中就不一定了。
We do not add this guard to the `MissionControlComponent` because, as the parent, it controls the lifetime of the `MissionService`. We do not add this guard to the `MissionControlComponent` because, as the parent, it controls the lifetime of the `MissionService`.
我们不需要在`MissionControlComponent`中添加这个保护措施,因为作为父级,它控制`MissionService`的生命期。 我们不需要在`MissionControlComponent`中添加这个保护措施,因为作为父组件,它控制着`MissionService`的生命期。
:marked :marked
The *History* log demonstrates that messages travel in both directions between the parent `MissionControlComponent` and the `AstronautComponent` children, facilitated by the service: 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`之间,信息通过该服务实现了双向传递。
figure.image-display figure.image-display
img(src="/resources/images/cookbooks/component-communication/bidirectional-service.gif" alt="bidirectional-service") img(src="/resources/images/cookbooks/component-communication/bidirectional-service.gif" alt="bidirectional-service")
@ -439,7 +440,7 @@ figure.image-display
Tests click buttons of both the parent `MissionControlComponent` and the `AstronautComponent` children and verify that the *History* meets expectations: 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*日志和预期的一样。
+makeExample('cb-component-communication/e2e-spec.js', 'bidirectional-service') +makeExample('cb-component-communication/e2e-spec.js', 'bidirectional-service')

View File

@ -193,7 +193,7 @@ include ../_util-fns
See both examples in the following `main.ts` See both examples in the following `main.ts`
where we list their service providers in an array in the second parameter of the `bootstrap` method. where we list their service providers in an array in the second parameter of the `bootstrap` method.
在下面`main.ts`的两个例子中,在`bootstrap`函数方法的第二个参数的数组中,我们列出了它们的服务供应商。 在下面`main.ts`的两个例子中,在`bootstrap`方法的第二个参数的数组中,我们列出了它们的服务供应商。
+makeExample('cb-dependency-injection/ts/app/main.ts','bootstrap','app/main.ts')(format='.') +makeExample('cb-dependency-injection/ts/app/main.ts','bootstrap','app/main.ts')(format='.')
@ -1153,7 +1153,7 @@ a(id="find-parent")
perhaps to access values or call methods on that component. perhaps to access values or call methods on that component.
应用程序组件经常需要共享信息。我们喜欢更加松散结合的技术,比如数据绑定和服务共享。 应用程序组件经常需要共享信息。我们喜欢更加松散结合的技术,比如数据绑定和服务共享。
但是有时候组件需要拥有另一个组件的引用,用来访问该组件的属性值或者调用它的函数方法。 但是有时候组件需要拥有另一个组件的引用,用来访问该组件的属性值或者调用它的方法。
Obtaining a component reference is a bit tricky in Angular. Obtaining a component reference is a bit tricky in Angular.
Although an Angular application is a tree of components, Although an Angular application is a tree of components,

View File

@ -41,7 +41,7 @@ include ../_util-fns
The cookbook is a perpetual *work-in-progress*. The cookbook is a perpetual *work-in-progress*.
本“烹饪书”处于持续的*建设中*的状态 本“烹饪书”还在*持续建设中*
We welcome feedback! Leave a comment by clicking the icon in upper right corner of the banner. We welcome feedback! Leave a comment by clicking the icon in upper right corner of the banner.
@ -53,5 +53,5 @@ include ../_util-fns
Post issues with *Angular 2 itself* to the [angular](https://github.com/angular/angular) github repository. Post issues with *Angular 2 itself* to the [angular](https://github.com/angular/angular) github repository.
在[angular](https://github.com/angular/angular)提交*Angular 2本身*的题。 在[angular](https://github.com/angular/angular)提交*Angular 2本身*的题。
// #enddocregion cookbook // #enddocregion cookbook

View File

@ -2403,7 +2403,7 @@ a(href="#toc") 回到顶部
:marked :marked
**Why?** Services are ideal for sharing methods across a feature area or an app. **Why?** Services are ideal for sharing methods across a feature area or an app.
**为何?**服务是在一个特性范围或一个应用内理想的共享函数方法的理想载体。 **为何?**服务是在一个特性范围或一个应用内理想的共享方法的理想载体。
.s-why.s-why-last .s-why.s-why-last
:marked :marked
@ -2483,7 +2483,7 @@ a(href="#toc") 回到顶部
:marked :marked
**Why?** This is ideal when a service is sharing methods or state. **Why?** This is ideal when a service is sharing methods or state.
**为何?**服务是共享函数方法或状态的理想方法。 **为何?**服务是共享方法或状态的理想方法。
.s-why.s-why-last .s-why.s-why-last
:marked :marked