@angular/material 7.0.4 → 7.2.1

package/esm5/select.es5.js

@@ -7,11 +7,11 @@
  */
 import { animate, state, style, transition, trigger } from '@angular/animations';
 import { __extends } from 'tslib';
-import { ActiveDescendantKeyManager } from '@angular/cdk/a11y';
+import { ActiveDescendantKeyManager, LiveAnnouncer } from '@angular/cdk/a11y';
 import { Directionality } from '@angular/cdk/bidi';
 import { coerceBooleanProperty } from '@angular/cdk/coercion';
 import { SelectionModel } from '@angular/cdk/collections';
-import { A, DOWN_ARROW, END, ENTER, HOME, LEFT_ARROW, RIGHT_ARROW, SPACE, UP_ARROW } from '@angular/cdk/keycodes';
+import { A, DOWN_ARROW, END, ENTER, HOME, LEFT_ARROW, RIGHT_ARROW, SPACE, UP_ARROW, hasModifierKey } from '@angular/cdk/keycodes';
 import { CdkConnectedOverlay, Overlay, OverlayModule } from '@angular/cdk/overlay';
 import { ViewportRuler } from '@angular/cdk/scrolling';
 import { Attribute, ChangeDetectionStrategy, ChangeDetectorRef, Component, ContentChild, ContentChildren, Directive, ElementRef, EventEmitter, Inject, InjectionToken, Input, isDevMode, NgZone, Optional, Output, Self, ViewChild, ViewEncapsulation, NgModule } from '@angular/core';
@@ -24,25 +24,26 @@ import { CommonModule } from '@angular/common';
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
-/** *
+/**
  * The following are all the animations for the mat-select component, with each
  * const containing the metadata for one animation.
  *
  * The values below match the implementation of the AngularJS Material mat-select animation.
  * \@docs-private
-  @type {?} */
+ * @type {?}
+ */
 var matSelectAnimations = {
     /**
-       * This animation transforms the select's overlay panel on and off the page.
-       *
-       * When the panel is attached to the DOM, it expands its width by the amount of padding, scales it
-       * up to 100% on the Y axis, fades in its border, and translates slightly up and to the
-       * side to ensure the option text correctly overlaps the trigger text.
-       *
-       * When the panel is removed from the DOM, it simply fades out linearly.
-       */
+     * This animation transforms the select's overlay panel on and off the page.
+     *
+     * When the panel is attached to the DOM, it expands its width by the amount of padding, scales it
+     * up to 100% on the Y axis, fades in its border, and translates slightly up and to the
+     * side to ensure the option text correctly overlaps the trigger text.
+     *
+     * When the panel is removed from the DOM, it simply fades out linearly.
+     */
     transformPanel: trigger('transformPanel', [
         state('void', style({
             transform: 'scaleY(0.8)',
@@ -65,12 +66,12 @@ var matSelectAnimations = {
         transition('* => void', animate('100ms 25ms linear', style({ opacity: 0 })))
     ]),
     /**
-       * This animation fades in the background color and text content of the
-       * select's options. It is time delayed to occur 100ms after the overlay
-       * panel has transformed in.
-       * @deprecated Not used anymore. To be removed.
-       * @breaking-change 8.0.0
-       */
+     * This animation fades in the background color and text content of the
+     * select's options. It is time delayed to occur 100ms after the overlay
+     * panel has transformed in.
+     * @deprecated Not used anymore. To be removed.
+     * \@breaking-change 8.0.0
+     */
     fadeInContent: trigger('fadeInContent', [
         state('showing', style({ opacity: 1 })),
         transition('void => showing', [
@@ -79,22 +80,24 @@ var matSelectAnimations = {
         ])
     ])
 };
-/** *
+/**
  * @deprecated
  * \@breaking-change 8.0.0
  * \@docs-private
-  @type {?} */
+ * @type {?}
+ */
 var transformPanel = matSelectAnimations.transformPanel;
-/** *
+/**
  * @deprecated
  * \@breaking-change 8.0.0
  * \@docs-private
-  @type {?} */
+ * @type {?}
+ */
 var fadeInContent = matSelectAnimations.fadeInContent;
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 
 /**
@@ -128,27 +131,32 @@ function getMatSelectNonFunctionValueError() {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /** @type {?} */
 var nextUniqueId = 0;
-/** *
+/**
  * The max height of the select's overlay panel
-  @type {?} */
+ * @type {?}
+ */
 var SELECT_PANEL_MAX_HEIGHT = 256;
-/** *
+/**
  * The panel's padding on the x-axis
-  @type {?} */
+ * @type {?}
+ */
 var SELECT_PANEL_PADDING_X = 16;
-/** *
+/**
  * The panel's x axis padding if it is indented (e.g. there is an option group).
-  @type {?} */
+ * @type {?}
+ */
 var SELECT_PANEL_INDENT_PADDING_X = SELECT_PANEL_PADDING_X * 2;
-/** *
+/**
  * The height of the select items in `em` units.
-  @type {?} */
+ * @type {?}
+ */
 var SELECT_ITEM_HEIGHT_EM = 3;
-/** *
+// TODO(josephperrott): Revert to a constant after 2018 spec updates are fully merged.
+/**
  * Distance between the panel edge and the option text in
  * multi-selection mode.
  *
@@ -156,16 +164,19 @@ var SELECT_ITEM_HEIGHT_EM = 3;
  * (SELECT_PANEL_PADDING_X * 1.5) + 20 = 44
  * The padding is multiplied by 1.5 because the checkbox's margin is half the padding.
  * The checkbox width is 16px.
-  @type {?} */
+ * @type {?}
+ */
 var SELECT_MULTIPLE_PANEL_PADDING_X = 0;
-/** *
+/**
  * The select panel will only "fit" inside the viewport if it is positioned at
  * this value or more away from the viewport boundary.
-  @type {?} */
+ * @type {?}
+ */
 var SELECT_PANEL_VIEWPORT_PADDING = 8;
-/** *
+/**
  * Injection token that determines the scroll handling while a select is open.
-  @type {?} */
+ * @type {?}
+ */
 var MAT_SELECT_SCROLL_STRATEGY = new InjectionToken('mat-select-scroll-strategy');
 /**
  * \@docs-private
@@ -175,9 +186,10 @@ var MAT_SELECT_SCROLL_STRATEGY = new InjectionToken('mat-select-scroll-strategy'
 function MAT_SELECT_SCROLL_STRATEGY_PROVIDER_FACTORY(overlay) {
     return function () { return overlay.scrollStrategies.reposition(); };
 }
-/** *
+/**
  * \@docs-private
-  @type {?} */
+ * @type {?}
+ */
 var MAT_SELECT_SCROLL_STRATEGY_PROVIDER = {
     provide: MAT_SELECT_SCROLL_STRATEGY,
     deps: [Overlay],
@@ -196,10 +208,13 @@ MatSelectChange = /** @class */ (function () {
     }
     return MatSelectChange;
 }());
+// Boilerplate for applying mixins to MatSelect.
 /**
  * \@docs-private
  */
-var  /**
+var  
+// Boilerplate for applying mixins to MatSelect.
+/**
  * \@docs-private
  */
 MatSelectBase = /** @class */ (function () {
@@ -229,7 +244,7 @@ var MatSelectTrigger = /** @class */ (function () {
 }());
 var MatSelect = /** @class */ (function (_super) {
     __extends(MatSelect, _super);
-    function MatSelect(_viewportRuler, _changeDetectorRef, _ngZone, _defaultErrorStateMatcher, elementRef, _dir, _parentForm, _parentFormGroup, _parentFormField, ngControl, tabIndex, scrollStrategyFactory) {
+    function MatSelect(_viewportRuler, _changeDetectorRef, _ngZone, _defaultErrorStateMatcher, elementRef, _dir, _parentForm, _parentFormGroup, _parentFormField, ngControl, tabIndex, scrollStrategyFactory, _liveAnnouncer) {
         var _this = _super.call(this, elementRef, _defaultErrorStateMatcher, _parentForm, _parentFormGroup, ngControl) || this;
         _this._viewportRuler = _viewportRuler;
         _this._changeDetectorRef = _changeDetectorRef;
@@ -237,6 +252,7 @@ var MatSelect = /** @class */ (function (_super) {
         _this._dir = _dir;
         _this._parentFormField = _parentFormField;
         _this.ngControl = ngControl;
+        _this._liveAnnouncer = _liveAnnouncer;
         /**
          * Whether or not the overlay panel is open.
          */
@@ -606,7 +622,7 @@ var MatSelect = /** @class */ (function (_super) {
     function (changes) {
         // Updating the disabled state is handled by `mixinDisabled`, but we need to additionally let
         // the parent form field know to run change detection when the disabled state changes.
-        if (changes["disabled"]) {
+        if (changes.disabled) {
             this.stateChanges.next();
         }
     };
@@ -859,13 +875,16 @@ var MatSelect = /** @class */ (function (_super) {
             this.panelOpen ? this._handleOpenKeydown(event) : this._handleClosedKeydown(event);
         }
     };
+    /** Handles keyboard events while the select is closed. */
     /**
      * Handles keyboard events while the select is closed.
+     * @private
      * @param {?} event
      * @return {?}
      */
     MatSelect.prototype._handleClosedKeydown = /**
      * Handles keyboard events while the select is closed.
+     * @private
      * @param {?} event
      * @return {?}
      */
@@ -880,11 +899,13 @@ var MatSelect = /** @class */ (function (_super) {
         /** @type {?} */
         var manager = this._keyManager;
         // Open the select on ALT + arrow key to match the native <select>
-        if (isOpenKey || ((this.multiple || event.altKey) && isArrowKey)) {
+        if ((isOpenKey && !hasModifierKey(event)) || ((this.multiple || event.altKey) && isArrowKey)) {
             event.preventDefault(); // prevents the page from scrolling down when pressing space
             this.open();
         }
         else if (!this.multiple) {
+            /** @type {?} */
+            var selectedOption = this.selected;
             if (keyCode === HOME || keyCode === END) {
                 keyCode === HOME ? manager.setFirstItemActive() : manager.setLastItemActive();
                 event.preventDefault();
@@ -892,15 +913,23 @@ var MatSelect = /** @class */ (function (_super) {
             else {
                 manager.onKeydown(event);
             }
+            // Since the value has changed, we need to announce it ourselves.
+            // @breaking-change 8.0.0 remove null check for _liveAnnouncer.
+            if (this._liveAnnouncer && selectedOption !== this.selected) {
+                this._liveAnnouncer.announce(((/** @type {?} */ (this.selected))).viewValue);
+            }
         }
     };
+    /** Handles keyboard events when the selected is open. */
     /**
      * Handles keyboard events when the selected is open.
+     * @private
      * @param {?} event
      * @return {?}
      */
     MatSelect.prototype._handleOpenKeydown = /**
      * Handles keyboard events when the selected is open.
+     * @private
      * @param {?} event
      * @return {?}
      */
@@ -920,7 +949,8 @@ var MatSelect = /** @class */ (function (_super) {
             event.preventDefault();
             this.close();
         }
-        else if ((keyCode === ENTER || keyCode === SPACE) && manager.activeItem) {
+        else if ((keyCode === ENTER || keyCode === SPACE) && manager.activeItem &&
+            !hasModifierKey(event)) {
             event.preventDefault();
             manager.activeItem._selectViaInteraction();
         }
@@ -1010,12 +1040,19 @@ var MatSelect = /** @class */ (function (_super) {
     function () {
         return this._parentFormField ? "mat-" + this._parentFormField.color : '';
     };
+    // TODO(josephperrott): Remove after 2018 spec updates are fully merged.
+    /** Sets the pseudo checkbox padding size based on the width of the pseudo checkbox. */
+    // TODO(josephperrott): Remove after 2018 spec updates are fully merged.
     /**
      * Sets the pseudo checkbox padding size based on the width of the pseudo checkbox.
+     * @private
      * @return {?}
      */
-    MatSelect.prototype._setPseudoCheckboxPaddingSize = /**
+    MatSelect.prototype._setPseudoCheckboxPaddingSize = 
+    // TODO(josephperrott): Remove after 2018 spec updates are fully merged.
+    /**
      * Sets the pseudo checkbox padding size based on the width of the pseudo checkbox.
+     * @private
      * @return {?}
      */
     function () {
@@ -1040,9 +1077,11 @@ var MatSelect = /** @class */ (function (_super) {
         configurable: true
     });
     /**
+     * @private
      * @return {?}
      */
     MatSelect.prototype._initializeSelection = /**
+     * @private
      * @return {?}
      */
     function () {
@@ -1051,17 +1090,24 @@ var MatSelect = /** @class */ (function (_super) {
         // has changed after it was checked" errors from Angular.
         Promise.resolve().then(function () {
             _this._setSelectionByValue(_this.ngControl ? _this.ngControl.value : _this._value);
+            _this.stateChanges.next();
         });
     };
     /**
      * Sets the selected option based on a value. If no option can be
      * found with the designated value, the select trigger is cleared.
+     */
+    /**
+     * Sets the selected option based on a value. If no option can be
+     * found with the designated value, the select trigger is cleared.
+     * @private
      * @param {?} value
      * @return {?}
      */
     MatSelect.prototype._setSelectionByValue = /**
      * Sets the selected option based on a value. If no option can be
      * found with the designated value, the select trigger is cleared.
+     * @private
      * @param {?} value
      * @return {?}
      */
@@ -1089,11 +1135,17 @@ var MatSelect = /** @class */ (function (_super) {
     };
     /**
      * Finds and selects and option based on its value.
+     * @returns Option that has the corresponding value.
+     */
+    /**
+     * Finds and selects and option based on its value.
+     * @private
      * @param {?} value
      * @return {?} Option that has the corresponding value.
      */
     MatSelect.prototype._selectValue = /**
      * Finds and selects and option based on its value.
+     * @private
      * @param {?} value
      * @return {?} Option that has the corresponding value.
      */
@@ -1118,12 +1170,15 @@ var MatSelect = /** @class */ (function (_super) {
         }
         return correspondingOption;
     };
+    /** Sets up a key manager to listen to keyboard events on the overlay panel. */
     /**
      * Sets up a key manager to listen to keyboard events on the overlay panel.
+     * @private
      * @return {?}
      */
     MatSelect.prototype._initKeyManager = /**
      * Sets up a key manager to listen to keyboard events on the overlay panel.
+     * @private
      * @return {?}
      */
     function () {
@@ -1148,12 +1203,15 @@ var MatSelect = /** @class */ (function (_super) {
             }
         });
     };
+    /** Drops current option subscriptions and IDs and resets from scratch. */
     /**
      * Drops current option subscriptions and IDs and resets from scratch.
+     * @private
      * @return {?}
      */
     MatSelect.prototype._resetOptions = /**
      * Drops current option subscriptions and IDs and resets from scratch.
+     * @private
      * @return {?}
      */
     function () {
@@ -1176,14 +1234,17 @@ var MatSelect = /** @class */ (function (_super) {
         });
         this._setOptionIds();
     };
+    /** Invoked when an option is clicked. */
     /**
      * Invoked when an option is clicked.
+     * @private
      * @param {?} option
      * @param {?} isUserInput
      * @return {?}
      */
     MatSelect.prototype._onSelect = /**
      * Invoked when an option is clicked.
+     * @private
      * @param {?} option
      * @param {?} isUserInput
      * @return {?}
@@ -1217,12 +1278,15 @@ var MatSelect = /** @class */ (function (_super) {
         }
         this.stateChanges.next();
     };
+    /** Sorts the selected values in the selected based on their order in the panel. */
     /**
      * Sorts the selected values in the selected based on their order in the panel.
+     * @private
      * @return {?}
      */
     MatSelect.prototype._sortValues = /**
      * Sorts the selected values in the selected based on their order in the panel.
+     * @private
      * @return {?}
      */
     function () {
@@ -1237,13 +1301,16 @@ var MatSelect = /** @class */ (function (_super) {
             this.stateChanges.next();
         }
     };
+    /** Emits change event to set the model value. */
     /**
      * Emits change event to set the model value.
+     * @private
      * @param {?=} fallbackValue
      * @return {?}
      */
     MatSelect.prototype._propagateChanges = /**
      * Emits change event to set the model value.
+     * @private
      * @param {?=} fallbackValue
      * @return {?}
      */
@@ -1251,10 +1318,10 @@ var MatSelect = /** @class */ (function (_super) {
         /** @type {?} */
         var valueToEmit = null;
         if (this.multiple) {
-            valueToEmit = (/** @type {?} */ (this.selected)).map(function (option) { return option.value; });
+            valueToEmit = ((/** @type {?} */ (this.selected))).map(function (option) { return option.value; });
         }
         else {
-            valueToEmit = this.selected ? (/** @type {?} */ (this.selected)).value : fallbackValue;
+            valueToEmit = this.selected ? ((/** @type {?} */ (this.selected))).value : fallbackValue;
         }
         this._value = valueToEmit;
         this.valueChange.emit(valueToEmit);
@@ -1262,12 +1329,15 @@ var MatSelect = /** @class */ (function (_super) {
         this.selectionChange.emit(new MatSelectChange(this, valueToEmit));
         this._changeDetectorRef.markForCheck();
     };
+    /** Records option IDs to pass to the aria-owns property. */
     /**
      * Records option IDs to pass to the aria-owns property.
+     * @private
      * @return {?}
      */
     MatSelect.prototype._setOptionIds = /**
      * Records option IDs to pass to the aria-owns property.
+     * @private
      * @return {?}
      */
     function () {
@@ -1276,11 +1346,17 @@ var MatSelect = /** @class */ (function (_super) {
     /**
      * Highlights the selected item. If no option is selected, it will highlight
      * the first item instead.
+     */
+    /**
+     * Highlights the selected item. If no option is selected, it will highlight
+     * the first item instead.
+     * @private
      * @return {?}
      */
     MatSelect.prototype._highlightCorrectOption = /**
      * Highlights the selected item. If no option is selected, it will highlight
      * the first item instead.
+     * @private
      * @return {?}
      */
     function () {
@@ -1293,12 +1369,15 @@ var MatSelect = /** @class */ (function (_super) {
             }
         }
     };
+    /** Scrolls the active option into view. */
     /**
      * Scrolls the active option into view.
+     * @private
      * @return {?}
      */
     MatSelect.prototype._scrollActiveOptionIntoView = /**
      * Scrolls the active option into view.
+     * @private
      * @return {?}
      */
     function () {
@@ -1320,13 +1399,16 @@ var MatSelect = /** @class */ (function (_super) {
     function () {
         this._elementRef.nativeElement.focus();
     };
+    /** Gets the index of the provided option in the option list. */
     /**
      * Gets the index of the provided option in the option list.
+     * @private
      * @param {?} option
      * @return {?}
      */
     MatSelect.prototype._getOptionIndex = /**
      * Gets the index of the provided option in the option list.
+     * @private
      * @param {?} option
      * @return {?}
      */
@@ -1335,12 +1417,15 @@ var MatSelect = /** @class */ (function (_super) {
             return result === undefined ? (option === current ? index : undefined) : result;
         }, undefined);
     };
+    /** Calculates the scroll position and x- and y-offsets of the overlay panel. */
     /**
      * Calculates the scroll position and x- and y-offsets of the overlay panel.
+     * @private
      * @return {?}
      */
     MatSelect.prototype._calculateOverlayPosition = /**
      * Calculates the scroll position and x- and y-offsets of the overlay panel.
+     * @private
      * @return {?}
      */
     function () {
@@ -1352,11 +1437,15 @@ var MatSelect = /** @class */ (function (_super) {
         var panelHeight = Math.min(items * itemHeight, SELECT_PANEL_MAX_HEIGHT);
         /** @type {?} */
         var scrollContainerHeight = items * itemHeight;
+        // The farthest the panel can be scrolled before it hits the bottom
         /** @type {?} */
         var maxScroll = scrollContainerHeight - panelHeight;
+        // If no value is selected we open the popup to the first item.
         /** @type {?} */
-        var selectedOptionOffset = this.empty ? 0 : /** @type {?} */ ((this._getOptionIndex(this._selectionModel.selected[0])));
+        var selectedOptionOffset = this.empty ? 0 : (/** @type {?} */ (this._getOptionIndex(this._selectionModel.selected[0])));
         selectedOptionOffset += _countGroupLabelsBeforeOption(selectedOptionOffset, this.options, this.optionGroups);
+        // We must maintain a scroll buffer so the selected option will be scrolled to the
+        // center of the overlay panel rather than the top.
         /** @type {?} */
         var scrollBuffer = panelHeight / 2;
         this._scrollTop = this._calculateOverlayScroll(selectedOptionOffset, scrollBuffer, maxScroll);
@@ -1399,6 +1488,10 @@ var MatSelect = /** @class */ (function (_super) {
         var optionOffsetFromScrollTop = itemHeight * selectedIndex;
         /** @type {?} */
         var halfOptionHeight = itemHeight / 2;
+        // Starts at the optionOffsetFromScrollTop, which scrolls the option to the top of the
+        // scroll container, then subtracts the scroll buffer to scroll the option down to
+        // the center of the overlay panel. Half the option height must be re-added to the
+        // scrollTop so the option is centered based on its middle, not its top edge.
         /** @type {?} */
         var optimalScrollPosition = optionOffsetFromScrollTop - scrollBuffer + halfOptionHeight;
         return Math.min(Math.max(0, optimalScrollPosition), maxScroll);
@@ -1459,6 +1552,14 @@ var MatSelect = /** @class */ (function (_super) {
      * the panel opens. Will change based on LTR or RTL text direction. Note that the offset
      * can't be calculated until the panel has been attached, because we need to know the
      * content width in order to constrain the panel within the viewport.
+     */
+    /**
+     * Sets the x-offset of the overlay panel in relation to the trigger's top start corner.
+     * This must be adjusted to align the selected option text over the trigger text when
+     * the panel opens. Will change based on LTR or RTL text direction. Note that the offset
+     * can't be calculated until the panel has been attached, because we need to know the
+     * content width in order to constrain the panel within the viewport.
+     * @private
      * @return {?}
      */
     MatSelect.prototype._calculateOverlayOffsetX = /**
@@ -1467,6 +1568,7 @@ var MatSelect = /** @class */ (function (_super) {
      * the panel opens. Will change based on LTR or RTL text direction. Note that the offset
      * can't be calculated until the panel has been attached, because we need to know the
      * content width in order to constrain the panel within the viewport.
+     * @private
      * @return {?}
      */
     function () {
@@ -1494,6 +1596,7 @@ var MatSelect = /** @class */ (function (_super) {
         if (!isRtl) {
             offsetX *= -1;
         }
+        // Determine how much the select overflows on each side.
         /** @type {?} */
         var leftOverflow = 0 - (overlayRect.left + offsetX - (isRtl ? paddingWidth : 0));
         /** @type {?} */
@@ -1516,6 +1619,12 @@ var MatSelect = /** @class */ (function (_super) {
      * Calculates the y-offset of the select's overlay panel in relation to the
      * top start corner of the trigger. It has to be adjusted in order for the
      * selected option to be aligned over the trigger when the panel opens.
+     */
+    /**
+     * Calculates the y-offset of the select's overlay panel in relation to the
+     * top start corner of the trigger. It has to be adjusted in order for the
+     * selected option to be aligned over the trigger when the panel opens.
+     * @private
      * @param {?} selectedIndex
      * @param {?} scrollBuffer
      * @param {?} maxScroll
@@ -1525,6 +1634,7 @@ var MatSelect = /** @class */ (function (_super) {
      * Calculates the y-offset of the select's overlay panel in relation to the
      * top start corner of the trigger. It has to be adjusted in order for the
      * selected option to be aligned over the trigger when the panel opens.
+     * @private
      * @param {?} selectedIndex
      * @param {?} scrollBuffer
      * @param {?} maxScroll
@@ -1551,6 +1661,8 @@ var MatSelect = /** @class */ (function (_super) {
             var firstDisplayedIndex = this._getItemCount() - maxOptionsDisplayed;
             /** @type {?} */
             var selectedDisplayIndex = selectedIndex - firstDisplayedIndex;
+            // The first item is partially out of the viewport. Therefore we need to calculate what
+            // portion of it is shown in the viewport and account for it in our offset.
             /** @type {?} */
             var partialItemHeight = itemHeight - (this._getItemCount() * itemHeight - SELECT_PANEL_MAX_HEIGHT) % itemHeight;
             // Because the panel height is longer than the height of the options alone,
@@ -1575,6 +1687,13 @@ var MatSelect = /** @class */ (function (_super) {
      * If it will not fit, tries to adjust the scroll position and the associated
      * y-offset so the panel can open fully on-screen. If it still won't fit,
      * sets the offset back to 0 to allow the fallback position to take over.
+     */
+    /**
+     * Checks that the attempted overlay position will fit within the viewport.
+     * If it will not fit, tries to adjust the scroll position and the associated
+     * y-offset so the panel can open fully on-screen. If it still won't fit,
+     * sets the offset back to 0 to allow the fallback position to take over.
+     * @private
      * @param {?} maxScroll
      * @return {?}
      */
@@ -1583,6 +1702,7 @@ var MatSelect = /** @class */ (function (_super) {
      * If it will not fit, tries to adjust the scroll position and the associated
      * y-offset so the panel can open fully on-screen. If it still won't fit,
      * sets the offset back to 0 to allow the fallback position to take over.
+     * @private
      * @param {?} maxScroll
      * @return {?}
      */
@@ -1611,19 +1731,23 @@ var MatSelect = /** @class */ (function (_super) {
             this._transformOrigin = this._getOriginBasedOnOption();
         }
     };
+    /** Adjusts the overlay panel up to fit in the viewport. */
     /**
      * Adjusts the overlay panel up to fit in the viewport.
+     * @private
      * @param {?} panelHeightBottom
      * @param {?} bottomSpaceAvailable
      * @return {?}
      */
     MatSelect.prototype._adjustPanelUp = /**
      * Adjusts the overlay panel up to fit in the viewport.
+     * @private
      * @param {?} panelHeightBottom
      * @param {?} bottomSpaceAvailable
      * @return {?}
      */
     function (panelHeightBottom, bottomSpaceAvailable) {
+        // Browsers ignore fractional scroll offsets, so we need to round.
         /** @type {?} */
         var distanceBelowViewport = Math.round(panelHeightBottom - bottomSpaceAvailable);
         // Scrolls the panel up by the distance it was extending past the boundary, then
@@ -1640,8 +1764,10 @@ var MatSelect = /** @class */ (function (_super) {
             this._transformOrigin = "50% bottom 0px";
         }
     };
+    /** Adjusts the overlay panel down to fit in the viewport. */
     /**
      * Adjusts the overlay panel down to fit in the viewport.
+     * @private
      * @param {?} panelHeightTop
      * @param {?} topSpaceAvailable
      * @param {?} maxScroll
@@ -1649,12 +1775,14 @@ var MatSelect = /** @class */ (function (_super) {
      */
     MatSelect.prototype._adjustPanelDown = /**
      * Adjusts the overlay panel down to fit in the viewport.
+     * @private
      * @param {?} panelHeightTop
      * @param {?} topSpaceAvailable
      * @param {?} maxScroll
      * @return {?}
      */
     function (panelHeightTop, topSpaceAvailable, maxScroll) {
+        // Browsers ignore fractional scroll offsets, so we need to round.
         /** @type {?} */
         var distanceAboveViewport = Math.round(panelHeightTop - topSpaceAvailable);
         // Scrolls the panel down by the distance it was extending past the boundary, then
@@ -1672,12 +1800,15 @@ var MatSelect = /** @class */ (function (_super) {
             return;
         }
     };
+    /** Sets the transform origin point based on the selected option. */
     /**
      * Sets the transform origin point based on the selected option.
+     * @private
      * @return {?}
      */
     MatSelect.prototype._getOriginBasedOnOption = /**
      * Sets the transform origin point based on the selected option.
+     * @private
      * @return {?}
      */
     function () {
@@ -1689,23 +1820,29 @@ var MatSelect = /** @class */ (function (_super) {
         var originY = Math.abs(this._offsetY) - optionHeightAdjustment + itemHeight / 2;
         return "50% " + originY + "px 0px";
     };
+    /** Calculates the amount of items in the select. This includes options and group labels. */
     /**
      * Calculates the amount of items in the select. This includes options and group labels.
+     * @private
      * @return {?}
      */
     MatSelect.prototype._getItemCount = /**
      * Calculates the amount of items in the select. This includes options and group labels.
+     * @private
      * @return {?}
      */
     function () {
         return this.options.length + this.optionGroups.length;
     };
+    /** Calculates the height of the select's options. */
     /**
      * Calculates the height of the select's options.
+     * @private
      * @return {?}
      */
     MatSelect.prototype._getItemHeight = /**
      * Calculates the height of the select's options.
+     * @private
      * @return {?}
      */
     function () {
@@ -1768,7 +1905,7 @@ var MatSelect = /** @class */ (function (_super) {
         { type: Component, args: [{selector: 'mat-select',
                     exportAs: 'matSelect',
                     template: "<div cdk-overlay-origin class=\"mat-select-trigger\" aria-hidden=\"true\" (click)=\"toggle()\" #origin=\"cdkOverlayOrigin\" #trigger><div class=\"mat-select-value\" [ngSwitch]=\"empty\"><span class=\"mat-select-placeholder\" *ngSwitchCase=\"true\">{{placeholder || '\u00A0'}}</span> <span class=\"mat-select-value-text\" *ngSwitchCase=\"false\" [ngSwitch]=\"!!customTrigger\"><span *ngSwitchDefault>{{triggerValue || '\u00A0'}}</span><ng-content select=\"mat-select-trigger\" *ngSwitchCase=\"true\"></ng-content></span></div><div class=\"mat-select-arrow-wrapper\"><div class=\"mat-select-arrow\"></div></div></div><ng-template cdk-connected-overlay cdkConnectedOverlayLockPosition cdkConnectedOverlayHasBackdrop cdkConnectedOverlayBackdropClass=\"cdk-overlay-transparent-backdrop\" [cdkConnectedOverlayScrollStrategy]=\"_scrollStrategy\" [cdkConnectedOverlayOrigin]=\"origin\" [cdkConnectedOverlayOpen]=\"panelOpen\" [cdkConnectedOverlayPositions]=\"_positions\" [cdkConnectedOverlayMinWidth]=\"_triggerRect?.width\" [cdkConnectedOverlayOffsetY]=\"_offsetY\" (backdropClick)=\"close()\" (attach)=\"_onAttached()\" (detach)=\"close()\"><div #panel class=\"mat-select-panel {{ _getPanelTheme() }}\" [ngClass]=\"panelClass\" [@transformPanel]=\"multiple ? 'showing-multiple' : 'showing'\" (@transformPanel.done)=\"_panelDoneAnimatingStream.next($event.toState)\" [style.transformOrigin]=\"_transformOrigin\" [style.font-size.px]=\"_triggerFontSize\" (keydown)=\"_handleKeydown($event)\"><ng-content></ng-content></div></ng-template>",
-                    styles: [".mat-select{display:inline-block;width:100%;outline:0}.mat-select-trigger{display:inline-table;cursor:pointer;position:relative;box-sizing:border-box}.mat-select-disabled .mat-select-trigger{-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;cursor:default}.mat-select-value{display:table-cell;max-width:0;width:100%;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.mat-select-value-text{white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.mat-select-arrow-wrapper{display:table-cell;vertical-align:middle}.mat-form-field-appearance-fill .mat-select-arrow-wrapper{transform:translateY(-50%)}.mat-form-field-appearance-outline .mat-select-arrow-wrapper{transform:translateY(-25%)}.mat-form-field-appearance-standard .mat-select:not(.mat-select-empty) .mat-select-arrow-wrapper{transform:translateY(-50%)}.mat-form-field-appearance-standard .mat-select.mat-select-empty .mat-select-arrow-wrapper{transition:transform .4s cubic-bezier(.25,.8,.25,1)}._mat-animation-noopable.mat-form-field-appearance-standard .mat-select.mat-select-empty .mat-select-arrow-wrapper{transition:none}.mat-select-arrow{width:0;height:0;border-left:5px solid transparent;border-right:5px solid transparent;border-top:5px solid;margin:0 4px}.mat-select-panel{min-width:112px;max-width:280px;overflow:auto;-webkit-overflow-scrolling:touch;padding-top:0;padding-bottom:0;max-height:256px;min-width:100%;border-radius:4px}@media screen and (-ms-high-contrast:active){.mat-select-panel{outline:solid 1px}}.mat-select-panel .mat-optgroup-label,.mat-select-panel .mat-option{font-size:inherit;line-height:3em;height:3em}.mat-form-field-type-mat-select:not(.mat-form-field-disabled) .mat-form-field-flex{cursor:pointer}.mat-form-field-type-mat-select .mat-form-field-label{width:calc(100% - 18px)}.mat-select-placeholder{transition:color .4s .133s cubic-bezier(.25,.8,.25,1)}._mat-animation-noopable .mat-select-placeholder{transition:none}.mat-form-field-hide-placeholder .mat-select-placeholder{color:transparent;-webkit-text-fill-color:transparent;transition:none;display:block}"],
+                    styles: [".mat-select{display:inline-block;width:100%;outline:0}.mat-select-trigger{display:inline-table;cursor:pointer;position:relative;box-sizing:border-box}.mat-select-disabled .mat-select-trigger{-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;cursor:default}.mat-select-value{display:table-cell;max-width:0;width:100%;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.mat-select-value-text{white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.mat-select-arrow-wrapper{display:table-cell;vertical-align:middle}.mat-form-field-appearance-fill .mat-select-arrow-wrapper{transform:translateY(-50%)}.mat-form-field-appearance-outline .mat-select-arrow-wrapper{transform:translateY(-25%)}.mat-form-field-appearance-standard.mat-form-field-has-label .mat-select:not(.mat-select-empty) .mat-select-arrow-wrapper{transform:translateY(-50%)}.mat-form-field-appearance-standard .mat-select.mat-select-empty .mat-select-arrow-wrapper{transition:transform .4s cubic-bezier(.25,.8,.25,1)}._mat-animation-noopable.mat-form-field-appearance-standard .mat-select.mat-select-empty .mat-select-arrow-wrapper{transition:none}.mat-select-arrow{width:0;height:0;border-left:5px solid transparent;border-right:5px solid transparent;border-top:5px solid;margin:0 4px}.mat-select-panel{min-width:112px;max-width:280px;overflow:auto;-webkit-overflow-scrolling:touch;padding-top:0;padding-bottom:0;max-height:256px;min-width:100%;border-radius:4px}@media (-ms-high-contrast:active){.mat-select-panel{outline:solid 1px}}.mat-select-panel .mat-optgroup-label,.mat-select-panel .mat-option{font-size:inherit;line-height:3em;height:3em}.mat-form-field-type-mat-select:not(.mat-form-field-disabled) .mat-form-field-flex{cursor:pointer}.mat-form-field-type-mat-select .mat-form-field-label{width:calc(100% - 18px)}.mat-select-placeholder{transition:color .4s .133s cubic-bezier(.25,.8,.25,1)}._mat-animation-noopable .mat-select-placeholder{transition:none}.mat-form-field-hide-placeholder .mat-select-placeholder{color:transparent;-webkit-text-fill-color:transparent;transition:none;display:block}"],
                     inputs: ['disabled', 'disableRipple', 'tabIndex'],
                     encapsulation: ViewEncapsulation.None,
                     changeDetection: ChangeDetectionStrategy.OnPush,
@@ -1816,7 +1953,8 @@ var MatSelect = /** @class */ (function (_super) {
         { type: MatFormField, decorators: [{ type: Optional }] },
         { type: NgControl, decorators: [{ type: Self }, { type: Optional }] },
         { type: String, decorators: [{ type: Attribute, args: ['tabindex',] }] },
-        { type: undefined, decorators: [{ type: Inject, args: [MAT_SELECT_SCROLL_STRATEGY,] }] }
+        { type: undefined, decorators: [{ type: Inject, args: [MAT_SELECT_SCROLL_STRATEGY,] }] },
+        { type: LiveAnnouncer }
     ]; };
     MatSelect.propDecorators = {
         trigger: [{ type: ViewChild, args: ['trigger',] }],
@@ -1848,7 +1986,7 @@ var MatSelect = /** @class */ (function (_super) {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 var MatSelectModule = /** @class */ (function () {
     function MatSelectModule() {
@@ -1871,12 +2009,12 @@ var MatSelectModule = /** @class */ (function () {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 
 export { MatSelectModule, MAT_SELECT_SCROLL_STRATEGY_PROVIDER_FACTORY, SELECT_PANEL_MAX_HEIGHT, SELECT_PANEL_PADDING_X, SELECT_PANEL_INDENT_PADDING_X, SELECT_ITEM_HEIGHT_EM, SELECT_MULTIPLE_PANEL_PADDING_X, SELECT_PANEL_VIEWPORT_PADDING, MAT_SELECT_SCROLL_STRATEGY, MAT_SELECT_SCROLL_STRATEGY_PROVIDER, MatSelectChange, MatSelectBase, _MatSelectMixinBase, MatSelectTrigger, MatSelect, matSelectAnimations, transformPanel, fadeInContent };