@angular/material 7.0.4 → 7.2.1

package/bundles/material-autocomplete.umd.js

@@ -42,12 +42,13 @@ function __extends(d, b) {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
-/** *
+/**
  * Autocomplete IDs need to be unique across components, so this counter exists outside of
  * the component definition.
-  @type {?} */
+ * @type {?}
+ */
 var _uniqueAutocompleteIdCounter = 0;
 /**
  * Event object that is emitted when an autocomplete option is selected.
@@ -62,10 +63,13 @@ MatAutocompleteSelectedEvent = /** @class */ (function () {
     }
     return MatAutocompleteSelectedEvent;
 }());
+// Boilerplate for applying mixins to MatAutocomplete.
 /**
  * \@docs-private
  */
-var   /**
+var   
+// Boilerplate for applying mixins to MatAutocomplete.
+/**
  * \@docs-private
  */
 MatAutocompleteBase = /** @class */ (function () {
@@ -75,9 +79,10 @@ MatAutocompleteBase = /** @class */ (function () {
 }());
 /** @type {?} */
 var _MatAutocompleteMixinBase = core$1.mixinDisableRipple(MatAutocompleteBase);
-/** *
+/**
  * Injection token to be used to override the default options for `mat-autocomplete`.
-  @type {?} */
+ * @type {?}
+ */
 var MAT_AUTOCOMPLETE_DEFAULT_OPTIONS = new core.InjectionToken('mat-autocomplete-default-options', {
     providedIn: 'root',
     factory: MAT_AUTOCOMPLETE_DEFAULT_OPTIONS_FACTORY,
@@ -254,7 +259,7 @@ var MatAutocomplete = /** @class */ (function (_super) {
     MatAutocomplete.decorators = [
         { type: core.Component, args: [{selector: 'mat-autocomplete',
                     template: "<ng-template><div class=\"mat-autocomplete-panel\" role=\"listbox\" [id]=\"id\" [ngClass]=\"_classList\" #panel><ng-content></ng-content></div></ng-template>",
-                    styles: [".mat-autocomplete-panel{min-width:112px;max-width:280px;overflow:auto;-webkit-overflow-scrolling:touch;visibility:hidden;max-width:none;max-height:256px;position:relative;width:100%;border-bottom-left-radius:4px;border-bottom-right-radius:4px}.mat-autocomplete-panel.mat-autocomplete-visible{visibility:visible}.mat-autocomplete-panel.mat-autocomplete-hidden{visibility:hidden}.mat-autocomplete-panel-above .mat-autocomplete-panel{border-radius:0;border-top-left-radius:4px;border-top-right-radius:4px}.mat-autocomplete-panel .mat-divider-horizontal{margin-top:-1px}@media screen and (-ms-high-contrast:active){.mat-autocomplete-panel{outline:solid 1px}}"],
+                    styles: [".mat-autocomplete-panel{min-width:112px;max-width:280px;overflow:auto;-webkit-overflow-scrolling:touch;visibility:hidden;max-width:none;max-height:256px;position:relative;width:100%;border-bottom-left-radius:4px;border-bottom-right-radius:4px}.mat-autocomplete-panel.mat-autocomplete-visible{visibility:visible}.mat-autocomplete-panel.mat-autocomplete-hidden{visibility:hidden}.mat-autocomplete-panel-above .mat-autocomplete-panel{border-radius:0;border-top-left-radius:4px;border-top-right-radius:4px}.mat-autocomplete-panel .mat-divider-horizontal{margin-top:-1px}@media (-ms-high-contrast:active){.mat-autocomplete-panel{outline:solid 1px}}"],
                     encapsulation: core.ViewEncapsulation.None,
                     changeDetection: core.ChangeDetectionStrategy.OnPush,
                     exportAs: 'matAutocomplete',
@@ -291,7 +296,7 @@ var MatAutocomplete = /** @class */ (function (_super) {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  * Directive applied to an element to make it usable
@@ -316,19 +321,22 @@ var MatAutocompleteOrigin = /** @class */ (function () {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
-/** *
+/**
  * The height of each autocomplete option.
-  @type {?} */
+ * @type {?}
+ */
 var AUTOCOMPLETE_OPTION_HEIGHT = 48;
-/** *
+/**
  * The total height of the autocomplete panel.
-  @type {?} */
+ * @type {?}
+ */
 var AUTOCOMPLETE_PANEL_HEIGHT = 256;
-/** *
+/**
  * Injection token that determines the scroll handling while the autocomplete panel is open.
-  @type {?} */
+ * @type {?}
+ */
 var MAT_AUTOCOMPLETE_SCROLL_STRATEGY = new core.InjectionToken('mat-autocomplete-scroll-strategy');
 /**
  * \@docs-private
@@ -338,18 +346,20 @@ var MAT_AUTOCOMPLETE_SCROLL_STRATEGY = new core.InjectionToken('mat-autocomplete
 function MAT_AUTOCOMPLETE_SCROLL_STRATEGY_FACTORY(overlay$$1) {
     return function () { return overlay$$1.scrollStrategies.reposition(); };
 }
-/** *
+/**
  * \@docs-private
-  @type {?} */
+ * @type {?}
+ */
 var MAT_AUTOCOMPLETE_SCROLL_STRATEGY_FACTORY_PROVIDER = {
     provide: MAT_AUTOCOMPLETE_SCROLL_STRATEGY,
     deps: [overlay.Overlay],
     useFactory: MAT_AUTOCOMPLETE_SCROLL_STRATEGY_FACTORY,
 };
-/** *
+/**
  * Provider that allows the autocomplete to register as a ControlValueAccessor.
  * \@docs-private
-  @type {?} */
+ * @type {?}
+ */
 var MAT_AUTOCOMPLETE_VALUE_ACCESSOR = {
     provide: forms.NG_VALUE_ACCESSOR,
     useExisting: core.forwardRef(function () { return MatAutocompleteTrigger; }),
@@ -552,7 +562,7 @@ var MatAutocompleteTrigger = /** @class */ (function () {
      */
     function () {
         if (this._overlayAttached) {
-            /** @type {?} */ ((this._overlayRef)).updatePosition();
+            (/** @type {?} */ (this._overlayRef)).updatePosition();
         }
     };
     Object.defineProperty(MatAutocompleteTrigger.prototype, "panelClosingActions", {
@@ -591,12 +601,15 @@ var MatAutocompleteTrigger = /** @class */ (function () {
         enumerable: true,
         configurable: true
     });
+    /** Stream of clicks outside of the autocomplete panel. */
     /**
      * Stream of clicks outside of the autocomplete panel.
+     * @private
      * @return {?}
      */
     MatAutocompleteTrigger.prototype._getOutsideClickStream = /**
      * Stream of clicks outside of the autocomplete panel.
+     * @private
      * @return {?}
      */
     function () {
@@ -607,7 +620,7 @@ var MatAutocompleteTrigger = /** @class */ (function () {
         return rxjs.merge(rxjs.fromEvent(this._document, 'click'), rxjs.fromEvent(this._document, 'touchend'))
             .pipe(operators.filter(function (event) {
             /** @type {?} */
-            var clickTarget = /** @type {?} */ (event.target);
+            var clickTarget = (/** @type {?} */ (event.target));
             /** @type {?} */
             var formField$$1 = _this._formField ?
                 _this._formField._elementRef.nativeElement : null;
@@ -618,11 +631,14 @@ var MatAutocompleteTrigger = /** @class */ (function () {
         }));
     };
     // Implemented as part of ControlValueAccessor.
+    // Implemented as part of ControlValueAccessor.
     /**
      * @param {?} value
      * @return {?}
      */
-    MatAutocompleteTrigger.prototype.writeValue = /**
+    MatAutocompleteTrigger.prototype.writeValue = 
+    // Implemented as part of ControlValueAccessor.
+    /**
      * @param {?} value
      * @return {?}
      */
@@ -631,11 +647,14 @@ var MatAutocompleteTrigger = /** @class */ (function () {
         Promise.resolve(null).then(function () { return _this._setTriggerValue(value); });
     };
     // Implemented as part of ControlValueAccessor.
+    // Implemented as part of ControlValueAccessor.
     /**
      * @param {?} fn
      * @return {?}
      */
-    MatAutocompleteTrigger.prototype.registerOnChange = /**
+    MatAutocompleteTrigger.prototype.registerOnChange = 
+    // Implemented as part of ControlValueAccessor.
+    /**
      * @param {?} fn
      * @return {?}
      */
@@ -643,11 +662,14 @@ var MatAutocompleteTrigger = /** @class */ (function () {
         this._onChange = fn;
     };
     // Implemented as part of ControlValueAccessor.
+    // Implemented as part of ControlValueAccessor.
     /**
      * @param {?} fn
      * @return {?}
      */
-    MatAutocompleteTrigger.prototype.registerOnTouched = /**
+    MatAutocompleteTrigger.prototype.registerOnTouched = 
+    // Implemented as part of ControlValueAccessor.
+    /**
      * @param {?} fn
      * @return {?}
      */
@@ -655,11 +677,14 @@ var MatAutocompleteTrigger = /** @class */ (function () {
         this._onTouched = fn;
     };
     // Implemented as part of ControlValueAccessor.
+    // Implemented as part of ControlValueAccessor.
     /**
      * @param {?} isDisabled
      * @return {?}
      */
-    MatAutocompleteTrigger.prototype.setDisabledState = /**
+    MatAutocompleteTrigger.prototype.setDisabledState = 
+    // Implemented as part of ControlValueAccessor.
+    /**
      * @param {?} isDisabled
      * @return {?}
      */
@@ -715,7 +740,7 @@ var MatAutocompleteTrigger = /** @class */ (function () {
      */
     function (event) {
         /** @type {?} */
-        var target = /** @type {?} */ (event.target);
+        var target = (/** @type {?} */ (event.target));
         /** @type {?} */
         var value = target.value;
         // Based on `NumberValueAccessor` from forms.
@@ -727,10 +752,10 @@ var MatAutocompleteTrigger = /** @class */ (function () {
         // filter out all of the extra events, we save the value on focus and between
         // `input` events, and we check whether it changed.
         // See: https://connect.microsoft.com/IE/feedback/details/885747/
-        if (this._previousValue !== value && document.activeElement === event.target) {
+        if (this._previousValue !== value) {
             this._previousValue = value;
             this._onChange(value);
-            if (this._canOpen()) {
+            if (this._canOpen() && document.activeElement === event.target) {
                 this.openPanel();
             }
         }
@@ -755,6 +780,13 @@ var MatAutocompleteTrigger = /** @class */ (function () {
      * In "auto" mode, the label will animate down as soon as focus is lost.
      * This causes the value to jump when selecting an option with the mouse.
      * This method manually floats the label until the panel can be closed.
+     * @param shouldAnimate Whether the label should be animated when it is floated.
+     */
+    /**
+     * In "auto" mode, the label will animate down as soon as focus is lost.
+     * This causes the value to jump when selecting an option with the mouse.
+     * This method manually floats the label until the panel can be closed.
+     * @private
      * @param {?=} shouldAnimate Whether the label should be animated when it is floated.
      * @return {?}
      */
@@ -762,6 +794,7 @@ var MatAutocompleteTrigger = /** @class */ (function () {
      * In "auto" mode, the label will animate down as soon as focus is lost.
      * This causes the value to jump when selecting an option with the mouse.
      * This method manually floats the label until the panel can be closed.
+     * @private
      * @param {?=} shouldAnimate Whether the label should be animated when it is floated.
      * @return {?}
      */
@@ -777,12 +810,15 @@ var MatAutocompleteTrigger = /** @class */ (function () {
             this._manuallyFloatingLabel = true;
         }
     };
+    /** If the label has been manually elevated, return it to its normal state. */
     /**
      * If the label has been manually elevated, return it to its normal state.
+     * @private
      * @return {?}
      */
     MatAutocompleteTrigger.prototype._resetLabel = /**
      * If the label has been manually elevated, return it to its normal state.
+     * @private
      * @return {?}
      */
     function () {
@@ -799,6 +835,16 @@ var MatAutocompleteTrigger = /** @class */ (function () {
      * bottom of the panel. If that offset is above the top of the visible panel, the new scrollTop
      * will become the offset. If that offset is visible within the panel already, the scrollTop is
      * not adjusted.
+     */
+    /**
+     * Given that we are not actually focusing active options, we must manually adjust scroll
+     * to reveal options below the fold. First, we find the offset of the option from the top
+     * of the panel. If that offset is below the fold, the new scrollTop will be the offset -
+     * the panel height + the option height, so the active option will be just visible at the
+     * bottom of the panel. If that offset is above the top of the visible panel, the new scrollTop
+     * will become the offset. If that offset is visible within the panel already, the scrollTop is
+     * not adjusted.
+     * @private
      * @return {?}
      */
     MatAutocompleteTrigger.prototype._scrollToOption = /**
@@ -809,6 +855,7 @@ var MatAutocompleteTrigger = /** @class */ (function () {
      * bottom of the panel. If that offset is above the top of the visible panel, the new scrollTop
      * will become the offset. If that offset is visible within the panel already, the scrollTop is
      * not adjusted.
+     * @private
      * @return {?}
      */
     function () {
@@ -823,11 +870,17 @@ var MatAutocompleteTrigger = /** @class */ (function () {
     /**
      * This method listens to a stream of panel closing actions and resets the
      * stream every time the option list changes.
+     */
+    /**
+     * This method listens to a stream of panel closing actions and resets the
+     * stream every time the option list changes.
+     * @private
      * @return {?}
      */
     MatAutocompleteTrigger.prototype._subscribeToClosingActions = /**
      * This method listens to a stream of panel closing actions and resets the
      * stream every time the option list changes.
+     * @private
      * @return {?}
      */
     function () {
@@ -848,7 +901,7 @@ var MatAutocompleteTrigger = /** @class */ (function () {
             _this._resetActiveItem();
             _this.autocomplete._setVisibility();
             if (_this.panelOpen) {
-                /** @type {?} */ ((_this._overlayRef)).updatePosition();
+                (/** @type {?} */ (_this._overlayRef)).updatePosition();
             }
             return _this.panelClosingActions;
         }), 
@@ -857,12 +910,15 @@ var MatAutocompleteTrigger = /** @class */ (function () {
             // set the value, close the panel, and complete.
             .subscribe(function (event) { return _this._setValueAndClose(event); });
     };
+    /** Destroys the autocomplete suggestion panel. */
     /**
      * Destroys the autocomplete suggestion panel.
+     * @private
      * @return {?}
      */
     MatAutocompleteTrigger.prototype._destroyPanel = /**
      * Destroys the autocomplete suggestion panel.
+     * @private
      * @return {?}
      */
     function () {
@@ -873,10 +929,12 @@ var MatAutocompleteTrigger = /** @class */ (function () {
         }
     };
     /**
+     * @private
      * @param {?} value
      * @return {?}
      */
     MatAutocompleteTrigger.prototype._setTriggerValue = /**
+     * @private
      * @param {?} value
      * @return {?}
      */
@@ -885,6 +943,8 @@ var MatAutocompleteTrigger = /** @class */ (function () {
         var toDisplay = this.autocomplete && this.autocomplete.displayWith ?
             this.autocomplete.displayWith(value) :
             value;
+        // Simply falling back to an empty string if the display value is falsy does not work properly.
+        // The display value can also be the number zero and shouldn't fall back to an empty string.
         /** @type {?} */
         var inputValue = toDisplay != null ? toDisplay : '';
         // If it's used within a `MatFormField`, we should set it through the property so it can go
@@ -901,6 +961,12 @@ var MatAutocompleteTrigger = /** @class */ (function () {
      * This method closes the panel, and if a value is specified, also sets the associated
      * control to that value. It will also mark the control as dirty if this interaction
      * stemmed from the user.
+     */
+    /**
+     * This method closes the panel, and if a value is specified, also sets the associated
+     * control to that value. It will also mark the control as dirty if this interaction
+     * stemmed from the user.
+     * @private
      * @param {?} event
      * @return {?}
      */
@@ -908,6 +974,7 @@ var MatAutocompleteTrigger = /** @class */ (function () {
      * This method closes the panel, and if a value is specified, also sets the associated
      * control to that value. It will also mark the control as dirty if this interaction
      * stemmed from the user.
+     * @private
      * @param {?} event
      * @return {?}
      */
@@ -923,11 +990,16 @@ var MatAutocompleteTrigger = /** @class */ (function () {
     };
     /**
      * Clear any previous selected option and emit a selection change event for this option
+     */
+    /**
+     * Clear any previous selected option and emit a selection change event for this option
+     * @private
      * @param {?} skip
      * @return {?}
      */
     MatAutocompleteTrigger.prototype._clearPreviousSelectedOption = /**
      * Clear any previous selected option and emit a selection change event for this option
+     * @private
      * @param {?} skip
      * @return {?}
      */
@@ -939,9 +1011,11 @@ var MatAutocompleteTrigger = /** @class */ (function () {
         });
     };
     /**
+     * @private
      * @return {?}
      */
     MatAutocompleteTrigger.prototype._attachOverlay = /**
+     * @private
      * @return {?}
      */
     function () {
@@ -989,9 +1063,11 @@ var MatAutocompleteTrigger = /** @class */ (function () {
         }
     };
     /**
+     * @private
      * @return {?}
      */
     MatAutocompleteTrigger.prototype._getOverlayConfig = /**
+     * @private
      * @return {?}
      */
     function () {
@@ -1003,9 +1079,11 @@ var MatAutocompleteTrigger = /** @class */ (function () {
         });
     };
     /**
+     * @private
      * @return {?}
      */
     MatAutocompleteTrigger.prototype._getOverlayPosition = /**
+     * @private
      * @return {?}
      */
     function () {
@@ -1034,9 +1112,11 @@ var MatAutocompleteTrigger = /** @class */ (function () {
         return this._positionStrategy;
     };
     /**
+     * @private
      * @return {?}
      */
     MatAutocompleteTrigger.prototype._getConnectedElement = /**
+     * @private
      * @return {?}
      */
     function () {
@@ -1046,20 +1126,25 @@ var MatAutocompleteTrigger = /** @class */ (function () {
         return this._formField ? this._formField.getConnectedOverlayOrigin() : this._element;
     };
     /**
+     * @private
      * @return {?}
      */
     MatAutocompleteTrigger.prototype._getPanelWidth = /**
+     * @private
      * @return {?}
      */
     function () {
         return this.autocomplete.panelWidth || this._getHostWidth();
     };
+    /** Returns the width of the input element, so the panel width can match it. */
     /**
      * Returns the width of the input element, so the panel width can match it.
+     * @private
      * @return {?}
      */
     MatAutocompleteTrigger.prototype._getHostWidth = /**
      * Returns the width of the input element, so the panel width can match it.
+     * @private
      * @return {?}
      */
     function () {
@@ -1068,22 +1153,31 @@ var MatAutocompleteTrigger = /** @class */ (function () {
     /**
      * Resets the active item to -1 so arrow events will activate the
      * correct options, or to 0 if the consumer opted into it.
+     */
+    /**
+     * Resets the active item to -1 so arrow events will activate the
+     * correct options, or to 0 if the consumer opted into it.
+     * @private
      * @return {?}
      */
     MatAutocompleteTrigger.prototype._resetActiveItem = /**
      * Resets the active item to -1 so arrow events will activate the
      * correct options, or to 0 if the consumer opted into it.
+     * @private
      * @return {?}
      */
     function () {
         this.autocomplete._keyManager.setActiveItem(this.autocomplete.autoActiveFirstOption ? 0 : -1);
     };
+    /** Determines whether the panel can be opened. */
     /**
      * Determines whether the panel can be opened.
+     * @private
      * @return {?}
      */
     MatAutocompleteTrigger.prototype._canOpen = /**
      * Determines whether the panel can be opened.
+     * @private
      * @return {?}
      */
     function () {
@@ -1098,7 +1192,7 @@ var MatAutocompleteTrigger = /** @class */ (function () {
                         '[attr.autocomplete]': 'autocompleteAttribute',
                         '[attr.role]': 'autocompleteDisabled ? null : "combobox"',
                         '[attr.aria-autocomplete]': 'autocompleteDisabled ? null : "list"',
-                        '[attr.aria-activedescendant]': 'activeOption?.id',
+                        '[attr.aria-activedescendant]': '(panelOpen && activeOption) ? activeOption.id : null',
                         '[attr.aria-expanded]': 'autocompleteDisabled ? null : panelOpen.toString()',
                         '[attr.aria-owns]': '(autocompleteDisabled || !panelOpen) ? null : autocomplete?.id',
                         // Note: we use `focusin`, as opposed to `focus`, in order to open the panel
@@ -1136,7 +1230,7 @@ var MatAutocompleteTrigger = /** @class */ (function () {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 var MatAutocompleteModule = /** @class */ (function () {
     function MatAutocompleteModule() {
@@ -1173,7 +1267,7 @@ exports.MAT_AUTOCOMPLETE_SCROLL_STRATEGY = MAT_AUTOCOMPLETE_SCROLL_STRATEGY;
 exports.MAT_AUTOCOMPLETE_SCROLL_STRATEGY_FACTORY_PROVIDER = MAT_AUTOCOMPLETE_SCROLL_STRATEGY_FACTORY_PROVIDER;
 exports.MAT_AUTOCOMPLETE_VALUE_ACCESSOR = MAT_AUTOCOMPLETE_VALUE_ACCESSOR;
 exports.MatAutocompleteTrigger = MatAutocompleteTrigger;
-exports.ɵa30 = MatAutocompleteOrigin;
+exports.ɵa28 = MatAutocompleteOrigin;
 
 Object.defineProperty(exports, '__esModule', { value: true });