docs: 基于其它部分的翻译，自动翻译完全相同的句子

Author: Zhicheng WANG

src/cdk/a11y/interactivity-checker/interactivity-checker.ts

@@ -138,6 +138,8 @@ export class InteractivityChecker {
   /**
    * Gets whether an element can be focused by the user.
    *
+   * 获取用户是否可以给某个元素设置焦点。
+   *
    * @param element Element to be checked.
    * @param config The config object with options to customize this method's behavior
    * @returns Whether the element is focusable.

src/cdk/a11y/key-manager/list-key-manager.ts

@@ -26,7 +26,12 @@ import {debounceTime, filter, map, tap} from 'rxjs/operators';
 
 /** This interface is for items that can be passed to a ListKeyManager. */
 export interface ListKeyManagerOption {
-  /** Whether the option is disabled. */
+  /**
+   * Whether the option is disabled.
+   *
+   * 该选项是否被禁用。
+   *
+   */
   disabled?: boolean;
 
   /** Gets the label for this option. */
@@ -190,6 +195,9 @@ export class ListKeyManager<T extends ListKeyManagerOption> {
 
   /**
    * Sets the active item to the item at the index specified.
+   *
+   * 把激活条目设置为由索引指定的条目。
+   *
    * @param index The index of the item to be set as active.
    */
   setActiveItem(index: number): void;
@@ -212,6 +220,9 @@ export class ListKeyManager<T extends ListKeyManagerOption> {
 
   /**
    * Sets the active item depending on the key event passed in.
+   *
+   * 根据传入的键盘事件设置激活条目。
+   *
    * @param event Keyboard event to be used for determining which element should be active.
    */
   onKeydown(event: KeyboardEvent): void {
@@ -309,22 +320,42 @@ export class ListKeyManager<T extends ListKeyManagerOption> {
     return this._pressedLetters.length > 0;
   }
 
-  /** Sets the active item to the first enabled item in the list. */
+  /**
+   * Sets the active item to the first enabled item in the list.
+   *
+   * 将激活条目设置为列表中第一个可用的（enabled）条目。
+   *
+   */
   setFirstItemActive(): void {
     this._setActiveItemByIndex(0, 1);
   }
 
-  /** Sets the active item to the last enabled item in the list. */
+  /**
+   * Sets the active item to the last enabled item in the list.
+   *
+   * 将激活条目设置为列表中最后一个可用的（enabled）条目。
+   *
+   */
   setLastItemActive(): void {
     this._setActiveItemByIndex(this._items.length - 1, -1);
   }
 
-  /** Sets the active item to the next enabled item in the list. */
+  /**
+   * Sets the active item to the next enabled item in the list.
+   *
+   * 将激活条目设置为列表中的下一个可用的（enabled）条目。
+   *
+   */
   setNextItemActive(): void {
     this._activeItemIndex < 0 ? this.setFirstItemActive() : this._setActiveItemByDelta(1);
   }
 
-  /** Sets the active item to a previous enabled item in the list. */
+  /**
+   * Sets the active item to a previous enabled item in the list.
+   *
+   * 将激活条目设置为列表中的上一个可用的（enabled）条目。
+   *
+   */
   setPreviousItemActive(): void {
     this._activeItemIndex < 0 && this._wrap ? this.setLastItemActive()
                                             : this._setActiveItemByDelta(-1);

src/cdk/drag-drop/directives/drag.ts

@@ -115,7 +115,12 @@ export class CdkDrag<T = any> implements AfterViewInit, OnChanges, OnDestroy {
    */
   @Input('cdkDragFreeDragPosition') freeDragPosition: {x: number, y: number};
 
-  /** Whether starting to drag this element is disabled. */
+  /**
+   * Whether starting to drag this element is disabled.
+   *
+   * 是否已禁止拖动此元素。
+   *
+   */
   @Input('cdkDragDisabled')
   get disabled(): boolean {
     return this._disabled || (this.dropContainer && this.dropContainer.disabled);
@@ -134,28 +139,63 @@ export class CdkDrag<T = any> implements AfterViewInit, OnChanges, OnDestroy {
    */
   @Input('cdkDragConstrainPosition') constrainPosition?: (point: Point, dragRef: DragRef) => Point;
 
-  /** Class to be added to the preview element. */
+  /**
+   * Class to be added to the preview element.
+   *
+   * 要添加到预览元素中的类。
+   *
+   */
   @Input('cdkDragPreviewClass') previewClass: string | string[];
 
-  /** Emits when the user starts dragging the item. */
+  /**
+   * Emits when the user starts dragging the item.
+   *
+   * 当用户开始拖动该条目时会触发。
+   *
+   */
   @Output('cdkDragStarted') started: EventEmitter<CdkDragStart> = new EventEmitter<CdkDragStart>();
 
-  /** Emits when the user has released a drag item, before any animations have started. */
+  /**
+   * Emits when the user has released a drag item, before any animations have started.
+   *
+   * 当用户释放了一个拖动条目时触发。位于任何动画开始之前。
+   *
+   */
   @Output('cdkDragReleased') released: EventEmitter<CdkDragRelease> =
       new EventEmitter<CdkDragRelease>();
 
-  /** Emits when the user stops dragging an item in the container. */
+  /**
+   * Emits when the user stops dragging an item in the container.
+   *
+   * 当用户停止拖动容器中的某个条目时，会发出本通知。
+   *
+   */
   @Output('cdkDragEnded') ended: EventEmitter<CdkDragEnd> = new EventEmitter<CdkDragEnd>();
 
-  /** Emits when the user has moved the item into a new container. */
+  /**
+   * Emits when the user has moved the item into a new container.
+   *
+   * 当用户把本条目移到新容器中时发出通知。
+   *
+   */
   @Output('cdkDragEntered') entered: EventEmitter<CdkDragEnter<any>> =
       new EventEmitter<CdkDragEnter<any>>();
 
-  /** Emits when the user removes the item its container by dragging it into another container. */
+  /**
+   * Emits when the user removes the item its container by dragging it into another container.
+   *
+   * 当用户通过把拖动条目从所在的容器移到另一个容器中时，就会触发。
+   *
+   */
   @Output('cdkDragExited') exited: EventEmitter<CdkDragExit<any>> =
       new EventEmitter<CdkDragExit<any>>();
 
-  /** Emits when the user drops the item inside a container. */
+  /**
+   * Emits when the user drops the item inside a container.
+   *
+   * 当用户把条目放到容器中时，就会触发。
+   *
+   */
   @Output('cdkDragDropped') dropped: EventEmitter<CdkDragDrop<any>> =
       new EventEmitter<CdkDragDrop<any>>();
 
@@ -232,12 +272,22 @@ export class CdkDrag<T = any> implements AfterViewInit, OnChanges, OnDestroy {
     return this._dragRef.getPlaceholderElement();
   }
 
-  /** Returns the root draggable element. */
+  /**
+   * Returns the root draggable element.
+   *
+   * 返回可拖动条目的根元素。
+   *
+   */
   getRootElement(): HTMLElement {
     return this._dragRef.getRootElement();
   }
 
-  /** Resets a standalone drag item to its initial position. */
+  /**
+   * Resets a standalone drag item to its initial position.
+   *
+   * 将一个独立的拖动条目重置到初始位置。
+   *
+   */
   reset(): void {
     this._dragRef.reset();
   }

src/cdk/drag-drop/directives/drop-list.ts

@@ -106,10 +106,20 @@ export class CdkDropList<T = any> implements OnDestroy {
    */
   @Input() id: string = `cdk-drop-list-${_uniqueIdCounter++}`;
 
-  /** Locks the position of the draggable elements inside the container along the specified axis. */
+  /**
+   * Locks the position of the draggable elements inside the container along the specified axis.
+   *
+   * 沿着指定的轴锁定容器内可拖动元素的位置。
+   *
+   */
   @Input('cdkDropListLockAxis') lockAxis: DragAxis;
 
-  /** Whether starting a dragging sequence from this container is disabled. */
+  /**
+   * Whether starting a dragging sequence from this container is disabled.
+   *
+   * 是否禁用了从此容器启动拖曳序列的方法。
+   *
+   */
   @Input('cdkDropListDisabled')
   get disabled(): boolean {
     return this._disabled || (!!this._group && this._group.disabled);
@@ -134,24 +144,42 @@ export class CdkDropList<T = any> implements OnDestroy {
   @Input('cdkDropListEnterPredicate')
   enterPredicate: (drag: CdkDrag, drop: CdkDropList) => boolean = () => true
 
-  /** Functions that is used to determine whether an item can be sorted into a particular index. */
+  /**
+   * Functions that is used to determine whether an item can be sorted into a particular index.
+   *
+   * 一个函数，用来判断某个条目是否可以被排序到特定索引。
+   *
+   */
   @Input('cdkDropListSortPredicate')
   sortPredicate: (index: number, drag: CdkDrag, drop: CdkDropList) => boolean = () => true
 
   /** Whether to auto-scroll the view when the user moves their pointer close to the edges. */
   @Input('cdkDropListAutoScrollDisabled')
   autoScrollDisabled: boolean;
 
-  /** Number of pixels to scroll for each frame when auto-scrolling an element. */
+  /**
+   * Number of pixels to scroll for each frame when auto-scrolling an element.
+   *
+   * 当自动滚动元素时，这是每一帧滚动的像素数。
+   *
+   */
   @Input('cdkDropListAutoScrollStep')
   autoScrollStep: number;
 
-  /** Emits when the user drops an item inside the container. */
+  /**
+   * Emits when the user drops an item inside the container.
+   *
+   * 当用户把一个条目投放进该容器时就会触发。
+   *
+   */
   @Output('cdkDropListDropped')
   dropped: EventEmitter<CdkDragDrop<T, any>> = new EventEmitter<CdkDragDrop<T, any>>();
 
   /**
    * Emits when the user has moved a new drag item into this container.
+   *
+   * 当用户把一个新的拖动条目移到这个容器中时，就会触发。
+   *
    */
   @Output('cdkDropListEntered')
   entered: EventEmitter<CdkDragEnter<T>> = new EventEmitter<CdkDragEnter<T>>();
@@ -163,7 +191,12 @@ export class CdkDropList<T = any> implements OnDestroy {
   @Output('cdkDropListExited')
   exited: EventEmitter<CdkDragExit<T>> = new EventEmitter<CdkDragExit<T>>();
 
-  /** Emits as the user is swapping items while actively dragging. */
+  /**
+   * Emits as the user is swapping items while actively dragging.
+   *
+   * 当用户正在主动拖动以交换条目时，就会触发。
+   *
+   */
   @Output('cdkDropListSorted')
   sorted: EventEmitter<CdkDragSortEvent<T>> = new EventEmitter<CdkDragSortEvent<T>>();
 

src/cdk/overlay/position/connected-position.ts

@@ -80,7 +80,6 @@ export class ConnectionPositionPair {
  *
  * \-------------------------- | | | | | Scrollable | | | | | | | -------------------------- | Scrollable | | |
  *
- *
  * * * *
  * @docs-private
  */

src/cdk/overlay/position/flexible-connected-position-strategy.ts

@@ -64,7 +64,12 @@ export class FlexibleConnectedPositionStrategy implements PositionStrategy {
   /** Whether the overlay can grow via flexible width/height after the initial open. */
   private _growAfterOpen = false;
 
-  /** Whether the overlay's width and height can be constrained to fit within the viewport. */
+  /**
+   * Whether the overlay's width and height can be constrained to fit within the viewport.
+   *
+   * 浮层的宽度和高度是否可以约束在当前视口中。
+   *
+   */
   private _hasFlexibleDimensions = true;
 
   /** Whether the overlay position is locked. */

src/cdk/overlay/scroll/block-scroll-strategy.spec.ts

@@ -171,6 +171,7 @@ describe('BlockScrollStrategy', () => {
    * Skips the specified test, if it is being executed on iOS. This is necessary, because
    * programmatic scrolling inside the Karma iframe doesn't work on iOS, which renders these
    * tests unusable. For example, something as basic as the following won't work:
+   *
    * ```
    * window.scroll(0, 100);
    * expect(viewport.getViewportScrollPosition().top).toBe(100);

src/cdk/schematics/utils/vendored-ast-utils/index.ts

@@ -189,8 +189,7 @@ function nodesByPosition(first: ts.Node, second: ts.Node): number {
 /**
  * Insert `toInsert` after the last occurence of `ts.SyntaxKind[nodes[i].kind]`
  * or after the last of occurence of `syntaxKind` if the last occurence is a sub child
- * of ts.SyntaxKind[nodes[i].kind] and save the changes in file.
- *
+ * of ts.SyntaxKind\[nodes[i].kind] and save the changes in file.
  * @param nodes insert after the last occurence of nodes
  * @param toInsert string to insert
  * @param file file to insert changes into