@ionic/core 8.8.11 → 8.8.12-dev.11781793379.156d3260

package/dist/collection/components/col/col.js

@@ -2,12 +2,16 @@
  * (C) Ionic http://ionicframework.com - MIT License
  */
 import { Host, forceUpdate, h } from "@stencil/core";
+import { printIonWarning } from "../../utils/logging/index";
 import { matchBreakpoint } from "../../utils/media";
-import { getIonMode } from "../../global/ionic-global";
-const win = typeof window !== 'undefined' ? window : undefined;
+import { getIonTheme } from "../../global/ionic-global";
+// TODO(FW-7285): Replace with global breakpoints
 // eslint-disable-next-line @typescript-eslint/prefer-optional-chain
-const SUPPORTS_VARS = win && !!(win.CSS && win.CSS.supports && win.CSS.supports('--a: 0'));
 const BREAKPOINTS = ['', 'xs', 'sm', 'md', 'lg', 'xl'];
+/**
+ * @virtualProp {"ios" | "md"} mode - The mode determines the platform behaviors of the component.
+ * @virtualProp {"ios" | "md" | "ionic"} theme - The theme determines the visual appearance of the component.
+ */
 export class Col {
     onResize() {
         forceUpdate(this);
@@ -29,65 +33,60 @@ export class Col {
         // increase in size and we want to return the largest match
         return matched;
     }
-    calculateSize() {
-        const columns = this.getColumns('size');
+    getStyleClass(property, className, acceptsAuto = false) {
+        const colPropertyValue = this.getColumns(property);
         // If size wasn't set for any breakpoint
         // or if the user set the size without a value
         // it means we need to stick with the default and return
         // e.g. <ion-col size-md>
-        if (!columns || columns === '') {
+        if (!colPropertyValue || colPropertyValue === '') {
             return;
         }
-        // If the size is set to auto then don't calculate a size
-        const colSize = columns === 'auto'
-            ? 'auto'
-            : // If CSS supports variables we should use the grid columns var
-                SUPPORTS_VARS
-                    ? `calc(calc(${columns} / var(--ion-grid-columns, 12)) * 100%)`
-                    : // Convert the columns to a percentage by dividing by the total number
-                        // of columns (12) and then multiplying by 100
-                        (columns / 12) * 100 + '%';
-        return {
-            flex: `0 0 ${colSize}`,
-            width: `${colSize}`,
-            'max-width': `${colSize}`,
-        };
-    }
-    // Called by push, pull, and offset since they use the same calculations
-    calculatePosition(property, modifier) {
-        const columns = this.getColumns(property);
-        if (!columns) {
+        if (acceptsAuto && colPropertyValue === 'auto') {
+            return 'ion-grid-col-auto';
+        }
+        const valueNumber = parseInt(colPropertyValue);
+        if (isNaN(valueNumber)) {
             return;
         }
-        // If the number of columns passed are greater than 0 and less than
-        // 12 we can position the column, else default to auto
-        const amount = SUPPORTS_VARS
-            ? // If CSS supports variables we should use the grid columns var
-                `calc(calc(${columns} / var(--ion-grid-columns, 12)) * 100%)`
-            : // Convert the columns to a percentage by dividing by the total number
-                // of columns (12) and then multiplying by 100
-                columns > 0 && columns < 12
-                    ? (columns / 12) * 100 + '%'
-                    : 'auto';
-        return {
-            [modifier]: amount,
-        };
+        return `${className}-col--${valueNumber}`;
     }
-    calculateOffset(isRTL) {
-        return this.calculatePosition('offset', isRTL ? 'margin-right' : 'margin-left');
+    getSizeClass() {
+        return this.getStyleClass('size', 'ion-grid', true);
     }
-    calculatePull(isRTL) {
-        return this.calculatePosition('pull', isRTL ? 'left' : 'right');
+    getOrderClass() {
+        return this.getStyleClass('order', 'ion-grid-order');
     }
-    calculatePush(isRTL) {
-        return this.calculatePosition('push', isRTL ? 'right' : 'left');
+    getOffsetClass() {
+        return this.getStyleClass('offset', 'ion-grid-offset');
+    }
+    componentDidLoad() {
+        if (this.pull ||
+            this.pullLg ||
+            this.pullMd ||
+            this.pullSm ||
+            this.pullXl ||
+            this.pullXs ||
+            this.push ||
+            this.pushLg ||
+            this.pushMd ||
+            this.pushSm ||
+            this.pushXl ||
+            this.pushXs) {
+            printIonWarning('[ion-col] - The pull and push properties are deprecated and no longer work, in favor of the order and size properties.', this.el);
+        }
     }
     render() {
-        const isRTL = document.dir === 'rtl';
-        const mode = getIonMode(this);
-        return (h(Host, { key: '32ed75d81dd09d9bc8999f6d42e5b3cb99c84d91', class: {
-                [mode]: true,
-            }, style: Object.assign(Object.assign(Object.assign(Object.assign({}, this.calculateOffset(isRTL)), this.calculatePull(isRTL)), this.calculatePush(isRTL)), this.calculateSize()) }, h("slot", { key: '38f8d0440c20cc6d1b1d6a654d07f16de61d8134' })));
+        const theme = getIonTheme(this);
+        const colSize = this.getSizeClass();
+        const colOrder = this.getOrderClass();
+        const colOffset = this.getOffsetClass();
+        return (h(Host, { key: '7fc98e15bd75e9c22fe7eaf71f2f49f5d987613a', class: {
+                [theme]: true,
+                [`${colSize}`]: colSize !== undefined,
+                [`${colOrder}`]: colOrder !== undefined,
+                [`${colOffset}`]: colOffset !== undefined,
+            } }, h("slot", { key: '6ed04a2c2bcdb0400354368c568e58414a60fc39' })));
     }
     static get is() { return "ion-col"; }
     static get encapsulation() { return "shadow"; }
@@ -217,7 +216,26 @@ export class Col {
                 "reflect": false,
                 "attribute": "offset-xl"
             },
-            "pull": {
+            "order": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "The order of the column, in terms of where the column should position itself in the columns renderer.\nIf no value is passed, the column order implicit value will be the order in the html structure."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "order"
+            },
+            "orderXs": {
                 "type": "string",
                 "mutable": false,
                 "complexType": {
@@ -229,6 +247,104 @@ export class Col {
                 "optional": true,
                 "docs": {
                     "tags": [],
+                    "text": "The order of the column for xs screens, in terms of where the column should position itself in the columns renderer.\nIf no value is passed, the column order implicit value will be the order in the html structure."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "order-xs"
+            },
+            "orderSm": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "The order of the column for sm screens, in terms of where the column should position itself in the columns renderer.\nIf no value is passed, the column order implicit value will be the order in the html structure."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "order-sm"
+            },
+            "orderMd": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "The order of the column for md screens, in terms of where the column should position itself in the columns renderer.\nIf no value is passed, the column order implicit value will be the order in the html structure."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "order-md"
+            },
+            "orderLg": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "The order of the column for lg screens, in terms of where the column should position itself in the columns renderer.\nIf no value is passed, the column order implicit value will be the order in the html structure."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "order-lg"
+            },
+            "orderXl": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "The order of the column for xl screens, in terms of where the column should position itself in the columns renderer.\nIf no value is passed, the column order implicit value will be the order in the html structure."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "order-xl"
+            },
+            "pull": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [{
+                            "name": "deprecated",
+                            "text": "Use the combination of `size` and `order` properties to achieve the same effect."
+                        }],
                     "text": "The amount to pull the column, in terms of how many columns it should shift to the start of\nthe total available."
                 },
                 "getter": false,
@@ -247,7 +363,10 @@ export class Col {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "deprecated",
+                            "text": "Use the combination of `size` and `order` properties to achieve the same effect."
+                        }],
                     "text": "The amount to pull the column for xs screens, in terms of how many columns it should shift\nto the start of the total available."
                 },
                 "getter": false,
@@ -266,7 +385,10 @@ export class Col {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "deprecated",
+                            "text": "Use the combination of `size` and `order` properties to achieve the same effect."
+                        }],
                     "text": "The amount to pull the column for sm screens, in terms of how many columns it should shift\nto the start of the total available."
                 },
                 "getter": false,
@@ -285,7 +407,10 @@ export class Col {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "deprecated",
+                            "text": "Use the combination of `size` and `order` properties to achieve the same effect."
+                        }],
                     "text": "The amount to pull the column for md screens, in terms of how many columns it should shift\nto the start of the total available."
                 },
                 "getter": false,
@@ -304,7 +429,10 @@ export class Col {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "deprecated",
+                            "text": "Use the combination of `size` and `order` properties to achieve the same effect."
+                        }],
                     "text": "The amount to pull the column for lg screens, in terms of how many columns it should shift\nto the start of the total available."
                 },
                 "getter": false,
@@ -323,7 +451,10 @@ export class Col {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "deprecated",
+                            "text": "Use the combination of `size` and `order` properties to achieve the same effect."
+                        }],
                     "text": "The amount to pull the column for xl screens, in terms of how many columns it should shift\nto the start of the total available."
                 },
                 "getter": false,
@@ -342,7 +473,10 @@ export class Col {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "deprecated",
+                            "text": "Use the combination of `size` and `order` properties to achieve the same effect."
+                        }],
                     "text": "The amount to push the column, in terms of how many columns it should shift to the end\nof the total available."
                 },
                 "getter": false,
@@ -361,7 +495,10 @@ export class Col {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "deprecated",
+                            "text": "Use the combination of `size` and `order` properties to achieve the same effect."
+                        }],
                     "text": "The amount to push the column for xs screens, in terms of how many columns it should shift\nto the end of the total available."
                 },
                 "getter": false,
@@ -380,7 +517,10 @@ export class Col {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "deprecated",
+                            "text": "Use the combination of `size` and `order` properties to achieve the same effect."
+                        }],
                     "text": "The amount to push the column for sm screens, in terms of how many columns it should shift\nto the end of the total available."
                 },
                 "getter": false,
@@ -399,7 +539,10 @@ export class Col {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "deprecated",
+                            "text": "Use the combination of `size` and `order` properties to achieve the same effect."
+                        }],
                     "text": "The amount to push the column for md screens, in terms of how many columns it should shift\nto the end of the total available."
                 },
                 "getter": false,
@@ -418,7 +561,10 @@ export class Col {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "deprecated",
+                            "text": "Use the combination of `size` and `order` properties to achieve the same effect."
+                        }],
                     "text": "The amount to push the column for lg screens, in terms of how many columns it should shift\nto the end of the total available."
                 },
                 "getter": false,
@@ -437,7 +583,10 @@ export class Col {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "deprecated",
+                            "text": "Use the combination of `size` and `order` properties to achieve the same effect."
+                        }],
                     "text": "The amount to push the column for xl screens, in terms of how many columns it should shift\nto the end of the total available."
                 },
                 "getter": false,
@@ -561,6 +710,7 @@ export class Col {
             }
         };
     }
+    static get elementRef() { return "el"; }
     static get listeners() {
         return [{
                 "name": "resize",

package/dist/collection/components/content/content.css

@@ -1,3 +1,9 @@
+/**
+ * Convert a pixels given value into rem
+ * 
+ * @param pixels - Value in pixels to be converted (i.e. px)
+ * @param context (optional) - Baseline value
+ */
 /**
  * Convert a font size to a dynamic font size.
  * Fonts that participate in Dynamic Type should use
@@ -98,8 +104,8 @@
 }
 
 #background-content {
-  left: 0px;
   right: 0px;
+  left: 0px;
   top: calc(var(--offset-top) * -1);
   bottom: calc(var(--offset-bottom) * -1);
   position: absolute;
@@ -107,8 +113,8 @@
 }
 
 .inner-scroll {
-  left: 0px;
   right: 0px;
+  left: 0px;
   top: calc(var(--offset-top) * -1);
   bottom: calc(var(--offset-bottom) * -1);
   -webkit-padding-start: var(--padding-start);

package/dist/collection/components/content/content.js

@@ -6,8 +6,12 @@ import { componentOnReady, hasLazyBuild, inheritAriaAttributes } from "../../uti
 import { isPlatform } from "../../utils/platform";
 import { isRTL } from "../../utils/rtl/index";
 import { createColorClasses, hostContext } from "../../utils/theme";
-import { getIonMode } from "../../global/ionic-global";
+import { config } from "../../global/config";
+import { getIonMode, getIonTheme } from "../../global/ionic-global";
 /**
+ * @virtualProp {"ios" | "md"} mode - The mode determines the platform behaviors of the component.
+ * @virtualProp {"ios" | "md" | "ionic"} theme - The theme determines the visual appearance of the component.
+ *
  * @slot - Content is placed in the scrollable area if provided without a slot.
  * @slot fixed - Should be used for fixed content that should not scroll.
  *
@@ -171,9 +175,8 @@ export class Content {
             this.resize();
         }, 100);
     }
-    shouldForceOverscroll() {
+    shouldForceOverscroll(mode) {
         const { forceOverscroll } = this;
-        const mode = getIonMode(this);
         return forceOverscroll === undefined ? mode === 'ios' && isPlatform('ios') : forceOverscroll;
     }
     resize() {
@@ -369,12 +372,13 @@ export class Content {
     render() {
         const { fixedSlotPlacement, inheritedAttributes, isMainContent, scrollX, scrollY, el } = this;
         const rtl = isRTL(el) ? 'rtl' : 'ltr';
-        const mode = getIonMode(this);
-        const forceOverscroll = this.shouldForceOverscroll();
-        const transitionShadow = mode === 'ios';
+        const theme = getIonTheme(this);
+        const mode = getIonMode(this, theme);
+        const forceOverscroll = this.shouldForceOverscroll(mode);
+        const transitionShadow = theme === 'ios';
         this.resize();
-        return (h(Host, Object.assign({ key: '8c1bc4a4df8698d3884741eb38512dc059210c50', role: isMainContent ? 'main' : undefined, class: createColorClasses(this.color, {
-                [mode]: true,
+        return (h(Host, Object.assign({ key: 'd7f325c30b698dc42ec5e8c45b29e82749743cf4', role: isMainContent ? 'main' : undefined, class: createColorClasses(this.color, {
+                [theme]: true,
                 'content-fullscreen': this.fullscreen,
                 'content-sizing': hostContext('ion-popover', this.el),
                 overscroll: forceOverscroll,
@@ -382,12 +386,12 @@ export class Content {
             }), style: {
                 '--offset-top': `${this.cTop}px`,
                 '--offset-bottom': `${this.cBottom}px`,
-            } }, inheritedAttributes), h("div", { key: '5e7412549b51ef7543d9378ecab9aac6bc461588', ref: (el) => (this.backgroundContentEl = el), id: "background-content", part: "background" }), fixedSlotPlacement === 'before' ? h("slot", { name: "fixed" }) : null, h("div", { key: '33f6fbf7e1e027c7cbd2dda95b487f18dc648cef', class: {
+            } }, inheritedAttributes), h("div", { key: 'c93b2c622a69c7fd153bbe9b0c6f8c24d85ed969', ref: (el) => (this.backgroundContentEl = el), id: "background-content", part: "background" }), fixedSlotPlacement === 'before' ? h("slot", { name: "fixed" }) : null, h("div", { key: '1700cc94e464ad1ab1c6672270f9649e90be3a5e', class: {
                 'inner-scroll': true,
                 'scroll-x': scrollX,
                 'scroll-y': scrollY,
                 overscroll: (scrollX || scrollY) && forceOverscroll,
-            }, ref: (scrollEl) => (this.scrollEl = scrollEl), onScroll: this.scrollEvents ? (ev) => this.onScroll(ev) : undefined, part: "scroll" }, h("slot", { key: '00c8fe7b9e73533c702273c9457d274195d54e98' })), transitionShadow ? (h("div", { class: "transition-effect" }, h("div", { class: "transition-cover" }), h("div", { class: "transition-shadow" }))) : null, fixedSlotPlacement === 'after' ? h("slot", { name: "fixed" }) : null));
+            }, ref: (scrollEl) => (this.scrollEl = scrollEl), onScroll: this.scrollEvents ? (ev) => this.onScroll(ev) : undefined, part: "scroll" }, h("slot", { key: 'bff713ead4f61730e3f36b5af4b771ae62bde6cd' })), transitionShadow ? (h("div", { class: "transition-effect" }, h("div", { class: "transition-cover" }), h("div", { class: "transition-shadow" }))) : null, fixedSlotPlacement === 'after' ? h("slot", { name: "fixed" }) : null));
     }
     static get is() { return "ion-content"; }
     static get encapsulation() { return "shadow"; }
@@ -845,7 +849,8 @@ const getPageElement = (el) => {
      * between the popover and the edges of the screen. But if the popover contains
      * its own page element, we should use that instead.
      */
-    const page = el.closest('ion-app, ion-page, .ion-page, page-inner, .popover-content');
+    const appRootSelector = config.get('appRootSelector', 'ion-app');
+    const page = el.closest(`${appRootSelector}, ion-page, .ion-page, page-inner, .popover-content`);
     if (page) {
         return page;
     }