@ionic/core 7.4.4-dev.11696956070.1faa3cfe → 7.4.4-dev.11699471770.1b7273c4

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

@@ -6,13 +6,12 @@ import { getElementRoot } from "../../../utils/helpers";
 /**
  * iOS Toast Enter Animation
  */
-export const iosEnterAnimation = (baseEl, position) => {
+export const iosEnterAnimation = (baseEl, opts) => {
   const baseAnimation = createAnimation();
   const wrapperAnimation = createAnimation();
+  const { position, top, bottom } = opts;
   const root = getElementRoot(baseEl);
   const wrapperEl = root.querySelector('.toast-wrapper');
-  const bottom = `calc(-10px - var(--ion-safe-area-bottom, 0px))`;
-  const top = `calc(10px + var(--ion-safe-area-top, 0px))`;
   wrapperAnimation.addElement(wrapperEl);
   switch (position) {
     case 'top':

package/dist/collection/components/toast/animations/ios.leave.js

@@ -6,13 +6,12 @@ import { getElementRoot } from "../../../utils/helpers";
 /**
  * iOS Toast Leave Animation
  */
-export const iosLeaveAnimation = (baseEl, position) => {
+export const iosLeaveAnimation = (baseEl, opts) => {
   const baseAnimation = createAnimation();
   const wrapperAnimation = createAnimation();
+  const { position, top, bottom } = opts;
   const root = getElementRoot(baseEl);
   const wrapperEl = root.querySelector('.toast-wrapper');
-  const bottom = `calc(-10px - var(--ion-safe-area-bottom, 0px))`;
-  const top = `calc(10px + var(--ion-safe-area-top, 0px))`;
   wrapperAnimation.addElement(wrapperEl);
   switch (position) {
     case 'top':

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

@@ -6,13 +6,12 @@ import { getElementRoot } from "../../../utils/helpers";
 /**
  * MD Toast Enter Animation
  */
-export const mdEnterAnimation = (baseEl, position) => {
+export const mdEnterAnimation = (baseEl, opts) => {
   const baseAnimation = createAnimation();
   const wrapperAnimation = createAnimation();
+  const { position, top, bottom } = opts;
   const root = getElementRoot(baseEl);
   const wrapperEl = root.querySelector('.toast-wrapper');
-  const bottom = `calc(8px + var(--ion-safe-area-bottom, 0px))`;
-  const top = `calc(8px + var(--ion-safe-area-top, 0px))`;
   wrapperAnimation.addElement(wrapperEl);
   switch (position) {
     case 'top':

package/dist/collection/components/toast/animations/utils.js

@@ -0,0 +1,85 @@
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
+import { win } from "../../../utils/browser/index";
+import { printIonWarning } from "../../../utils/logging/index";
+/**
+ * Calculate the CSS top and bottom position of the toast, to be used
+ * as starting points for the animation keyframes.
+ *
+ * Note that MD animates bottom-positioned toasts using style.bottom,
+ * which calculates from the bottom edge of the screen, while iOS uses
+ * translateY, which calculates from the top edge of the screen. This
+ * is why the bottom calculates differ slightly between modes.
+ *
+ * @param position The value of the toast's position prop.
+ * @param positionAnchor The element the toast should be anchored to,
+ * if applicable.
+ * @param mode The toast component's mode (md, ios, etc).
+ * @param toast A reference to the toast element itself.
+ */
+export function getAnimationPosition(position, positionAnchor, mode, toast) {
+  /**
+   * Start with a predefined offset from the edge the toast will be
+   * positioned relative to, whether on the screen or anchor element.
+   */
+  let offset;
+  if (mode === 'md') {
+    offset = 8;
+  }
+  else {
+    offset = position === 'top' ? 10 : -10;
+  }
+  /**
+   * If positionAnchor is defined, add in the distance from the target
+   * screen edge to the target anchor edge. For position="top", the
+   * bottom anchor edge is targeted. For position="bottom", the top
+   * anchor edge is targeted.
+   */
+  if (positionAnchor && win) {
+    warnIfAnchorIsHidden(positionAnchor, toast);
+    const box = positionAnchor.getBoundingClientRect();
+    if (position === 'top') {
+      offset += box.bottom;
+    }
+    else if (position === 'bottom') {
+      /**
+       * Just box.top is the distance from the top edge of the screen
+       * to the top edge of the anchor. We want to calculate from the
+       * bottom edge of the screen instead.
+       */
+      if (mode === 'md') {
+        offset += win.innerHeight - box.top;
+      }
+      else {
+        offset -= win.innerHeight - box.top;
+      }
+    }
+    /**
+     * We don't include safe area here because that should already be
+     * accounted for when checking the position of the anchor.
+     */
+    return {
+      top: `${offset}px`,
+      bottom: `${offset}px`,
+    };
+  }
+  else {
+    return {
+      top: `calc(${offset}px + var(--ion-safe-area-top, 0px))`,
+      bottom: mode === 'md'
+        ? `calc(${offset}px + var(--ion-safe-area-bottom, 0px))`
+        : `calc(${offset}px - var(--ion-safe-area-bottom, 0px))`,
+    };
+  }
+}
+/**
+ * If the anchor element is hidden, getBoundingClientRect()
+ * will return all 0s for it, which can cause unexpected
+ * results in the position calculation when animating.
+ */
+function warnIfAnchorIsHidden(positionAnchor, toast) {
+  if (positionAnchor.offsetParent === null) {
+    printIonWarning('The positionAnchor element for ion-toast was found in the DOM, but appears to be hidden. This may lead to unexpected positioning of the toast.', toast);
+  }
+}

package/dist/collection/components/toast/test/position-anchor/toast.e2e.js

@@ -0,0 +1,45 @@
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
+import { expect } from "@playwright/test";
+import { configs, test } from "../../../../utils/test/playwright/index";
+configs({ directions: ['ltr'] }).forEach(({ title, screenshot, config }) => {
+  test.describe(title('toast: positionAnchor'), () => {
+    test.beforeEach(async ({ page }) => {
+      await page.goto('/src/components/toast/test/position-anchor', config);
+      /**
+       * We need to screenshot the whole page to ensure the toasts are positioned
+       * correctly, but we don't need much extra white space between the header
+       * and footer.
+       */
+      await page.setViewportSize({
+        width: 425,
+        height: 425,
+      });
+    });
+    test('should place top-position toast underneath anchor', async ({ page }) => {
+      const ionToastDidPresent = await page.spyOnEvent('ionToastDidPresent');
+      await page.click('#headerAnchor');
+      await ionToastDidPresent.next();
+      await expect(page).toHaveScreenshot(screenshot(`toast-header-anchor`));
+    });
+    test('should place bottom-position toast above anchor', async ({ page }) => {
+      const ionToastDidPresent = await page.spyOnEvent('ionToastDidPresent');
+      await page.click('#footerAnchor');
+      await ionToastDidPresent.next();
+      await expect(page).toHaveScreenshot(screenshot(`toast-footer-anchor`));
+    });
+    test('should ignore anchor for middle-position toast', async ({ page }) => {
+      const ionToastDidPresent = await page.spyOnEvent('ionToastDidPresent');
+      await page.click('#middleAnchor');
+      await ionToastDidPresent.next();
+      await expect(page).toHaveScreenshot(screenshot(`toast-middle-anchor`));
+    });
+    test('should correctly anchor toast when using an element reference', async ({ page }) => {
+      const ionToastDidPresent = await page.spyOnEvent('ionToastDidPresent');
+      await page.click('#headerElAnchor');
+      await ionToastDidPresent.next();
+      await expect(page).toHaveScreenshot(screenshot(`toast-header-el-anchor`));
+    });
+  });
+});

package/dist/collection/components/toast/toast.js

@@ -15,6 +15,7 @@ import { iosEnterAnimation } from "./animations/ios.enter";
 import { iosLeaveAnimation } from "./animations/ios.leave";
 import { mdEnterAnimation } from "./animations/md.enter";
 import { mdLeaveAnimation } from "./animations/md.leave";
+import { getAnimationPosition } from "./animations/utils";
 // TODO(FW-2832): types
 /**
  * @virtualProp {"ios" | "md"} mode - The mode determines which platform styles to use.
@@ -54,6 +55,7 @@ export class Toast {
     this.message = undefined;
     this.keyboardClose = false;
     this.position = 'bottom';
+    this.positionAnchor = undefined;
     this.buttons = undefined;
     this.translucent = false;
     this.animated = true;
@@ -101,7 +103,19 @@ export class Toast {
   async present() {
     const unlock = await this.lockController.lock();
     await this.delegateController.attachViewToDom();
-    await present(this, 'toastEnter', iosEnterAnimation, mdEnterAnimation, this.position);
+    const { el, position } = this;
+    const anchor = this.getAnchorElement();
+    const animationPosition = getAnimationPosition(position, anchor, getIonMode(this), el);
+    /**
+     * Cache the calculated position of the toast, so we can re-use it
+     * in the dismiss animation.
+     */
+    this.lastPresentedPosition = animationPosition;
+    await present(this, 'toastEnter', iosEnterAnimation, mdEnterAnimation, {
+      position,
+      top: animationPosition.top,
+      bottom: animationPosition.bottom,
+    });
     /**
      * Content is revealed to screen readers after
      * the transition to avoid jank since this
@@ -123,15 +137,28 @@ export class Toast {
    * Some examples include: ``"cancel"`, `"destructive"`, "selected"`, and `"backdrop"`.
    */
   async dismiss(data, role) {
+    var _a, _b;
     const unlock = await this.lockController.lock();
-    if (this.durationTimeout) {
-      clearTimeout(this.durationTimeout);
+    const { durationTimeout, position, lastPresentedPosition } = this;
+    if (durationTimeout) {
+      clearTimeout(durationTimeout);
     }
-    const dismissed = await dismiss(this, data, role, 'toastLeave', iosLeaveAnimation, mdLeaveAnimation, this.position);
+    const dismissed = await dismiss(this, data, role, 'toastLeave', iosLeaveAnimation, mdLeaveAnimation, 
+    /**
+     * Fetch the cached position that was calculated back in the present
+     * animation. We always want to animate the dismiss from the same
+     * position the present stopped at, so the animation looks continuous.
+     */
+    {
+      position,
+      top: (_a = lastPresentedPosition === null || lastPresentedPosition === void 0 ? void 0 : lastPresentedPosition.top) !== null && _a !== void 0 ? _a : '',
+      bottom: (_b = lastPresentedPosition === null || lastPresentedPosition === void 0 ? void 0 : lastPresentedPosition.bottom) !== null && _b !== void 0 ? _b : '',
+    });
     if (dismissed) {
       this.delegateController.removeViewFromDom();
       this.revealContentToScreenReader = false;
     }
+    this.lastPresentedPosition = undefined;
     unlock();
     return dismissed;
   }
@@ -155,6 +182,44 @@ export class Toast {
       : [];
     return buttons;
   }
+  /**
+   * Returns the element specified by the positionAnchor prop,
+   * or undefined if prop's value is an ID string and the element
+   * is not found in the DOM.
+   */
+  getAnchorElement() {
+    const { position, positionAnchor, el } = this;
+    /**
+     * If positionAnchor is undefined then
+     * no anchor should be used when presenting the toast.
+     */
+    if (positionAnchor === undefined) {
+      return;
+    }
+    if (position === 'middle' && positionAnchor !== undefined) {
+      printIonWarning('The positionAnchor property is ignored when using position="middle".', this.el);
+      return undefined;
+    }
+    if (typeof positionAnchor === 'string') {
+      /**
+       * If the anchor is defined as an ID, find the element.
+       * We do this on every present so the toast doesn't need
+       * to account for the surrounding DOM changing since the
+       * last time it was presented.
+       */
+      const foundEl = document.getElementById(positionAnchor);
+      if (foundEl === null) {
+        printIonWarning(`An anchor element with an ID of "${positionAnchor}" was not found in the DOM.`, el);
+        return undefined;
+      }
+      return foundEl;
+    }
+    if (positionAnchor instanceof HTMLElement) {
+      return positionAnchor;
+    }
+    printIonWarning('Invalid positionAnchor value:', positionAnchor, el);
+    return undefined;
+  }
   async buttonClick(button) {
     const role = button.role;
     if (isCancel(role)) {
@@ -517,12 +582,34 @@ export class Toast {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "The position of the toast on the screen."
+          "text": "The starting position of the toast on the screen. Can be tweaked further\nusing the `positionAnchor` property."
         },
         "attribute": "position",
         "reflect": false,
         "defaultValue": "'bottom'"
       },
+      "positionAnchor": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "HTMLElement | string",
+          "resolved": "HTMLElement | string | undefined",
+          "references": {
+            "HTMLElement": {
+              "location": "global",
+              "id": "global::HTMLElement"
+            }
+          }
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": "The element to anchor the toast's position to. Can be set as a direct reference\nor the ID of the element. With `position=\"bottom\"`, the toast will sit above the\nchosen element. With `position=\"top\"`, the toast will sit below the chosen element.\nWith `position=\"middle\"`, the value of `positionAnchor` is ignored."
+        },
+        "attribute": "position-anchor",
+        "reflect": false
+      },
       "buttons": {
         "type": "unknown",
         "mutable": false,
@@ -813,8 +900,9 @@ export class Toast {
               "id": "global::Promise"
             },
             "ToastPresentOptions": {
-              "location": "global",
-              "id": "global::ToastPresentOptions"
+              "location": "import",
+              "path": "./toast-interface",
+              "id": "src/components/toast/toast-interface.ts::ToastPresentOptions"
             }
           },
           "return": "Promise<void>"
@@ -846,8 +934,9 @@ export class Toast {
               "id": "global::Promise"
             },
             "ToastDismissOptions": {
-              "location": "global",
-              "id": "global::ToastDismissOptions"
+              "location": "import",
+              "path": "./toast-interface",
+              "id": "src/components/toast/toast-interface.ts::ToastDismissOptions"
             }
           },
           "return": "Promise<boolean>"

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

@@ -44,9 +44,6 @@ export class Toggle {
       }
     };
     this.onClick = (ev) => {
-      if (this.disabled) {
-        return;
-      }
       ev.preventDefault();
       if (this.lastDrag + 300 < Date.now()) {
         this.toggleChecked();

package/dist/collection/index.js

@@ -13,6 +13,7 @@ export { componentOnReady } from './utils/helpers';
 export { isPlatform, getPlatforms } from './utils/platform';
 export { IonicSafeString } from './utils/sanitization';
 export { getMode, setupConfig } from './utils/config';
+export { openURL } from './utils/theme';
 export { LIFECYCLE_WILL_ENTER, LIFECYCLE_DID_ENTER, LIFECYCLE_WILL_LEAVE, LIFECYCLE_DID_LEAVE, LIFECYCLE_WILL_UNLOAD, } from './components/nav/constants';
 export { menuController } from './utils/menu-controller';
 export { alertController, actionSheetController, modalController, loadingController, pickerController, popoverController, toastController, } from './utils/overlays';

package/dist/collection/utils/native/haptic.js

@@ -75,6 +75,7 @@ const HapticEngine = {
      * if the browser does not support the Vibrate API.
      */
     if ((capacitor === null || capacitor === void 0 ? void 0 : capacitor.getPlatform()) === 'web') {
+      // eslint-disable-next-line @typescript-eslint/prefer-optional-chain
       return typeof navigator !== 'undefined' && navigator.vibrate !== undefined;
     }
     return true;

package/dist/collection/utils/overlays.js

@@ -68,6 +68,7 @@ export const setOverlayId = (el) => {
   return el.id;
 };
 export const createOverlay = (tagName, opts) => {
+  // eslint-disable-next-line @typescript-eslint/prefer-optional-chain
   if (typeof window !== 'undefined' && typeof window.customElements !== 'undefined') {
     return window.customElements.whenDefined(tagName).then(() => {
       const element = document.createElement(tagName);

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

@@ -202,6 +202,7 @@ export const iosTransitionAnimation = (navEl, opts) => {
       .easing(opts.easing || EASING)
       .fill('both')
       .beforeRemoveClass('ion-page-invisible');
+    // eslint-disable-next-line @typescript-eslint/prefer-optional-chain
     if (leavingEl && navEl !== null && navEl !== undefined) {
       const navDecorAnimation = createAnimation();
       navDecorAnimation.addElement(navEl);

package/dist/docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2023-10-10T16:43:54",
+  "timestamp": "2023-11-08T19:31:44",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.4.0",
@@ -7102,11 +7102,17 @@
         },
         {
           "name": "hourCycle",
-          "type": "\"h12\" | \"h23\" | undefined",
+          "type": "\"h11\" | \"h12\" | \"h23\" | \"h24\" | undefined",
           "complexType": {
-            "original": "'h23' | 'h12'",
-            "resolved": "\"h12\" | \"h23\" | undefined",
-            "references": {}
+            "original": "DatetimeHourCycle",
+            "resolved": "\"h11\" | \"h12\" | \"h23\" | \"h24\" | undefined",
+            "references": {
+              "DatetimeHourCycle": {
+                "location": "import",
+                "path": "./datetime-interface",
+                "id": "src/components/datetime/datetime-interface.ts::DatetimeHourCycle"
+              }
+            }
           },
           "mutable": false,
           "attr": "hour-cycle",
@@ -7114,6 +7120,10 @@
           "docs": "The hour cycle of the `ion-datetime`. If no value is set, this is\nspecified by the current locale.",
           "docsTags": [],
           "values": [
+            {
+              "value": "h11",
+              "type": "string"
+            },
             {
               "value": "h12",
               "type": "string"
@@ -7122,6 +7132,10 @@
               "value": "h23",
               "type": "string"
             },
+            {
+              "value": "h24",
+              "type": "string"
+            },
             {
               "type": "undefined"
             }
@@ -27719,7 +27733,7 @@
           "mutable": false,
           "attr": "position",
           "reflectToAttr": false,
-          "docs": "The position of the toast on the screen.",
+          "docs": "The starting position of the toast on the screen. Can be tweaked further\nusing the `positionAnchor` property.",
           "docsTags": [],
           "default": "'bottom'",
           "values": [
@@ -27739,6 +27753,38 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "positionAnchor",
+          "type": "HTMLElement | string | undefined",
+          "complexType": {
+            "original": "HTMLElement | string",
+            "resolved": "HTMLElement | string | undefined",
+            "references": {
+              "HTMLElement": {
+                "location": "global",
+                "id": "global::HTMLElement"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "position-anchor",
+          "reflectToAttr": false,
+          "docs": "The element to anchor the toast's position to. Can be set as a direct reference\nor the ID of the element. With `position=\"bottom\"`, the toast will sit above the\nchosen element. With `position=\"top\"`, the toast will sit below the chosen element.\nWith `position=\"middle\"`, the value of `positionAnchor` is ignored.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "HTMLElement"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
         {
           "name": "translucent",
           "type": "boolean",
@@ -27821,8 +27867,9 @@
                 "id": "global::Promise"
               },
               "ToastDismissOptions": {
-                "location": "global",
-                "id": "global::ToastDismissOptions"
+                "location": "import",
+                "path": "./toast-interface",
+                "id": "src/components/toast/toast-interface.ts::ToastDismissOptions"
               }
             },
             "return": "Promise<boolean>"
@@ -27918,8 +27965,9 @@
                 "id": "global::Promise"
               },
               "ToastPresentOptions": {
-                "location": "global",
-                "id": "global::ToastPresentOptions"
+                "location": "import",
+                "path": "./toast-interface",
+                "id": "src/components/toast/toast-interface.ts::ToastPresentOptions"
               }
             },
             "return": "Promise<void>"
@@ -28995,6 +29043,11 @@
       "docstring": "",
       "path": "src/components/datetime/datetime-interface.ts"
     },
+    "src/components/datetime/datetime-interface.ts::DatetimeHourCycle": {
+      "declaration": "export type DatetimeHourCycle = 'h11' | 'h12' | 'h23' | 'h24';",
+      "docstring": "",
+      "path": "src/components/datetime/datetime-interface.ts"
+    },
     "src/components/datetime/datetime-interface.ts::DatetimeChangeEventDetail": {
       "declaration": "export interface DatetimeChangeEventDetail {\n  value?: string | string[] | null;\n}",
       "docstring": "",
@@ -29290,6 +29343,16 @@
       "docstring": "",
       "path": "src/components/toast/toast-interface.ts"
     },
+    "src/components/toast/toast-interface.ts::ToastPresentOptions": {
+      "declaration": "export type ToastPresentOptions = ToastPositionAlias & ToastAnimationPosition;",
+      "docstring": "",
+      "path": "src/components/toast/toast-interface.ts"
+    },
+    "src/components/toast/toast-interface.ts::ToastDismissOptions": {
+      "declaration": "export type ToastDismissOptions = ToastPositionAlias & ToastAnimationPosition;",
+      "docstring": "",
+      "path": "src/components/toast/toast-interface.ts"
+    },
     "src/components/toggle/toggle-interface.ts::ToggleChangeEventDetail": {
       "declaration": "export interface ToggleChangeEventDetail<T = any> {\n  value: T;\n  checked: boolean;\n}",
       "docstring": "",

package/dist/esm/{button-active-7180a130.js → button-active-3dd473a1.js}

@@ -2,7 +2,7 @@
  * (C) Ionic http://ionicframework.com - MIT License
  */
 import { w as writeTask } from './index-cb894020.js';
-import { h as hapticSelectionEnd, a as hapticSelectionStart, b as hapticSelectionChanged } from './haptic-6447af60.js';
+import { h as hapticSelectionEnd, a as hapticSelectionStart, b as hapticSelectionChanged } from './haptic-1243b917.js';
 import { createGesture } from './index-ff313b19.js';
 
 const createButtonActiveGesture = (el, isButton) => {