diff --git a/aio/content/translations/cn/api-plan.md b/aio/content/translations/cn/api-plan.md index 3b983196d2..e6892037d4 100644 --- a/aio/content/translations/cn/api-plan.md +++ b/aio/content/translations/cn/api-plan.md @@ -60,7 +60,7 @@ [x] | router/CanActivate | 0.27 [x] | router | 0.26 [ ] | animations/style | 0.25 -[ ] | common/SlicePipe | 0.25 +[x] | common/SlicePipe | 0.25 [ ] | router/Event | 0.25 [ ] | common/JsonPipe | 0.25 [x] | forms/FormArray | 0.25 diff --git a/packages/common/src/pipes/slice_pipe.ts b/packages/common/src/pipes/slice_pipe.ts index af2726382e..4c8347cf41 100644 --- a/packages/common/src/pipes/slice_pipe.ts +++ b/packages/common/src/pipes/slice_pipe.ts @@ -15,27 +15,43 @@ import {invalidPipeArgumentError} from './invalid_pipe_argument_error'; * * Creates a new `Array` or `String` containing a subset (slice) of the elements. * + * 从一个 `Array` 或 `String` 中创建其元素一个新子集(slice)。 + * * All behavior is based on the expected behavior of the JavaScript API `Array.prototype.slice()` * and `String.prototype.slice()`. * + * 所有行为都基于 JavaScript API `Array.prototype.slice()` 和 `String.prototype.slice()` 的预期行为。 + * * When operating on an `Array`, the returned `Array` is always a copy even when all * the elements are being returned. * + * 当操作 `Array` 时,返回的 `Array` 始终是一个副本 —— 即使返回了所有元素也是一样。 + * * When operating on a blank value, the pipe returns the blank value. * + * 当操作空白值时,该管道也会返回空白值。 + * * ### List Example * + * ### 列表范例 + * * This `ngFor` example: * + * `ngFor` 例子: + * * {@example common/pipes/ts/slice_pipe.ts region='SlicePipe_list'} * * produces the following: * + * 生成下列内容: + * *
  • b
  • *
  • c
  • * * ## String Examples * + * ## 字符串范例 + * * {@example common/pipes/ts/slice_pipe.ts region='SlicePipe_string'} * * @@ -45,18 +61,47 @@ import {invalidPipeArgumentError} from './invalid_pipe_argument_error'; export class SlicePipe implements PipeTransform { /** * @param value a list or a string to be sliced. + * + * 要截取的列表或字符串。 + * * @param start the starting index of the subset to return: + * + * 要返回的子集的初始索引: + * * - **a positive integer**: return the item at `start` index and all items after * in the list or string expression. + * + * **一个正整数**:从列表或字符串表达式中返回从 `start` 索引处及之后的所有条目。 + * * - **a negative integer**: return the item at `start` index from the end and all items after * in the list or string expression. + * + * **一个负整数**:从列表或字符串表达式中返回从结尾开始的第 `start` 索引处及之后的所有条目。 + * * - **if positive and greater than the size of the expression**: return an empty list or * string. + * + * **如果是正数而且大于表达式的条目数**:返回空列表或空字符串。 + * * - **if negative and greater than the size of the expression**: return entire list or string. + * + * **如果是复数而且大于表达式的条目数**:返回整个列表或字符串。 + * * @param end the ending index of the subset to return: + * + * 所要返回的子集的结尾索引: + * * - **omitted**: return all items until the end. + * + * **省略**:返回结尾之前的全部条目。 + * * - **if positive**: return all items before `end` index of the list or string. + * + * **如果为正数**:从列表或字符串中返回 `end` 索引之前的所有条目。 + * * - **if negative**: return all items before `end` index from the end of the list or string. + * + * **如果为负数**:从列表或字符串中返回 `end` 索引之前的所有条目。 */ transform(value: any, start: number, end?: number): any { if (value == null) return value;