@angular/cdk 9.1.2 → 9.2.1

package/fesm2015/a11y.js

@@ -2653,6 +2653,31 @@ if (false) {
     CdkAriaLive.prototype._ngZone;
 }
 
+/**
+ * @fileoverview added by tsickle
+ * Generated from: src/cdk/a11y/fake-mousedown.ts
+ * @suppress {checkTypes,constantProperty,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
+ */
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * 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
+ */
+/**
+ * Screenreaders will often fire fake mousedown events when a focusable element
+ * is activated using the keyboard. We can typically distinguish between these faked
+ * mousedown events and real mousedown events using the "buttons" property. While
+ * real mousedowns will indicate the mouse button that was pressed (e.g. "1" for
+ * the left mouse button), faked mousedowns will usually set the property value to 0.
+ * @param {?} event
+ * @return {?}
+ */
+function isFakeMousedownFromScreenReader(event) {
+    return event.buttons === 0;
+}
+
 /**
  * @fileoverview added by tsickle
  * Generated from: src/cdk/a11y/focus-monitor/focus-monitor.ts
@@ -2675,6 +2700,34 @@ if (false) {
      */
     FocusOptions.prototype.preventScroll;
 }
+/** @enum {number} */
+const FocusMonitorDetectionMode = {
+    /**
+     * Any mousedown, keydown, or touchstart event that happened in the previous
+     * tick or the current tick will be used to assign a focus event's origin (to
+     * either mouse, keyboard, or touch). This is the default option.
+     */
+    IMMEDIATE: 0,
+    /**
+     * A focus event's origin is always attributed to the last corresponding
+     * mousedown, keydown, or touchstart event, no matter how long ago it occured.
+     */
+    EVENTUAL: 1,
+};
+/**
+ * Injectable service-level options for FocusMonitor.
+ * @record
+ */
+function FocusMonitorOptions() { }
+if (false) {
+    /** @type {?|undefined} */
+    FocusMonitorOptions.prototype.detectionMode;
+}
+/**
+ * InjectionToken for FocusMonitorOptions.
+ * @type {?}
+ */
+const FOCUS_MONITOR_DEFAULT_OPTIONS = new InjectionToken('cdk-focus-monitor-default-options');
 /**
  * Event listener options that enable capturing and also
  * mark the listener as passive if the browser supports it.
@@ -2691,8 +2744,12 @@ class FocusMonitor {
     /**
      * @param {?} _ngZone
      * @param {?} _platform
+     * @param {?} document
+     * @param {?} options
      */
-    constructor(_ngZone, _platform) {
+    constructor(_ngZone, _platform, 
+    /** @breaking-change 11.0.0 make document required */
+    document, options) {
         this._ngZone = _ngZone;
         this._platform = _platform;
         /**
@@ -2728,13 +2785,18 @@ class FocusMonitor {
          * Needs to be an arrow function in order to preserve the context when it gets bound.
          */
         this._documentMousedownListener = (/**
+         * @param {?} event
          * @return {?}
          */
-        () => {
+        (event) => {
             // On mousedown record the origin only if there is not touch
             // target, since a mousedown can happen as a result of a touch event.
             if (!this._lastTouchTarget) {
-                this._setOriginForCurrentEventQueue('mouse');
+                // In some cases screen readers fire fake `mousedown` events instead of `keydown`.
+                // Resolve the focus source to `keyboard` if we detect one of them.
+                /** @type {?} */
+                const source = isFakeMousedownFromScreenReader(event) ? 'keyboard' : 'mouse';
+                this._setOriginForCurrentEventQueue(source);
             }
         });
         /**
@@ -2777,6 +2839,26 @@ class FocusMonitor {
              */
             () => this._windowFocused = false));
         });
+        /**
+         * Event listener for `focus` and 'blur' events on the document.
+         * Needs to be an arrow function in order to preserve the context when it gets bound.
+         */
+        this._documentFocusAndBlurListener = (/**
+         * @param {?} event
+         * @return {?}
+         */
+        (event) => {
+            /** @type {?} */
+            const target = (/** @type {?} */ (event.target));
+            /** @type {?} */
+            const handler = event.type === 'focus' ? this._onFocus : this._onBlur;
+            // We need to walk up the ancestor chain in order to support `checkChildren`.
+            for (let el = target; el; el = el.parentElement) {
+                handler.call(this, event, el);
+            }
+        });
+        this._document = document;
+        this._detectionMode = (options === null || options === void 0 ? void 0 : options.detectionMode) || 0 /* IMMEDIATE */;
     }
     /**
      * @param {?} element
@@ -2793,50 +2875,18 @@ class FocusMonitor {
         // Check if we're already monitoring this element.
         if (this._elementInfo.has(nativeElement)) {
             /** @type {?} */
-            let cachedInfo = this._elementInfo.get(nativeElement);
+            const cachedInfo = this._elementInfo.get(nativeElement);
             (/** @type {?} */ (cachedInfo)).checkChildren = checkChildren;
             return (/** @type {?} */ (cachedInfo)).subject.asObservable();
         }
         // Create monitored element info.
         /** @type {?} */
-        let info = {
-            unlisten: (/**
-             * @return {?}
-             */
-            () => { }),
+        const info = {
             checkChildren: checkChildren,
             subject: new Subject()
         };
         this._elementInfo.set(nativeElement, info);
         this._incrementMonitoredElementCount();
-        // Start listening. We need to listen in capture phase since focus events don't bubble.
-        /** @type {?} */
-        let focusListener = (/**
-         * @param {?} event
-         * @return {?}
-         */
-        (event) => this._onFocus(event, nativeElement));
-        /** @type {?} */
-        let blurListener = (/**
-         * @param {?} event
-         * @return {?}
-         */
-        (event) => this._onBlur(event, nativeElement));
-        this._ngZone.runOutsideAngular((/**
-         * @return {?}
-         */
-        () => {
-            nativeElement.addEventListener('focus', focusListener, true);
-            nativeElement.addEventListener('blur', blurListener, true);
-        }));
-        // Create an unlisten function for later.
-        info.unlisten = (/**
-         * @return {?}
-         */
-        () => {
-            nativeElement.removeEventListener('focus', focusListener, true);
-            nativeElement.removeEventListener('blur', blurListener, true);
-        });
         return info.subject.asObservable();
     }
     /**
@@ -2849,7 +2899,6 @@ class FocusMonitor {
         /** @type {?} */
         const elementInfo = this._elementInfo.get(nativeElement);
         if (elementInfo) {
-            elementInfo.unlisten();
             elementInfo.subject.complete();
             this._setClasses(nativeElement);
             this._elementInfo.delete(nativeElement);
@@ -2883,6 +2932,24 @@ class FocusMonitor {
          */
         (_info, element) => this.stopMonitoring(element)));
     }
+    /**
+     * Access injected document if available or fallback to global document reference
+     * @private
+     * @return {?}
+     */
+    _getDocument() {
+        return this._document || document;
+    }
+    /**
+     * Use defaultView of injected document if available or fallback to global window reference
+     * @private
+     * @return {?}
+     */
+    _getWindow() {
+        /** @type {?} */
+        const doc = this._getDocument();
+        return doc.defaultView || window;
+    }
     /**
      * @private
      * @param {?} element
@@ -2898,6 +2965,31 @@ class FocusMonitor {
             element.classList.remove(className);
         }
     }
+    /**
+     * @private
+     * @param {?} event
+     * @return {?}
+     */
+    _getFocusOrigin(event) {
+        // If we couldn't detect a cause for the focus event, it's due to one of three reasons:
+        // 1) The window has just regained focus, in which case we want to restore the focused state of
+        //    the element from before the window blurred.
+        // 2) It was caused by a touch event, in which case we mark the origin as 'touch'.
+        // 3) The element was programmatically focused, in which case we should mark the origin as
+        //    'program'.
+        if (this._origin) {
+            return this._origin;
+        }
+        if (this._windowFocused && this._lastFocusOrigin) {
+            return this._lastFocusOrigin;
+        }
+        else if (this._wasCausedByTouch(event)) {
+            return 'touch';
+        }
+        else {
+            return 'program';
+        }
+    }
     /**
      * Sets the focus classes on the element based on the given focus origin.
      * @private
@@ -2906,18 +2998,15 @@ class FocusMonitor {
      * @return {?}
      */
     _setClasses(element, origin) {
-        /** @type {?} */
-        const elementInfo = this._elementInfo.get(element);
-        if (elementInfo) {
-            this._toggleClass(element, 'cdk-focused', !!origin);
-            this._toggleClass(element, 'cdk-touch-focused', origin === 'touch');
-            this._toggleClass(element, 'cdk-keyboard-focused', origin === 'keyboard');
-            this._toggleClass(element, 'cdk-mouse-focused', origin === 'mouse');
-            this._toggleClass(element, 'cdk-program-focused', origin === 'program');
-        }
+        this._toggleClass(element, 'cdk-focused', !!origin);
+        this._toggleClass(element, 'cdk-touch-focused', origin === 'touch');
+        this._toggleClass(element, 'cdk-keyboard-focused', origin === 'keyboard');
+        this._toggleClass(element, 'cdk-mouse-focused', origin === 'mouse');
+        this._toggleClass(element, 'cdk-program-focused', origin === 'program');
     }
     /**
      * Sets the origin and schedules an async function to clear it at the end of the event queue.
+     * If the detection mode is 'eventual', the origin is never cleared.
      * @private
      * @param {?} origin The origin to set.
      * @return {?}
@@ -2928,13 +3017,15 @@ class FocusMonitor {
          */
         () => {
             this._origin = origin;
-            // Sometimes the focus origin won't be valid in Firefox because Firefox seems to focus *one*
-            // tick after the interaction event fired. To ensure the focus origin is always correct,
-            // the focus origin will be determined at the beginning of the next tick.
-            this._originTimeoutId = setTimeout((/**
-             * @return {?}
-             */
-            () => this._origin = null), 1);
+            if (this._detectionMode === 0 /* IMMEDIATE */) {
+                // Sometimes the focus origin won't be valid in Firefox because Firefox seems to focus *one*
+                // tick after the interaction event fired. To ensure the focus origin is always correct,
+                // the focus origin will be determined at the beginning of the next tick.
+                this._originTimeoutId = setTimeout((/**
+                 * @return {?}
+                 */
+                () => this._origin = null), 1);
+            }
         }));
     }
     /**
@@ -2989,25 +3080,8 @@ class FocusMonitor {
         if (!elementInfo || (!elementInfo.checkChildren && element !== event.target)) {
             return;
         }
-        // If we couldn't detect a cause for the focus event, it's due to one of three reasons:
-        // 1) The window has just regained focus, in which case we want to restore the focused state of
-        //    the element from before the window blurred.
-        // 2) It was caused by a touch event, in which case we mark the origin as 'touch'.
-        // 3) The element was programmatically focused, in which case we should mark the origin as
-        //    'program'.
         /** @type {?} */
-        let origin = this._origin;
-        if (!origin) {
-            if (this._windowFocused && this._lastFocusOrigin) {
-                origin = this._lastFocusOrigin;
-            }
-            else if (this._wasCausedByTouch(event)) {
-                origin = 'touch';
-            }
-            else {
-                origin = 'program';
-            }
-        }
+        const origin = this._getFocusOrigin(event);
         this._setClasses(element, origin);
         this._emitOrigin(elementInfo.subject, origin);
         this._lastFocusOrigin = origin;
@@ -3055,6 +3129,12 @@ class FocusMonitor {
              * @return {?}
              */
             () => {
+                /** @type {?} */
+                const document = this._getDocument();
+                /** @type {?} */
+                const window = this._getWindow();
+                document.addEventListener('focus', this._documentFocusAndBlurListener, captureEventListenerOptions);
+                document.addEventListener('blur', this._documentFocusAndBlurListener, captureEventListenerOptions);
                 document.addEventListener('keydown', this._documentKeydownListener, captureEventListenerOptions);
                 document.addEventListener('mousedown', this._documentMousedownListener, captureEventListenerOptions);
                 document.addEventListener('touchstart', this._documentTouchstartListener, captureEventListenerOptions);
@@ -3069,6 +3149,12 @@ class FocusMonitor {
     _decrementMonitoredElementCount() {
         // Unregister global listeners when last element is unmonitored.
         if (!--this._monitoredElementCount) {
+            /** @type {?} */
+            const document = this._getDocument();
+            /** @type {?} */
+            const window = this._getWindow();
+            document.removeEventListener('focus', this._documentFocusAndBlurListener, captureEventListenerOptions);
+            document.removeEventListener('blur', this._documentFocusAndBlurListener, captureEventListenerOptions);
             document.removeEventListener('keydown', this._documentKeydownListener, captureEventListenerOptions);
             document.removeEventListener('mousedown', this._documentMousedownListener, captureEventListenerOptions);
             document.removeEventListener('touchstart', this._documentTouchstartListener, captureEventListenerOptions);
@@ -3086,9 +3172,11 @@ FocusMonitor.decorators = [
 /** @nocollapse */
 FocusMonitor.ctorParameters = () => [
     { type: NgZone },
-    { type: Platform }
+    { type: Platform },
+    { type: undefined, decorators: [{ type: Optional }, { type: Inject, args: [DOCUMENT,] }] },
+    { type: undefined, decorators: [{ type: Optional }, { type: Inject, args: [FOCUS_MONITOR_DEFAULT_OPTIONS,] }] }
 ];
-/** @nocollapse */ FocusMonitor.ɵprov = ɵɵdefineInjectable({ factory: function FocusMonitor_Factory() { return new FocusMonitor(ɵɵinject(NgZone), ɵɵinject(Platform)); }, token: FocusMonitor, providedIn: "root" });
+/** @nocollapse */ FocusMonitor.ɵprov = ɵɵdefineInjectable({ factory: function FocusMonitor_Factory() { return new FocusMonitor(ɵɵinject(NgZone), ɵɵinject(Platform), ɵɵinject(DOCUMENT, 8), ɵɵinject(FOCUS_MONITOR_DEFAULT_OPTIONS, 8)); }, token: FocusMonitor, providedIn: "root" });
 if (false) {
     /**
      * The focus origin that the next focus event is a result of.
@@ -3144,6 +3232,13 @@ if (false) {
      * @private
      */
     FocusMonitor.prototype._monitoredElementCount;
+    /**
+     * The specified detection mode, used for attributing the origin of a focus
+     * event.
+     * @type {?}
+     * @private
+     */
+    FocusMonitor.prototype._detectionMode;
     /**
      * Event listener for `keydown` events on the document.
      * Needs to be an arrow function in order to preserve the context when it gets bound.
@@ -3172,6 +3267,19 @@ if (false) {
      * @private
      */
     FocusMonitor.prototype._windowFocusListener;
+    /**
+     * Used to reference correct document/window
+     * @type {?}
+     * @protected
+     */
+    FocusMonitor.prototype._document;
+    /**
+     * Event listener for `focus` and 'blur' events on the document.
+     * Needs to be an arrow function in order to preserve the context when it gets bound.
+     * @type {?}
+     * @private
+     */
+    FocusMonitor.prototype._documentFocusAndBlurListener;
     /**
      * @type {?}
      * @private
@@ -3249,31 +3357,6 @@ if (false) {
     CdkMonitorFocus.prototype._focusMonitor;
 }
 
-/**
- * @fileoverview added by tsickle
- * Generated from: src/cdk/a11y/fake-mousedown.ts
- * @suppress {checkTypes,constantProperty,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
- */
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * 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
- */
-/**
- * Screenreaders will often fire fake mousedown events when a focusable element
- * is activated using the keyboard. We can typically distinguish between these faked
- * mousedown events and real mousedown events using the "buttons" property. While
- * real mousedowns will indicate the mouse button that was pressed (e.g. "1" for
- * the left mouse button), faked mousedowns will usually set the property value to 0.
- * @param {?} event
- * @return {?}
- */
-function isFakeMousedownFromScreenReader(event) {
-    return event.buttons === 0;
-}
-
 /**
  * @fileoverview added by tsickle
  * Generated from: src/cdk/a11y/high-contrast-mode/high-contrast-mode-detector.ts
@@ -3338,11 +3421,15 @@ class HighContrastModeDetector {
         this._document.body.appendChild(testElement);
         // Get the computed style for the background color, collapsing spaces to normalize between
         // browsers. Once we get this color, we no longer need the test element. Access the `window`
-        // via the document so we can fake it in tests.
+        // via the document so we can fake it in tests. Note that we have extra null checks, because
+        // this logic will likely run during app bootstrap and throwing can break the entire app.
+        /** @type {?} */
+        const documentWindow = this._document.defaultView || window;
         /** @type {?} */
-        const documentWindow = (/** @type {?} */ (this._document.defaultView));
+        const computedStyle = (documentWindow && documentWindow.getComputedStyle) ?
+            documentWindow.getComputedStyle(testElement) : null;
         /** @type {?} */
-        const computedColor = (documentWindow.getComputedStyle(testElement).backgroundColor || '').replace(/ /g, '');
+        const computedColor = (computedStyle && computedStyle.backgroundColor || '').replace(/ /g, '');
         this._document.body.removeChild(testElement);
         switch (computedColor) {
             case 'rgb(0,0,0)': return 2 /* WHITE_ON_BLACK */;
@@ -3432,5 +3519,5 @@ A11yModule.ctorParameters = () => [
  * Generated bundle index. Do not edit.
  */
 
-export { A11yModule, ActiveDescendantKeyManager, AriaDescriber, CDK_DESCRIBEDBY_HOST_ATTRIBUTE, CDK_DESCRIBEDBY_ID_PREFIX, CdkAriaLive, CdkMonitorFocus, CdkTrapFocus, ConfigurableFocusTrap, ConfigurableFocusTrapFactory, EventListenerFocusTrapInertStrategy, FOCUS_TRAP_INERT_STRATEGY, FocusKeyManager, FocusMonitor, FocusTrap, FocusTrapFactory, HighContrastModeDetector, InteractivityChecker, LIVE_ANNOUNCER_DEFAULT_OPTIONS, LIVE_ANNOUNCER_ELEMENT_TOKEN, LIVE_ANNOUNCER_ELEMENT_TOKEN_FACTORY, ListKeyManager, LiveAnnouncer, MESSAGES_CONTAINER_ID, TOUCH_BUFFER_MS, isFakeMousedownFromScreenReader, FocusTrapManager as ɵangular_material_src_cdk_a11y_a11y_a, ConfigurableFocusTrapConfig as ɵangular_material_src_cdk_a11y_a11y_b };
+export { A11yModule, ActiveDescendantKeyManager, AriaDescriber, CDK_DESCRIBEDBY_HOST_ATTRIBUTE, CDK_DESCRIBEDBY_ID_PREFIX, CdkAriaLive, CdkMonitorFocus, CdkTrapFocus, ConfigurableFocusTrap, ConfigurableFocusTrapFactory, EventListenerFocusTrapInertStrategy, FOCUS_MONITOR_DEFAULT_OPTIONS, FOCUS_TRAP_INERT_STRATEGY, FocusKeyManager, FocusMonitor, FocusTrap, FocusTrapFactory, HighContrastModeDetector, InteractivityChecker, LIVE_ANNOUNCER_DEFAULT_OPTIONS, LIVE_ANNOUNCER_ELEMENT_TOKEN, LIVE_ANNOUNCER_ELEMENT_TOKEN_FACTORY, ListKeyManager, LiveAnnouncer, MESSAGES_CONTAINER_ID, TOUCH_BUFFER_MS, isFakeMousedownFromScreenReader, FocusTrapManager as ɵangular_material_src_cdk_a11y_a11y_a, ConfigurableFocusTrapConfig as ɵangular_material_src_cdk_a11y_a11y_b };
 //# sourceMappingURL=a11y.js.map