@ionic/core 8.8.20-dev.11787158518.168a2fea → 8.8.20-dev.11789504012.1a675914

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

@@ -5,9 +5,10 @@ import { Host, forceUpdate, 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.
@@ -17,113 +18,72 @@ import { getIonMode } from "../../global/ionic-global";
  * @part native - The native HTML button or anchor element that wraps all child elements.
  */
 export class Button {
-    inItem = false;
-    inListHeader = false;
-    inToolbar = false;
-    formButtonEl = null;
-    formEl = null;
-    inheritedAttributes = {};
-    el;
-    /**
-     * If `true`, the button only has an icon.
-     */
-    isCircle = false;
-    /**
-     * The color to use from your application's color palette.
-     * Default options are: `"primary"`, `"secondary"`, `"tertiary"`, `"success"`, `"warning"`, `"danger"`, `"light"`, `"medium"`, and `"dark"`.
-     * For more information on colors, see [theming](/docs/theming/basics).
-     */
-    color;
-    /**
-     * The type of button.
-     */
-    buttonType = 'button';
-    /**
-     * If `true`, the user cannot interact with the button.
-     */
-    disabled = false;
+    constructor() {
+        this.inDatetime = false;
+        this.inItem = false;
+        this.inListHeader = false;
+        this.inButtons = false;
+        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') {
+                openURL(this.href, ev, this.routerDirection, this.routerAnimation);
+            }
+            else if (hasShadowDom(el)) {
+                this.submitForm(ev);
+            }
+        };
+        this.onFocus = () => {
+            this.ionFocus.emit();
+        };
+        this.onBlur = () => {
+            this.ionBlur.emit();
+        };
+        this.slotChanged = () => {
+            /**
+             * Ensures that the 'has-icon-only' class is properly added
+             * or removed from `ion-button` when manipulating the
+             * `icon-only` slot.
+             *
+             * Without this, the 'has-icon-only' class is only checked
+             * or added when `ion-button` component first renders.
+             */
+            this.isCircle = this.hasIconOnly;
+        };
+    }
     disabledChanged() {
         const { disabled } = this;
         if (this.formButtonEl) {
             this.formButtonEl.disabled = disabled;
         }
     }
-    /**
-     * Set to `"block"` for a full-width button or to `"full"` for a full-width button
-     * with square corners and no left or right borders.
-     */
-    expand;
-    /**
-     * Set to `"clear"` for a transparent button that resembles a flat button, to `"outline"`
-     * for a transparent button with a border, or to `"solid"` for a button with a filled background.
-     * The default fill is `"solid"` except inside of a toolbar, where the default is `"clear"`.
-     */
-    fill;
-    /**
-     * When using a router, it specifies the transition direction when navigating to
-     * another page using `href`.
-     */
-    routerDirection = 'forward';
-    /**
-     * When using a router, it specifies the transition animation when navigating to
-     * another page using `href`.
-     */
-    routerAnimation;
-    /**
-     * This attribute instructs browsers to download a URL instead of navigating to
-     * it, so the user will be prompted to save it as a local file. If the attribute
-     * has a value, it is used as the pre-filled file name in the Save prompt
-     * (the user can still change the file name if they want).
-     */
-    download;
-    /**
-     * Contains a URL or a URL fragment that the hyperlink points to.
-     * If this property is set, an anchor tag will be rendered.
-     */
-    href;
-    /**
-     * Specifies the relationship of the target object to the link object.
-     * The value is a space-separated list of [link types](https://developer.mozilla.org/en-US/docs/Web/HTML/Link_types).
-     */
-    rel;
-    /**
-     * Set to `"round"` for a button with more rounded corners.
-     */
-    shape;
-    /**
-     * Set to `"small"` for a button with less height and padding, to `"default"`
-     * for a button with the default height and padding, or to `"large"` for a button
-     * with more height and padding. By default the size is unset, unless the button
-     * is inside of an item, where the size is `"small"` by default. Set the size to
-     * `"default"` inside of an item to make it a standard size button.
-     */
-    size;
-    /**
-     * If `true`, activates a button with a heavier font weight.
-     */
-    strong = false;
-    /**
-     * Specifies where to display the linked URL.
-     * Only applies when an `href` is provided.
-     * Special keywords: `"_blank"`, `"_self"`, `"_parent"`, `"_top"`.
-     */
-    target;
-    /**
-     * The type of the button.
-     */
-    type = 'button';
-    /**
-     * The HTML form element or form element id. Used to submit a form when the button is not a child of the form.
-     */
-    form;
-    /**
-     * Emitted when the button has focus.
-     */
-    ionFocus;
-    /**
-     * Emitted when the button loses focus.
-     */
-    ionBlur;
     /**
      * This component is used within the `ion-input-password-toggle` component
      * to toggle the visibility of the password input.
@@ -135,10 +95,7 @@ export class Button {
      * @param propName
      */
     onAriaChanged(newValue, _oldValue, propName) {
-        this.inheritedAttributes = {
-            ...this.inheritedAttributes,
-            [propName]: newValue,
-        };
+        this.inheritedAttributes = Object.assign(Object.assign({}, this.inheritedAttributes), { [propName]: newValue });
         forceUpdate(this);
     }
     /**
@@ -175,23 +132,51 @@ export class Button {
         }
     }
     componentWillLoad() {
-        this.inToolbar = !!this.el.closest('ion-buttons');
-        this.inListHeader = !!this.el.closest('ion-list-header');
-        this.inItem = !!this.el.closest('ion-item') || !!this.el.closest('ion-item-divider');
+        this.inDatetime = hostContext('ion-datetime', this.el);
+        this.inButtons = hostContext('ion-buttons', this.el);
+        this.inListHeader = hostContext('ion-list-header', this.el);
+        this.inItem = hostContext('ion-item', this.el) || hostContext('ion-item-divider', this.el);
         this.inheritedAttributes = inheritAriaAttributes(this.el);
     }
     get hasIconOnly() {
         return !!this.el.querySelector('[slot="icon-only"]');
     }
+    get hasBadge() {
+        return !!this.el.querySelector('ion-badge');
+    }
     get rippleType() {
         const hasClearFill = this.fill === undefined || this.fill === 'clear';
-        // If the button is in a toolbar, has a clear fill (which is the default)
-        // and only has an icon we use the unbounded "circular" ripple effect
-        if (hasClearFill && this.hasIconOnly && this.inToolbar) {
+        // Use the unbounded "circular" ripple effect if it:
+        // - Has a clear fill (the default)
+        // - Only has an icon and
+        // - Is inside of buttons (used in a toolbar) or a datetime
+        if (hasClearFill && this.hasIconOnly && (this.inButtons || this.inDatetime)) {
             return 'unbounded';
         }
         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;
+    }
+    /**
+     * Get the default size. If size is unset and the button is inside an item,
+     * the default size is "small". Otherwise, it uses the value of size.
+     */
+    getSize() {
+        const { size } = this;
+        if (size === undefined) {
+            return this.inItem ? 'small' : 'medium';
+        }
+        return size;
+    }
     /**
      * Finds the form element based on the provided `form` selector
      * or element reference provided.
@@ -251,36 +236,12 @@ export class Button {
             this.formButtonEl.click();
         }
     }
-    handleClick = (ev) => {
-        const { el } = this;
-        if (this.type === 'button') {
-            openURL(this.href, ev, this.routerDirection, this.routerAnimation);
-        }
-        else if (hasShadowDom(el)) {
-            this.submitForm(ev);
-        }
-    };
-    onFocus = () => {
-        this.ionFocus.emit();
-    };
-    onBlur = () => {
-        this.ionBlur.emit();
-    };
-    slotChanged = () => {
-        /**
-         * Ensures that the 'has-icon-only' class is properly added
-         * or removed from `ion-button` when manipulating the
-         * `icon-only` slot.
-         *
-         * Without this, the 'has-icon-only' class is only checked
-         * or added when `ion-button` component first renders.
-         */
-        this.isCircle = this.hasIconOnly;
-    };
     render() {
+        const { buttonType, type, disabled, rel, target, href, color, expand, hasIconOnly, hasBadge, 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 }
@@ -292,7 +253,7 @@ export class Button {
             };
         let fill = this.fill;
         if (fill === undefined) {
-            fill = this.inToolbar || this.inListHeader ? 'clear' : 'solid';
+            fill = this.inDatetime || this.inButtons || this.inListHeader ? 'clear' : 'solid';
         }
         /**
          * We call renderHiddenButton in the render function to account
@@ -304,35 +265,39 @@ export class Button {
         {
             type !== 'button' && this.renderHiddenButton();
         }
-        return (h(Host, { key: '82c71b8cbf3bb51e443f4aa99c375bf5be6b8dc7', onClick: this.handleClick, "aria-disabled": disabled ? 'true' : null, class: createColorClasses(color, {
-                [mode]: true,
+        return (h(Host, { key: 'dfceaa1d8516f47405c21ca275a175da4bd979ae', 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-datetime': this.inDatetime,
                 'in-toolbar': hostContext('ion-toolbar', this.el),
                 'in-toolbar-color': hostContext('ion-toolbar[color]', this.el),
-                'in-buttons': hostContext('ion-buttons', this.el),
+                'in-buttons': this.inButtons,
                 'button-has-icon-only': hasIconOnly,
+                'button-has-badge': hasBadge,
                 'button-disabled': disabled,
                 'ion-activatable': true,
                 'ion-focusable': true,
-            }) }, h(TagType, { key: '53f4cb366bac796ab38f609e858bc1a55fce7641', ...attrs, class: "button-native", part: "native", disabled: disabled, onFocus: this.onFocus, onBlur: this.onBlur, ...inheritedAttributes }, h("span", { key: '40e127fc11c889e77b8bf02e8714f0dea83bfce7', class: "button-inner" }, h("slot", { key: 'e11c8c86d3f0894658a8999129425c9c111f5540', name: "icon-only", onSlotchange: this.slotChanged }), h("slot", { key: '105ea9259ea17036359e6fe7eced8b267ab8e0f6', name: "start" }), h("slot", { key: '0d7b0966e328a5b10b0562dacbd638dfd08d92af' }), h("slot", { key: 'c542b40685802464d69f57ecc0a7c3465d24a417', name: "end" })), mode === 'md' && h("ion-ripple-effect", { key: '46df4cbeb057b0a8daab92226121d8bbb8c0ee07', type: this.rippleType }))));
+            }) }, h(TagType, Object.assign({ key: '5700fe835b87793191096ede610bc0715948f3a8' }, attrs, { class: "button-native", part: "native", disabled: disabled, onFocus: this.onFocus, onBlur: this.onBlur }, inheritedAttributes), h("span", { key: '2c585de91a70c798e635f0fc01717cd3835a370e', class: "button-inner" }, h("slot", { key: 'f96e2332cc60db1284712556f93d8399dfd87760', name: "icon-only", onSlotchange: this.slotChanged }), h("slot", { key: '6950960f24939eef4642942a94fce36fd64297b1', name: "start" }), h("slot", { key: 'dc49986b248393952cf06f083b7d9b95344694c7' }), h("slot", { key: '2b789b801b093da53ae987fc3c6886516cae7edf', name: "end" })), mode === 'md' && h("ion-ripple-effect", { key: '2c93d4511b50270d8fd736479ef17a8cc5c92bc1', 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() {
@@ -434,7 +399,7 @@ export class Button {
                 "optional": true,
                 "docs": {
                     "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\"`."
+                    "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 when inside of a buttons or datetime component, where\nthe default fill is `\"clear\"`."
                 },
                 "getter": false,
                 "setter": false,
@@ -553,15 +518,15 @@ 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,
@@ -572,15 +537,15 @@ export class Button {
                 "type": "string",
                 "mutable": false,
                 "complexType": {
-                    "original": "'small' | 'default' | 'large'",
-                    "resolved": "\"default\" | \"large\" | \"small\" | undefined",
+                    "original": "'small' | 'default' | 'medium' | 'large'",
+                    "resolved": "\"default\" | \"large\" | \"medium\" | \"small\" | undefined",
                     "references": {}
                 },
                 "required": false,
                 "optional": true,
                 "docs": {
                     "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."
+                    "text": "Set to `\"small\"` for a button with less height and padding, to `\"medium\"`\nfor a button with the medium 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,