@ionic/core 8.4.2-dev.11736797843.16cc5058 → 8.4.2-dev.11739377372.17be7c08

package/dist/collection/components/button/button.ios.css

@@ -1,3 +1,70 @@
+/**
+ * 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
+ * dynamic font sizes.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param unit (optional) - The unit to convert to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * a maximum font size.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param maxScale - The maximum scale of the font (i.e. 2.5 for a maximum 250% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * a minimum font size.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param minScale - The minimum scale of the font (i.e. 0.8 for a minimum 80% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * maximum and minimum font sizes.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param minScale - The minimum scale of the font (i.e. 0.8 for a minimum 80% scale).
+ * @param maxScale - The maximum scale of the font (i.e. 2.5 for a maximum 250% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * A heuristic that applies CSS to tablet
+ * viewports.
+ *
+ * Usage:
+ * @include tablet-viewport() {
+ *   :host {
+ *     background-color: green;
+ *   }
+ * }
+ */
+/**
+ * A heuristic that applies CSS to mobile
+ * viewports (i.e. phones, not tablets).
+ *
+ * Usage:
+ * @include mobile-viewport() {
+ *   :host {
+ *     background-color: blue;
+ *   }
+ * }
+ */
+/**
+ * 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
@@ -97,7 +164,6 @@
   display: inline-block;
   width: auto;
   color: var(--color);
-  font-family: var(--ion-font-family, inherit);
   text-align: center;
   text-decoration: none;
   white-space: normal;
@@ -177,18 +243,18 @@
   padding-inline-end: var(--padding-end);
   padding-top: var(--padding-top);
   padding-bottom: var(--padding-bottom);
+  color: inherit;
   font-family: inherit;
   font-size: inherit;
   font-style: inherit;
   font-weight: inherit;
   letter-spacing: inherit;
+  text-align: inherit;
   text-decoration: inherit;
   text-indent: inherit;
   text-overflow: inherit;
   text-transform: inherit;
-  text-align: inherit;
   white-space: inherit;
-  color: inherit;
   display: flex;
   position: relative;
   align-items: center;
@@ -234,35 +300,16 @@
 }
 
 ::slotted(ion-icon) {
-  font-size: 1.35em;
   pointer-events: none;
 }
 
-::slotted(ion-icon[slot=start]) {
-  -webkit-margin-start: -0.3em;
-  margin-inline-start: -0.3em;
-  -webkit-margin-end: 0.3em;
-  margin-inline-end: 0.3em;
-  margin-top: 0;
-  margin-bottom: 0;
-}
-
-::slotted(ion-icon[slot=end]) {
-  -webkit-margin-start: 0.3em;
-  margin-inline-start: 0.3em;
-  -webkit-margin-end: -0.2em;
-  margin-inline-end: -0.2em;
-  margin-top: 0;
-  margin-bottom: 0;
-}
-
 ion-ripple-effect {
   color: var(--ripple-color);
 }
 
 .button-native::after {
-  left: 0;
   right: 0;
+  left: 0;
   top: 0;
   bottom: 0;
   position: absolute;
@@ -326,6 +373,38 @@ ion-ripple-effect {
   color: var(--ion-toolbar-background, var(--color));
 }
 
+:host {
+  font-family: var(--ion-font-family, inherit);
+}
+
+::slotted(ion-icon) {
+  font-size: 1.35em;
+}
+
+::slotted(ion-icon[slot=start]) {
+  -webkit-margin-start: -0.3em;
+  margin-inline-start: -0.3em;
+  -webkit-margin-end: 0.3em;
+  margin-inline-end: 0.3em;
+  margin-top: 0;
+  margin-bottom: 0;
+}
+
+::slotted(ion-icon[slot=end]) {
+  -webkit-margin-start: 0.3em;
+  margin-inline-start: 0.3em;
+  -webkit-margin-end: -0.2em;
+  margin-inline-end: -0.2em;
+  margin-top: 0;
+  margin-bottom: 0;
+}
+
+/**
+ * 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
@@ -381,6 +460,12 @@ ion-ripple-effect {
  *   }
  * }
  */
+/**
+ * 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
@@ -437,7 +522,6 @@ ion-ripple-effect {
  * }
  */
 :host {
-  --border-radius: 14px;
   --padding-top: 13px;
   --padding-bottom: 13px;
   --padding-start: 1em;
@@ -465,13 +549,12 @@ ion-ripple-effect {
 }
 
 :host(.button-outline) {
-  --border-radius: 14px;
   --border-width: 1px;
   --border-style: solid;
   --background-activated: var(--ion-color-primary, #0054e9);
   --background-focused: var(--ion-color-primary, #0054e9);
   --background-hover: transparent;
-  --background-focused-opacity: .1;
+  --background-focused-opacity: 0.1;
   --color-activated: var(--ion-color-primary-contrast, #fff);
 }
 
@@ -480,7 +563,7 @@ ion-ripple-effect {
   --background-activated-opacity: 0;
   --background-focused: var(--ion-color-primary, #0054e9);
   --background-hover: transparent;
-  --background-focused-opacity: .1;
+  --background-focused-opacity: 0.1;
   font-size: min(1.0625rem, 51px);
   font-weight: normal;
 }
@@ -501,7 +584,6 @@ ion-ripple-effect {
 }
 
 :host(.button-large) {
-  --border-radius: 16px;
   --padding-top: 17px;
   --padding-start: 1em;
   --padding-end: 1em;
@@ -511,7 +593,6 @@ ion-ripple-effect {
 }
 
 :host(.button-small) {
-  --border-radius: 6px;
   --padding-top: 4px;
   --padding-start: 0.9em;
   --padding-end: 0.9em;
@@ -520,12 +601,24 @@ ion-ripple-effect {
   font-size: min(0.8125rem, 39px);
 }
 
+:host(.button-soft) {
+  --border-radius: 6px;
+}
+
+:host(.button-soft.button-large) {
+  --border-radius: 8px;
+}
+
+:host(.button-soft.button-small) {
+  --border-radius: 4px;
+}
+
 :host(.button-round) {
   --border-radius: 999px;
-  --padding-top: 0;
-  --padding-start: 26px;
-  --padding-end: 26px;
-  --padding-bottom: 0;
+}
+
+:host(.button-rectangular) {
+  --border-radius: 0px;
 }
 
 :host(.button-strong) {
@@ -548,7 +641,7 @@ ion-ripple-effect {
     *
     * Since the `ion-button` uses `rem` for the font size, we can't
     * just pass the desired icon font size in `em` to the `
-    * dynamic-font-clamp`. Instead, we need to adjust the base size 
+    * dynamic-font-clamp`. Instead, we need to adjust the base size
     * to account for the ion-button` font size.
     *
     * For example, if the default font size of `ion-button` is 16px
@@ -570,7 +663,7 @@ ion-ripple-effect {
     *
     * Since the `ion-button` uses `rem` for the font size, we can't
     * just pass the desired icon font size in `em` to the `
-    * dynamic-font-clamp`. Instead, we need to adjust the base size 
+    * dynamic-font-clamp`. Instead, we need to adjust the base size
     * to account for the ion-button` font size.
     *
     * For example, if the default font size of `ion-button` is 13px
@@ -592,7 +685,7 @@ ion-ripple-effect {
     *
     * Since the `ion-button` uses `rem` for the font size, we can't
     * just pass the desired icon font size in `em` to the `
-    * dynamic-font-clamp`. Instead, we need to adjust the base size 
+    * dynamic-font-clamp`. Instead, we need to adjust the base size
     * to account for the ion-button` font size.
     *
     * For example, if the default font size of `ion-button` is 20px

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

@@ -5,9 +5,10 @@ import { Host, h } from "@stencil/core";
 import { inheritAriaAttributes, hasShadowDom } from "../../utils/helpers";
 import { printIonWarning } from "../../utils/logging/index";
 import { createColorClasses, hostContext, openURL } from "../../utils/theme";
-import { getIonMode } from "../../global/ionic-global";
+import { getIonTheme, getIonMode } from "../../global/ionic-global";
 /**
- * @virtualProp {"ios" | "md"} mode - The mode determines which platform styles to use.
+ * @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 between the named slots if provided without a slot.
  * @slot icon-only - Should be used on an icon in a button that has no text.
@@ -24,31 +25,6 @@ export class Button {
         this.formButtonEl = null;
         this.formEl = null;
         this.inheritedAttributes = {};
-        /**
-         * If `true`, the button only has an icon.
-         */
-        this.isCircle = false;
-        /**
-         * The type of button.
-         */
-        this.buttonType = 'button';
-        /**
-         * If `true`, the user cannot interact with the button.
-         */
-        this.disabled = false;
-        /**
-         * When using a router, it specifies the transition direction when navigating to
-         * another page using `href`.
-         */
-        this.routerDirection = 'forward';
-        /**
-         * If `true`, activates a button with a heavier font weight.
-         */
-        this.strong = false;
-        /**
-         * The type of the button.
-         */
-        this.type = 'button';
         this.handleClick = (ev) => {
             const { el } = this;
             if (this.type === 'button') {
@@ -75,6 +51,23 @@ export class Button {
              */
             this.isCircle = this.hasIconOnly;
         };
+        this.isCircle = false;
+        this.color = undefined;
+        this.buttonType = 'button';
+        this.disabled = false;
+        this.expand = undefined;
+        this.fill = undefined;
+        this.routerDirection = 'forward';
+        this.routerAnimation = undefined;
+        this.download = undefined;
+        this.href = undefined;
+        this.rel = undefined;
+        this.shape = undefined;
+        this.size = undefined;
+        this.strong = false;
+        this.target = undefined;
+        this.type = 'button';
+        this.form = undefined;
     }
     disabledChanged() {
         const { disabled } = this;
@@ -129,6 +122,31 @@ export class Button {
         }
         return 'bounded';
     }
+    /**
+     * Set the shape based on the theme
+     */
+    getShape() {
+        const theme = getIonTheme(this);
+        const { shape } = this;
+        if (shape === undefined) {
+            return theme === 'ios' ? 'soft' : 'round';
+        }
+        return shape;
+    }
+    /**
+     * Disable the "xsmall" and "xlarge" sizes if the theme is "ios" or "md"
+     */
+    getSize() {
+        const theme = getIonTheme(this);
+        const { size } = this;
+        if (size === undefined && this.inItem) {
+            return 'small';
+        }
+        if ((theme === 'ios' || theme === 'md') && (size === 'xsmall' || size === 'xlarge')) {
+            return undefined;
+        }
+        return size;
+    }
     /**
      * Finds the form element based on the provided `form` selector
      * or element reference provided.
@@ -189,9 +207,11 @@ export class Button {
         }
     }
     render() {
+        const { buttonType, type, disabled, rel, target, href, color, expand, hasIconOnly, strong, inheritedAttributes } = this;
+        const theme = getIonTheme(this);
         const mode = getIonMode(this);
-        const { buttonType, type, disabled, rel, target, size, href, color, expand, hasIconOnly, shape, strong, inheritedAttributes, } = this;
-        const finalSize = size === undefined && this.inItem ? 'small' : size;
+        const size = this.getSize();
+        const shape = this.getShape();
         const TagType = href === undefined ? 'button' : 'a';
         const attrs = TagType === 'button'
             ? { type }
@@ -219,12 +239,12 @@ export class Button {
         {
             type !== 'button' && this.renderHiddenButton();
         }
-        return (h(Host, { key: '340a809d85698741bb36e796355cae89a970655f', onClick: this.handleClick, "aria-disabled": disabled ? 'true' : null, class: createColorClasses(color, {
-                [mode]: true,
+        return (h(Host, { key: 'aa13cfc27904c24cd16192738b0859c5ea3ea2e0', onClick: this.handleClick, "aria-disabled": disabled ? 'true' : null, class: createColorClasses(color, {
+                [theme]: true,
                 [buttonType]: true,
                 [`${buttonType}-${expand}`]: expand !== undefined,
-                [`${buttonType}-${finalSize}`]: finalSize !== undefined,
-                [`${buttonType}-${shape}`]: shape !== undefined,
+                [`${buttonType}-${size}`]: size !== undefined,
+                [`${buttonType}-${shape}`]: true,
                 [`${buttonType}-${fill}`]: true,
                 [`${buttonType}-strong`]: strong,
                 'in-toolbar': hostContext('ion-toolbar', this.el),
@@ -234,20 +254,22 @@ export class Button {
                 'button-disabled': disabled,
                 'ion-activatable': true,
                 'ion-focusable': true,
-            }) }, h(TagType, Object.assign({ key: '03ae1b94a0d606aa65aa6f82c2fc76abcf3f1300' }, attrs, { class: "button-native", part: "native", disabled: disabled, onFocus: this.onFocus, onBlur: this.onBlur }, inheritedAttributes), h("span", { key: '90bf53d4ffcab88ee596ece7113d5b6409e61143', class: "button-inner" }, h("slot", { key: 'a7876695f0d8702e8bcb471ae4c0984f27d77458', name: "icon-only", onSlotchange: this.slotChanged }), h("slot", { key: '2c8551586f8726884d7797a6d3fee2d4b3aab35f', name: "start" }), h("slot", { key: '9ab07accdb22b08d0a463a7c821c9793507d1f7d' }), h("slot", { key: '8984afe177e6ba021435875a3798e2a64f3bdf2c', name: "end" })), mode === 'md' && h("ion-ripple-effect", { key: '3e9f01e7a1198b6b7109502293a971da7072a4f3', type: this.rippleType }))));
+            }) }, h(TagType, Object.assign({ key: 'bf9a567fc1d5d750497e1dbf0e05c87001a62bc4' }, attrs, { class: "button-native", part: "native", disabled: disabled, onFocus: this.onFocus, onBlur: this.onBlur }, inheritedAttributes), h("span", { key: '6cc018bf4ec14040bdfa889aac5d59e1a98c0bb3', class: "button-inner" }, h("slot", { key: '4fb8a7a16b72dde27f073112a37106a2bbb54b4e', name: "icon-only", onSlotchange: this.slotChanged }), h("slot", { key: '41124f00a8b8b4a0be25baf8262b6ad745b3480e', name: "start" }), h("slot", { key: '19cc8118cc46a97af30f0cfde90babfd461a69c5' }), h("slot", { key: 'abae6b6ded9af682c81b1f2142623a0a5f3a519d', name: "end" })), mode === 'md' && h("ion-ripple-effect", { key: '8a6b9ada215999bc2f43fc7ec381e6ddf875ae95', type: this.rippleType }))));
     }
     static get is() { return "ion-button"; }
     static get encapsulation() { return "shadow"; }
     static get originalStyleUrls() {
         return {
             "ios": ["button.ios.scss"],
-            "md": ["button.md.scss"]
+            "md": ["button.md.scss"],
+            "ionic": ["button.ionic.scss"]
         };
     }
     static get styleUrls() {
         return {
             "ios": ["button.ios.css"],
-            "md": ["button.md.css"]
+            "md": ["button.md.css"],
+            "ionic": ["button.ionic.css"]
         };
     }
     static get properties() {
@@ -272,8 +294,6 @@ export class Button {
                     "tags": [],
                     "text": "The color to use from your application's color palette.\nDefault options are: `\"primary\"`, `\"secondary\"`, `\"tertiary\"`, `\"success\"`, `\"warning\"`, `\"danger\"`, `\"light\"`, `\"medium\"`, and `\"dark\"`.\nFor more information on colors, see [theming](/docs/theming/basics)."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "color",
                 "reflect": true
             },
@@ -291,8 +311,6 @@ export class Button {
                     "tags": [],
                     "text": "The type of button."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "button-type",
                 "reflect": false,
                 "defaultValue": "'button'"
@@ -311,8 +329,6 @@ export class Button {
                     "tags": [],
                     "text": "If `true`, the user cannot interact with the button."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "disabled",
                 "reflect": true,
                 "defaultValue": "false"
@@ -331,8 +347,6 @@ export class Button {
                     "tags": [],
                     "text": "Set to `\"block\"` for a full-width button or to `\"full\"` for a full-width button\nwith square corners and no left or right borders."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "expand",
                 "reflect": true
             },
@@ -350,8 +364,6 @@ export class Button {
                     "tags": [],
                     "text": "Set to `\"clear\"` for a transparent button that resembles a flat button, to `\"outline\"`\nfor a transparent button with a border, or to `\"solid\"` for a button with a filled background.\nThe default fill is `\"solid\"` except inside of a toolbar, where the default is `\"clear\"`."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "fill",
                 "reflect": true
             },
@@ -375,8 +387,6 @@ export class Button {
                     "tags": [],
                     "text": "When using a router, it specifies the transition direction when navigating to\nanother page using `href`."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "router-direction",
                 "reflect": false,
                 "defaultValue": "'forward'"
@@ -400,9 +410,7 @@ export class Button {
                 "docs": {
                     "tags": [],
                     "text": "When using a router, it specifies the transition animation when navigating to\nanother page using `href`."
-                },
-                "getter": false,
-                "setter": false
+                }
             },
             "download": {
                 "type": "string",
@@ -418,8 +426,6 @@ export class Button {
                     "tags": [],
                     "text": "This attribute instructs browsers to download a URL instead of navigating to\nit, so the user will be prompted to save it as a local file. If the attribute\nhas a value, it is used as the pre-filled file name in the Save prompt\n(the user can still change the file name if they want)."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "download",
                 "reflect": false
             },
@@ -437,8 +443,6 @@ export class Button {
                     "tags": [],
                     "text": "Contains a URL or a URL fragment that the hyperlink points to.\nIf this property is set, an anchor tag will be rendered."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "href",
                 "reflect": false
             },
@@ -456,8 +460,6 @@ export class Button {
                     "tags": [],
                     "text": "Specifies the relationship of the target object to the link object.\nThe value is a space-separated list of [link types](https://developer.mozilla.org/en-US/docs/Web/HTML/Link_types)."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "rel",
                 "reflect": false
             },
@@ -465,18 +467,16 @@ export class Button {
                 "type": "string",
                 "mutable": false,
                 "complexType": {
-                    "original": "'round'",
-                    "resolved": "\"round\" | undefined",
+                    "original": "'soft' | 'round' | 'rectangular'",
+                    "resolved": "\"rectangular\" | \"round\" | \"soft\" | undefined",
                     "references": {}
                 },
                 "required": false,
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": "Set to `\"round\"` for a button with more rounded corners."
+                    "text": "Set to `\"soft\"` for a button with slightly rounded corners, `\"round\"` for a button with fully\nrounded corners, or `\"rectangular\"` for a button without rounded corners.\nDefaults to `\"soft\"` for the `\"ios\"` theme and `\"round\"` for all other themes."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "shape",
                 "reflect": true
             },
@@ -484,8 +484,8 @@ export class Button {
                 "type": "string",
                 "mutable": false,
                 "complexType": {
-                    "original": "'small' | 'default' | 'large'",
-                    "resolved": "\"default\" | \"large\" | \"small\" | undefined",
+                    "original": "'xsmall' | 'small' | 'default' | 'large' | 'xlarge'",
+                    "resolved": "\"default\" | \"large\" | \"small\" | \"xlarge\" | \"xsmall\" | undefined",
                     "references": {}
                 },
                 "required": false,
@@ -494,8 +494,6 @@ export class Button {
                     "tags": [],
                     "text": "Set to `\"small\"` for a button with less height and padding, to `\"default\"`\nfor a button with the default height and padding, or to `\"large\"` for a button\nwith more height and padding. By default the size is unset, unless the button\nis inside of an item, where the size is `\"small\"` by default. Set the size to\n`\"default\"` inside of an item to make it a standard size button."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "size",
                 "reflect": true
             },
@@ -513,8 +511,6 @@ export class Button {
                     "tags": [],
                     "text": "If `true`, activates a button with a heavier font weight."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "strong",
                 "reflect": false,
                 "defaultValue": "false"
@@ -533,8 +529,6 @@ export class Button {
                     "tags": [],
                     "text": "Specifies where to display the linked URL.\nOnly applies when an `href` is provided.\nSpecial keywords: `\"_blank\"`, `\"_self\"`, `\"_parent\"`, `\"_top\"`."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "target",
                 "reflect": false
             },
@@ -552,8 +546,6 @@ export class Button {
                     "tags": [],
                     "text": "The type of the button."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "type",
                 "reflect": false,
                 "defaultValue": "'button'"
@@ -577,8 +569,6 @@ export class Button {
                     "tags": [],
                     "text": "The HTML form element or form element id. Used to submit a form when the button is not a child of the form."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "form",
                 "reflect": false
             }