@ionic/core 8.8.18 → 8.8.19-dev.11786730389.1a1927bf

package/dist/collection/components/loading/loading.js

@@ -5,7 +5,7 @@ import { Host, h } from "@stencil/core";
 import { ENABLE_HTML_CONTENT_DEFAULT } from "../../utils/config";
 import { raf } from "../../utils/helpers";
 import { createLockController } from "../../utils/lock-controller";
-import { BACKDROP, dismiss, eventMethod, prepareOverlay, present, createDelegateController, createTriggerController, setOverlayId, } from "../../utils/overlays";
+import { BACKDROP, cleanupRootFocusTrapAccessibility, createDelegateController, createTriggerController, dismiss, eventMethod, prepareOverlay, present, setOverlayId, } from "../../utils/overlays";
 import { sanitizeDOMString } from "../../utils/sanitization/index";
 import { getClassMap } from "../../utils/theme";
 import { config } from "../../global/config";
@@ -19,52 +19,84 @@ import { mdLeaveAnimation } from "./animations/md.leave";
  * @virtualProp {"ios" | "md"} mode - The mode determines which platform styles to use.
  */
 export class Loading {
-    constructor() {
-        this.delegateController = createDelegateController(this);
-        this.lockController = createLockController();
-        this.triggerController = createTriggerController();
-        this.customHTMLEnabled = config.get('innerHTMLTemplatesEnabled', ENABLE_HTML_CONTENT_DEFAULT);
-        this.presented = false;
-        /** @internal */
-        this.hasController = false;
-        /**
-         * If `true`, the keyboard will be automatically dismissed when the overlay is presented.
-         */
-        this.keyboardClose = true;
-        /**
-         * Number of milliseconds to wait before dismissing the loading indicator.
-         */
-        this.duration = 0;
-        /**
-         * If `true`, the loading indicator will be dismissed when the backdrop is clicked.
-         */
-        this.backdropDismiss = false;
-        /**
-         * If `true`, a backdrop will be displayed behind the loading indicator.
-         */
-        this.showBackdrop = true;
-        /**
-         * If `true`, the loading indicator will be translucent.
-         * Only applies when the mode is `"ios"` and the device supports
-         * [`backdrop-filter`](https://developer.mozilla.org/en-US/docs/Web/CSS/backdrop-filter#Browser_compatibility).
-         */
-        this.translucent = false;
-        /**
-         * If `true`, the loading indicator will animate.
-         */
-        this.animated = true;
-        /**
-         * If `true`, the loading indicator will open. If `false`, the loading indicator will close.
-         * Use this if you need finer grained control over presentation, otherwise
-         * just use the loadingController or the `trigger` property.
-         * Note: `isOpen` will not automatically be set back to `false` when
-         * the loading indicator dismisses. You will need to do that in your code.
-         */
-        this.isOpen = false;
-        this.onBackdropTap = () => {
-            this.dismiss(undefined, BACKDROP);
-        };
-    }
+    delegateController = createDelegateController(this);
+    lockController = createLockController();
+    triggerController = createTriggerController();
+    customHTMLEnabled = config.get('innerHTMLTemplatesEnabled', ENABLE_HTML_CONTENT_DEFAULT);
+    durationTimeout;
+    presented = false;
+    lastFocus;
+    el;
+    /** @internal */
+    overlayIndex;
+    /** @internal */
+    delegate;
+    /** @internal */
+    hasController = false;
+    /**
+     * If `true`, the keyboard will be automatically dismissed when the overlay is presented.
+     */
+    keyboardClose = true;
+    /**
+     * Animation to use when the loading indicator is presented.
+     */
+    enterAnimation;
+    /**
+     * Animation to use when the loading indicator is dismissed.
+     */
+    leaveAnimation;
+    /**
+     * Optional text content to display in the loading indicator.
+     *
+     * This property accepts custom HTML as a string.
+     * Content is parsed as plaintext by default.
+     * `innerHTMLTemplatesEnabled` must be set to `true` in the Ionic config
+     * before custom HTML can be used.
+     */
+    message;
+    /**
+     * Additional classes to apply for custom CSS. If multiple classes are
+     * provided they should be separated by spaces.
+     */
+    cssClass;
+    /**
+     * Number of milliseconds to wait before dismissing the loading indicator.
+     */
+    duration = 0;
+    /**
+     * If `true`, the loading indicator will be dismissed when the backdrop is clicked.
+     */
+    backdropDismiss = false;
+    /**
+     * If `true`, a backdrop will be displayed behind the loading indicator.
+     */
+    showBackdrop = true;
+    /**
+     * The name of the spinner to display.
+     */
+    spinner;
+    /**
+     * If `true`, the loading indicator will be translucent.
+     * Only applies when the mode is `"ios"` and the device supports
+     * [`backdrop-filter`](https://developer.mozilla.org/en-US/docs/Web/CSS/backdrop-filter#Browser_compatibility).
+     */
+    translucent = false;
+    /**
+     * If `true`, the loading indicator will animate.
+     */
+    animated = true;
+    /**
+     * Additional attributes to pass to the loader.
+     */
+    htmlAttributes;
+    /**
+     * If `true`, the loading indicator will open. If `false`, the loading indicator will close.
+     * Use this if you need finer grained control over presentation, otherwise
+     * just use the loadingController or the `trigger` property.
+     * Note: `isOpen` will not automatically be set back to `false` when
+     * the loading indicator dismisses. You will need to do that in your code.
+     */
+    isOpen = false;
     onIsOpenChange(newValue, oldValue) {
         if (newValue === true && oldValue === false) {
             this.present();
@@ -73,23 +105,63 @@ export class Loading {
             this.dismiss();
         }
     }
+    /**
+     * An ID corresponding to the trigger element that
+     * causes the loading indicator to open when clicked.
+     */
+    trigger;
     triggerChanged() {
         const { trigger, el, triggerController } = this;
         if (trigger) {
             triggerController.addClickListener(el, trigger);
         }
     }
+    /**
+     * Emitted after the loading has presented.
+     */
+    didPresent;
+    /**
+     * Emitted before the loading has presented.
+     */
+    willPresent;
+    /**
+     * Emitted before the loading has dismissed.
+     */
+    willDismiss;
+    /**
+     * Emitted after the loading has dismissed.
+     */
+    didDismiss;
+    /**
+     * Emitted after the loading indicator has presented.
+     * Shorthand for ionLoadingWillDismiss.
+     */
+    didPresentShorthand;
+    /**
+     * Emitted before the loading indicator has presented.
+     * Shorthand for ionLoadingWillPresent.
+     */
+    willPresentShorthand;
+    /**
+     * Emitted before the loading indicator has dismissed.
+     * Shorthand for ionLoadingWillDismiss.
+     */
+    willDismissShorthand;
+    /**
+     * Emitted after the loading indicator has dismissed.
+     * Shorthand for ionLoadingDidDismiss.
+     */
+    didDismissShorthand;
     connectedCallback() {
         prepareOverlay(this.el);
         this.triggerChanged();
     }
     componentWillLoad() {
-        var _a;
         if (this.spinner === undefined) {
             const mode = getIonMode(this);
             this.spinner = config.get('loadingSpinner', config.get('spinner', mode === 'ios' ? 'lines' : 'crescent'));
         }
-        if (!((_a = this.htmlAttributes) === null || _a === void 0 ? void 0 : _a.id)) {
+        if (!this.htmlAttributes?.id) {
             setOverlayId(this.el);
         }
     }
@@ -114,6 +186,10 @@ export class Loading {
     }
     disconnectedCallback() {
         this.triggerController.removeClickListener();
+        // Clean up aria-hidden if removed without dismiss() being called
+        if (this.presented) {
+            cleanupRootFocusTrapAccessibility();
+        }
     }
     /**
      * Present the loading overlay after it has been created.
@@ -163,6 +239,9 @@ export class Loading {
     onWillDismiss() {
         return eventMethod(this.el, 'ionLoadingWillDismiss');
     }
+    onBackdropTap = () => {
+        this.dismiss(undefined, BACKDROP);
+    };
     renderLoadingMessage(msgId) {
         const { customHTMLEnabled, message } = this;
         if (customHTMLEnabled) {
@@ -179,9 +258,14 @@ export class Loading {
          * Otherwise, don't set aria-labelledby.
          */
         const ariaLabelledBy = message !== undefined ? msgId : null;
-        return (h(Host, Object.assign({ key: 'f86ddbc600cb5c396b7de38fb5f49625388c3c3f', role: "dialog", "aria-modal": "true", "aria-labelledby": ariaLabelledBy, tabindex: "-1" }, htmlAttributes, { style: {
+        return (h(Host, { key: 'ab48bfcee8f7e3e33847a2f262fdc08b9ea804ca', role: "dialog", "aria-modal": "true", "aria-labelledby": ariaLabelledBy, tabindex: "-1", ...htmlAttributes, style: {
                 zIndex: `${40000 + this.overlayIndex}`,
-            }, onIonBackdropTap: this.onBackdropTap, class: Object.assign(Object.assign({}, getClassMap(this.cssClass)), { [mode]: true, 'overlay-hidden': true, 'loading-translucent': this.translucent }) }), h("ion-backdrop", { key: 'b53727aaddc37ef3c685fcc150c6d5193290a847', visible: this.showBackdrop, tappable: this.backdropDismiss }), h("div", { key: '4c61bede8e0a4e47daa6f1f9d0f364ef6aec0bc3', tabindex: "0", "aria-hidden": "true" }), h("div", { key: '84e51ceb07118f1eaeb757df28801c255496931b', class: "loading-wrapper ion-overlay-wrapper" }, spinner && (h("div", { key: 'fc97f1912e0fc558b7c309a5bc084415f5f620b2', class: "loading-spinner" }, h("ion-spinner", { key: '6e186d856cd3f10f22c3e317ef00f31b4216459c', name: spinner, "aria-hidden": "true" }))), message !== undefined && this.renderLoadingMessage(msgId)), h("div", { key: 'dcbe9d9a619daa1c08174e73827bdabeb59dde92', tabindex: "0", "aria-hidden": "true" })));
+            }, onIonBackdropTap: this.onBackdropTap, class: {
+                ...getClassMap(this.cssClass),
+                [mode]: true,
+                'overlay-hidden': true,
+                'loading-translucent': this.translucent,
+            } }, h("ion-backdrop", { key: '41baccc7fb6474389a3a3431c208e829ef738b75', visible: this.showBackdrop, tappable: this.backdropDismiss }), h("div", { key: '7b7290974abbe8db8739b19835aca9f8b5c271c2', tabindex: "0", "aria-hidden": "true" }), h("div", { key: 'e32466abfcc92aaad47ea03b1dcb49f66abe4b63', class: "loading-wrapper ion-overlay-wrapper" }, spinner && (h("div", { key: 'c5e6e6f9e3f39dba0225d08d7dd2c1b96a1d83c7', class: "loading-spinner" }, h("ion-spinner", { key: 'f428038959d879404ea898011363aac0b807ad11', name: spinner, "aria-hidden": "true" }))), message !== undefined && this.renderLoadingMessage(msgId)), h("div", { key: '490e531367b86c319fa4260722dcff4dd631fa88', tabindex: "0", "aria-hidden": "true" })));
     }
     static get is() { return "ion-loading"; }
     static get encapsulation() { return "scoped"; }

package/dist/collection/components/menu/menu.js

@@ -23,63 +23,69 @@ const mdEasingReverse = 'cubic-bezier(0.4, 0, 0.6, 1)';
  * @part backdrop - The backdrop that appears over the main content when the menu is open.
  */
 export class Menu {
-    constructor() {
-        this.lastOnEnd = 0;
-        this.blocker = GESTURE_CONTROLLER.createBlocker({ disableScroll: true });
-        this.didLoad = false;
-        /**
-         * Flag used to determine if an open/close
-         * operation was cancelled. For example, if
-         * an app calls "menu.open" then disables the menu
-         * part way through the animation, then this would
-         * be considered a cancelled operation.
-         */
-        this.operationCancelled = false;
-        this.isAnimating = false;
-        this._isOpen = false;
-        this.inheritedAttributes = {};
-        this.handleFocus = (ev) => {
-            /**
-             * Overlays have their own focus trapping listener
-             * so we do not want the two listeners to conflict
-             * with each other. If the top-most overlay that is
-             * open does not contain this ion-menu, then ion-menu's
-             * focus trapping should not run.
-             */
-            const lastOverlay = getPresentedOverlay(document);
-            if (lastOverlay && !lastOverlay.contains(this.el)) {
-                return;
-            }
-            this.trapKeyboardFocus(ev, document);
-        };
-        /**
-         * If true, then the menu should be
-         * visible within a split pane.
-         * If false, then the menu is hidden.
-         * However, the menu-button/menu-toggle
-         * components can be used to open the
-         * menu.
-         */
-        this.isPaneVisible = false;
-        this.isEndSide = false;
-        /**
-         * If `true`, the menu is disabled.
-         */
-        this.disabled = false;
-        /**
-         * Which side of the view the menu should be placed.
-         */
-        this.side = 'start';
-        /**
-         * If `true`, swiping the menu is enabled.
-         */
-        this.swipeGesture = true;
+    animation;
+    lastOnEnd = 0;
+    gesture;
+    blocker = GESTURE_CONTROLLER.createBlocker({ disableScroll: true });
+    didLoad = false;
+    /**
+     * Flag used to determine if an open/close
+     * operation was cancelled. For example, if
+     * an app calls "menu.open" then disables the menu
+     * part way through the animation, then this would
+     * be considered a cancelled operation.
+     */
+    operationCancelled = false;
+    isAnimating = false;
+    width;
+    _isOpen = false;
+    backdropEl;
+    menuInnerEl;
+    contentEl;
+    lastFocus;
+    inheritedAttributes = {};
+    handleFocus = (ev) => {
         /**
-         * The edge threshold for dragging the menu open.
-         * If a drag/swipe happens over this value, the menu is not triggered.
+         * Overlays have their own focus trapping listener
+         * so we do not want the two listeners to conflict
+         * with each other. If the top-most overlay that is
+         * open does not contain this ion-menu, then ion-menu's
+         * focus trapping should not run.
          */
-        this.maxEdgeStart = 50;
-    }
+        const lastOverlay = getPresentedOverlay(document);
+        if (lastOverlay && !lastOverlay.contains(this.el)) {
+            return;
+        }
+        this.trapKeyboardFocus(ev, document);
+    };
+    el;
+    /**
+     * If true, then the menu should be
+     * visible within a split pane.
+     * If false, then the menu is hidden.
+     * However, the menu-button/menu-toggle
+     * components can be used to open the
+     * menu.
+     */
+    isPaneVisible = false;
+    isEndSide = false;
+    /**
+     * The `id` of the main content. When using
+     * a router this is typically `ion-router-outlet`.
+     * When not using a router, this is typically
+     * your main view's `ion-content`. This is not the
+     * id of the `ion-content` inside of your `ion-menu`.
+     */
+    contentId;
+    /**
+     * An id for the menu.
+     */
+    menuId;
+    /**
+     * The display type of the menu.
+     * Available options: `"overlay"`, `"reveal"`, `"push"`.
+     */
+    type;
     typeChanged(type, oldType) {
         const contentEl = this.contentEl;
         if (contentEl) {
@@ -95,6 +101,10 @@ export class Menu {
         }
         this.animation = undefined;
     }
+    /**
+     * If `true`, the menu is disabled.
+     */
+    disabled = false;
     disabledChanged() {
         this.updateState();
         this.ionMenuChange.emit({
@@ -102,6 +112,10 @@ export class Menu {
             open: this._isOpen,
         });
     }
+    /**
+     * Which side of the view the menu should be placed.
+     */
+    side = 'start';
     sideChanged() {
         this.isEndSide = isEnd(this.side);
         /**
@@ -110,9 +124,39 @@ export class Menu {
          */
         this.animation = undefined;
     }
+    /**
+     * If `true`, swiping the menu is enabled.
+     */
+    swipeGesture = true;
     swipeGestureChanged() {
         this.updateState();
     }
+    /**
+     * The edge threshold for dragging the menu open.
+     * If a drag/swipe happens over this value, the menu is not triggered.
+     */
+    maxEdgeStart = 50;
+    /**
+     * Emitted when the menu is about to be opened.
+     */
+    ionWillOpen;
+    /**
+     * Emitted when the menu is about to be closed.
+     */
+    ionWillClose;
+    /**
+     * Emitted when the menu is open.
+     */
+    ionDidOpen;
+    /**
+     * Emitted when the menu is closed.
+     */
+    ionDidClose;
+    /**
+     * Emitted when the menu state is changed.
+     * @internal
+     */
+    ionMenuChange;
     async connectedCallback() {
         // TODO: connectedCallback is fired in CE build
         // before WC is defined. This needs to be fixed in Stencil.
@@ -293,9 +337,8 @@ export class Menu {
      * @param role The role of the element that is closing the menu.
      */
     setOpen(shouldOpen, animated = true, role) {
-        var _a;
         // Blur the active element to prevent it from being kept focused inside an element that will be set with aria-hidden="true"
-        (_a = document.activeElement) === null || _a === void 0 ? void 0 : _a.blur();
+        document.activeElement?.blur();
         return menuController._setOpen(this, shouldOpen, animated, role);
     }
     trapKeyboardFocus(ev, doc) {
@@ -555,7 +598,6 @@ export class Menu {
         }
     }
     afterAnimation(isOpen, role) {
-        var _a;
         // keep opening/closing the menu disabled for a touch more yet
         // only add listeners/css if it's enabled and isOpen
         // and only remove listeners/css if it's not open
@@ -583,7 +625,7 @@ export class Menu {
              * it isn't already focused. Use the host element instead of the
              * first descendant to avoid the scroll position jumping around.
              */
-            const focusedMenu = (_a = document.activeElement) === null || _a === void 0 ? void 0 : _a.closest('ion-menu');
+            const focusedMenu = document.activeElement?.closest('ion-menu');
             if (focusedMenu !== this.el) {
                 this.el.focus();
             }

package/dist/collection/components/menu-button/menu-button.js

@@ -16,25 +16,31 @@ import { updateVisibility } from "../menu-toggle/menu-toggle-util";
  * @part icon - The menu button icon (uses ion-icon).
  */
 export class MenuButton {
-    constructor() {
-        this.inheritedAttributes = {};
-        this.visible = false;
-        /**
-         * If `true`, the user cannot interact with the menu button.
-         */
-        this.disabled = false;
-        /**
-         * Automatically hides the menu button when the corresponding menu is not active
-         */
-        this.autoHide = true;
-        /**
-         * The type of the button.
-         */
-        this.type = 'button';
-        this.onClick = async () => {
-            return menuController.toggle(this.menu);
-        };
-    }
+    inheritedAttributes = {};
+    el;
+    visible = false;
+    /**
+     * The color to use from your application's color palette.
+     * Default options are: `"primary"`, `"secondary"`, `"tertiary"`, `"success"`, `"warning"`, `"danger"`, `"light"`, `"medium"`, and `"dark"`.
+     * For more information on colors, see [theming](/docs/theming/basics).
+     */
+    color;
+    /**
+     * If `true`, the user cannot interact with the menu button.
+     */
+    disabled = false;
+    /**
+     * Optional property that maps to a Menu's `menuId` prop. Can also be `start` or `end` for the menu side. This is used to find the correct menu to toggle
+     */
+    menu;
+    /**
+     * Automatically hides the menu button when the corresponding menu is not active
+     */
+    autoHide = true;
+    /**
+     * The type of the button.
+     */
+    type = 'button';
     componentWillLoad() {
         this.inheritedAttributes = inheritAriaAttributes(this.el);
     }
@@ -44,6 +50,9 @@ export class MenuButton {
     async visibilityChanged() {
         this.visible = await updateVisibility(this.menu);
     }
+    onClick = async () => {
+        return menuController.toggle(this.menu);
+    };
     render() {
         const { color, disabled, inheritedAttributes } = this;
         const mode = getIonMode(this);
@@ -62,7 +71,7 @@ export class MenuButton {
                 'in-toolbar-color': hostContext('ion-toolbar[color]', this.el),
                 'ion-activatable': true,
                 'ion-focusable': true,
-            }) }, h("button", Object.assign({ key: '7c4a449e239679376f38471d95fd602f9caec5f6' }, attrs, { disabled: disabled, class: "button-native", part: "native", "aria-label": ariaLabel }), h("span", { key: '8bb5bf453280a66109198c970b678ad800c7a8cf', class: "button-inner" }, h("slot", { key: '7f78b1e7a0695f2bd600d13ca81f50dd8b965726' }, h("ion-icon", { key: '9f67f5bb06b1f03a6e5df9ecbe23ebf69fb40756', part: "icon", icon: menuIcon, mode: mode, lazy: false, "aria-hidden": "true" }))), mode === 'md' && h("ion-ripple-effect", { key: '10be7145c614144e94c3cc0b92dc5ee4e1587fe6', type: "unbounded" }))));
+            }) }, h("button", { key: '7c4a449e239679376f38471d95fd602f9caec5f6', ...attrs, disabled: disabled, class: "button-native", part: "native", "aria-label": ariaLabel }, h("span", { key: '8bb5bf453280a66109198c970b678ad800c7a8cf', class: "button-inner" }, h("slot", { key: '7f78b1e7a0695f2bd600d13ca81f50dd8b965726' }, h("ion-icon", { key: '9f67f5bb06b1f03a6e5df9ecbe23ebf69fb40756', part: "icon", icon: menuIcon, mode: mode, lazy: false, "aria-hidden": "true" }))), mode === 'md' && h("ion-ripple-effect", { key: '10be7145c614144e94c3cc0b92dc5ee4e1587fe6', type: "unbounded" }))));
     }
     static get is() { return "ion-menu-button"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/menu-toggle/menu-toggle.js

@@ -9,25 +9,32 @@ import { updateVisibility } from "./menu-toggle-util";
  * @slot - Content is placed inside the toggle to act as the click target.
  */
 export class MenuToggle {
-    constructor() {
-        this.visible = false;
-        /**
-         * Automatically hides the content when the corresponding menu is not active.
-         *
-         * By default, it's `true`. Change it to `false` in order to
-         * keep `ion-menu-toggle` always visible regardless the state of the menu.
-         */
-        this.autoHide = true;
-        this.onClick = () => {
-            return menuController.toggle(this.menu);
-        };
-    }
+    visible = false;
+    /**
+     * Optional property that maps to a Menu's `menuId` prop.
+     * Can also be `start` or `end` for the menu side.
+     * This is used to find the correct menu to toggle.
+     *
+     * If this property is not used, `ion-menu-toggle` will toggle the
+     * first menu that is active.
+     */
+    menu;
+    /**
+     * Automatically hides the content when the corresponding menu is not active.
+     *
+     * By default, it's `true`. Change it to `false` in order to
+     * keep `ion-menu-toggle` always visible regardless the state of the menu.
+     */
+    autoHide = true;
     connectedCallback() {
         this.visibilityChanged();
     }
     async visibilityChanged() {
         this.visible = await updateVisibility(this.menu);
     }
+    onClick = () => {
+        return menuController.toggle(this.menu);
+    };
     render() {
         const mode = getIonMode(this);
         const hidden = this.autoHide && !this.visible;

package/dist/collection/components/modal/animations/ios.enter.js

@@ -26,7 +26,7 @@ export const iosEnterAnimation = (baseEl, opts) => {
     wrapperAnimation.addElement(root.querySelectorAll('.modal-wrapper, .modal-shadow')).beforeStyles({ opacity: 1 });
     // The content animation is only added if scrolling is enabled for
     // all the breakpoints.
-    !expandToScroll && (contentAnimation === null || contentAnimation === void 0 ? void 0 : contentAnimation.addElement(baseEl.querySelector('.ion-page')));
+    !expandToScroll && contentAnimation?.addElement(baseEl.querySelector('.ion-page'));
     const baseAnimation = createAnimation('entering-base')
         .addElement(baseEl)
         .easing('cubic-bezier(0.32,0.72,0,1)')

package/dist/collection/components/modal/animations/md.enter.js

@@ -28,7 +28,7 @@ export const mdEnterAnimation = (baseEl, opts) => {
     wrapperAnimation.addElement(root.querySelector('.modal-wrapper'));
     // The content animation is only added if scrolling is enabled for
     // all the breakpoints.
-    !expandToScroll && (contentAnimation === null || contentAnimation === void 0 ? void 0 : contentAnimation.addElement(baseEl.querySelector('.ion-page')));
+    !expandToScroll && contentAnimation?.addElement(baseEl.querySelector('.ion-page'));
     const baseAnimation = createAnimation()
         .addElement(baseEl)
         .easing('cubic-bezier(0.36,0.66,0.04,1)')