@ionic/core 8.8.19 → 8.8.20-dev.11787158518.168a2fea

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

@@ -1,20 +1,20 @@
 /*!
  * (C) Ionic http://ionicframework.com - MIT License
  */
-import { r as registerInstance, c as createEvent, e as config, j as printIonError, h, d as Host, g as getElement } from './index-tcQvqkiX.js';
+import { r as registerInstance, c as createEvent, g as getElement, e as config, j as printIonError, h, d as Host } from './index-ChhhtsGZ.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-COCl_nm9.js';
-import { G as GESTURE_CONTROLLER } from './gesture-controller-BTEOs1at.js';
-import { shouldUseCloseWatcher } from './hardware-back-button-B93Gru0Y.js';
-import { o as isEndSide, i as inheritAriaAttributes, l as assert, e as clamp } from './helpers-DkCLSLI9.js';
-import { m as menuController } from './index-DdeElWma.js';
-import { b as getIonMode, a as isPlatform } from './ionic-global-Cp_eT4sZ.js';
-import { h as hostContext, c as createColorClasses } from './theme-DiVJyqlX.js';
-import { u as menuOutline, v as menuSharp } from './index-DV3sJJW8.js';
+import { o as getPresentedOverlay, B as BACKDROP, n as focusFirstDescendant, q as focusLastDescendant, G as GESTURE } from './overlays-CPmIs9Ls.js';
+import { G as GESTURE_CONTROLLER } from './gesture-controller-TXPDHL13.js';
+import { shouldUseCloseWatcher } from './hardware-back-button-gLJHMX_F.js';
+import { o as isEndSide, i as inheritAriaAttributes, l as assert, e as clamp } from './helpers-CAGf8Wgp.js';
+import { m as menuController } from './index-CqneaaGd.js';
+import { b as getIonMode, a as isPlatform } from './ionic-global-BVB7BrLT.js';
+import { h as hostContext, c as createColorClasses } from './theme-byZM6qHV.js';
+import { u as menuOutline, v as menuSharp } from './index-BvabGprD.js';
 import './index-ZjP4CjeZ.js';
-import './framework-delegate-B9yvYzqV.js';
-import './dir-o8OKV5aD.js';
-import './animation-DLJpuoEz.js';
+import './framework-delegate-BHTU2Ip9.js';
+import './dir-Dojwmvde.js';
+import './animation-CGFdmGk9.js';
 
 const menuIosCss = () => `:host{--width:304px;--min-width:auto;--max-width:auto;--height:100%;--min-height:auto;--max-height:auto;--background:var(--ion-background-color, #fff);left:0;right:0;top:0;bottom:0;display:none;position:absolute;contain:strict}:host(.show-menu){display:block}.menu-inner{-webkit-transform:translateX(-9999px);transform:translateX(-9999px);display:-ms-flexbox;display:flex;position:absolute;-ms-flex-direction:column;flex-direction:column;-ms-flex-pack:justify;justify-content:space-between;width:var(--width);min-width:var(--min-width);max-width:var(--max-width);height:var(--height);min-height:var(--min-height);max-height:var(--max-height);background:var(--background);contain:strict}:host(.menu-side-start) .menu-inner{--ion-safe-area-right:0px;top:0;bottom:0}:host(.menu-side-start) .menu-inner{inset-inline-start:0;inset-inline-end:auto}:host-context([dir=rtl]):host(.menu-side-start) .menu-inner,:host-context([dir=rtl]).menu-side-start .menu-inner{--ion-safe-area-right:unset;--ion-safe-area-left:0px}@supports selector(:dir(rtl)){:host(.menu-side-start:dir(rtl)) .menu-inner{--ion-safe-area-right:unset;--ion-safe-area-left:0px}}:host(.menu-side-end) .menu-inner{--ion-safe-area-left:0px;top:0;bottom:0}:host(.menu-side-end) .menu-inner{inset-inline-start:auto;inset-inline-end:0}:host-context([dir=rtl]):host(.menu-side-end) .menu-inner,:host-context([dir=rtl]).menu-side-end .menu-inner{--ion-safe-area-left:unset;--ion-safe-area-right:0px}@supports selector(:dir(rtl)){:host(.menu-side-end:dir(rtl)) .menu-inner{--ion-safe-area-left:unset;--ion-safe-area-right:0px}}ion-backdrop{display:none;opacity:0.01;z-index:-1}@media (max-width: 340px){.menu-inner{--width:264px}}:host(.menu-type-reveal){z-index:0}:host(.menu-type-reveal.show-menu) .menu-inner{-webkit-transform:translate3d(0,  0,  0);transform:translate3d(0,  0,  0)}:host(.menu-type-overlay){z-index:1000}:host(.menu-type-overlay) .show-backdrop{display:block;cursor:pointer}:host(.menu-pane-visible){-ms-flex:0 1 auto;flex:0 1 auto;width:var(--side-width, var(--width));min-width:var(--side-min-width, var(--min-width));max-width:var(--side-max-width, var(--max-width))}:host(.menu-pane-visible.split-pane-side){left:0;right:0;top:0;bottom:0;position:relative;-webkit-box-shadow:none;box-shadow:none;z-index:0}:host(.menu-pane-visible.split-pane-side.menu-enabled){display:-ms-flexbox;display:flex;-ms-flex-negative:0;flex-shrink:0}:host(.menu-pane-visible.split-pane-side){-ms-flex-order:-1;order:-1}:host(.menu-pane-visible.split-pane-side[side=end]){-ms-flex-order:1;order:1}:host(.menu-pane-visible) .menu-inner{left:0;right:0;width:auto;-webkit-transform:none;transform:none;-webkit-box-shadow:none;box-shadow:none}:host(.menu-pane-visible) ion-backdrop{display:hidden !important}:host(.menu-pane-visible.split-pane-side){-webkit-border-start:0;border-inline-start:0;-webkit-border-end:var(--border);border-inline-end:var(--border);border-top:0;border-bottom:0;min-width:var(--side-min-width);max-width:var(--side-max-width)}:host(.menu-pane-visible.split-pane-side[side=end]){-webkit-border-start:var(--border);border-inline-start:var(--border);-webkit-border-end:0;border-inline-end:0;border-top:0;border-bottom:0;min-width:var(--side-min-width);max-width:var(--side-max-width)}:host(.menu-type-push){z-index:1000}:host(.menu-type-push) .show-backdrop{display:block}`;
 
@@ -32,62 +32,70 @@ const Menu = class {
         this.ionDidOpen = createEvent(this, "ionDidOpen", 7);
         this.ionDidClose = createEvent(this, "ionDidClose", 7);
         this.ionMenuChange = createEvent(this, "ionMenuChange", 7);
-        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);
+    };
+    get el() { return getElement(this); }
+    /**
+     * 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) {
@@ -103,6 +111,10 @@ const Menu = class {
         }
         this.animation = undefined;
     }
+    /**
+     * If `true`, the menu is disabled.
+     */
+    disabled = false;
     disabledChanged() {
         this.updateState();
         this.ionMenuChange.emit({
@@ -110,6 +122,10 @@ const Menu = class {
             open: this._isOpen,
         });
     }
+    /**
+     * Which side of the view the menu should be placed.
+     */
+    side = 'start';
     sideChanged() {
         this.isEndSide = isEndSide(this.side, this.el);
         /**
@@ -118,9 +134,39 @@ const Menu = class {
          */
         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.
@@ -146,7 +192,7 @@ const Menu = class {
         // register this menu with the app's menu controller
         menuController._register(this);
         this.menuChanged();
-        this.gesture = (await import('./index-Bck1OwMs.js')).createGesture({
+        this.gesture = (await import('./index-DcPaH5uL.js')).createGesture({
             el: document,
             gestureName: 'menu-swipe',
             gesturePriority: 30,
@@ -298,9 +344,8 @@ const Menu = class {
      * @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) {
@@ -560,7 +605,6 @@ const Menu = class {
         }
     }
     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
@@ -588,7 +632,7 @@ const Menu = class {
              * 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();
             }
@@ -663,16 +707,15 @@ const Menu = class {
          * the ionBackButton listener in the menu controller
          * will handle closing the menu when Escape is pressed.
          */
-        return (h(Host, { key: 'e97587ece74feec95a3526bf4823538feb3b9ffc', onKeyDown: shouldUseCloseWatcher() ? null : this.onKeydown, role: "navigation", "aria-label": inheritedAttributes['aria-label'] || 'menu', class: {
+        return (h(Host, { key: '1208ba437fa58680325408d3d4c8580950da1d68', onKeyDown: shouldUseCloseWatcher() ? null : this.onKeydown, role: "navigation", "aria-label": inheritedAttributes['aria-label'] || 'menu', class: {
                 [mode]: true,
                 [`menu-type-${type}`]: true,
                 'menu-enabled': !disabled,
                 [`menu-side-${side}`]: true,
                 'menu-pane-visible': isPaneVisible,
                 'split-pane-side': hostContext('ion-split-pane', el),
-            } }, h("div", { key: '0a8694d1772558f18b38332b3936d0f21fd35ce7', class: "menu-inner", part: "container", ref: (el) => (this.menuInnerEl = el) }, h("slot", { key: '51fe03c098ed8a7f8ecdb12a1649424b4adfa59a' })), h("ion-backdrop", { key: 'cd53a4d9ffef157bd95c652be76c92961f0ff480', ref: (el) => (this.backdropEl = el), class: "menu-backdrop", tappable: false, stopPropagation: false, part: "backdrop" })));
+            } }, h("div", { key: 'c0ddc957b7a7956b41901d77ae02d91e73071c55', class: "menu-inner", part: "container", ref: (el) => (this.menuInnerEl = el) }, h("slot", { key: '6e44c56116431a024f114ab85ded1b822c942fac' })), h("ion-backdrop", { key: '5f4bbcf84444d96ec6b02bf567e1aaf95f59078d', ref: (el) => (this.backdropEl = el), class: "menu-backdrop", tappable: false, stopPropagation: false, part: "backdrop" })));
     }
-    get el() { return getElement(this); }
     static get watchers() { return {
         "type": [{
                 "typeChanged": 0
@@ -720,24 +763,32 @@ const menuButtonMdCss = () => `:host{--background:transparent;--color-focused:cu
 const MenuButton = class {
     constructor(hostRef) {
         registerInstance(this, hostRef);
-        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 = {};
+    get el() { return getElement(this); }
+    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);
     }
@@ -747,6 +798,9 @@ const MenuButton = class {
     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);
@@ -756,7 +810,7 @@ const MenuButton = class {
             type: this.type,
         };
         const ariaLabel = inheritedAttributes['aria-label'] || 'menu';
-        return (h(Host, { key: 'dcade732e366f0687d92cb9ce4065b78b0b41d24', onClick: this.onClick, "aria-disabled": disabled ? 'true' : null, "aria-hidden": hidden ? 'true' : null, class: createColorClasses(color, {
+        return (h(Host, { key: 'b8869377822b082c6c4d3f16135b50b733eabf65', onClick: this.onClick, "aria-disabled": disabled ? 'true' : null, "aria-hidden": hidden ? 'true' : null, class: createColorClasses(color, {
                 [mode]: true,
                 button: true, // ion-buttons target .button
                 'menu-button-hidden': hidden,
@@ -765,9 +819,8 @@ const MenuButton = class {
                 '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: '48fc0a7011414b60dd7d5136f247e937ae4bb8c8', ...attrs, disabled: disabled, class: "button-native", part: "native", "aria-label": ariaLabel }, h("span", { key: '8c712f28c5afd345e403a9afc525931112852708', class: "button-inner" }, h("slot", { key: 'dd872325e42baf435188478c8d1cfc416075089d' }, h("ion-icon", { key: 'a4f02bdb715b07792c17e12c7837873d70171f88', part: "icon", icon: menuIcon, mode: mode, lazy: false, "aria-hidden": "true" }))), mode === 'md' && h("ion-ripple-effect", { key: '564e2a8a804e14d1135502f7b17d8b7b9862e81b', type: "unbounded" }))));
     }
-    get el() { return getElement(this); }
 };
 MenuButton.style = {
     ios: menuButtonIosCss(),
@@ -779,31 +832,40 @@ const menuToggleCss = () => `:host(.menu-toggle-hidden){display:none}`;
 const MenuToggle = class {
     constructor(hostRef) {
         registerInstance(this, hostRef);
-        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;
-        return (h(Host, { key: '55135952f3a42cb5d21916dfb7b169d894b381e3', onClick: this.onClick, "aria-hidden": hidden ? 'true' : null, class: {
+        return (h(Host, { key: '76d21ea6493b8161860c941e3754fef1e20395cc', onClick: this.onClick, "aria-hidden": hidden ? 'true' : null, class: {
                 [mode]: true,
                 'menu-toggle-hidden': hidden,
-            } }, h("slot", { key: 'e8ecb59a6ec075b07e2a1b8fcdf7df3dd9975a03' })));
+            } }, h("slot", { key: '9383610fd3105e1928a38788eb596e313e2b07f8' })));
     }
 };
 MenuToggle.style = menuToggleCss();