@ionic/core 8.7.6-dev.11759412372.1f332f62 → 8.7.6-dev.11759493293.13f81b9f

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

@@ -2,12 +2,15 @@
  * (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";
 // 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 +32,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: 'e4a5e41ee5cd7ef62aa32a1f4f290a3be2fae212', class: {
+                [theme]: true,
+                [`${colSize}`]: colSize !== undefined,
+                [`${colOrder}`]: colOrder !== undefined,
+                [`${colOffset}`]: colOffset !== undefined,
+            } }, h("slot", { key: '7058c34c183cdad24630314ec0bedffef40a32af' })));
     }
     static get is() { return "ion-col"; }
     static get encapsulation() { return "shadow"; }
@@ -105,7 +103,6 @@ export class Col {
         return {
             "offset": {
                 "type": "string",
-                "attribute": "offset",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -120,11 +117,11 @@ export class Col {
                 },
                 "getter": false,
                 "setter": false,
-                "reflect": false
+                "reflect": false,
+                "attribute": "offset"
             },
             "offsetXs": {
                 "type": "string",
-                "attribute": "offset-xs",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -139,11 +136,11 @@ export class Col {
                 },
                 "getter": false,
                 "setter": false,
-                "reflect": false
+                "reflect": false,
+                "attribute": "offset-xs"
             },
             "offsetSm": {
                 "type": "string",
-                "attribute": "offset-sm",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -158,11 +155,11 @@ export class Col {
                 },
                 "getter": false,
                 "setter": false,
-                "reflect": false
+                "reflect": false,
+                "attribute": "offset-sm"
             },
             "offsetMd": {
                 "type": "string",
-                "attribute": "offset-md",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -177,11 +174,11 @@ export class Col {
                 },
                 "getter": false,
                 "setter": false,
-                "reflect": false
+                "reflect": false,
+                "attribute": "offset-md"
             },
             "offsetLg": {
                 "type": "string",
-                "attribute": "offset-lg",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -196,11 +193,11 @@ export class Col {
                 },
                 "getter": false,
                 "setter": false,
-                "reflect": false
+                "reflect": false,
+                "attribute": "offset-lg"
             },
             "offsetXl": {
                 "type": "string",
-                "attribute": "offset-xl",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -215,11 +212,68 @@ export class Col {
                 },
                 "getter": false,
                 "setter": false,
-                "reflect": false
+                "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": {
+                    "original": "string",
+                    "resolved": "string | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "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",
-                "attribute": "pull",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -230,15 +284,75 @@ export class Col {
                 "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,
                 "setter": false,
-                "reflect": false
+                "reflect": false,
+                "attribute": "pull"
             },
             "pullXs": {
                 "type": "string",
-                "attribute": "pull-xs",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -248,16 +362,19 @@ 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,
                 "setter": false,
-                "reflect": false
+                "reflect": false,
+                "attribute": "pull-xs"
             },
             "pullSm": {
                 "type": "string",
-                "attribute": "pull-sm",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -267,16 +384,19 @@ 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,
                 "setter": false,
-                "reflect": false
+                "reflect": false,
+                "attribute": "pull-sm"
             },
             "pullMd": {
                 "type": "string",
-                "attribute": "pull-md",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -286,16 +406,19 @@ 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,
                 "setter": false,
-                "reflect": false
+                "reflect": false,
+                "attribute": "pull-md"
             },
             "pullLg": {
                 "type": "string",
-                "attribute": "pull-lg",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -305,16 +428,19 @@ 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,
                 "setter": false,
-                "reflect": false
+                "reflect": false,
+                "attribute": "pull-lg"
             },
             "pullXl": {
                 "type": "string",
-                "attribute": "pull-xl",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -324,16 +450,19 @@ 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,
                 "setter": false,
-                "reflect": false
+                "reflect": false,
+                "attribute": "pull-xl"
             },
             "push": {
                 "type": "string",
-                "attribute": "push",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -343,16 +472,19 @@ 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,
                 "setter": false,
-                "reflect": false
+                "reflect": false,
+                "attribute": "push"
             },
             "pushXs": {
                 "type": "string",
-                "attribute": "push-xs",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -362,16 +494,19 @@ 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,
                 "setter": false,
-                "reflect": false
+                "reflect": false,
+                "attribute": "push-xs"
             },
             "pushSm": {
                 "type": "string",
-                "attribute": "push-sm",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -381,16 +516,19 @@ 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,
                 "setter": false,
-                "reflect": false
+                "reflect": false,
+                "attribute": "push-sm"
             },
             "pushMd": {
                 "type": "string",
-                "attribute": "push-md",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -400,16 +538,19 @@ 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,
                 "setter": false,
-                "reflect": false
+                "reflect": false,
+                "attribute": "push-md"
             },
             "pushLg": {
                 "type": "string",
-                "attribute": "push-lg",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -419,16 +560,19 @@ 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,
                 "setter": false,
-                "reflect": false
+                "reflect": false,
+                "attribute": "push-lg"
             },
             "pushXl": {
                 "type": "string",
-                "attribute": "push-xl",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -438,16 +582,19 @@ 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,
                 "setter": false,
-                "reflect": false
+                "reflect": false,
+                "attribute": "push-xl"
             },
             "size": {
                 "type": "string",
-                "attribute": "size",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -462,11 +609,11 @@ export class Col {
                 },
                 "getter": false,
                 "setter": false,
-                "reflect": false
+                "reflect": false,
+                "attribute": "size"
             },
             "sizeXs": {
                 "type": "string",
-                "attribute": "size-xs",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -481,11 +628,11 @@ export class Col {
                 },
                 "getter": false,
                 "setter": false,
-                "reflect": false
+                "reflect": false,
+                "attribute": "size-xs"
             },
             "sizeSm": {
                 "type": "string",
-                "attribute": "size-sm",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -500,11 +647,11 @@ export class Col {
                 },
                 "getter": false,
                 "setter": false,
-                "reflect": false
+                "reflect": false,
+                "attribute": "size-sm"
             },
             "sizeMd": {
                 "type": "string",
-                "attribute": "size-md",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -519,11 +666,11 @@ export class Col {
                 },
                 "getter": false,
                 "setter": false,
-                "reflect": false
+                "reflect": false,
+                "attribute": "size-md"
             },
             "sizeLg": {
                 "type": "string",
-                "attribute": "size-lg",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -538,11 +685,11 @@ export class Col {
                 },
                 "getter": false,
                 "setter": false,
-                "reflect": false
+                "reflect": false,
+                "attribute": "size-lg"
             },
             "sizeXl": {
                 "type": "string",
-                "attribute": "size-xl",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -557,10 +704,12 @@ export class Col {
                 },
                 "getter": false,
                 "setter": false,
-                "reflect": false
+                "reflect": false,
+                "attribute": "size-xl"
             }
         };
     }
+    static get elementRef() { return "el"; }
     static get listeners() {
         return [{
                 "name": "resize",