@angular/material 7.0.3 → 7.2.0

package/esm5/dialog.es5.js

@@ -5,7 +5,7 @@
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.io/license
  */
-import { animate, state, style, transition, trigger, query, animateChild, group } from '@angular/animations';
+import { animate, state, style, transition, trigger } from '@angular/animations';
 import { __assign, __extends } from 'tslib';
 import { Component, ElementRef, EventEmitter, Inject, Optional, ChangeDetectorRef, ViewChild, ViewEncapsulation, ChangeDetectionStrategy, Injectable, InjectionToken, Injector, SkipSelf, TemplateRef, Directive, Input, NgModule } from '@angular/core';
 import { DOCUMENT, Location, CommonModule } from '@angular/common';
@@ -20,7 +20,7 @@ import { MatCommonModule } from '@angular/material/core';
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  * Configuration for opening a modal dialog with the MatDialog service.
@@ -91,13 +91,14 @@ MatDialogConfig = /** @class */ (function () {
          * the `HashLocationStrategy`).
          */
         this.closeOnNavigation = true;
+        // TODO(jelbourn): add configuration for lifecycle hooks, ARIA labelling.
     }
     return MatDialogConfig;
 }());
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /** @type {?} */
 var animationBody = [
@@ -106,27 +107,28 @@ var animationBody = [
     // decimate the animation performance. Leaving it as `none` solves both issues.
     state('void, exit', style({ opacity: 0, transform: 'scale(0.7)' })),
     state('enter', style({ transform: 'none' })),
-    transition('* => enter', group([
-        // `animateChild` allows for child component to animate at the same time. See #13870.
-        query('@*', animateChild(), { optional: true }),
-        animate('150ms cubic-bezier(0, 0, 0.2, 1)', style({ transform: 'none', opacity: 1 })),
-    ])),
+    transition('* => enter', animate('150ms cubic-bezier(0, 0, 0.2, 1)', style({ transform: 'none', opacity: 1 }))),
     transition('* => void, * => exit', animate('75ms cubic-bezier(0.4, 0.0, 0.2, 1)', style({ opacity: 0 }))),
 ];
-/** *
+/**
  * Animations used by MatDialog.
  * \@docs-private
-  @type {?} */
+ * @type {?}
+ */
 var matDialogAnimations = {
-    /** Animation that is applied on the dialog container by defalt. */
+    /**
+     * Animation that is applied on the dialog container by defalt.
+     */
     dialogContainer: trigger('dialogContainer', animationBody),
-    /** @deprecated @breaking-change 8.0.0 Use `matDialogAnimations.dialogContainer` instead. */
+    /**
+     * @deprecated \@breaking-change 8.0.0 Use `matDialogAnimations.dialogContainer` instead.
+     */
     slideDialog: trigger('slideDialog', animationBody)
 };
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  * Throws an exception for the case when a ComponentPortal is
@@ -215,12 +217,15 @@ var MatDialogContainer = /** @class */ (function (_super) {
         this._savePreviouslyFocusedElement();
         return this._portalOutlet.attachTemplatePortal(portal);
     };
+    /** Moves the focus inside the focus trap. */
     /**
      * Moves the focus inside the focus trap.
+     * @private
      * @return {?}
      */
     MatDialogContainer.prototype._trapFocus = /**
      * Moves the focus inside the focus trap.
+     * @private
      * @return {?}
      */
     function () {
@@ -234,12 +239,15 @@ var MatDialogContainer = /** @class */ (function (_super) {
             this._focusTrap.focusInitialElementWhenReady();
         }
     };
+    /** Restores focus to the element that was focused before the dialog opened. */
     /**
      * Restores focus to the element that was focused before the dialog opened.
+     * @private
      * @return {?}
      */
     MatDialogContainer.prototype._restoreFocus = /**
      * Restores focus to the element that was focused before the dialog opened.
+     * @private
      * @return {?}
      */
     function () {
@@ -253,18 +261,21 @@ var MatDialogContainer = /** @class */ (function (_super) {
             this._focusTrap.destroy();
         }
     };
+    /** Saves a reference to the element that was focused before the dialog was opened. */
     /**
      * Saves a reference to the element that was focused before the dialog was opened.
+     * @private
      * @return {?}
      */
     MatDialogContainer.prototype._savePreviouslyFocusedElement = /**
      * Saves a reference to the element that was focused before the dialog was opened.
+     * @private
      * @return {?}
      */
     function () {
         var _this = this;
         if (this._document) {
-            this._elementFocusedBeforeDialogWasOpened = /** @type {?} */ (this._document.activeElement);
+            this._elementFocusedBeforeDialogWasOpened = (/** @type {?} */ (this._document.activeElement));
             // Note that there is no focus method when rendering on the server.
             if (this._elementRef.nativeElement.focus) {
                 // Move focus onto the dialog immediately in order to prevent the user from accidentally
@@ -363,8 +374,10 @@ var MatDialogContainer = /** @class */ (function (_super) {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
+// TODO(jelbourn): resizing
+// Counter for unique dialog ids.
 /** @type {?} */
 var uniqueId = 0;
 /**
@@ -415,7 +428,7 @@ MatDialogRef = /** @class */ (function () {
             _this._beforeClosed.complete();
             _this._afterClosed.next(_this._result);
             _this._afterClosed.complete();
-            _this.componentInstance = /** @type {?} */ ((null));
+            _this.componentInstance = (/** @type {?} */ (null));
             _this._overlayRef.dispose();
         });
         _overlayRef.keydownEvents()
@@ -524,17 +537,21 @@ MatDialogRef = /** @class */ (function () {
      */
     /**
      * Updates the dialog's position.
+     * @template THIS
+     * @this {THIS}
      * @param {?=} position New dialog position.
-     * @return {?}
+     * @return {THIS}
      */
     MatDialogRef.prototype.updatePosition = /**
      * Updates the dialog's position.
+     * @template THIS
+     * @this {THIS}
      * @param {?=} position New dialog position.
-     * @return {?}
+     * @return {THIS}
      */
     function (position) {
         /** @type {?} */
-        var strategy = this._getPositionStrategy();
+        var strategy = (/** @type {?} */ (this))._getPositionStrategy();
         if (position && (position.left || position.right)) {
             position.left ? strategy.left(position.left) : strategy.right(position.right);
         }
@@ -547,8 +564,8 @@ MatDialogRef = /** @class */ (function () {
         else {
             strategy.centerVertically();
         }
-        this._overlayRef.updatePosition();
-        return this;
+        (/** @type {?} */ (this))._overlayRef.updatePosition();
+        return (/** @type {?} */ (this));
     };
     /**
      * Updates the dialog's width and height.
@@ -557,22 +574,26 @@ MatDialogRef = /** @class */ (function () {
      */
     /**
      * Updates the dialog's width and height.
+     * @template THIS
+     * @this {THIS}
      * @param {?=} width New width of the dialog.
      * @param {?=} height New height of the dialog.
-     * @return {?}
+     * @return {THIS}
      */
     MatDialogRef.prototype.updateSize = /**
      * Updates the dialog's width and height.
+     * @template THIS
+     * @this {THIS}
      * @param {?=} width New width of the dialog.
      * @param {?=} height New height of the dialog.
-     * @return {?}
+     * @return {THIS}
      */
     function (width, height) {
         if (width === void 0) { width = ''; }
         if (height === void 0) { height = ''; }
-        this._getPositionStrategy().width(width).height(height);
-        this._overlayRef.updatePosition();
-        return this;
+        (/** @type {?} */ (this))._getPositionStrategy().width(width).height(height);
+        (/** @type {?} */ (this))._overlayRef.updatePosition();
+        return (/** @type {?} */ (this));
     };
     /**
      * Gets an observable that is notified when the dialog is finished opening.
@@ -614,35 +635,41 @@ MatDialogRef = /** @class */ (function () {
     function () {
         return this.beforeClosed();
     };
+    /** Fetches the position strategy object from the overlay ref. */
     /**
      * Fetches the position strategy object from the overlay ref.
+     * @private
      * @return {?}
      */
     MatDialogRef.prototype._getPositionStrategy = /**
      * Fetches the position strategy object from the overlay ref.
+     * @private
      * @return {?}
      */
     function () {
-        return /** @type {?} */ (this._overlayRef.getConfig().positionStrategy);
+        return (/** @type {?} */ (this._overlayRef.getConfig().positionStrategy));
     };
     return MatDialogRef;
 }());
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
-/** *
+/**
  * Injection token that can be used to access the data that was passed in to a dialog.
-  @type {?} */
+ * @type {?}
+ */
 var MAT_DIALOG_DATA = new InjectionToken('MatDialogData');
-/** *
+/**
  * Injection token that can be used to specify default dialog options.
-  @type {?} */
+ * @type {?}
+ */
 var MAT_DIALOG_DEFAULT_OPTIONS = new InjectionToken('mat-dialog-default-options');
-/** *
+/**
  * Injection token that determines the scroll handling while the dialog is open.
-  @type {?} */
+ * @type {?}
+ */
 var MAT_DIALOG_SCROLL_STRATEGY = new InjectionToken('mat-dialog-scroll-strategy');
 /**
  * \@docs-private
@@ -660,9 +687,10 @@ function MAT_DIALOG_SCROLL_STRATEGY_FACTORY(overlay) {
 function MAT_DIALOG_SCROLL_STRATEGY_PROVIDER_FACTORY(overlay) {
     return function () { return overlay.scrollStrategies.block(); };
 }
-/** *
+/**
  * \@docs-private
-  @type {?} */
+ * @type {?}
+ */
 var MAT_DIALOG_SCROLL_STRATEGY_PROVIDER = {
     provide: MAT_DIALOG_SCROLL_STRATEGY,
     deps: [Overlay],
@@ -835,11 +863,18 @@ var MatDialog = /** @class */ (function () {
     };
     /**
      * Creates the overlay into which the dialog will be loaded.
+     * @param config The dialog configuration.
+     * @returns A promise resolving to the OverlayRef for the created overlay.
+     */
+    /**
+     * Creates the overlay into which the dialog will be loaded.
+     * @private
      * @param {?} config The dialog configuration.
      * @return {?} A promise resolving to the OverlayRef for the created overlay.
      */
     MatDialog.prototype._createOverlay = /**
      * Creates the overlay into which the dialog will be loaded.
+     * @private
      * @param {?} config The dialog configuration.
      * @return {?} A promise resolving to the OverlayRef for the created overlay.
      */
@@ -850,11 +885,18 @@ var MatDialog = /** @class */ (function () {
     };
     /**
      * Creates an overlay config from a dialog config.
+     * @param dialogConfig The dialog configuration.
+     * @returns The overlay configuration.
+     */
+    /**
+     * Creates an overlay config from a dialog config.
+     * @private
      * @param {?} dialogConfig The dialog configuration.
      * @return {?} The overlay configuration.
      */
     MatDialog.prototype._getOverlayConfig = /**
      * Creates an overlay config from a dialog config.
+     * @private
      * @param {?} dialogConfig The dialog configuration.
      * @return {?} The overlay configuration.
      */
@@ -879,12 +921,20 @@ var MatDialog = /** @class */ (function () {
     };
     /**
      * Attaches an MatDialogContainer to a dialog's already-created overlay.
+     * @param overlay Reference to the dialog's underlying overlay.
+     * @param config The dialog configuration.
+     * @returns A promise resolving to a ComponentRef for the attached container.
+     */
+    /**
+     * Attaches an MatDialogContainer to a dialog's already-created overlay.
+     * @private
      * @param {?} overlay Reference to the dialog's underlying overlay.
      * @param {?} config The dialog configuration.
      * @return {?} A promise resolving to a ComponentRef for the attached container.
      */
     MatDialog.prototype._attachDialogContainer = /**
      * Attaches an MatDialogContainer to a dialog's already-created overlay.
+     * @private
      * @param {?} overlay Reference to the dialog's underlying overlay.
      * @param {?} config The dialog configuration.
      * @return {?} A promise resolving to a ComponentRef for the attached container.
@@ -904,6 +954,16 @@ var MatDialog = /** @class */ (function () {
     };
     /**
      * Attaches the user-provided component to the already-created MatDialogContainer.
+     * @param componentOrTemplateRef The type of component being loaded into the dialog,
+     *     or a TemplateRef to instantiate as the content.
+     * @param dialogContainer Reference to the wrapping MatDialogContainer.
+     * @param overlayRef Reference to the overlay in which the dialog resides.
+     * @param config The dialog configuration.
+     * @returns A promise resolving to the MatDialogRef that should be returned to the user.
+     */
+    /**
+     * Attaches the user-provided component to the already-created MatDialogContainer.
+     * @private
      * @template T, R
      * @param {?} componentOrTemplateRef The type of component being loaded into the dialog,
      *     or a TemplateRef to instantiate as the content.
@@ -914,6 +974,7 @@ var MatDialog = /** @class */ (function () {
      */
     MatDialog.prototype._attachDialogContent = /**
      * Attaches the user-provided component to the already-created MatDialogContainer.
+     * @private
      * @template T, R
      * @param {?} componentOrTemplateRef The type of component being loaded into the dialog,
      *     or a TemplateRef to instantiate as the content.
@@ -923,6 +984,8 @@ var MatDialog = /** @class */ (function () {
      * @return {?} A promise resolving to the MatDialogRef that should be returned to the user.
      */
     function (componentOrTemplateRef, dialogContainer, overlayRef, config) {
+        // Create a reference to the dialog we're creating in order to give the user a handle
+        // to modify and close it.
         /** @type {?} */
         var dialogRef = new MatDialogRef(overlayRef, dialogContainer, this._location, config.id);
         // When the dialog backdrop is clicked, we want to close it.
@@ -934,7 +997,7 @@ var MatDialog = /** @class */ (function () {
             });
         }
         if (componentOrTemplateRef instanceof TemplateRef) {
-            dialogContainer.attachTemplatePortal(new TemplatePortal(componentOrTemplateRef, /** @type {?} */ ((null)), /** @type {?} */ ({ $implicit: config.data, dialogRef: dialogRef })));
+            dialogContainer.attachTemplatePortal(new TemplatePortal(componentOrTemplateRef, (/** @type {?} */ (null)), (/** @type {?} */ ({ $implicit: config.data, dialogRef: dialogRef }))));
         }
         else {
             /** @type {?} */
@@ -951,6 +1014,15 @@ var MatDialog = /** @class */ (function () {
     /**
      * Creates a custom injector to be used inside the dialog. This allows a component loaded inside
      * of a dialog to close itself and, optionally, to return a value.
+     * @param config Config object that is used to construct the dialog.
+     * @param dialogRef Reference to the dialog.
+     * @param container Dialog container element that wraps all of the contents.
+     * @returns The custom injector that can be used inside the dialog.
+     */
+    /**
+     * Creates a custom injector to be used inside the dialog. This allows a component loaded inside
+     * of a dialog to close itself and, optionally, to return a value.
+     * @private
      * @template T
      * @param {?} config Config object that is used to construct the dialog.
      * @param {?} dialogRef Reference to the dialog.
@@ -960,6 +1032,7 @@ var MatDialog = /** @class */ (function () {
     MatDialog.prototype._createInjector = /**
      * Creates a custom injector to be used inside the dialog. This allows a component loaded inside
      * of a dialog to close itself and, optionally, to return a value.
+     * @private
      * @template T
      * @param {?} config Config object that is used to construct the dialog.
      * @param {?} dialogRef Reference to the dialog.
@@ -969,6 +1042,10 @@ var MatDialog = /** @class */ (function () {
     function (config, dialogRef, dialogContainer) {
         /** @type {?} */
         var userInjector = config && config.viewContainerRef && config.viewContainerRef.injector;
+        // The MatDialogContainer is injected in the portal as the MatDialogContainer and the dialog's
+        // content are created out of the same ViewContainerRef and as such, are siblings for injector
+        // purposes. To allow the hierarchy that is expected, the MatDialogContainer is explicitly
+        // added to the injection tokens.
         /** @type {?} */
         var injectionTokens = new WeakMap([
             [MatDialogContainer, dialogContainer],
@@ -986,11 +1063,17 @@ var MatDialog = /** @class */ (function () {
     };
     /**
      * Removes a dialog from the array of open dialogs.
+     * @param dialogRef Dialog to be removed.
+     */
+    /**
+     * Removes a dialog from the array of open dialogs.
+     * @private
      * @param {?} dialogRef Dialog to be removed.
      * @return {?}
      */
     MatDialog.prototype._removeOpenDialog = /**
      * Removes a dialog from the array of open dialogs.
+     * @private
      * @param {?} dialogRef Dialog to be removed.
      * @return {?}
      */
@@ -1017,10 +1100,15 @@ var MatDialog = /** @class */ (function () {
     };
     /**
      * Hides all of the content that isn't an overlay from assistive technology.
+     */
+    /**
+     * Hides all of the content that isn't an overlay from assistive technology.
+     * @private
      * @return {?}
      */
     MatDialog.prototype._hideNonDialogContentFromAssistiveTechnology = /**
      * Hides all of the content that isn't an overlay from assistive technology.
+     * @private
      * @return {?}
      */
     function () {
@@ -1043,13 +1131,16 @@ var MatDialog = /** @class */ (function () {
             }
         }
     };
+    /** Closes all of the dialogs in an array. */
     /**
      * Closes all of the dialogs in an array.
+     * @private
      * @param {?} dialogs
      * @return {?}
      */
     MatDialog.prototype._closeDialogs = /**
      * Closes all of the dialogs in an array.
+     * @private
      * @param {?} dialogs
      * @return {?}
      */
@@ -1091,11 +1182,12 @@ function _applyConfigDefaults(config, defaultOptions) {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
-/** *
+/**
  * Counter used to generate unique IDs for dialog elements.
-  @type {?} */
+ * @type {?}
+ */
 var dialogElementUid = 0;
 /**
  * Button that will close the current dialog.
@@ -1123,7 +1215,7 @@ var MatDialogClose = /** @class */ (function () {
             // views cannot be given a custom injector. Instead, we look up the DialogRef by
             // ID. This must occur in `onInit`, as the ID binding for the dialog container won't
             // be resolved at constructor time.
-            this.dialogRef = /** @type {?} */ ((getClosestDialog(this._elementRef, this._dialog.openDialogs)));
+            this.dialogRef = (/** @type {?} */ (getClosestDialog(this._elementRef, this._dialog.openDialogs)));
         }
     };
     /**
@@ -1136,7 +1228,7 @@ var MatDialogClose = /** @class */ (function () {
      */
     function (changes) {
         /** @type {?} */
-        var proxiedChange = changes["_matDialogClose"] || changes["_matDialogCloseResult"];
+        var proxiedChange = changes._matDialogClose || changes._matDialogCloseResult;
         if (proxiedChange) {
             this.dialogResult = proxiedChange.currentValue;
         }
@@ -1184,7 +1276,7 @@ var MatDialogTitle = /** @class */ (function () {
     function () {
         var _this = this;
         if (!this._dialogRef) {
-            this._dialogRef = /** @type {?} */ ((getClosestDialog(this._elementRef, this._dialog.openDialogs)));
+            this._dialogRef = (/** @type {?} */ (getClosestDialog(this._elementRef, this._dialog.openDialogs)));
         }
         if (this._dialogRef) {
             Promise.resolve().then(function () {
@@ -1258,12 +1350,12 @@ function getClosestDialog(element, openDialogs) {
     while (parent && !parent.classList.contains('mat-dialog-container')) {
         parent = parent.parentElement;
     }
-    return parent ? openDialogs.find(function (dialog) { return dialog.id === /** @type {?} */ ((parent)).id; }) : null;
+    return parent ? openDialogs.find(function (dialog) { return dialog.id === (/** @type {?} */ (parent)).id; }) : null;
 }
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 var MatDialogModule = /** @class */ (function () {
     function MatDialogModule() {
@@ -1303,12 +1395,12 @@ var MatDialogModule = /** @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 { MatDialogModule, MAT_DIALOG_SCROLL_STRATEGY_FACTORY, MAT_DIALOG_SCROLL_STRATEGY_PROVIDER_FACTORY, MAT_DIALOG_DATA, MAT_DIALOG_DEFAULT_OPTIONS, MAT_DIALOG_SCROLL_STRATEGY, MAT_DIALOG_SCROLL_STRATEGY_PROVIDER, MatDialog, throwMatDialogContentAlreadyAttachedError, MatDialogContainer, MatDialogClose, MatDialogTitle, MatDialogContent, MatDialogActions, MatDialogConfig, MatDialogRef, matDialogAnimations };