@ionic/core 7.5.8-dev.11704294569.1abc989d → 7.5.8-dev.11705350665.1a40ee3a

package/dist/collection/utils/transition/index.js

@@ -2,7 +2,9 @@
  * (C) Ionic http://ionicframework.com - MIT License
  */
 import { Build, writeTask } from "@stencil/core";
+import { printIonWarning } from "../logging/index";
 import { LIFECYCLE_DID_ENTER, LIFECYCLE_DID_LEAVE, LIFECYCLE_WILL_ENTER, LIFECYCLE_WILL_LEAVE, } from "../../components/nav/constants";
+import { config } from "../../global/config";
 import { raf } from "../helpers";
 const iosTransitionAnimation = () => import('./ios.transition');
 const mdTransitionAnimation = () => import('./md.transition');
@@ -24,9 +26,23 @@ export const transition = (opts) => {
         });
     });
 };
+const LAST_FOCUS = 'ion-last-focus';
 const beforeTransition = (opts) => {
     const enteringEl = opts.enteringEl;
     const leavingEl = opts.leavingEl;
+    const focusManagerEnabled = config.get('experimentalFocusManagerPriority', false);
+    /**
+     * When going back to a previously visited page
+     * focus should typically be moved back to the
+     * element that was last focused when the user
+     * was on this view.
+     */
+    if (focusManagerEnabled) {
+        const activeEl = document.activeElement;
+        if (activeEl !== null && (leavingEl === null || leavingEl === void 0 ? void 0 : leavingEl.contains(activeEl))) {
+            activeEl.setAttribute(LAST_FOCUS, 'true');
+        }
+    }
     setZIndex(enteringEl, leavingEl, opts.direction);
     if (opts.showGoBack) {
         enteringEl.classList.add('can-go-back');
@@ -52,6 +68,18 @@ const runTransition = async (opts) => {
     const ani = animationBuilder && Build.isBrowser ? animation(animationBuilder, opts) : noAnimation(opts); // fast path for no animation
     return ani;
 };
+/**
+ * Moves focus to a specified element.
+ * Note that we do not remove the tabindex
+ * because that can result in an unintentional
+ * blur. Non-focusables can't be focused, so the
+ * body will get focused again.
+ */
+const moveFocus = (el) => {
+    el.tabIndex = -1;
+    el.focus();
+    console.log('focus', el);
+};
 const afterTransition = (opts) => {
     const enteringEl = opts.enteringEl;
     const leavingEl = opts.leavingEl;
@@ -61,6 +89,69 @@ const afterTransition = (opts) => {
         leavingEl.classList.remove('ion-page-invisible');
         leavingEl.style.removeProperty('pointer-events');
     }
+    const focusManagerPriorities = config.get('experimentalFocusManagerPriority', false);
+    if (Array.isArray(focusManagerPriorities) && !enteringEl.contains(document.activeElement)) {
+        /**
+         * When going back to a previously visited view
+         * focus should always be moved back to the element
+         * that the user was last focused on when they were on this view.
+         */
+        const lastFocus = enteringEl.querySelector(`[${LAST_FOCUS}]`);
+        if (lastFocus) {
+            moveFocus(lastFocus);
+            return;
+        }
+        for (const priority of focusManagerPriorities) {
+            switch (priority) {
+                case 'content':
+                    /**
+                     * If no level one heading exists then we should at least focus the
+                     * header so focus starts at the top of the page.
+                     */
+                    const content = enteringEl.querySelector('main, [role="main"]');
+                    if (content) {
+                        moveFocus(content);
+                        return;
+                    }
+                    break;
+                case 'heading':
+                    /**
+                     * If no last focus exists then we should prefer to focus
+                     * level one headings. We do not prioritize the header yet
+                     * because the header can have non-title elements such as
+                     * a back button which is not necessarily helpful
+                     * to focus first.
+                     */
+                    const headingOne = enteringEl.querySelector('h1, [role="heading"][aria-level="1"]');
+                    if (headingOne) {
+                        moveFocus(headingOne);
+                        return;
+                    }
+                    break;
+                case 'banner':
+                    /**
+                     * If no level one heading exists then we should at least focus the
+                     * header so focus starts at the top of the page.
+                     */
+                    const header = enteringEl.querySelector('header, [role="banner"]');
+                    if (header) {
+                        moveFocus(header);
+                        return;
+                    }
+                    break;
+                default:
+                    printIonWarning(`Unrecognized focus manager priority value ${priority}`);
+                    break;
+            }
+        }
+        /**
+         * If there is no header then focus the page
+         * so focus at least moves to the correct view.
+         * The browser will then determine where within the
+         * page to move focus to.
+         */
+        moveFocus(enteringEl);
+    }
 };
 const getAnimationBuilder = async (opts) => {
     if (!opts.leavingEl || !opts.animated || opts.duration === 0) {