@angular/material 7.0.3 → 7.2.0

package/bundles/material-menu.umd.js

@@ -6,10 +6,10 @@
  * found in the LICENSE file at https://angular.io/license
  */
 (function (global, factory) {
-	typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('@angular/core'), require('@angular/cdk/portal'), require('@angular/common'), require('rxjs'), require('@angular/animations'), require('@angular/cdk/a11y'), require('@angular/material/core'), require('@angular/cdk/coercion'), require('@angular/cdk/keycodes'), require('rxjs/operators'), require('@angular/cdk/bidi'), require('@angular/cdk/overlay')) :
-	typeof define === 'function' && define.amd ? define('@angular/material/menu', ['exports', '@angular/core', '@angular/cdk/portal', '@angular/common', 'rxjs', '@angular/animations', '@angular/cdk/a11y', '@angular/material/core', '@angular/cdk/coercion', '@angular/cdk/keycodes', 'rxjs/operators', '@angular/cdk/bidi', '@angular/cdk/overlay'], factory) :
-	(factory((global.ng = global.ng || {}, global.ng.material = global.ng.material || {}, global.ng.material.menu = {}),global.ng.core,global.ng.cdk.portal,global.ng.common,global.rxjs,global.ng.animations,global.ng.cdk.a11y,global.ng.material.core,global.ng.cdk.coercion,global.ng.cdk.keycodes,global.rxjs.operators,global.ng.cdk.bidi,global.ng.cdk.overlay));
-}(this, (function (exports,core,portal,common,rxjs,animations,a11y,core$1,coercion,keycodes,operators,bidi,overlay) { 'use strict';
+	typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('@angular/core'), require('@angular/cdk/portal'), require('@angular/common'), require('rxjs'), require('@angular/animations'), require('@angular/cdk/a11y'), require('@angular/material/core'), require('@angular/cdk/coercion'), require('@angular/cdk/keycodes'), require('rxjs/operators'), require('@angular/cdk/bidi'), require('@angular/cdk/overlay'), require('@angular/cdk/platform')) :
+	typeof define === 'function' && define.amd ? define('@angular/material/menu', ['exports', '@angular/core', '@angular/cdk/portal', '@angular/common', 'rxjs', '@angular/animations', '@angular/cdk/a11y', '@angular/material/core', '@angular/cdk/coercion', '@angular/cdk/keycodes', 'rxjs/operators', '@angular/cdk/bidi', '@angular/cdk/overlay', '@angular/cdk/platform'], factory) :
+	(factory((global.ng = global.ng || {}, global.ng.material = global.ng.material || {}, global.ng.material.menu = {}),global.ng.core,global.ng.cdk.portal,global.ng.common,global.rxjs,global.ng.animations,global.ng.cdk.a11y,global.ng.material.core,global.ng.cdk.coercion,global.ng.cdk.keycodes,global.rxjs.operators,global.ng.cdk.bidi,global.ng.cdk.overlay,global.ng.cdk.platform));
+}(this, (function (exports,core,portal,common,rxjs,animations,a11y,core$1,coercion,keycodes,operators,bidi,overlay,platform) { 'use strict';
 
 /*! *****************************************************************************
 Copyright (c) Microsoft Corporation. All rights reserved.
@@ -42,7 +42,7 @@ function __extends(d, b) {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  * Menu content that will be rendered lazily once the menu is opened.
@@ -86,12 +86,11 @@ var MatMenuContent = /** @class */ (function () {
             this._outlet = new portal.DomPortalOutlet(this._document.createElement('div'), this._componentFactoryResolver, this._appRef, this._injector);
         }
         /** @type {?} */
-        var element = this._template.elementRef.nativeElement; /** @type {?} */
-        ((
+        var element = this._template.elementRef.nativeElement;
         // Because we support opening the same menu from different triggers (which in turn have their
         // own `OverlayRef` panel), we have to re-insert the host element every time, otherwise we
         // risk it staying attached to a pane that's no longer in the DOM.
-        element.parentNode)).insertBefore(this._outlet.outletElement, element);
+        (/** @type {?} */ (element.parentNode)).insertBefore(this._outlet.outletElement, element);
         this._portal.attach(this._outlet, context);
         this._attached.next();
     };
@@ -144,23 +143,24 @@ var MatMenuContent = /** @class */ (function () {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
-/** *
+/**
  * Animations used by the mat-menu component.
  * Animation duration and timing values are based on:
  * https://material.io/guidelines/components/menus.html#menus-usage
  * \@docs-private
-  @type {?} */
+ * @type {?}
+ */
 var matMenuAnimations = {
     /**
-       * This animation controls the menu panel's entry and exit from the page.
-       *
-       * When the menu panel is added to the DOM, it scales in and fades in its border.
-       *
-       * When the menu panel is removed from the DOM, it simply fades out after a brief
-       * delay to display the ripple.
-       */
+     * This animation controls the menu panel's entry and exit from the page.
+     *
+     * When the menu panel is added to the DOM, it scales in and fades in its border.
+     *
+     * When the menu panel is removed from the DOM, it simply fades out after a brief
+     * delay to display the ripple.
+     */
     transformMenu: animations.trigger('transformMenu', [
         animations.state('void', animations.style({
             opacity: 0,
@@ -173,9 +173,9 @@ var matMenuAnimations = {
         animations.transition('* => void', animations.animate('100ms 25ms linear', animations.style({ opacity: 0 })))
     ]),
     /**
-       * This animation fades in the background color and content of the menu panel
-       * after its containing element is scaled in.
-       */
+     * This animation fades in the background color and content of the menu panel
+     * after its containing element is scaled in.
+     */
     fadeInItems: animations.trigger('fadeInItems', [
         // TODO(crisbeto): this is inside the `transformMenu`
         // now. Remove next time we do breaking changes.
@@ -186,22 +186,24 @@ var matMenuAnimations = {
         ])
     ])
 };
-/** *
+/**
  * @deprecated
  * \@breaking-change 8.0.0
  * \@docs-private
-  @type {?} */
+ * @type {?}
+ */
 var fadeInItems = matMenuAnimations.fadeInItems;
-/** *
+/**
  * @deprecated
  * \@breaking-change 8.0.0
  * \@docs-private
-  @type {?} */
+ * @type {?}
+ */
 var transformMenu = matMenuAnimations.transformMenu;
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 
 /**
@@ -233,22 +235,26 @@ function throwMatMenuInvalidPositionY() {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
-/** *
+/**
  * Injection token used to provide the parent menu to menu-specific components.
  * \@docs-private
-  @type {?} */
+ * @type {?}
+ */
 var MAT_MENU_PANEL = new core.InjectionToken('MAT_MENU_PANEL');
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
+// Boilerplate for applying mixins to MatMenuItem.
 /**
  * \@docs-private
  */
-var   /**
+var   
+// Boilerplate for applying mixins to MatMenuItem.
+/**
  * \@docs-private
  */
 MatMenuItemBase = /** @class */ (function () {
@@ -271,6 +277,10 @@ var MatMenuItem = /** @class */ (function (_super) {
         _this._elementRef = _elementRef;
         _this._focusMonitor = _focusMonitor;
         _this._parentMenu = _parentMenu;
+        /**
+         * ARIA role for the menu item.
+         */
+        _this.role = 'menuitem';
         /**
          * Stream that emits when the menu item is hovered.
          */
@@ -418,7 +428,7 @@ var MatMenuItem = /** @class */ (function (_super) {
                     exportAs: 'matMenuItem',
                     inputs: ['disabled', 'disableRipple'],
                     host: {
-                        'role': 'menuitem',
+                        '[attr.role]': 'role',
                         'class': 'mat-menu-item',
                         '[class.mat-menu-item-highlighted]': '_highlighted',
                         '[class.mat-menu-item-submenu-trigger]': '_triggersSubmenu',
@@ -440,16 +450,20 @@ var MatMenuItem = /** @class */ (function (_super) {
         { type: a11y.FocusMonitor },
         { type: undefined, decorators: [{ type: core.Inject, args: [MAT_MENU_PANEL,] }, { type: core.Optional }] }
     ]; };
+    MatMenuItem.propDecorators = {
+        role: [{ type: core.Input }]
+    };
     return MatMenuItem;
 }(_MatMenuItemMixinBase));
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
-/** *
+/**
  * Injection token to be used to override the default options for `mat-menu`.
-  @type {?} */
+ * @type {?}
+ */
 var MAT_MENU_DEFAULT_OPTIONS = new core.InjectionToken('mat-menu-default-options', {
     providedIn: 'root',
     factory: MAT_MENU_DEFAULT_OPTIONS_FACTORY
@@ -466,10 +480,11 @@ function MAT_MENU_DEFAULT_OPTIONS_FACTORY() {
         backdropClass: 'cdk-overlay-transparent-backdrop',
     };
 }
-/** *
+/**
  * Start elevation for the menu panel.
  * \@docs-private
-  @type {?} */
+ * @type {?}
+ */
 var MAT_MENU_BASE_ELEVATION = 4;
 var MatMenu = /** @class */ (function () {
     function MatMenu(_elementRef, _ngZone, _defaultOptions) {
@@ -782,6 +797,7 @@ var MatMenu = /** @class */ (function () {
      * @return {?}
      */
     function (depth) {
+        // The elevation starts at the base and increases by one for each level.
         /** @type {?} */
         var newElevation = "mat-elevation-z" + (MAT_MENU_BASE_ELEVATION + depth);
         /** @type {?} */
@@ -931,7 +947,7 @@ var MatMenu = /** @class */ (function () {
     MatMenu.decorators = [
         { type: core.Component, args: [{selector: 'mat-menu',
                     template: "<ng-template><div class=\"mat-menu-panel\" [ngClass]=\"_classList\" (keydown)=\"_handleKeydown($event)\" (click)=\"closed.emit('click')\" [@transformMenu]=\"_panelAnimationState\" (@transformMenu.start)=\"_isAnimating = true\" (@transformMenu.done)=\"_onAnimationDone($event)\" tabindex=\"-1\" role=\"menu\"><div class=\"mat-menu-content\"><ng-content></ng-content></div></div></ng-template>",
-                    styles: [".mat-menu-panel{min-width:112px;max-width:280px;overflow:auto;-webkit-overflow-scrolling:touch;max-height:calc(100vh - 48px);border-radius:4px;outline:0}@media screen and (-ms-high-contrast:active){.mat-menu-panel{outline:solid 1px}}.mat-menu-content:not(:empty){padding-top:8px;padding-bottom:8px}.mat-menu-item{-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;cursor:pointer;outline:0;border:none;-webkit-tap-highlight-color:transparent;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;display:block;line-height:48px;height:48px;padding:0 16px;text-align:left;text-decoration:none;max-width:100%;position:relative}.mat-menu-item::-moz-focus-inner{border:0}.mat-menu-item[disabled]{cursor:default}[dir=rtl] .mat-menu-item{text-align:right}.mat-menu-item .mat-icon{margin-right:16px;vertical-align:middle}.mat-menu-item .mat-icon svg{vertical-align:top}[dir=rtl] .mat-menu-item .mat-icon{margin-left:16px;margin-right:0}@media screen and (-ms-high-contrast:active){.mat-menu-item-highlighted,.mat-menu-item.cdk-keyboard-focused,.mat-menu-item.cdk-program-focused{outline:dotted 1px}}.mat-menu-item-submenu-trigger{padding-right:32px}.mat-menu-item-submenu-trigger::after{width:0;height:0;border-style:solid;border-width:5px 0 5px 5px;border-color:transparent transparent transparent currentColor;content:'';display:inline-block;position:absolute;top:50%;right:16px;transform:translateY(-50%)}[dir=rtl] .mat-menu-item-submenu-trigger{padding-right:16px;padding-left:32px}[dir=rtl] .mat-menu-item-submenu-trigger::after{right:auto;left:16px;transform:rotateY(180deg) translateY(-50%)}.mat-menu-panel.ng-animating .mat-menu-item-submenu-trigger{pointer-events:none}button.mat-menu-item{width:100%}.mat-menu-item .mat-menu-ripple{top:0;left:0;right:0;bottom:0;position:absolute;pointer-events:none}"],
+                    styles: [".mat-menu-panel{min-width:112px;max-width:280px;overflow:auto;-webkit-overflow-scrolling:touch;max-height:calc(100vh - 48px);border-radius:4px;outline:0}.mat-menu-panel.ng-animating{pointer-events:none}@media screen and (-ms-high-contrast:active){.mat-menu-panel{outline:solid 1px}}.mat-menu-content:not(:empty){padding-top:8px;padding-bottom:8px}.mat-menu-item{-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;cursor:pointer;outline:0;border:none;-webkit-tap-highlight-color:transparent;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;display:block;line-height:48px;height:48px;padding:0 16px;text-align:left;text-decoration:none;max-width:100%;position:relative}.mat-menu-item::-moz-focus-inner{border:0}.mat-menu-item[disabled]{cursor:default}[dir=rtl] .mat-menu-item{text-align:right}.mat-menu-item .mat-icon{margin-right:16px;vertical-align:middle}.mat-menu-item .mat-icon svg{vertical-align:top}[dir=rtl] .mat-menu-item .mat-icon{margin-left:16px;margin-right:0}@media screen and (-ms-high-contrast:active){.mat-menu-item-highlighted,.mat-menu-item.cdk-keyboard-focused,.mat-menu-item.cdk-program-focused{outline:dotted 1px}}.mat-menu-item-submenu-trigger{padding-right:32px}.mat-menu-item-submenu-trigger::after{width:0;height:0;border-style:solid;border-width:5px 0 5px 5px;border-color:transparent transparent transparent currentColor;content:'';display:inline-block;position:absolute;top:50%;right:16px;transform:translateY(-50%)}[dir=rtl] .mat-menu-item-submenu-trigger{padding-right:16px;padding-left:32px}[dir=rtl] .mat-menu-item-submenu-trigger::after{right:auto;left:16px;transform:rotateY(180deg) translateY(-50%)}button.mat-menu-item{width:100%}.mat-menu-item .mat-menu-ripple{top:0;left:0;right:0;bottom:0;position:absolute;pointer-events:none}"],
                     changeDetection: core.ChangeDetectionStrategy.OnPush,
                     encapsulation: core.ViewEncapsulation.None,
                     exportAs: 'matMenu',
@@ -969,11 +985,12 @@ var MatMenu = /** @class */ (function () {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
-/** *
+/**
  * Injection token that determines the scroll handling while the menu is open.
-  @type {?} */
+ * @type {?}
+ */
 var MAT_MENU_SCROLL_STRATEGY = new core.InjectionToken('mat-menu-scroll-strategy');
 /**
  * \@docs-private
@@ -983,24 +1000,33 @@ var MAT_MENU_SCROLL_STRATEGY = new core.InjectionToken('mat-menu-scroll-strategy
 function MAT_MENU_SCROLL_STRATEGY_FACTORY(overlay$$1) {
     return function () { return overlay$$1.scrollStrategies.reposition(); };
 }
-/** *
+/**
  * \@docs-private
-  @type {?} */
+ * @type {?}
+ */
 var MAT_MENU_SCROLL_STRATEGY_FACTORY_PROVIDER = {
     provide: MAT_MENU_SCROLL_STRATEGY,
     deps: [overlay.Overlay],
     useFactory: MAT_MENU_SCROLL_STRATEGY_FACTORY,
 };
-/** *
+/**
  * Default top padding of the menu panel.
-  @type {?} */
+ * @type {?}
+ */
 var MENU_PANEL_TOP_PADDING = 8;
+/**
+ * Options for binding a passive event listener.
+ * @type {?}
+ */
+var passiveEventListenerOptions = platform.normalizePassiveListenerOptions({ passive: true });
+// TODO(andrewseguin): Remove the kebab versions in favor of camelCased attribute selectors
 /**
  * This directive is intended to be used in conjunction with an mat-menu tag.  It is
  * responsible for toggling the display of the provided menu instance.
  */
 var MatMenuTrigger = /** @class */ (function () {
     function MatMenuTrigger(_overlay, _element, _viewContainerRef, scrollStrategy, _parentMenu, _menuItemInstance, _dir, _focusMonitor) {
+        var _this = this;
         this._overlay = _overlay;
         this._element = _element;
         this._viewContainerRef = _viewContainerRef;
@@ -1013,6 +1039,11 @@ var MatMenuTrigger = /** @class */ (function () {
         this._closeSubscription = rxjs.Subscription.EMPTY;
         this._hoverSubscription = rxjs.Subscription.EMPTY;
         this._menuCloseSubscription = rxjs.Subscription.EMPTY;
+        /**
+         * Handles touch start events on the trigger.
+         * Needs to be an arrow function so we can easily use addEventListener and removeEventListener.
+         */
+        this._handleTouchStart = function () { return _this._openedBy = 'touch'; };
         // Tracking input type is necessary so it's possible to only auto-focus
         // the first item of the list when the menu is opened via the keyboard
         this._openedBy = null;
@@ -1025,6 +1056,7 @@ var MatMenuTrigger = /** @class */ (function () {
          * @deprecated Switch to `menuOpened` instead
          * \@breaking-change 8.0.0
          */
+        // tslint:disable-next-line:no-output-on-prefix
         this.onMenuOpen = this.menuOpened;
         /**
          * Event emitted when the associated menu is closed.
@@ -1035,7 +1067,9 @@ var MatMenuTrigger = /** @class */ (function () {
          * @deprecated Switch to `menuClosed` instead
          * \@breaking-change 8.0.0
          */
+        // tslint:disable-next-line:no-output-on-prefix
         this.onMenuClose = this.menuClosed;
+        _element.nativeElement.addEventListener('touchstart', this._handleTouchStart, passiveEventListenerOptions);
         if (_menuItemInstance) {
             _menuItemInstance._triggersSubmenu = this.triggersSubmenu();
         }
@@ -1114,6 +1148,7 @@ var MatMenuTrigger = /** @class */ (function () {
             this._overlayRef.dispose();
             this._overlayRef = null;
         }
+        this._element.nativeElement.removeEventListener('touchstart', this._handleTouchStart, passiveEventListenerOptions);
         this._cleanUpSubscriptions();
     };
     Object.defineProperty(MatMenuTrigger.prototype, "menuOpen", {
@@ -1181,7 +1216,7 @@ var MatMenuTrigger = /** @class */ (function () {
         this._checkMenu();
         /** @type {?} */
         var overlayRef = this._createOverlay();
-        this._setPosition(/** @type {?} */ (overlayRef.getConfig().positionStrategy));
+        this._setPosition((/** @type {?} */ (overlayRef.getConfig().positionStrategy)));
         overlayRef.attach(this._getPortal());
         if (this.menu.lazyContent) {
             this.menu.lazyContent.attach(this.menuData);
@@ -1227,12 +1262,15 @@ var MatMenuTrigger = /** @class */ (function () {
             this._element.nativeElement.focus();
         }
     };
+    /** Closes the menu and does the necessary cleanup. */
     /**
      * Closes the menu and does the necessary cleanup.
+     * @private
      * @return {?}
      */
     MatMenuTrigger.prototype._destroyMenu = /**
      * Closes the menu and does the necessary cleanup.
+     * @private
      * @return {?}
      */
     function () {
@@ -1252,7 +1290,7 @@ var MatMenuTrigger = /** @class */ (function () {
                     .pipe(operators.filter(function (event) { return event.toState === 'void'; }), operators.take(1), 
                 // Interrupt if the content got re-attached.
                 operators.takeUntil(menu.lazyContent._attached))
-                    .subscribe(function () { return ((menu.lazyContent)).detach(); }, undefined, function () {
+                    .subscribe(function () { return (/** @type {?} */ (menu.lazyContent)).detach(); }, undefined, function () {
                     // No matter whether the content got re-attached, reset the menu.
                     _this._resetMenu();
                 });
@@ -1271,11 +1309,17 @@ var MatMenuTrigger = /** @class */ (function () {
     /**
      * This method sets the menu state to open and focuses the first item if
      * the menu was opened via the keyboard.
+     */
+    /**
+     * This method sets the menu state to open and focuses the first item if
+     * the menu was opened via the keyboard.
+     * @private
      * @return {?}
      */
     MatMenuTrigger.prototype._initMenu = /**
      * This method sets the menu state to open and focuses the first item if
      * the menu was opened via the keyboard.
+     * @private
      * @return {?}
      */
     function () {
@@ -1285,12 +1329,15 @@ var MatMenuTrigger = /** @class */ (function () {
         this._setIsMenuOpen(true);
         this.menu.focusFirstItem(this._openedBy || 'program');
     };
+    /** Updates the menu elevation based on the amount of parent menus that it has. */
     /**
      * Updates the menu elevation based on the amount of parent menus that it has.
+     * @private
      * @return {?}
      */
     MatMenuTrigger.prototype._setMenuElevation = /**
      * Updates the menu elevation based on the amount of parent menus that it has.
+     * @private
      * @return {?}
      */
     function () {
@@ -1309,11 +1356,17 @@ var MatMenuTrigger = /** @class */ (function () {
     /**
      * This method resets the menu when it's closed, most importantly restoring
      * focus to the menu trigger if the menu was opened via the keyboard.
+     */
+    /**
+     * This method resets the menu when it's closed, most importantly restoring
+     * focus to the menu trigger if the menu was opened via the keyboard.
+     * @private
      * @return {?}
      */
     MatMenuTrigger.prototype._resetMenu = /**
      * This method resets the menu when it's closed, most importantly restoring
      * focus to the menu trigger if the menu was opened via the keyboard.
+     * @private
      * @return {?}
      */
     function () {
@@ -1331,11 +1384,17 @@ var MatMenuTrigger = /** @class */ (function () {
         }
         this._openedBy = null;
     };
+    // set state rather than toggle to support triggers sharing a menu
+    // set state rather than toggle to support triggers sharing a menu
     /**
+     * @private
      * @param {?} isOpen
      * @return {?}
      */
-    MatMenuTrigger.prototype._setIsMenuOpen = /**
+    MatMenuTrigger.prototype._setIsMenuOpen = 
+    // set state rather than toggle to support triggers sharing a menu
+    /**
+     * @private
      * @param {?} isOpen
      * @return {?}
      */
@@ -1349,11 +1408,17 @@ var MatMenuTrigger = /** @class */ (function () {
     /**
      * This method checks that a valid instance of MatMenu has been passed into
      * matMenuTriggerFor. If not, an exception is thrown.
+     */
+    /**
+     * This method checks that a valid instance of MatMenu has been passed into
+     * matMenuTriggerFor. If not, an exception is thrown.
+     * @private
      * @return {?}
      */
     MatMenuTrigger.prototype._checkMenu = /**
      * This method checks that a valid instance of MatMenu has been passed into
      * matMenuTriggerFor. If not, an exception is thrown.
+     * @private
      * @return {?}
      */
     function () {
@@ -1364,18 +1429,24 @@ var MatMenuTrigger = /** @class */ (function () {
     /**
      * This method creates the overlay from the provided menu's template and saves its
      * OverlayRef so that it can be attached to the DOM when openMenu is called.
+     */
+    /**
+     * This method creates the overlay from the provided menu's template and saves its
+     * OverlayRef so that it can be attached to the DOM when openMenu is called.
+     * @private
      * @return {?}
      */
     MatMenuTrigger.prototype._createOverlay = /**
      * This method creates the overlay from the provided menu's template and saves its
      * OverlayRef so that it can be attached to the DOM when openMenu is called.
+     * @private
      * @return {?}
      */
     function () {
         if (!this._overlayRef) {
             /** @type {?} */
             var config = this._getOverlayConfig();
-            this._subscribeToPositions(/** @type {?} */ (config.positionStrategy));
+            this._subscribeToPositions((/** @type {?} */ (config.positionStrategy)));
             this._overlayRef = this._overlay.create(config);
             // Consume the `keydownEvents` in order to prevent them from going to another overlay.
             // Ideally we'd also have our keyboard event logic in here, however doing so will
@@ -1386,10 +1457,16 @@ var MatMenuTrigger = /** @class */ (function () {
     };
     /**
      * This method builds the configuration object needed to create the overlay, the OverlayState.
+     * @returns OverlayConfig
+     */
+    /**
+     * This method builds the configuration object needed to create the overlay, the OverlayState.
+     * @private
      * @return {?} OverlayConfig
      */
     MatMenuTrigger.prototype._getOverlayConfig = /**
      * This method builds the configuration object needed to create the overlay, the OverlayState.
+     * @private
      * @return {?} OverlayConfig
      */
     function () {
@@ -1408,6 +1485,12 @@ var MatMenuTrigger = /** @class */ (function () {
      * Listens to changes in the position of the overlay and sets the correct classes
      * on the menu based on the new position. This ensures the animation origin is always
      * correct, even if a fallback position is used for the overlay.
+     */
+    /**
+     * Listens to changes in the position of the overlay and sets the correct classes
+     * on the menu based on the new position. This ensures the animation origin is always
+     * correct, even if a fallback position is used for the overlay.
+     * @private
      * @param {?} position
      * @return {?}
      */
@@ -1415,6 +1498,7 @@ var MatMenuTrigger = /** @class */ (function () {
      * Listens to changes in the position of the overlay and sets the correct classes
      * on the menu based on the new position. This ensures the animation origin is always
      * correct, even if a fallback position is used for the overlay.
+     * @private
      * @param {?} position
      * @return {?}
      */
@@ -1425,20 +1509,27 @@ var MatMenuTrigger = /** @class */ (function () {
                 /** @type {?} */
                 var posX = change.connectionPair.overlayX === 'start' ? 'after' : 'before';
                 /** @type {?} */
-                var posY = change.connectionPair.overlayY === 'top' ? 'below' : 'above'; /** @type {?} */
-                ((_this.menu.setPositionClasses))(posX, posY);
+                var posY = change.connectionPair.overlayY === 'top' ? 'below' : 'above';
+                (/** @type {?} */ (_this.menu.setPositionClasses))(posX, posY);
             });
         }
     };
     /**
      * Sets the appropriate positions on a position strategy
      * so the overlay connects with the trigger correctly.
+     * @param positionStrategy Strategy whose position to update.
+     */
+    /**
+     * Sets the appropriate positions on a position strategy
+     * so the overlay connects with the trigger correctly.
+     * @private
      * @param {?} positionStrategy Strategy whose position to update.
      * @return {?}
      */
     MatMenuTrigger.prototype._setPosition = /**
      * Sets the appropriate positions on a position strategy
      * so the overlay connects with the trigger correctly.
+     * @private
      * @param {?} positionStrategy Strategy whose position to update.
      * @return {?}
      */
@@ -1479,32 +1570,38 @@ var MatMenuTrigger = /** @class */ (function () {
             }
         ]);
     };
+    /** Cleans up the active subscriptions. */
     /**
      * Cleans up the active subscriptions.
+     * @private
      * @return {?}
      */
     MatMenuTrigger.prototype._cleanUpSubscriptions = /**
      * Cleans up the active subscriptions.
+     * @private
      * @return {?}
      */
     function () {
         this._closeSubscription.unsubscribe();
         this._hoverSubscription.unsubscribe();
     };
+    /** Returns a stream that emits whenever an action that should close the menu occurs. */
     /**
      * Returns a stream that emits whenever an action that should close the menu occurs.
+     * @private
      * @return {?}
      */
     MatMenuTrigger.prototype._menuClosingActions = /**
      * Returns a stream that emits whenever an action that should close the menu occurs.
+     * @private
      * @return {?}
      */
     function () {
         var _this = this;
         /** @type {?} */
-        var backdrop = /** @type {?} */ ((this._overlayRef)).backdropClick();
+        var backdrop = (/** @type {?} */ (this._overlayRef)).backdropClick();
         /** @type {?} */
-        var detachments = /** @type {?} */ ((this._overlayRef)).detachments();
+        var detachments = (/** @type {?} */ (this._overlayRef)).detachments();
         /** @type {?} */
         var parentClose = this._parentMenu ? this._parentMenu.closed : rxjs.of();
         /** @type {?} */
@@ -1575,12 +1672,15 @@ var MatMenuTrigger = /** @class */ (function () {
             this.toggleMenu();
         }
     };
+    /** Handles the cases where the user hovers over the trigger. */
     /**
      * Handles the cases where the user hovers over the trigger.
+     * @private
      * @return {?}
      */
     MatMenuTrigger.prototype._handleHover = /**
      * Handles the cases where the user hovers over the trigger.
+     * @private
      * @return {?}
      */
     function () {
@@ -1611,12 +1711,15 @@ var MatMenuTrigger = /** @class */ (function () {
             }
         });
     };
+    /** Gets the portal that should be attached to the overlay. */
     /**
      * Gets the portal that should be attached to the overlay.
+     * @private
      * @return {?}
      */
     MatMenuTrigger.prototype._getPortal = /**
      * Gets the portal that should be attached to the overlay.
+     * @private
      * @return {?}
      */
     function () {
@@ -1635,7 +1738,6 @@ var MatMenuTrigger = /** @class */ (function () {
                         'aria-haspopup': 'true',
                         '[attr.aria-expanded]': 'menuOpen || null',
                         '(mousedown)': '_handleMousedown($event)',
-                        '(touchstart)': '_openedBy = "touch"',
                         '(keydown)': '_handleKeydown($event)',
                         '(click)': '_handleClick($event)',
                     },
@@ -1667,7 +1769,7 @@ var MatMenuTrigger = /** @class */ (function () {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 var MatMenuModule = /** @class */ (function () {
     function MatMenuModule() {