From ee075b2bbd9728c8c448f9077e60832e048ae7a6 Mon Sep 17 00:00:00 2001
From: Zhicheng Wang <zcwang@thoughtworks.com>
Date: Tue, 4 Sep 2018 16:42:02 +0800
Subject: [PATCH] =?UTF-8?q?docs(API):=20=E7=BF=BB=E8=AF=91=E5=AE=8C?=
 =?UTF-8?q?=E4=BA=86=20QueryList?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 aio/content/translations/cn/api-plan.md |  2 +-
 packages/core/src/linker/query_list.ts  | 25 +++++++++++++++++++++++++
 2 files changed, 26 insertions(+), 1 deletion(-)

diff --git a/aio/content/translations/cn/api-plan.md b/aio/content/translations/cn/api-plan.md
index c77c79419d..1e27c52271 100644
--- a/aio/content/translations/cn/api-plan.md
+++ b/aio/content/translations/cn/api-plan.md
@@ -78,7 +78,7 @@
 [x]  | core/ComponentFactoryResolver  | 0.20
 [x]  | forms/Form  | 0.20
 [x]  | common/http/HttpErrorResponse  | 0.20
-[ ]  | core/QueryList  | 0.19
+[x]  | core/QueryList  | 0.19
 [ ]  | forms  | 0.19
 [ ]  | animations/state  | 0.19
 [ ]  | common  | 0.19
diff --git a/packages/core/src/linker/query_list.ts b/packages/core/src/linker/query_list.ts
index fd06b021f4..5e6c62665f 100644
--- a/packages/core/src/linker/query_list.ts
+++ b/packages/core/src/linker/query_list.ts
@@ -16,19 +16,32 @@ import {getSymbolIterator} from '../util';
  * An unmodifiable list of items that Angular keeps up to date when the state
  * of the application changes.
  *
+ * 一个不可修改的条目列表，当应用状态变化时，Angular 会保证它是最新的。
+ *
  * The type of object that {@link ViewChildren}, {@link ContentChildren}, and {@link QueryList}
  * provide.
  *
+ * {@link ViewChildren}、{@link ContentChildren} 和 {@link QueryList} 所提供对象的类型。
+ *
  * Implements an iterable interface, therefore it can be used in both ES6
  * javascript `for (var i of items)` loops as well as in Angular templates with
  * `*ngFor="let i of myList"`.
  *
+ * 实现一个可迭代接口，因此它可以用于 ES6 JavaScript 的 `for (var i of items)` 循环，和 Angular 模板中的 `*ngFor="let i of myList"`。
+ *
  * Changes can be observed by subscribing to the changes `Observable`.
  *
+ * 可以通过订阅 `changes` 这个 `Observable` 来监听这些变化。
+ *
  * NOTE: In the future this class will implement an `Observable` interface.
  *
+ * 注意：将来此类将会实现 `Observable` 接口。
+ *
  * @usageNotes
  * ### Example
+ *
+ * ### 例子
+ *
  * ```typescript
  * @Component({...})
  * class Container {
@@ -50,12 +63,16 @@ export class QueryList<T>/* implements Iterable<T> */ {
   /**
    * See
    * [Array.map](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map)
+   *
+   * 参见 [Array.map](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map)
    */
   map<U>(fn: (item: T, index: number, array: T[]) => U): U[] { return this._results.map(fn); }
 
   /**
    * See
    * [Array.filter](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter)
+   *
+   * 参见 [Array.filter](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter)
    */
   filter(fn: (item: T, index: number, array: T[]) => boolean): T[] {
     return this._results.filter(fn);
@@ -64,6 +81,8 @@ export class QueryList<T>/* implements Iterable<T> */ {
   /**
    * See
    * [Array.find](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/find)
+   *
+   * 参见 [Array.find](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/find)
    */
   find(fn: (item: T, index: number, array: T[]) => boolean): T|undefined {
     return this._results.find(fn);
@@ -72,6 +91,8 @@ export class QueryList<T>/* implements Iterable<T> */ {
   /**
    * See
    * [Array.reduce](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/reduce)
+   *
+   * 参见 [Array.reduce](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/reduce)
    */
   reduce<U>(fn: (prevValue: U, curValue: T, curIndex: number, array: T[]) => U, init: U): U {
     return this._results.reduce(fn, init);
@@ -80,12 +101,16 @@ export class QueryList<T>/* implements Iterable<T> */ {
   /**
    * See
    * [Array.forEach](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/forEach)
+   *
+   * 参见 [Array.forEach](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/forEach)
    */
   forEach(fn: (item: T, index: number, array: T[]) => void): void { this._results.forEach(fn); }
 
   /**
    * See
    * [Array.some](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/some)
+   *
+   * 参见 [Array.some](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/some)
    */
   some(fn: (value: T, index: number, array: T[]) => boolean): boolean {
     return this._results.some(fn);