@ionic/core 8.7.5-nightly.20250924 → 8.7.5

package/components/modal.js

@@ -984,6 +984,12 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
     const backdropAnimation = animation.childAnimations.find((ani) => ani.id === 'backdropAnimation');
     const contentAnimation = animation.childAnimations.find((ani) => ani.id === 'contentAnimation');
     const enableBackdrop = () => {
+        // Respect explicit opt-out of focus trapping/backdrop interactions
+        // If focusTrap is false or showBackdrop is false, do not enable the backdrop or re-enable focus trap
+        const el = baseEl;
+        if (el.focusTrap === false || el.showBackdrop === false) {
+            return;
+        }
         baseEl.style.setProperty('pointer-events', 'auto');
         backdropEl.style.setProperty('pointer-events', 'auto');
         /**
@@ -1108,7 +1114,9 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
          * ion-backdrop and .modal-wrapper always have pointer-events: auto
          * applied, so the modal content can still be interacted with.
          */
-        const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint;
+        const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint &&
+            baseEl.focusTrap !== false &&
+            baseEl.showBackdrop !== false;
         if (shouldEnableBackdrop) {
             enableBackdrop();
         }
@@ -1416,7 +1424,9 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
                              * Backdrop should become enabled
                              * after the backdropBreakpoint value
                              */
-                            const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint;
+                            const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint &&
+                                baseEl.focusTrap !== false &&
+                                baseEl.showBackdrop !== false;
                             if (shouldEnableBackdrop) {
                                 enableBackdrop();
                             }

package/components/overlays.js

@@ -496,11 +496,9 @@ const setRootAriaHidden = (hidden = false) => {
     }
     if (hidden) {
         viewContainer.setAttribute('aria-hidden', 'true');
-        viewContainer.setAttribute('inert', '');
     }
     else {
         viewContainer.removeAttribute('aria-hidden');
-        viewContainer.removeAttribute('inert');
     }
 };
 const present = async (overlay, name, iosEnterAnimation, mdEnterAnimation, opts) => {
@@ -524,14 +522,34 @@ const present = async (overlay, name, iosEnterAnimation, mdEnterAnimation, opts)
      * focus traps.
      *
      * All other overlays should have focus traps to prevent
-     * the keyboard focus from leaving the overlay.
+     * the keyboard focus from leaving the overlay unless
+     * developers explicitly opt out (for example, sheet
+     * modals that should permit background interaction).
+     *
+     * Note: Some apps move inline overlays to a specific container
+     * during the willPresent lifecycle (e.g., React portals via
+     * onWillPresent). Defer applying aria-hidden/inert to the app
+     * root until after willPresent so we can detect where the
+     * overlay is finally inserted. If the overlay is inside the
+     * view container subtree, skip adding aria-hidden/inert there
+     * to avoid disabling the overlay.
      */
-    if (overlay.el.tagName !== 'ION-TOAST') {
-        setRootAriaHidden(true);
-        document.body.classList.add(BACKDROP_NO_SCROLL);
-    }
+    const overlayEl = overlay.el;
+    const shouldTrapFocus = overlayEl.tagName !== 'ION-TOAST' && overlayEl.focusTrap !== false;
+    // Only lock out root content when backdrop is active. Developers relying on showBackdrop=false
+    // expect background interaction to remain enabled.
+    const shouldLockRoot = shouldTrapFocus && overlayEl.showBackdrop !== false;
     overlay.presented = true;
     overlay.willPresent.emit();
+    if (shouldLockRoot) {
+        const root = getAppRoot(document);
+        const viewContainer = root.querySelector('ion-router-outlet, #ion-view-container-root');
+        const overlayInsideViewContainer = viewContainer ? viewContainer.contains(overlayEl) : false;
+        if (!overlayInsideViewContainer) {
+            setRootAriaHidden(true);
+        }
+        document.body.classList.add(BACKDROP_NO_SCROLL);
+    }
     (_a = overlay.willPresentShorthand) === null || _a === void 0 ? void 0 : _a.emit();
     const mode = getIonMode(overlay);
     // get the user's animation fn if one was provided
@@ -628,20 +646,24 @@ const dismiss = async (overlay, data, role, name, iosLeaveAnimation, mdLeaveAnim
      * For accessibility, toasts lack focus traps and don't receive
      * `aria-hidden` on the root element when presented.
      *
-     * All other overlays use focus traps to keep keyboard focus
-     * within the overlay, setting `aria-hidden` on the root element
-     * to enhance accessibility.
-     *
-     * Therefore, we must remove `aria-hidden` from the root element
-     * when the last non-toast overlay is dismissed.
+     * Overlays that opt into focus trapping set `aria-hidden`
+     * on the root element to keep keyboard focus and pointer
+     * events inside the overlay. We must remove `aria-hidden`
+     * from the root element when the last focus-trapping overlay
+     * is dismissed.
      */
-    const overlaysNotToast = presentedOverlays.filter((o) => o.tagName !== 'ION-TOAST');
-    const lastOverlayNotToast = overlaysNotToast.length === 1 && overlaysNotToast[0].id === overlay.el.id;
+    const overlaysLockingRoot = presentedOverlays.filter((o) => {
+        const el = o;
+        return el.tagName !== 'ION-TOAST' && el.focusTrap !== false && el.showBackdrop !== false;
+    });
+    const overlayEl = overlay.el;
+    const locksRoot = overlayEl.tagName !== 'ION-TOAST' && overlayEl.focusTrap !== false && overlayEl.showBackdrop !== false;
     /**
-     * If this is the last visible overlay that is not a toast
+     * If this is the last visible overlay that is trapping focus
      * then we want to re-add the root to the accessibility tree.
      */
-    if (lastOverlayNotToast) {
+    const lastOverlayTrappingFocus = locksRoot && overlaysLockingRoot.length === 1 && overlaysLockingRoot[0].id === overlayEl.id;
+    if (lastOverlayTrappingFocus) {
         setRootAriaHidden(false);
         document.body.classList.remove(BACKDROP_NO_SCROLL);
     }

package/dist/cjs/index.cjs.js

@@ -15,7 +15,7 @@ var index$2 = require('./index-DNh170BW.js');
 var config = require('./config-CKhELRRu.js');
 var theme = require('./theme-CeDs6Hcv.js');
 var index$3 = require('./index-D24wggHR.js');
-var overlays = require('./overlays-v_jc1Hok.js');
+var overlays = require('./overlays-czPyT6xP.js');
 require('./index-DkNv4J_i.js');
 require('./gesture-controller-dtqlP_q4.js');
 require('./hardware-back-button-BxdNu76F.js');

package/dist/cjs/ion-action-sheet.cjs.entry.js

@@ -7,7 +7,7 @@ var index = require('./index-DNh170BW.js');
 var buttonActive = require('./button-active-BzZenWWH.js');
 var helpers = require('./helpers-DgwmcYAu.js');
 var lockController = require('./lock-controller-aDB9wrEf.js');
-var overlays = require('./overlays-v_jc1Hok.js');
+var overlays = require('./overlays-czPyT6xP.js');
 var theme = require('./theme-CeDs6Hcv.js');
 var ionicGlobal = require('./ionic-global-UI5YPSi-.js');
 var animation = require('./animation-ZJ1lAkZD.js');

package/dist/cjs/ion-alert.cjs.entry.js

@@ -8,7 +8,7 @@ var config = require('./config-CKhELRRu.js');
 var buttonActive = require('./button-active-BzZenWWH.js');
 var helpers = require('./helpers-DgwmcYAu.js');
 var lockController = require('./lock-controller-aDB9wrEf.js');
-var overlays = require('./overlays-v_jc1Hok.js');
+var overlays = require('./overlays-czPyT6xP.js');
 var theme = require('./theme-CeDs6Hcv.js');
 var ionicGlobal = require('./ionic-global-UI5YPSi-.js');
 var animation = require('./animation-ZJ1lAkZD.js');

package/dist/cjs/ion-datetime_3.cjs.entry.js

@@ -6,7 +6,7 @@
 var index = require('./index-DNh170BW.js');
 var focusVisible = require('./focus-visible-CCvKiLh3.js');
 var helpers = require('./helpers-DgwmcYAu.js');
-var overlays = require('./overlays-v_jc1Hok.js');
+var overlays = require('./overlays-czPyT6xP.js');
 var dir = require('./dir-Cn0z1rJH.js');
 var theme = require('./theme-CeDs6Hcv.js');
 var index$1 = require('./index-DqmRDbxg.js');

package/dist/cjs/ion-loading.cjs.entry.js

@@ -7,7 +7,7 @@ var index = require('./index-DNh170BW.js');
 var config = require('./config-CKhELRRu.js');
 var helpers = require('./helpers-DgwmcYAu.js');
 var lockController = require('./lock-controller-aDB9wrEf.js');
-var overlays = require('./overlays-v_jc1Hok.js');
+var overlays = require('./overlays-czPyT6xP.js');
 var theme = require('./theme-CeDs6Hcv.js');
 var ionicGlobal = require('./ionic-global-UI5YPSi-.js');
 var animation = require('./animation-ZJ1lAkZD.js');

package/dist/cjs/ion-menu_3.cjs.entry.js

@@ -5,7 +5,7 @@
 
 var index = require('./index-DNh170BW.js');
 var cubicBezier = require('./cubic-bezier-DAjy1V-e.js');
-var overlays = require('./overlays-v_jc1Hok.js');
+var overlays = require('./overlays-czPyT6xP.js');
 var gestureController = require('./gesture-controller-dtqlP_q4.js');
 var hardwareBackButton = require('./hardware-back-button-BxdNu76F.js');
 var helpers = require('./helpers-DgwmcYAu.js');

package/dist/cjs/ion-modal.cjs.entry.js

@@ -9,7 +9,7 @@ var frameworkDelegate = require('./framework-delegate-WkyjrnCx.js');
 var helpers = require('./helpers-DgwmcYAu.js');
 var lockController = require('./lock-controller-aDB9wrEf.js');
 var capacitor = require('./capacitor-DmA66EwP.js');
-var overlays = require('./overlays-v_jc1Hok.js');
+var overlays = require('./overlays-czPyT6xP.js');
 var theme = require('./theme-CeDs6Hcv.js');
 var index$4 = require('./index-BzEyuIww.js');
 var ionicGlobal = require('./ionic-global-UI5YPSi-.js');
@@ -987,6 +987,12 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
     const backdropAnimation = animation.childAnimations.find((ani) => ani.id === 'backdropAnimation');
     const contentAnimation = animation.childAnimations.find((ani) => ani.id === 'contentAnimation');
     const enableBackdrop = () => {
+        // Respect explicit opt-out of focus trapping/backdrop interactions
+        // If focusTrap is false or showBackdrop is false, do not enable the backdrop or re-enable focus trap
+        const el = baseEl;
+        if (el.focusTrap === false || el.showBackdrop === false) {
+            return;
+        }
         baseEl.style.setProperty('pointer-events', 'auto');
         backdropEl.style.setProperty('pointer-events', 'auto');
         /**
@@ -1111,7 +1117,9 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
          * ion-backdrop and .modal-wrapper always have pointer-events: auto
          * applied, so the modal content can still be interacted with.
          */
-        const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint;
+        const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint &&
+            baseEl.focusTrap !== false &&
+            baseEl.showBackdrop !== false;
         if (shouldEnableBackdrop) {
             enableBackdrop();
         }
@@ -1419,7 +1427,9 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
                              * Backdrop should become enabled
                              * after the backdropBreakpoint value
                              */
-                            const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint;
+                            const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint &&
+                                baseEl.focusTrap !== false &&
+                                baseEl.showBackdrop !== false;
                             if (shouldEnableBackdrop) {
                                 enableBackdrop();
                             }

package/dist/cjs/ion-popover.cjs.entry.js

@@ -4,7 +4,7 @@
 'use strict';
 
 var index = require('./index-DNh170BW.js');
-var overlays = require('./overlays-v_jc1Hok.js');
+var overlays = require('./overlays-czPyT6xP.js');
 var frameworkDelegate = require('./framework-delegate-WkyjrnCx.js');
 var helpers = require('./helpers-DgwmcYAu.js');
 var lockController = require('./lock-controller-aDB9wrEf.js');

package/dist/cjs/ion-select-modal.cjs.entry.js

@@ -5,7 +5,7 @@
 
 var index = require('./index-DNh170BW.js');
 var ionicGlobal = require('./ionic-global-UI5YPSi-.js');
-var overlays = require('./overlays-v_jc1Hok.js');
+var overlays = require('./overlays-czPyT6xP.js');
 var theme = require('./theme-CeDs6Hcv.js');
 require('./index-DkNv4J_i.js');
 require('./helpers-DgwmcYAu.js');

package/dist/cjs/ion-select_3.cjs.entry.js

@@ -7,7 +7,7 @@ var index = require('./index-DNh170BW.js');
 var notchController = require('./notch-controller-Bf5Rr4R5.js');
 var compareWithUtils = require('./compare-with-utils-DSicavqM.js');
 var helpers = require('./helpers-DgwmcYAu.js');
-var overlays = require('./overlays-v_jc1Hok.js');
+var overlays = require('./overlays-czPyT6xP.js');
 var dir = require('./dir-Cn0z1rJH.js');
 var theme = require('./theme-CeDs6Hcv.js');
 var watchOptions = require('./watch-options-CviOsrTS.js');

package/dist/cjs/ion-toast.cjs.entry.js

@@ -7,7 +7,7 @@ var index$1 = require('./index-DNh170BW.js');
 var config = require('./config-CKhELRRu.js');
 var helpers = require('./helpers-DgwmcYAu.js');
 var lockController = require('./lock-controller-aDB9wrEf.js');
-var overlays = require('./overlays-v_jc1Hok.js');
+var overlays = require('./overlays-czPyT6xP.js');
 var theme = require('./theme-CeDs6Hcv.js');
 var ionicGlobal = require('./ionic-global-UI5YPSi-.js');
 var animation = require('./animation-ZJ1lAkZD.js');

package/dist/cjs/{overlays-v_jc1Hok.js → overlays-czPyT6xP.js}

@@ -498,11 +498,9 @@ const setRootAriaHidden = (hidden = false) => {
     }
     if (hidden) {
         viewContainer.setAttribute('aria-hidden', 'true');
-        viewContainer.setAttribute('inert', '');
     }
     else {
         viewContainer.removeAttribute('aria-hidden');
-        viewContainer.removeAttribute('inert');
     }
 };
 const present = async (overlay, name, iosEnterAnimation, mdEnterAnimation, opts) => {
@@ -526,14 +524,34 @@ const present = async (overlay, name, iosEnterAnimation, mdEnterAnimation, opts)
      * focus traps.
      *
      * All other overlays should have focus traps to prevent
-     * the keyboard focus from leaving the overlay.
+     * the keyboard focus from leaving the overlay unless
+     * developers explicitly opt out (for example, sheet
+     * modals that should permit background interaction).
+     *
+     * Note: Some apps move inline overlays to a specific container
+     * during the willPresent lifecycle (e.g., React portals via
+     * onWillPresent). Defer applying aria-hidden/inert to the app
+     * root until after willPresent so we can detect where the
+     * overlay is finally inserted. If the overlay is inside the
+     * view container subtree, skip adding aria-hidden/inert there
+     * to avoid disabling the overlay.
      */
-    if (overlay.el.tagName !== 'ION-TOAST') {
-        setRootAriaHidden(true);
-        document.body.classList.add(gestureController.BACKDROP_NO_SCROLL);
-    }
+    const overlayEl = overlay.el;
+    const shouldTrapFocus = overlayEl.tagName !== 'ION-TOAST' && overlayEl.focusTrap !== false;
+    // Only lock out root content when backdrop is active. Developers relying on showBackdrop=false
+    // expect background interaction to remain enabled.
+    const shouldLockRoot = shouldTrapFocus && overlayEl.showBackdrop !== false;
     overlay.presented = true;
     overlay.willPresent.emit();
+    if (shouldLockRoot) {
+        const root = getAppRoot(document);
+        const viewContainer = root.querySelector('ion-router-outlet, #ion-view-container-root');
+        const overlayInsideViewContainer = viewContainer ? viewContainer.contains(overlayEl) : false;
+        if (!overlayInsideViewContainer) {
+            setRootAriaHidden(true);
+        }
+        document.body.classList.add(gestureController.BACKDROP_NO_SCROLL);
+    }
     (_a = overlay.willPresentShorthand) === null || _a === void 0 ? void 0 : _a.emit();
     const mode = ionicGlobal.getIonMode(overlay);
     // get the user's animation fn if one was provided
@@ -630,20 +648,24 @@ const dismiss = async (overlay, data, role, name, iosLeaveAnimation, mdLeaveAnim
      * For accessibility, toasts lack focus traps and don't receive
      * `aria-hidden` on the root element when presented.
      *
-     * All other overlays use focus traps to keep keyboard focus
-     * within the overlay, setting `aria-hidden` on the root element
-     * to enhance accessibility.
-     *
-     * Therefore, we must remove `aria-hidden` from the root element
-     * when the last non-toast overlay is dismissed.
+     * Overlays that opt into focus trapping set `aria-hidden`
+     * on the root element to keep keyboard focus and pointer
+     * events inside the overlay. We must remove `aria-hidden`
+     * from the root element when the last focus-trapping overlay
+     * is dismissed.
      */
-    const overlaysNotToast = presentedOverlays.filter((o) => o.tagName !== 'ION-TOAST');
-    const lastOverlayNotToast = overlaysNotToast.length === 1 && overlaysNotToast[0].id === overlay.el.id;
+    const overlaysLockingRoot = presentedOverlays.filter((o) => {
+        const el = o;
+        return el.tagName !== 'ION-TOAST' && el.focusTrap !== false && el.showBackdrop !== false;
+    });
+    const overlayEl = overlay.el;
+    const locksRoot = overlayEl.tagName !== 'ION-TOAST' && overlayEl.focusTrap !== false && overlayEl.showBackdrop !== false;
     /**
-     * If this is the last visible overlay that is not a toast
+     * If this is the last visible overlay that is trapping focus
      * then we want to re-add the root to the accessibility tree.
      */
-    if (lastOverlayNotToast) {
+    const lastOverlayTrappingFocus = locksRoot && overlaysLockingRoot.length === 1 && overlaysLockingRoot[0].id === overlayEl.id;
+    if (lastOverlayTrappingFocus) {
         setRootAriaHidden(false);
         document.body.classList.remove(gestureController.BACKDROP_NO_SCROLL);
     }

package/dist/collection/components/modal/gestures/sheet.js

@@ -45,6 +45,12 @@ export const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpo
     const backdropAnimation = animation.childAnimations.find((ani) => ani.id === 'backdropAnimation');
     const contentAnimation = animation.childAnimations.find((ani) => ani.id === 'contentAnimation');
     const enableBackdrop = () => {
+        // Respect explicit opt-out of focus trapping/backdrop interactions
+        // If focusTrap is false or showBackdrop is false, do not enable the backdrop or re-enable focus trap
+        const el = baseEl;
+        if (el.focusTrap === false || el.showBackdrop === false) {
+            return;
+        }
         baseEl.style.setProperty('pointer-events', 'auto');
         backdropEl.style.setProperty('pointer-events', 'auto');
         /**
@@ -169,7 +175,9 @@ export const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpo
          * ion-backdrop and .modal-wrapper always have pointer-events: auto
          * applied, so the modal content can still be interacted with.
          */
-        const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint;
+        const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint &&
+            baseEl.focusTrap !== false &&
+            baseEl.showBackdrop !== false;
         if (shouldEnableBackdrop) {
             enableBackdrop();
         }
@@ -477,7 +485,9 @@ export const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpo
                              * Backdrop should become enabled
                              * after the backdropBreakpoint value
                              */
-                            const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint;
+                            const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint &&
+                                baseEl.focusTrap !== false &&
+                                baseEl.showBackdrop !== false;
                             if (shouldEnableBackdrop) {
                                 enableBackdrop();
                             }

package/dist/collection/utils/overlays.js

@@ -417,11 +417,9 @@ export const setRootAriaHidden = (hidden = false) => {
     }
     if (hidden) {
         viewContainer.setAttribute('aria-hidden', 'true');
-        viewContainer.setAttribute('inert', '');
     }
     else {
         viewContainer.removeAttribute('aria-hidden');
-        viewContainer.removeAttribute('inert');
     }
 };
 export const present = async (overlay, name, iosEnterAnimation, mdEnterAnimation, opts) => {
@@ -445,14 +443,34 @@ export const present = async (overlay, name, iosEnterAnimation, mdEnterAnimation
      * focus traps.
      *
      * All other overlays should have focus traps to prevent
-     * the keyboard focus from leaving the overlay.
+     * the keyboard focus from leaving the overlay unless
+     * developers explicitly opt out (for example, sheet
+     * modals that should permit background interaction).
+     *
+     * Note: Some apps move inline overlays to a specific container
+     * during the willPresent lifecycle (e.g., React portals via
+     * onWillPresent). Defer applying aria-hidden/inert to the app
+     * root until after willPresent so we can detect where the
+     * overlay is finally inserted. If the overlay is inside the
+     * view container subtree, skip adding aria-hidden/inert there
+     * to avoid disabling the overlay.
      */
-    if (overlay.el.tagName !== 'ION-TOAST') {
-        setRootAriaHidden(true);
-        document.body.classList.add(BACKDROP_NO_SCROLL);
-    }
+    const overlayEl = overlay.el;
+    const shouldTrapFocus = overlayEl.tagName !== 'ION-TOAST' && overlayEl.focusTrap !== false;
+    // Only lock out root content when backdrop is active. Developers relying on showBackdrop=false
+    // expect background interaction to remain enabled.
+    const shouldLockRoot = shouldTrapFocus && overlayEl.showBackdrop !== false;
     overlay.presented = true;
     overlay.willPresent.emit();
+    if (shouldLockRoot) {
+        const root = getAppRoot(document);
+        const viewContainer = root.querySelector('ion-router-outlet, #ion-view-container-root');
+        const overlayInsideViewContainer = viewContainer ? viewContainer.contains(overlayEl) : false;
+        if (!overlayInsideViewContainer) {
+            setRootAriaHidden(true);
+        }
+        document.body.classList.add(BACKDROP_NO_SCROLL);
+    }
     (_a = overlay.willPresentShorthand) === null || _a === void 0 ? void 0 : _a.emit();
     const mode = getIonMode(overlay);
     // get the user's animation fn if one was provided
@@ -549,20 +567,24 @@ export const dismiss = async (overlay, data, role, name, iosLeaveAnimation, mdLe
      * For accessibility, toasts lack focus traps and don't receive
      * `aria-hidden` on the root element when presented.
      *
-     * All other overlays use focus traps to keep keyboard focus
-     * within the overlay, setting `aria-hidden` on the root element
-     * to enhance accessibility.
-     *
-     * Therefore, we must remove `aria-hidden` from the root element
-     * when the last non-toast overlay is dismissed.
+     * Overlays that opt into focus trapping set `aria-hidden`
+     * on the root element to keep keyboard focus and pointer
+     * events inside the overlay. We must remove `aria-hidden`
+     * from the root element when the last focus-trapping overlay
+     * is dismissed.
      */
-    const overlaysNotToast = presentedOverlays.filter((o) => o.tagName !== 'ION-TOAST');
-    const lastOverlayNotToast = overlaysNotToast.length === 1 && overlaysNotToast[0].id === overlay.el.id;
+    const overlaysLockingRoot = presentedOverlays.filter((o) => {
+        const el = o;
+        return el.tagName !== 'ION-TOAST' && el.focusTrap !== false && el.showBackdrop !== false;
+    });
+    const overlayEl = overlay.el;
+    const locksRoot = overlayEl.tagName !== 'ION-TOAST' && overlayEl.focusTrap !== false && overlayEl.showBackdrop !== false;
     /**
-     * If this is the last visible overlay that is not a toast
+     * If this is the last visible overlay that is trapping focus
      * then we want to re-add the root to the accessibility tree.
      */
-    if (lastOverlayNotToast) {
+    const lastOverlayTrappingFocus = locksRoot && overlaysLockingRoot.length === 1 && overlaysLockingRoot[0].id === overlayEl.id;
+    if (lastOverlayTrappingFocus) {
         setRootAriaHidden(false);
         document.body.classList.remove(BACKDROP_NO_SCROLL);
     }

package/dist/docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2025-09-24T06:10:53",
+  "timestamp": "2025-09-24T19:46:45",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.36.2",

package/dist/esm/index.js

@@ -13,7 +13,7 @@ export { L as LogLevel } from './index-4DxY6_gG.js';
 export { I as IonicSafeString, g as getMode, s as setupConfig } from './config-Dx_6wPIJ.js';
 export { o as openURL } from './theme-DiVJyqlX.js';
 export { m as menuController } from './index-CXSTcaAW.js';
-export { b as actionSheetController, a as alertController, l as loadingController, m as modalController, p as pickerController, c as popoverController, t as toastController } from './overlays-BJaRj3Rj.js';
+export { b as actionSheetController, a as alertController, l as loadingController, m as modalController, p as pickerController, c as popoverController, t as toastController } from './overlays-BYcYBCrx.js';
 import './index-ZjP4CjeZ.js';
 import './gesture-controller-BTEOs1at.js';
 import './hardware-back-button-Dhbd-23H.js';

package/dist/esm/ion-action-sheet.entry.js

@@ -5,7 +5,7 @@ import { r as registerInstance, c as createEvent, a as readTask, h, d as Host, g
 import { c as createButtonActiveGesture } from './button-active-DBUPuLNw.js';
 import { r as raf } from './helpers-8KSQQGQy.js';
 import { c as createLockController } from './lock-controller-B-hirT0v.js';
-import { d as createDelegateController, e as createTriggerController, B as BACKDROP, i as isCancel, f as present, g as dismiss, h as eventMethod, s as safeCall, j as prepareOverlay, k as setOverlayId } from './overlays-BJaRj3Rj.js';
+import { d as createDelegateController, e as createTriggerController, B as BACKDROP, i as isCancel, f as present, g as dismiss, h as eventMethod, s as safeCall, j as prepareOverlay, k as setOverlayId } from './overlays-BYcYBCrx.js';
 import { g as getClassMap } from './theme-DiVJyqlX.js';
 import { b as getIonMode } from './ionic-global-CTSyufhF.js';
 import { c as createAnimation } from './animation-BvhAtgca.js';

package/dist/esm/ion-alert.entry.js

@@ -6,7 +6,7 @@ import { E as ENABLE_HTML_CONTENT_DEFAULT, a as sanitizeDOMString } from './conf
 import { c as createButtonActiveGesture } from './button-active-DBUPuLNw.js';
 import { r as raf } from './helpers-8KSQQGQy.js';
 import { c as createLockController } from './lock-controller-B-hirT0v.js';
-import { d as createDelegateController, e as createTriggerController, B as BACKDROP, i as isCancel, j as prepareOverlay, k as setOverlayId, f as present, g as dismiss, h as eventMethod, s as safeCall } from './overlays-BJaRj3Rj.js';
+import { d as createDelegateController, e as createTriggerController, B as BACKDROP, i as isCancel, j as prepareOverlay, k as setOverlayId, f as present, g as dismiss, h as eventMethod, s as safeCall } from './overlays-BYcYBCrx.js';
 import { g as getClassMap } from './theme-DiVJyqlX.js';
 import { b as getIonMode } from './ionic-global-CTSyufhF.js';
 import { c as createAnimation } from './animation-BvhAtgca.js';

package/dist/esm/ion-datetime_3.entry.js

@@ -4,7 +4,7 @@
 import { j as printIonError, f as printIonWarning, r as registerInstance, c as createEvent, w as writeTask, h, d as Host, g as getElement } from './index-4DxY6_gG.js';
 import { startFocusVisible } from './focus-visible-BmVRXR1y.js';
 import { r as raf, g as getElementRoot, a as renderHiddenInput, e as clamp } from './helpers-8KSQQGQy.js';
-import { F as FOCUS_TRAP_DISABLE_CLASS, d as createDelegateController, e as createTriggerController, B as BACKDROP, i as isCancel, j as prepareOverlay, k as setOverlayId, f as present, g as dismiss, h as eventMethod, s as safeCall } from './overlays-BJaRj3Rj.js';
+import { F as FOCUS_TRAP_DISABLE_CLASS, d as createDelegateController, e as createTriggerController, B as BACKDROP, i as isCancel, j as prepareOverlay, k as setOverlayId, f as present, g as dismiss, h as eventMethod, s as safeCall } from './overlays-BYcYBCrx.js';
 import { i as isRTL } from './dir-C53feagD.js';
 import { c as createColorClasses, g as getClassMap } from './theme-DiVJyqlX.js';
 import { l as chevronDown, o as caretUpSharp, p as chevronForward, q as caretDownSharp, c as chevronBack } from './index-DV3sJJW8.js';

package/dist/esm/ion-loading.entry.js

@@ -5,7 +5,7 @@ import { r as registerInstance, c as createEvent, e as config, h, d as Host, g a
 import { E as ENABLE_HTML_CONTENT_DEFAULT, a as sanitizeDOMString } from './config-Dx_6wPIJ.js';
 import { r as raf } from './helpers-8KSQQGQy.js';
 import { c as createLockController } from './lock-controller-B-hirT0v.js';
-import { d as createDelegateController, e as createTriggerController, B as BACKDROP, j as prepareOverlay, k as setOverlayId, f as present, g as dismiss, h as eventMethod } from './overlays-BJaRj3Rj.js';
+import { d as createDelegateController, e as createTriggerController, B as BACKDROP, j as prepareOverlay, k as setOverlayId, f as present, g as dismiss, h as eventMethod } from './overlays-BYcYBCrx.js';
 import { g as getClassMap } from './theme-DiVJyqlX.js';
 import { b as getIonMode } from './ionic-global-CTSyufhF.js';
 import { c as createAnimation } from './animation-BvhAtgca.js';

package/dist/esm/ion-menu_3.entry.js

@@ -3,7 +3,7 @@
  */
 import { r as registerInstance, c as createEvent, e as config, j as printIonError, h, d as Host, g as getElement } from './index-4DxY6_gG.js';
 import { g as getTimeGivenProgression } from './cubic-bezier-hHmYLOfE.js';
-import { o as getPresentedOverlay, B as BACKDROP, n as focusFirstDescendant, q as focusLastDescendant, G as GESTURE } from './overlays-BJaRj3Rj.js';
+import { o as getPresentedOverlay, B as BACKDROP, n as focusFirstDescendant, q as focusLastDescendant, G as GESTURE } from './overlays-BYcYBCrx.js';
 import { G as GESTURE_CONTROLLER } from './gesture-controller-BTEOs1at.js';
 import { shouldUseCloseWatcher } from './hardware-back-button-Dhbd-23H.js';
 import { o as isEndSide, i as inheritAriaAttributes, l as assert, e as clamp } from './helpers-8KSQQGQy.js';

package/dist/esm/ion-modal.entry.js

@@ -7,7 +7,7 @@ import { C as CoreDelegate, a as attachComponent, d as detachComponent } from '.
 import { e as clamp, g as getElementRoot, r as raf, b as inheritAttributes, h as hasLazyBuild } from './helpers-8KSQQGQy.js';
 import { c as createLockController } from './lock-controller-B-hirT0v.js';
 import { g as getCapacitor } from './capacitor-CFERIeaU.js';
-import { G as GESTURE, O as OVERLAY_GESTURE_PRIORITY, F as FOCUS_TRAP_DISABLE_CLASS, e as createTriggerController, B as BACKDROP, j as prepareOverlay, k as setOverlayId, f as present, g as dismiss, h as eventMethod } from './overlays-BJaRj3Rj.js';
+import { G as GESTURE, O as OVERLAY_GESTURE_PRIORITY, F as FOCUS_TRAP_DISABLE_CLASS, e as createTriggerController, B as BACKDROP, j as prepareOverlay, k as setOverlayId, f as present, g as dismiss, h as eventMethod } from './overlays-BYcYBCrx.js';
 import { g as getClassMap } from './theme-DiVJyqlX.js';
 import { e as deepReady, w as waitForMount } from './index-Dp7GXH1z.js';
 import { b as getIonMode } from './ionic-global-CTSyufhF.js';
@@ -985,6 +985,12 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
     const backdropAnimation = animation.childAnimations.find((ani) => ani.id === 'backdropAnimation');
     const contentAnimation = animation.childAnimations.find((ani) => ani.id === 'contentAnimation');
     const enableBackdrop = () => {
+        // Respect explicit opt-out of focus trapping/backdrop interactions
+        // If focusTrap is false or showBackdrop is false, do not enable the backdrop or re-enable focus trap
+        const el = baseEl;
+        if (el.focusTrap === false || el.showBackdrop === false) {
+            return;
+        }
         baseEl.style.setProperty('pointer-events', 'auto');
         backdropEl.style.setProperty('pointer-events', 'auto');
         /**
@@ -1109,7 +1115,9 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
          * ion-backdrop and .modal-wrapper always have pointer-events: auto
          * applied, so the modal content can still be interacted with.
          */
-        const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint;
+        const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint &&
+            baseEl.focusTrap !== false &&
+            baseEl.showBackdrop !== false;
         if (shouldEnableBackdrop) {
             enableBackdrop();
         }
@@ -1417,7 +1425,9 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
                              * Backdrop should become enabled
                              * after the backdropBreakpoint value
                              */
-                            const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint;
+                            const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint &&
+                                baseEl.focusTrap !== false &&
+                                baseEl.showBackdrop !== false;
                             if (shouldEnableBackdrop) {
                                 enableBackdrop();
                             }

package/dist/esm/ion-popover.entry.js

@@ -2,7 +2,7 @@
  * (C) Ionic http://ionicframework.com - MIT License
  */
 import { r as registerInstance, c as createEvent, f as printIonWarning, h, d as Host, g as getElement } from './index-4DxY6_gG.js';
-import { B as BACKDROP, j as prepareOverlay, k as setOverlayId, f as present, n as focusFirstDescendant, g as dismiss, h as eventMethod, F as FOCUS_TRAP_DISABLE_CLASS } from './overlays-BJaRj3Rj.js';
+import { B as BACKDROP, j as prepareOverlay, k as setOverlayId, f as present, n as focusFirstDescendant, g as dismiss, h as eventMethod, F as FOCUS_TRAP_DISABLE_CLASS } from './overlays-BYcYBCrx.js';
 import { C as CoreDelegate, a as attachComponent, d as detachComponent } from './framework-delegate-BLEBgH06.js';
 import { g as getElementRoot, r as raf, f as addEventListener, h as hasLazyBuild } from './helpers-8KSQQGQy.js';
 import { c as createLockController } from './lock-controller-B-hirT0v.js';

package/dist/esm/ion-select-modal.entry.js

@@ -3,7 +3,7 @@
  */
 import { r as registerInstance, h, i as forceUpdate, d as Host, g as getElement } from './index-4DxY6_gG.js';
 import { b as getIonMode } from './ionic-global-CTSyufhF.js';
-import { s as safeCall } from './overlays-BJaRj3Rj.js';
+import { s as safeCall } from './overlays-BYcYBCrx.js';
 import { g as getClassMap } from './theme-DiVJyqlX.js';
 import './index-ZjP4CjeZ.js';
 import './helpers-8KSQQGQy.js';