@angular/material 10.0.0-rc.3 → 10.1.0

package/fesm2015/tooltip.js

@@ -88,546 +88,553 @@ function MAT_TOOLTIP_DEFAULT_OPTIONS_FACTORY() {
  *
  * https://material.io/design/components/tooltips.html
  */
-let MatTooltip = /** @class */ (() => {
-    class MatTooltip {
-        constructor(_overlay, _elementRef, _scrollDispatcher, _viewContainerRef, _ngZone, _platform, _ariaDescriber, _focusMonitor, scrollStrategy, _dir, _defaultOptions) {
-            this._overlay = _overlay;
-            this._elementRef = _elementRef;
-            this._scrollDispatcher = _scrollDispatcher;
-            this._viewContainerRef = _viewContainerRef;
-            this._ngZone = _ngZone;
-            this._platform = _platform;
-            this._ariaDescriber = _ariaDescriber;
-            this._focusMonitor = _focusMonitor;
-            this._dir = _dir;
-            this._defaultOptions = _defaultOptions;
-            this._position = 'below';
-            this._disabled = false;
-            /** The default delay in ms before showing the tooltip after show is called */
-            this.showDelay = this._defaultOptions.showDelay;
-            /** The default delay in ms before hiding the tooltip after hide is called */
-            this.hideDelay = this._defaultOptions.hideDelay;
-            /**
-             * How touch gestures should be handled by the tooltip. On touch devices the tooltip directive
-             * uses a long press gesture to show and hide, however it can conflict with the native browser
-             * gestures. To work around the conflict, Angular Material disables native gestures on the
-             * trigger, but that might not be desirable on particular elements (e.g. inputs and draggable
-             * elements). The different values for this option configure the touch event handling as follows:
-             * - `auto` - Enables touch gestures for all elements, but tries to avoid conflicts with native
-             *   browser gestures on particular elements. In particular, it allows text selection on inputs
-             *   and textareas, and preserves the native browser dragging on elements marked as `draggable`.
-             * - `on` - Enables touch gestures for all elements and disables native
-             *   browser gestures with no exceptions.
-             * - `off` - Disables touch gestures. Note that this will prevent the tooltip from
-             *   showing on touch devices.
-             */
-            this.touchGestures = 'auto';
-            this._message = '';
-            /** Manually-bound passive event listeners. */
-            this._passiveListeners = new Map();
-            /** Emits when the component is destroyed. */
-            this._destroyed = new Subject();
-            /**
-             * Handles the keydown events on the host element.
-             * Needs to be an arrow function so that we can use it in addEventListener.
-             */
-            this._handleKeydown = (event) => {
-                if (this._isTooltipVisible() && event.keyCode === ESCAPE && !hasModifierKey(event)) {
-                    event.preventDefault();
-                    event.stopPropagation();
-                    this._ngZone.run(() => this.hide(0));
-                }
-            };
-            this._scrollStrategy = scrollStrategy;
-            if (_defaultOptions) {
-                if (_defaultOptions.position) {
-                    this.position = _defaultOptions.position;
-                }
-                if (_defaultOptions.touchGestures) {
-                    this.touchGestures = _defaultOptions.touchGestures;
-                }
+class MatTooltip {
+    constructor(_overlay, _elementRef, _scrollDispatcher, _viewContainerRef, _ngZone, _platform, _ariaDescriber, _focusMonitor, scrollStrategy, _dir, _defaultOptions) {
+        this._overlay = _overlay;
+        this._elementRef = _elementRef;
+        this._scrollDispatcher = _scrollDispatcher;
+        this._viewContainerRef = _viewContainerRef;
+        this._ngZone = _ngZone;
+        this._platform = _platform;
+        this._ariaDescriber = _ariaDescriber;
+        this._focusMonitor = _focusMonitor;
+        this._dir = _dir;
+        this._defaultOptions = _defaultOptions;
+        this._position = 'below';
+        this._disabled = false;
+        this._viewInitialized = false;
+        /** The default delay in ms before showing the tooltip after show is called */
+        this.showDelay = this._defaultOptions.showDelay;
+        /** The default delay in ms before hiding the tooltip after hide is called */
+        this.hideDelay = this._defaultOptions.hideDelay;
+        /**
+         * How touch gestures should be handled by the tooltip. On touch devices the tooltip directive
+         * uses a long press gesture to show and hide, however it can conflict with the native browser
+         * gestures. To work around the conflict, Angular Material disables native gestures on the
+         * trigger, but that might not be desirable on particular elements (e.g. inputs and draggable
+         * elements). The different values for this option configure the touch event handling as follows:
+         * - `auto` - Enables touch gestures for all elements, but tries to avoid conflicts with native
+         *   browser gestures on particular elements. In particular, it allows text selection on inputs
+         *   and textareas, and preserves the native browser dragging on elements marked as `draggable`.
+         * - `on` - Enables touch gestures for all elements and disables native
+         *   browser gestures with no exceptions.
+         * - `off` - Disables touch gestures. Note that this will prevent the tooltip from
+         *   showing on touch devices.
+         */
+        this.touchGestures = 'auto';
+        this._message = '';
+        /** Manually-bound passive event listeners. */
+        this._passiveListeners = new Map();
+        /** Emits when the component is destroyed. */
+        this._destroyed = new Subject();
+        /**
+         * Handles the keydown events on the host element.
+         * Needs to be an arrow function so that we can use it in addEventListener.
+         */
+        this._handleKeydown = (event) => {
+            if (this._isTooltipVisible() && event.keyCode === ESCAPE && !hasModifierKey(event)) {
+                event.preventDefault();
+                event.stopPropagation();
+                this._ngZone.run(() => this.hide(0));
+            }
+        };
+        this._scrollStrategy = scrollStrategy;
+        if (_defaultOptions) {
+            if (_defaultOptions.position) {
+                this.position = _defaultOptions.position;
+            }
+            if (_defaultOptions.touchGestures) {
+                this.touchGestures = _defaultOptions.touchGestures;
             }
-            _ngZone.runOutsideAngular(() => {
-                _elementRef.nativeElement.addEventListener('keydown', this._handleKeydown);
-            });
         }
-        /** Allows the user to define the position of the tooltip relative to the parent element */
-        get position() { return this._position; }
-        set position(value) {
-            if (value !== this._position) {
-                this._position = value;
-                if (this._overlayRef) {
-                    this._updatePosition();
-                    if (this._tooltipInstance) {
-                        this._tooltipInstance.show(0);
-                    }
-                    this._overlayRef.updatePosition();
+        _ngZone.runOutsideAngular(() => {
+            _elementRef.nativeElement.addEventListener('keydown', this._handleKeydown);
+        });
+    }
+    /** Allows the user to define the position of the tooltip relative to the parent element */
+    get position() { return this._position; }
+    set position(value) {
+        if (value !== this._position) {
+            this._position = value;
+            if (this._overlayRef) {
+                this._updatePosition();
+                if (this._tooltipInstance) {
+                    this._tooltipInstance.show(0);
                 }
+                this._overlayRef.updatePosition();
             }
         }
-        /** Disables the display of the tooltip. */
-        get disabled() { return this._disabled; }
-        set disabled(value) {
-            this._disabled = coerceBooleanProperty(value);
-            // If tooltip is disabled, hide immediately.
-            if (this._disabled) {
-                this.hide(0);
-            }
+    }
+    /** Disables the display of the tooltip. */
+    get disabled() { return this._disabled; }
+    set disabled(value) {
+        this._disabled = coerceBooleanProperty(value);
+        // If tooltip is disabled, hide immediately.
+        if (this._disabled) {
+            this.hide(0);
+        }
+        else {
+            this._setupPointerEvents();
         }
-        /** The message to be displayed in the tooltip */
-        get message() { return this._message; }
-        set message(value) {
+    }
+    /** The message to be displayed in the tooltip */
+    get message() { return this._message; }
+    set message(value) {
+        if (this._message) {
             this._ariaDescriber.removeDescription(this._elementRef.nativeElement, this._message);
-            // If the message is not a string (e.g. number), convert it to a string and trim it.
-            this._message = value != null ? `${value}`.trim() : '';
-            if (!this._message && this._isTooltipVisible()) {
-                this.hide(0);
-            }
-            else {
-                this._updateTooltipMessage();
-                this._ngZone.runOutsideAngular(() => {
-                    // The `AriaDescriber` has some functionality that avoids adding a description if it's the
-                    // same as the `aria-label` of an element, however we can't know whether the tooltip trigger
-                    // has a data-bound `aria-label` or when it'll be set for the first time. We can avoid the
-                    // issue by deferring the description by a tick so Angular has time to set the `aria-label`.
-                    Promise.resolve().then(() => {
-                        this._ariaDescriber.describe(this._elementRef.nativeElement, this.message);
-                    });
-                });
-            }
         }
-        /** Classes to be passed to the tooltip. Supports the same syntax as `ngClass`. */
-        get tooltipClass() { return this._tooltipClass; }
-        set tooltipClass(value) {
-            this._tooltipClass = value;
-            if (this._tooltipInstance) {
-                this._setTooltipClass(this._tooltipClass);
-            }
+        // If the message is not a string (e.g. number), convert it to a string and trim it.
+        this._message = value != null ? `${value}`.trim() : '';
+        if (!this._message && this._isTooltipVisible()) {
+            this.hide(0);
         }
-        ngAfterViewInit() {
-            // This needs to happen after view init so the initial values for all inputs have been set.
+        else {
             this._setupPointerEvents();
-            this._focusMonitor.monitor(this._elementRef)
-                .pipe(takeUntil(this._destroyed))
-                .subscribe(origin => {
-                // Note that the focus monitor runs outside the Angular zone.
-                if (!origin) {
-                    this._ngZone.run(() => this.hide(0));
-                }
-                else if (origin === 'keyboard') {
-                    this._ngZone.run(() => this.show());
-                }
+            this._updateTooltipMessage();
+            this._ngZone.runOutsideAngular(() => {
+                // The `AriaDescriber` has some functionality that avoids adding a description if it's the
+                // same as the `aria-label` of an element, however we can't know whether the tooltip trigger
+                // has a data-bound `aria-label` or when it'll be set for the first time. We can avoid the
+                // issue by deferring the description by a tick so Angular has time to set the `aria-label`.
+                Promise.resolve().then(() => {
+                    this._ariaDescriber.describe(this._elementRef.nativeElement, this.message);
+                });
             });
         }
-        /**
-         * Dispose the tooltip when destroyed.
-         */
-        ngOnDestroy() {
-            const nativeElement = this._elementRef.nativeElement;
-            clearTimeout(this._touchstartTimeout);
-            if (this._overlayRef) {
-                this._overlayRef.dispose();
-                this._tooltipInstance = null;
-            }
-            // Clean up the event listeners set in the constructor
-            nativeElement.removeEventListener('keydown', this._handleKeydown);
-            this._passiveListeners.forEach((listener, event) => {
-                nativeElement.removeEventListener(event, listener, passiveListenerOptions);
-            });
-            this._passiveListeners.clear();
-            this._destroyed.next();
-            this._destroyed.complete();
-            this._ariaDescriber.removeDescription(nativeElement, this.message);
-            this._focusMonitor.stopMonitoring(nativeElement);
-        }
-        /** Shows the tooltip after the delay in ms, defaults to tooltip-delay-show or 0ms if no input */
-        show(delay = this.showDelay) {
-            if (this.disabled || !this.message || (this._isTooltipVisible() &&
-                !this._tooltipInstance._showTimeoutId && !this._tooltipInstance._hideTimeoutId)) {
-                return;
-            }
-            const overlayRef = this._createOverlay();
-            this._detach();
-            this._portal = this._portal || new ComponentPortal(TooltipComponent, this._viewContainerRef);
-            this._tooltipInstance = overlayRef.attach(this._portal).instance;
-            this._tooltipInstance.afterHidden()
-                .pipe(takeUntil(this._destroyed))
-                .subscribe(() => this._detach());
+    }
+    /** Classes to be passed to the tooltip. Supports the same syntax as `ngClass`. */
+    get tooltipClass() { return this._tooltipClass; }
+    set tooltipClass(value) {
+        this._tooltipClass = value;
+        if (this._tooltipInstance) {
             this._setTooltipClass(this._tooltipClass);
-            this._updateTooltipMessage();
-            this._tooltipInstance.show(delay);
         }
-        /** Hides the tooltip after the delay in ms, defaults to tooltip-delay-hide or 0ms if no input */
-        hide(delay = this.hideDelay) {
+    }
+    ngAfterViewInit() {
+        // This needs to happen after view init so the initial values for all inputs have been set.
+        this._viewInitialized = true;
+        this._setupPointerEvents();
+        this._focusMonitor.monitor(this._elementRef)
+            .pipe(takeUntil(this._destroyed))
+            .subscribe(origin => {
+            // Note that the focus monitor runs outside the Angular zone.
+            if (!origin) {
+                this._ngZone.run(() => this.hide(0));
+            }
+            else if (origin === 'keyboard') {
+                this._ngZone.run(() => this.show());
+            }
+        });
+    }
+    /**
+     * Dispose the tooltip when destroyed.
+     */
+    ngOnDestroy() {
+        const nativeElement = this._elementRef.nativeElement;
+        clearTimeout(this._touchstartTimeout);
+        if (this._overlayRef) {
+            this._overlayRef.dispose();
+            this._tooltipInstance = null;
+        }
+        // Clean up the event listeners set in the constructor
+        nativeElement.removeEventListener('keydown', this._handleKeydown);
+        this._passiveListeners.forEach((listener, event) => {
+            nativeElement.removeEventListener(event, listener, passiveListenerOptions);
+        });
+        this._passiveListeners.clear();
+        this._destroyed.next();
+        this._destroyed.complete();
+        this._ariaDescriber.removeDescription(nativeElement, this.message);
+        this._focusMonitor.stopMonitoring(nativeElement);
+    }
+    /** Shows the tooltip after the delay in ms, defaults to tooltip-delay-show or 0ms if no input */
+    show(delay = this.showDelay) {
+        if (this.disabled || !this.message || (this._isTooltipVisible() &&
+            !this._tooltipInstance._showTimeoutId && !this._tooltipInstance._hideTimeoutId)) {
+            return;
+        }
+        const overlayRef = this._createOverlay();
+        this._detach();
+        this._portal = this._portal || new ComponentPortal(TooltipComponent, this._viewContainerRef);
+        this._tooltipInstance = overlayRef.attach(this._portal).instance;
+        this._tooltipInstance.afterHidden()
+            .pipe(takeUntil(this._destroyed))
+            .subscribe(() => this._detach());
+        this._setTooltipClass(this._tooltipClass);
+        this._updateTooltipMessage();
+        this._tooltipInstance.show(delay);
+    }
+    /** Hides the tooltip after the delay in ms, defaults to tooltip-delay-hide or 0ms if no input */
+    hide(delay = this.hideDelay) {
+        if (this._tooltipInstance) {
+            this._tooltipInstance.hide(delay);
+        }
+    }
+    /** Shows/hides the tooltip */
+    toggle() {
+        this._isTooltipVisible() ? this.hide() : this.show();
+    }
+    /** Returns true if the tooltip is currently visible to the user */
+    _isTooltipVisible() {
+        return !!this._tooltipInstance && this._tooltipInstance.isVisible();
+    }
+    /** Create the overlay config and position strategy */
+    _createOverlay() {
+        if (this._overlayRef) {
+            return this._overlayRef;
+        }
+        const scrollableAncestors = this._scrollDispatcher.getAncestorScrollContainers(this._elementRef);
+        // Create connected position strategy that listens for scroll events to reposition.
+        const strategy = this._overlay.position()
+            .flexibleConnectedTo(this._elementRef)
+            .withTransformOriginOn('.mat-tooltip')
+            .withFlexibleDimensions(false)
+            .withViewportMargin(8)
+            .withScrollableContainers(scrollableAncestors);
+        strategy.positionChanges.pipe(takeUntil(this._destroyed)).subscribe(change => {
             if (this._tooltipInstance) {
-                this._tooltipInstance.hide(delay);
+                if (change.scrollableViewProperties.isOverlayClipped && this._tooltipInstance.isVisible()) {
+                    // After position changes occur and the overlay is clipped by
+                    // a parent scrollable then close the tooltip.
+                    this._ngZone.run(() => this.hide(0));
+                }
             }
+        });
+        this._overlayRef = this._overlay.create({
+            direction: this._dir,
+            positionStrategy: strategy,
+            panelClass: TOOLTIP_PANEL_CLASS,
+            scrollStrategy: this._scrollStrategy()
+        });
+        this._updatePosition();
+        this._overlayRef.detachments()
+            .pipe(takeUntil(this._destroyed))
+            .subscribe(() => this._detach());
+        return this._overlayRef;
+    }
+    /** Detaches the currently-attached tooltip. */
+    _detach() {
+        if (this._overlayRef && this._overlayRef.hasAttached()) {
+            this._overlayRef.detach();
         }
-        /** Shows/hides the tooltip */
-        toggle() {
-            this._isTooltipVisible() ? this.hide() : this.show();
+        this._tooltipInstance = null;
+    }
+    /** Updates the position of the current tooltip. */
+    _updatePosition() {
+        const position = this._overlayRef.getConfig().positionStrategy;
+        const origin = this._getOrigin();
+        const overlay = this._getOverlayPosition();
+        position.withPositions([
+            Object.assign(Object.assign({}, origin.main), overlay.main),
+            Object.assign(Object.assign({}, origin.fallback), overlay.fallback)
+        ]);
+    }
+    /**
+     * Returns the origin position and a fallback position based on the user's position preference.
+     * The fallback position is the inverse of the origin (e.g. `'below' -> 'above'`).
+     */
+    _getOrigin() {
+        const isLtr = !this._dir || this._dir.value == 'ltr';
+        const position = this.position;
+        let originPosition;
+        if (position == 'above' || position == 'below') {
+            originPosition = { originX: 'center', originY: position == 'above' ? 'top' : 'bottom' };
         }
-        /** Returns true if the tooltip is currently visible to the user */
-        _isTooltipVisible() {
-            return !!this._tooltipInstance && this._tooltipInstance.isVisible();
+        else if (position == 'before' ||
+            (position == 'left' && isLtr) ||
+            (position == 'right' && !isLtr)) {
+            originPosition = { originX: 'start', originY: 'center' };
         }
-        /** Create the overlay config and position strategy */
-        _createOverlay() {
-            if (this._overlayRef) {
-                return this._overlayRef;
-            }
-            const scrollableAncestors = this._scrollDispatcher.getAncestorScrollContainers(this._elementRef);
-            // Create connected position strategy that listens for scroll events to reposition.
-            const strategy = this._overlay.position()
-                .flexibleConnectedTo(this._elementRef)
-                .withTransformOriginOn('.mat-tooltip')
-                .withFlexibleDimensions(false)
-                .withViewportMargin(8)
-                .withScrollableContainers(scrollableAncestors);
-            strategy.positionChanges.pipe(takeUntil(this._destroyed)).subscribe(change => {
+        else if (position == 'after' ||
+            (position == 'right' && isLtr) ||
+            (position == 'left' && !isLtr)) {
+            originPosition = { originX: 'end', originY: 'center' };
+        }
+        else {
+            throw getMatTooltipInvalidPositionError(position);
+        }
+        const { x, y } = this._invertPosition(originPosition.originX, originPosition.originY);
+        return {
+            main: originPosition,
+            fallback: { originX: x, originY: y }
+        };
+    }
+    /** Returns the overlay position and a fallback position based on the user's preference */
+    _getOverlayPosition() {
+        const isLtr = !this._dir || this._dir.value == 'ltr';
+        const position = this.position;
+        let overlayPosition;
+        if (position == 'above') {
+            overlayPosition = { overlayX: 'center', overlayY: 'bottom' };
+        }
+        else if (position == 'below') {
+            overlayPosition = { overlayX: 'center', overlayY: 'top' };
+        }
+        else if (position == 'before' ||
+            (position == 'left' && isLtr) ||
+            (position == 'right' && !isLtr)) {
+            overlayPosition = { overlayX: 'end', overlayY: 'center' };
+        }
+        else if (position == 'after' ||
+            (position == 'right' && isLtr) ||
+            (position == 'left' && !isLtr)) {
+            overlayPosition = { overlayX: 'start', overlayY: 'center' };
+        }
+        else {
+            throw getMatTooltipInvalidPositionError(position);
+        }
+        const { x, y } = this._invertPosition(overlayPosition.overlayX, overlayPosition.overlayY);
+        return {
+            main: overlayPosition,
+            fallback: { overlayX: x, overlayY: y }
+        };
+    }
+    /** Updates the tooltip message and repositions the overlay according to the new message length */
+    _updateTooltipMessage() {
+        // Must wait for the message to be painted to the tooltip so that the overlay can properly
+        // calculate the correct positioning based on the size of the text.
+        if (this._tooltipInstance) {
+            this._tooltipInstance.message = this.message;
+            this._tooltipInstance._markForCheck();
+            this._ngZone.onMicrotaskEmpty.asObservable().pipe(take(1), takeUntil(this._destroyed)).subscribe(() => {
                 if (this._tooltipInstance) {
-                    if (change.scrollableViewProperties.isOverlayClipped && this._tooltipInstance.isVisible()) {
-                        // After position changes occur and the overlay is clipped by
-                        // a parent scrollable then close the tooltip.
-                        this._ngZone.run(() => this.hide(0));
-                    }
+                    this._overlayRef.updatePosition();
                 }
             });
-            this._overlayRef = this._overlay.create({
-                direction: this._dir,
-                positionStrategy: strategy,
-                panelClass: TOOLTIP_PANEL_CLASS,
-                scrollStrategy: this._scrollStrategy()
-            });
-            this._updatePosition();
-            this._overlayRef.detachments()
-                .pipe(takeUntil(this._destroyed))
-                .subscribe(() => this._detach());
-            return this._overlayRef;
         }
-        /** Detaches the currently-attached tooltip. */
-        _detach() {
-            if (this._overlayRef && this._overlayRef.hasAttached()) {
-                this._overlayRef.detach();
-            }
-            this._tooltipInstance = null;
-        }
-        /** Updates the position of the current tooltip. */
-        _updatePosition() {
-            const position = this._overlayRef.getConfig().positionStrategy;
-            const origin = this._getOrigin();
-            const overlay = this._getOverlayPosition();
-            position.withPositions([
-                Object.assign(Object.assign({}, origin.main), overlay.main),
-                Object.assign(Object.assign({}, origin.fallback), overlay.fallback)
-            ]);
+    }
+    /** Updates the tooltip class */
+    _setTooltipClass(tooltipClass) {
+        if (this._tooltipInstance) {
+            this._tooltipInstance.tooltipClass = tooltipClass;
+            this._tooltipInstance._markForCheck();
         }
-        /**
-         * Returns the origin position and a fallback position based on the user's position preference.
-         * The fallback position is the inverse of the origin (e.g. `'below' -> 'above'`).
-         */
-        _getOrigin() {
-            const isLtr = !this._dir || this._dir.value == 'ltr';
-            const position = this.position;
-            let originPosition;
-            if (position == 'above' || position == 'below') {
-                originPosition = { originX: 'center', originY: position == 'above' ? 'top' : 'bottom' };
-            }
-            else if (position == 'before' ||
-                (position == 'left' && isLtr) ||
-                (position == 'right' && !isLtr)) {
-                originPosition = { originX: 'start', originY: 'center' };
-            }
-            else if (position == 'after' ||
-                (position == 'right' && isLtr) ||
-                (position == 'left' && !isLtr)) {
-                originPosition = { originX: 'end', originY: 'center' };
+    }
+    /** Inverts an overlay position. */
+    _invertPosition(x, y) {
+        if (this.position === 'above' || this.position === 'below') {
+            if (y === 'top') {
+                y = 'bottom';
             }
-            else {
-                throw getMatTooltipInvalidPositionError(position);
+            else if (y === 'bottom') {
+                y = 'top';
             }
-            const { x, y } = this._invertPosition(originPosition.originX, originPosition.originY);
-            return {
-                main: originPosition,
-                fallback: { originX: x, originY: y }
-            };
         }
-        /** Returns the overlay position and a fallback position based on the user's preference */
-        _getOverlayPosition() {
-            const isLtr = !this._dir || this._dir.value == 'ltr';
-            const position = this.position;
-            let overlayPosition;
-            if (position == 'above') {
-                overlayPosition = { overlayX: 'center', overlayY: 'bottom' };
+        else {
+            if (x === 'end') {
+                x = 'start';
             }
-            else if (position == 'below') {
-                overlayPosition = { overlayX: 'center', overlayY: 'top' };
+            else if (x === 'start') {
+                x = 'end';
             }
-            else if (position == 'before' ||
-                (position == 'left' && isLtr) ||
-                (position == 'right' && !isLtr)) {
-                overlayPosition = { overlayX: 'end', overlayY: 'center' };
-            }
-            else if (position == 'after' ||
-                (position == 'right' && isLtr) ||
-                (position == 'left' && !isLtr)) {
-                overlayPosition = { overlayX: 'start', overlayY: 'center' };
-            }
-            else {
-                throw getMatTooltipInvalidPositionError(position);
-            }
-            const { x, y } = this._invertPosition(overlayPosition.overlayX, overlayPosition.overlayY);
-            return {
-                main: overlayPosition,
-                fallback: { overlayX: x, overlayY: y }
-            };
         }
-        /** Updates the tooltip message and repositions the overlay according to the new message length */
-        _updateTooltipMessage() {
-            // Must wait for the message to be painted to the tooltip so that the overlay can properly
-            // calculate the correct positioning based on the size of the text.
-            if (this._tooltipInstance) {
-                this._tooltipInstance.message = this.message;
-                this._tooltipInstance._markForCheck();
-                this._ngZone.onMicrotaskEmpty.asObservable().pipe(take(1), takeUntil(this._destroyed)).subscribe(() => {
-                    if (this._tooltipInstance) {
-                        this._overlayRef.updatePosition();
-                    }
-                });
-            }
+        return { x, y };
+    }
+    /** Binds the pointer events to the tooltip trigger. */
+    _setupPointerEvents() {
+        // Optimization: Defer hooking up events if there's no message or the tooltip is disabled.
+        if (this._disabled || !this.message || !this._viewInitialized ||
+            this._passiveListeners.size) {
+            return;
         }
-        /** Updates the tooltip class */
-        _setTooltipClass(tooltipClass) {
-            if (this._tooltipInstance) {
-                this._tooltipInstance.tooltipClass = tooltipClass;
-                this._tooltipInstance._markForCheck();
-            }
+        // The mouse events shouldn't be bound on mobile devices, because they can prevent the
+        // first tap from firing its click event or can cause the tooltip to open for clicks.
+        if (!this._platform.IOS && !this._platform.ANDROID) {
+            this._passiveListeners
+                .set('mouseenter', () => this.show())
+                .set('mouseleave', () => this.hide());
         }
-        /** Inverts an overlay position. */
-        _invertPosition(x, y) {
-            if (this.position === 'above' || this.position === 'below') {
-                if (y === 'top') {
-                    y = 'bottom';
-                }
-                else if (y === 'bottom') {
-                    y = 'top';
-                }
-            }
-            else {
-                if (x === 'end') {
-                    x = 'start';
-                }
-                else if (x === 'start') {
-                    x = 'end';
-                }
-            }
-            return { x, y };
-        }
-        /** Binds the pointer events to the tooltip trigger. */
-        _setupPointerEvents() {
-            // The mouse events shouldn't be bound on mobile devices, because they can prevent the
-            // first tap from firing its click event or can cause the tooltip to open for clicks.
-            if (!this._platform.IOS && !this._platform.ANDROID) {
-                this._passiveListeners
-                    .set('mouseenter', () => this.show())
-                    .set('mouseleave', () => this.hide());
-            }
-            else if (this.touchGestures !== 'off') {
-                this._disableNativeGesturesIfNecessary();
-                const touchendListener = () => {
-                    clearTimeout(this._touchstartTimeout);
-                    this.hide(this._defaultOptions.touchendHideDelay);
-                };
-                this._passiveListeners
-                    .set('touchend', touchendListener)
-                    .set('touchcancel', touchendListener)
-                    .set('touchstart', () => {
-                    // Note that it's important that we don't `preventDefault` here,
-                    // because it can prevent click events from firing on the element.
-                    clearTimeout(this._touchstartTimeout);
-                    this._touchstartTimeout = setTimeout(() => this.show(), LONGPRESS_DELAY);
-                });
-            }
-            this._passiveListeners.forEach((listener, event) => {
-                this._elementRef.nativeElement.addEventListener(event, listener, passiveListenerOptions);
+        else if (this.touchGestures !== 'off') {
+            this._disableNativeGesturesIfNecessary();
+            const touchendListener = () => {
+                clearTimeout(this._touchstartTimeout);
+                this.hide(this._defaultOptions.touchendHideDelay);
+            };
+            this._passiveListeners
+                .set('touchend', touchendListener)
+                .set('touchcancel', touchendListener)
+                .set('touchstart', () => {
+                // Note that it's important that we don't `preventDefault` here,
+                // because it can prevent click events from firing on the element.
+                clearTimeout(this._touchstartTimeout);
+                this._touchstartTimeout = setTimeout(() => this.show(), LONGPRESS_DELAY);
             });
         }
-        /** Disables the native browser gestures, based on how the tooltip has been configured. */
-        _disableNativeGesturesIfNecessary() {
-            const element = this._elementRef.nativeElement;
-            const style = element.style;
-            const gestures = this.touchGestures;
-            if (gestures !== 'off') {
-                // If gestures are set to `auto`, we don't disable text selection on inputs and
-                // textareas, because it prevents the user from typing into them on iOS Safari.
-                if (gestures === 'on' || (element.nodeName !== 'INPUT' && element.nodeName !== 'TEXTAREA')) {
-                    style.userSelect = style.msUserSelect = style.webkitUserSelect =
-                        style.MozUserSelect = 'none';
-                }
-                // If we have `auto` gestures and the element uses native HTML dragging,
-                // we don't set `-webkit-user-drag` because it prevents the native behavior.
-                if (gestures === 'on' || !element.draggable) {
-                    style.webkitUserDrag = 'none';
-                }
-                style.touchAction = 'none';
-                style.webkitTapHighlightColor = 'transparent';
-            }
+        this._passiveListeners.forEach((listener, event) => {
+            this._elementRef.nativeElement.addEventListener(event, listener, passiveListenerOptions);
+        });
+    }
+    /** Disables the native browser gestures, based on how the tooltip has been configured. */
+    _disableNativeGesturesIfNecessary() {
+        const element = this._elementRef.nativeElement;
+        const style = element.style;
+        const gestures = this.touchGestures;
+        if (gestures !== 'off') {
+            // If gestures are set to `auto`, we don't disable text selection on inputs and
+            // textareas, because it prevents the user from typing into them on iOS Safari.
+            if (gestures === 'on' || (element.nodeName !== 'INPUT' && element.nodeName !== 'TEXTAREA')) {
+                style.userSelect = style.msUserSelect = style.webkitUserSelect =
+                    style.MozUserSelect = 'none';
+            }
+            // If we have `auto` gestures and the element uses native HTML dragging,
+            // we don't set `-webkit-user-drag` because it prevents the native behavior.
+            if (gestures === 'on' || !element.draggable) {
+                style.webkitUserDrag = 'none';
+            }
+            style.touchAction = 'none';
+            style.webkitTapHighlightColor = 'transparent';
         }
     }
-    MatTooltip.decorators = [
-        { type: Directive, args: [{
-                    selector: '[matTooltip]',
-                    exportAs: 'matTooltip',
-                    host: {
-                        'class': 'mat-tooltip-trigger'
-                    }
-                },] }
-    ];
-    MatTooltip.ctorParameters = () => [
-        { type: Overlay },
-        { type: ElementRef },
-        { type: ScrollDispatcher },
-        { type: ViewContainerRef },
-        { type: NgZone },
-        { type: Platform },
-        { type: AriaDescriber },
-        { type: FocusMonitor },
-        { type: undefined, decorators: [{ type: Inject, args: [MAT_TOOLTIP_SCROLL_STRATEGY,] }] },
-        { type: Directionality, decorators: [{ type: Optional }] },
-        { type: undefined, decorators: [{ type: Optional }, { type: Inject, args: [MAT_TOOLTIP_DEFAULT_OPTIONS,] }] }
-    ];
-    MatTooltip.propDecorators = {
-        position: [{ type: Input, args: ['matTooltipPosition',] }],
-        disabled: [{ type: Input, args: ['matTooltipDisabled',] }],
-        showDelay: [{ type: Input, args: ['matTooltipShowDelay',] }],
-        hideDelay: [{ type: Input, args: ['matTooltipHideDelay',] }],
-        touchGestures: [{ type: Input, args: ['matTooltipTouchGestures',] }],
-        message: [{ type: Input, args: ['matTooltip',] }],
-        tooltipClass: [{ type: Input, args: ['matTooltipClass',] }]
-    };
-    return MatTooltip;
-})();
+}
+MatTooltip.decorators = [
+    { type: Directive, args: [{
+                selector: '[matTooltip]',
+                exportAs: 'matTooltip',
+                host: {
+                    'class': 'mat-tooltip-trigger'
+                }
+            },] }
+];
+MatTooltip.ctorParameters = () => [
+    { type: Overlay },
+    { type: ElementRef },
+    { type: ScrollDispatcher },
+    { type: ViewContainerRef },
+    { type: NgZone },
+    { type: Platform },
+    { type: AriaDescriber },
+    { type: FocusMonitor },
+    { type: undefined, decorators: [{ type: Inject, args: [MAT_TOOLTIP_SCROLL_STRATEGY,] }] },
+    { type: Directionality, decorators: [{ type: Optional }] },
+    { type: undefined, decorators: [{ type: Optional }, { type: Inject, args: [MAT_TOOLTIP_DEFAULT_OPTIONS,] }] }
+];
+MatTooltip.propDecorators = {
+    position: [{ type: Input, args: ['matTooltipPosition',] }],
+    disabled: [{ type: Input, args: ['matTooltipDisabled',] }],
+    showDelay: [{ type: Input, args: ['matTooltipShowDelay',] }],
+    hideDelay: [{ type: Input, args: ['matTooltipHideDelay',] }],
+    touchGestures: [{ type: Input, args: ['matTooltipTouchGestures',] }],
+    message: [{ type: Input, args: ['matTooltip',] }],
+    tooltipClass: [{ type: Input, args: ['matTooltipClass',] }]
+};
 /**
  * Internal component that wraps the tooltip's content.
  * @docs-private
  */
-let TooltipComponent = /** @class */ (() => {
-    class TooltipComponent {
-        constructor(_changeDetectorRef, _breakpointObserver) {
-            this._changeDetectorRef = _changeDetectorRef;
-            this._breakpointObserver = _breakpointObserver;
-            /** Property watched by the animation framework to show or hide the tooltip */
-            this._visibility = 'initial';
-            /** Whether interactions on the page should close the tooltip */
-            this._closeOnInteraction = false;
-            /** Subject for notifying that the tooltip has been hidden from the view */
-            this._onHide = new Subject();
-            /** Stream that emits whether the user has a handset-sized display.  */
-            this._isHandset = this._breakpointObserver.observe(Breakpoints.Handset);
+class TooltipComponent {
+    constructor(_changeDetectorRef, _breakpointObserver) {
+        this._changeDetectorRef = _changeDetectorRef;
+        this._breakpointObserver = _breakpointObserver;
+        /** Property watched by the animation framework to show or hide the tooltip */
+        this._visibility = 'initial';
+        /** Whether interactions on the page should close the tooltip */
+        this._closeOnInteraction = false;
+        /** Subject for notifying that the tooltip has been hidden from the view */
+        this._onHide = new Subject();
+        /** Stream that emits whether the user has a handset-sized display.  */
+        this._isHandset = this._breakpointObserver.observe(Breakpoints.Handset);
+    }
+    /**
+     * Shows the tooltip with an animation originating from the provided origin
+     * @param delay Amount of milliseconds to the delay showing the tooltip.
+     */
+    show(delay) {
+        // Cancel the delayed hide if it is scheduled
+        if (this._hideTimeoutId) {
+            clearTimeout(this._hideTimeoutId);
+            this._hideTimeoutId = null;
         }
-        /**
-         * Shows the tooltip with an animation originating from the provided origin
-         * @param delay Amount of milliseconds to the delay showing the tooltip.
-         */
-        show(delay) {
-            // Cancel the delayed hide if it is scheduled
-            if (this._hideTimeoutId) {
-                clearTimeout(this._hideTimeoutId);
-                this._hideTimeoutId = null;
-            }
-            // Body interactions should cancel the tooltip if there is a delay in showing.
-            this._closeOnInteraction = true;
-            this._showTimeoutId = setTimeout(() => {
-                this._visibility = 'visible';
-                this._showTimeoutId = null;
-                // Mark for check so if any parent component has set the
-                // ChangeDetectionStrategy to OnPush it will be checked anyways
-                this._markForCheck();
-            }, delay);
+        // Body interactions should cancel the tooltip if there is a delay in showing.
+        this._closeOnInteraction = true;
+        this._showTimeoutId = setTimeout(() => {
+            this._visibility = 'visible';
+            this._showTimeoutId = null;
+            // Mark for check so if any parent component has set the
+            // ChangeDetectionStrategy to OnPush it will be checked anyways
+            this._markForCheck();
+        }, delay);
+    }
+    /**
+     * Begins the animation to hide the tooltip after the provided delay in ms.
+     * @param delay Amount of milliseconds to delay showing the tooltip.
+     */
+    hide(delay) {
+        // Cancel the delayed show if it is scheduled
+        if (this._showTimeoutId) {
+            clearTimeout(this._showTimeoutId);
+            this._showTimeoutId = null;
         }
-        /**
-         * Begins the animation to hide the tooltip after the provided delay in ms.
-         * @param delay Amount of milliseconds to delay showing the tooltip.
-         */
-        hide(delay) {
-            // Cancel the delayed show if it is scheduled
-            if (this._showTimeoutId) {
-                clearTimeout(this._showTimeoutId);
-                this._showTimeoutId = null;
-            }
-            this._hideTimeoutId = setTimeout(() => {
-                this._visibility = 'hidden';
-                this._hideTimeoutId = null;
-                // Mark for check so if any parent component has set the
-                // ChangeDetectionStrategy to OnPush it will be checked anyways
-                this._markForCheck();
-            }, delay);
-        }
-        /** Returns an observable that notifies when the tooltip has been hidden from view. */
-        afterHidden() {
-            return this._onHide.asObservable();
-        }
-        /** Whether the tooltip is being displayed. */
-        isVisible() {
-            return this._visibility === 'visible';
-        }
-        ngOnDestroy() {
-            this._onHide.complete();
-        }
-        _animationStart() {
-            this._closeOnInteraction = false;
-        }
-        _animationDone(event) {
-            const toState = event.toState;
-            if (toState === 'hidden' && !this.isVisible()) {
-                this._onHide.next();
-            }
-            if (toState === 'visible' || toState === 'hidden') {
-                this._closeOnInteraction = true;
-            }
+        this._hideTimeoutId = setTimeout(() => {
+            this._visibility = 'hidden';
+            this._hideTimeoutId = null;
+            // Mark for check so if any parent component has set the
+            // ChangeDetectionStrategy to OnPush it will be checked anyways
+            this._markForCheck();
+        }, delay);
+    }
+    /** Returns an observable that notifies when the tooltip has been hidden from view. */
+    afterHidden() {
+        return this._onHide.asObservable();
+    }
+    /** Whether the tooltip is being displayed. */
+    isVisible() {
+        return this._visibility === 'visible';
+    }
+    ngOnDestroy() {
+        this._onHide.complete();
+    }
+    _animationStart() {
+        this._closeOnInteraction = false;
+    }
+    _animationDone(event) {
+        const toState = event.toState;
+        if (toState === 'hidden' && !this.isVisible()) {
+            this._onHide.next();
         }
-        /**
-         * Interactions on the HTML body should close the tooltip immediately as defined in the
-         * material design spec.
-         * https://material.io/design/components/tooltips.html#behavior
-         */
-        _handleBodyInteraction() {
-            if (this._closeOnInteraction) {
-                this.hide(0);
-            }
+        if (toState === 'visible' || toState === 'hidden') {
+            this._closeOnInteraction = true;
         }
-        /**
-         * Marks that the tooltip needs to be checked in the next change detection run.
-         * Mainly used for rendering the initial text before positioning a tooltip, which
-         * can be problematic in components with OnPush change detection.
-         */
-        _markForCheck() {
-            this._changeDetectorRef.markForCheck();
+    }
+    /**
+     * Interactions on the HTML body should close the tooltip immediately as defined in the
+     * material design spec.
+     * https://material.io/design/components/tooltips.html#behavior
+     */
+    _handleBodyInteraction() {
+        if (this._closeOnInteraction) {
+            this.hide(0);
         }
     }
-    TooltipComponent.decorators = [
-        { type: Component, args: [{
-                    selector: 'mat-tooltip-component',
-                    template: "<div class=\"mat-tooltip\"\n     [ngClass]=\"tooltipClass\"\n     [class.mat-tooltip-handset]=\"(_isHandset | async)?.matches\"\n     [@state]=\"_visibility\"\n     (@state.start)=\"_animationStart()\"\n     (@state.done)=\"_animationDone($event)\">{{message}}</div>\n",
-                    encapsulation: ViewEncapsulation.None,
-                    changeDetection: ChangeDetectionStrategy.OnPush,
-                    animations: [matTooltipAnimations.tooltipState],
-                    host: {
-                        // Forces the element to have a layout in IE and Edge. This fixes issues where the element
-                        // won't be rendered if the animations are disabled or there is no web animations polyfill.
-                        '[style.zoom]': '_visibility === "visible" ? 1 : null',
-                        '(body:click)': 'this._handleBodyInteraction()',
-                        'aria-hidden': 'true',
-                    },
-                    styles: [".mat-tooltip-panel{pointer-events:none !important}.mat-tooltip{color:#fff;border-radius:4px;margin:14px;max-width:250px;padding-left:8px;padding-right:8px;overflow:hidden;text-overflow:ellipsis}.cdk-high-contrast-active .mat-tooltip{outline:solid 1px}.mat-tooltip-handset{margin:24px;padding-left:16px;padding-right:16px}\n"]
-                },] }
-    ];
-    TooltipComponent.ctorParameters = () => [
-        { type: ChangeDetectorRef },
-        { type: BreakpointObserver }
-    ];
-    return TooltipComponent;
-})();
+    /**
+     * Marks that the tooltip needs to be checked in the next change detection run.
+     * Mainly used for rendering the initial text before positioning a tooltip, which
+     * can be problematic in components with OnPush change detection.
+     */
+    _markForCheck() {
+        this._changeDetectorRef.markForCheck();
+    }
+}
+TooltipComponent.decorators = [
+    { type: Component, args: [{
+                selector: 'mat-tooltip-component',
+                template: "<div class=\"mat-tooltip\"\n     [ngClass]=\"tooltipClass\"\n     [class.mat-tooltip-handset]=\"(_isHandset | async)?.matches\"\n     [@state]=\"_visibility\"\n     (@state.start)=\"_animationStart()\"\n     (@state.done)=\"_animationDone($event)\">{{message}}</div>\n",
+                encapsulation: ViewEncapsulation.None,
+                changeDetection: ChangeDetectionStrategy.OnPush,
+                animations: [matTooltipAnimations.tooltipState],
+                host: {
+                    // Forces the element to have a layout in IE and Edge. This fixes issues where the element
+                    // won't be rendered if the animations are disabled or there is no web animations polyfill.
+                    '[style.zoom]': '_visibility === "visible" ? 1 : null',
+                    '(body:click)': 'this._handleBodyInteraction()',
+                    'aria-hidden': 'true',
+                },
+                styles: [".mat-tooltip-panel{pointer-events:none !important}.mat-tooltip{color:#fff;border-radius:4px;margin:14px;max-width:250px;padding-left:8px;padding-right:8px;overflow:hidden;text-overflow:ellipsis}.cdk-high-contrast-active .mat-tooltip{outline:solid 1px}.mat-tooltip-handset{margin:24px;padding-left:16px;padding-right:16px}\n"]
+            },] }
+];
+TooltipComponent.ctorParameters = () => [
+    { type: ChangeDetectorRef },
+    { type: BreakpointObserver }
+];
 
 /**
  * @license
@@ -636,25 +643,22 @@ let TooltipComponent = /** @class */ (() => {
  * 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
  */
-let MatTooltipModule = /** @class */ (() => {
-    class MatTooltipModule {
-    }
-    MatTooltipModule.decorators = [
-        { type: NgModule, args: [{
-                    imports: [
-                        A11yModule,
-                        CommonModule,
-                        OverlayModule,
-                        MatCommonModule,
-                    ],
-                    exports: [MatTooltip, TooltipComponent, MatCommonModule, CdkScrollableModule],
-                    declarations: [MatTooltip, TooltipComponent],
-                    entryComponents: [TooltipComponent],
-                    providers: [MAT_TOOLTIP_SCROLL_STRATEGY_FACTORY_PROVIDER]
-                },] }
-    ];
-    return MatTooltipModule;
-})();
+class MatTooltipModule {
+}
+MatTooltipModule.decorators = [
+    { type: NgModule, args: [{
+                imports: [
+                    A11yModule,
+                    CommonModule,
+                    OverlayModule,
+                    MatCommonModule,
+                ],
+                exports: [MatTooltip, TooltipComponent, MatCommonModule, CdkScrollableModule],
+                declarations: [MatTooltip, TooltipComponent],
+                entryComponents: [TooltipComponent],
+                providers: [MAT_TOOLTIP_SCROLL_STRATEGY_FACTORY_PROVIDER]
+            },] }
+];
 
 /**
  * @license