@ionic/core 9.0.11-dev.11793890855.1bf6a6e5 → 9.0.11-dev.11793906456.1ea7a0a7

package/dist/collection/components/input/input.js

@@ -2,18 +2,15 @@
  * (C) Ionic http://ionicframework.com - MIT License
  */
 import { Build, Host, forceUpdate, h, } from "@stencil/core";
-import { createClearButtonPressController, createClickController, createNotchController, createStartEndContainerController, checkInvalidState, } from "../../utils/forms/index";
+import { createClickController, createNotchController, createStartEndContainerController, checkInvalidState, } from "../../utils/forms/index";
 import { inheritAriaAttributes, debounceEvent, inheritAttributes, componentOnReady } from "../../utils/helpers";
-import { printIonWarning } from "../../utils/logging/index";
 import { createSlotMutationController } from "../../utils/slot-mutation-controller";
 import { createColorClasses, hostContext } from "../../utils/theme";
 import { closeCircle, closeSharp } from "ionicons/icons";
-import { config } from "../../global/config";
-import { getIonTheme } from "../../global/ionic-global";
+import { getIonMode } from "../../global/ionic-global";
 import { getCounterText } from "./input.utils";
 /**
- * @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.
+ * @virtualProp {"ios" | "md"} mode - The mode determines which platform styles to use.
  *
  * @slot label - The label text to associate with the input. Use the `labelPlacement` property to control where the label is placed relative to the input. Use this if you need to render a label with custom HTML. (EXPERIMENTAL)
  * @slot start - Content to display at the leading edge of the input. (EXPERIMENTAL)
@@ -47,9 +44,6 @@ export class Input {
          * Track validation state for proper aria-live announcements
          */
         this.isInvalid = false;
-        /** Keeps the clear button visible for the duration of a press. */
-        this.isClearButtonPressed = false;
-        this.clearButtonPressController = createClearButtonPressController((isPressed) => (this.isClearButtonPressed = isPressed));
         /**
          * Indicates whether and how the text value should be automatically capitalized as it is entered/edited by the user.
          * Available options: `"off"`, `"none"`, `"on"`, `"sentences"`, `"words"`, `"characters"`.
@@ -81,6 +75,15 @@ export class Input {
          * If `true`, the user cannot interact with the input.
          */
         this.disabled = false;
+        /**
+         * Where to place the label relative to the input.
+         * `"start"`: The label will appear to the left of the input in LTR and to the right in RTL.
+         * `"end"`: The label will appear to the right of the input in LTR and to the left in RTL.
+         * `"floating"`: The label will appear smaller and above the input when the input is focused or it has a value. Otherwise it will appear on top of the input.
+         * `"stacked"`: The label will appear smaller and above the input regardless even when the input is blurred or has no value.
+         * `"fixed"`: The label has the same behavior as `"start"` except it also has a fixed width. Long text will be truncated with ellipses ("...").
+         */
+        this.labelPlacement = 'start';
         /**
          * The name of the control, which is submitted with the form data.
          */
@@ -97,11 +100,6 @@ export class Input {
          * If `true`, the element will have its spelling and grammar checked.
          */
         this.spellcheck = false;
-        /**
-         * The size of the input. If "large", it will have an increased height. By default the
-         * size is medium. This property only applies to the `"ionic"` theme.
-         */
-        this.size = 'medium';
         /**
          * The type of control to display. The default type is text.
          */
@@ -147,7 +145,6 @@ export class Input {
             this.isComposing = false;
         };
         this.clearTextInput = (ev) => {
-            this.clearButtonPressController.release();
             if (this.clearInput && !this.readonly && !this.disabled && ev) {
                 ev.preventDefault();
                 ev.stopPropagation();
@@ -237,9 +234,6 @@ export class Input {
             ...inheritAriaAttributes(this.el),
             ...inheritAttributes(this.el, ['tabindex', 'title', 'data-form-type', 'dir']),
         };
-        if (this.labelPlacement === undefined) {
-            this.labelPlacement = getIonTheme(this) === 'ionic' ? ionicThemeDefaultLabelPlacement : 'start';
-        }
     }
     connectedCallback() {
         const { el } = this;
@@ -251,7 +245,7 @@ export class Input {
         this.setSlottedLabelId();
         this.notchController = createNotchController(el, () => this.notchSpacerEl, () => this.labelSlot);
         this.startEndContainerController = createStartEndContainerController(el, () => this.startContainerEl, () => this.endContainerEl, () => {
-            return Build.isBrowser && getIonTheme(this) === 'md' && this.fill === 'outline';
+            return Build.isBrowser && getIonMode(this) === 'md' && this.fill === 'outline';
         });
         this.startEndContainerController.calculateContainerWidths();
         this.clickController = createClickController(el, () => this.nativeInput);
@@ -300,11 +294,6 @@ export class Input {
                 detail: this.el,
             }));
         }
-        this.clearButtonPressController.destroy();
-        if (this.clickController) {
-            this.clickController.destroy();
-            this.clickController = undefined;
-        }
         if (this.slotMutationController) {
             this.slotMutationController.destroy();
             this.slotMutationController = undefined;
@@ -383,52 +372,6 @@ export class Input {
     getValue() {
         return typeof this.value === 'number' ? this.value.toString() : (this.value || '').toString();
     }
-    getFill() {
-        const theme = getIonTheme(this);
-        const { fill } = this;
-        if (theme === 'ionic' && fill === undefined) {
-            return 'outline';
-        }
-        return fill;
-    }
-    getLabelPlacement() {
-        const theme = getIonTheme(this);
-        const { el, labelPlacement } = this;
-        if (theme === 'ionic' && labelPlacement !== 'stacked' && labelPlacement !== 'floating') {
-            printIonWarning(`The "${labelPlacement}" label placement is not supported in the ${theme} theme. The default value of "${ionicThemeDefaultLabelPlacement}" will be used instead.`, el);
-            return ionicThemeDefaultLabelPlacement;
-        }
-        return labelPlacement;
-    }
-    // TODO(FW-6201): Remove this method when size is supported in ios and md
-    getSize() {
-        const theme = getIonTheme(this);
-        const { size } = this;
-        if (theme !== 'ionic' && (size === 'large' || size === 'xlarge')) {
-            printIonWarning(`The "${size}" size is not supported in the ${theme} theme.`);
-            // Fallback to medium size, which is the default size for all themes.
-            return 'medium';
-        }
-        return size;
-    }
-    getShape() {
-        const theme = getIonTheme(this);
-        const { shape } = this;
-        // TODO(ROU-5475): Remove the check for `soft` when the shape is supported in ios and md.
-        if ((theme === 'ios' && shape === 'round') || (theme !== 'ionic' && shape === 'soft')) {
-            printIonWarning(`The "${shape}" shape is not supported in the ${theme} theme.`);
-            return undefined;
-        }
-        if (shape !== undefined) {
-            return shape;
-        }
-        // TODO(FW-6229): Update this when the default shape has been decided.
-        if (theme !== 'ionic') {
-            return undefined;
-        }
-        // Fallback to round shape, which is the default shape for the ionic theme.
-        return 'round';
-    }
     checkClearOnEdit(ev) {
         if (!this.shouldClearOnEdit()) {
             return;
@@ -560,109 +503,59 @@ export class Input {
      * Renders the outline border with a notch for the label.
      */
     renderOutlineContainer() {
-        return (h("div", { key: "outline", class: "input-outline-container" }, h("div", { class: "input-outline-start" }), h("div", { class: {
+        return (h("div", { class: "input-outline-container" }, h("div", { class: "input-outline-start" }), h("div", { class: {
                 'input-outline-notch': true,
                 'input-outline-notch-hidden': !this.hasLabel,
             } }, h("div", { class: "notch-spacer", "aria-hidden": "true", ref: (el) => (this.notchSpacerEl = el) }, this.label)), h("div", { class: "input-outline-end" })));
     }
-    renderNativeInput() {
-        const { disabled, readonly, inputId } = this;
-        return (h("input", { class: "native-input", ref: (input) => (this.nativeInput = input), id: inputId, disabled: disabled, autoCapitalize: this.autocapitalize, autoComplete: this.autocomplete, autoCorrect: this.autocorrect ? 'on' : 'off', autoFocus: this.autofocus, enterKeyHint: this.enterkeyhint, inputMode: this.inputmode, min: this.min, max: this.max, minLength: this.minlength, maxLength: this.maxlength, multiple: this.multiple, name: this.name, pattern: this.pattern, placeholder: this.placeholder || '', readOnly: readonly, required: this.required, spellcheck: this.spellcheck, step: this.step, type: this.type, value: this.getValue(), onInput: this.onInput, onChange: this.onChange, onBlur: this.onBlur, onFocus: this.onFocus, onKeyDown: this.onKeydown, onCompositionstart: this.onCompositionStart, onCompositionend: this.onCompositionEnd, "aria-describedby": this.getHintTextID(), "aria-invalid": this.isInvalid ? 'true' : undefined, "aria-labelledby": this.getLabelledById(), ...this.inheritedAttributes }));
-    }
-    renderClearButton() {
-        const { clearInput, disabled, readonly } = this;
-        if (!clearInput || readonly || disabled) {
-            return undefined;
-        }
-        return (h("button", { "aria-label": "reset", type: "button", class: {
-                'input-clear-icon': true,
-                'input-clear-button-pressed': this.isClearButtonPressed,
-            }, onPointerDown: this.clearButtonPressController.onPointerDown, onPointerCancel: this.clearButtonPressController.release, onClick: this.clearTextInput }, h("ion-icon", { "aria-hidden": "true", icon: this.inputClearIcon })));
-    }
-    renderStartContainer() {
-        return (h("div", { key: "start", class: "input-start", ref: (el) => (this.startContainerEl = el) }, h("slot", { name: "start" })));
-    }
-    renderEndContainer() {
-        return (h("div", { key: "end", class: "input-end", ref: (el) => (this.endContainerEl = el) }, this.renderClearButton(), h("slot", { name: "end" })));
-    }
-    /**
-     * Every theme renders the same label and control structure, aside from the md
-     * outline container below. The label is nested alongside the input so the ios
-     * and md floating label can escape the control and clear the start and end
-     * slots. The ionic theme lifts it above the field with grid instead.
-     */
-    renderField() {
-        const hasOutlineFill = getIonTheme(this) === 'md' && this.getFill() === 'outline';
-        return [
-            hasOutlineFill && this.renderOutlineContainer(),
-            this.renderStartContainer(),
-            h("div", { key: "control", class: "input-control" }, this.renderLabel(), h("div", { class: "native-wrapper", onClick: this.onLabelClick }, this.renderNativeInput())),
-            this.renderEndContainer(),
-        ];
-    }
-    /**
-     * Get the icon to use for the clear icon.
-     * If an icon is set on the component, use that.
-     * Otherwise, use the icon set in the config.
-     * If no icon is set in the config, use the default icon.
-     *
-     * @internal
-     */
-    get inputClearIcon() {
-        // Return the icon if it is explicitly set
-        if (this.clearInputIcon != null) {
-            return this.clearInputIcon;
-        }
-        // Determine the theme and map to the default icon
-        const theme = getIonTheme(this);
-        const defaultIcon = theme === 'ios' ? closeCircle : closeSharp;
-        return config.get('inputClearIcon', defaultIcon);
-    }
     render() {
-        const { disabled, readonly, inputId, hasFocus } = this;
-        const theme = getIonTheme(this);
-        const fill = this.getFill();
-        const size = this.getSize();
-        const shape = this.getShape();
+        const { disabled, fill, readonly, shape, inputId, labelPlacement, hasFocus, clearInputIcon } = this;
+        const mode = getIonMode(this);
+        const value = this.getValue();
         const inItem = hostContext('ion-item', this.el);
-        const shouldRenderHighlight = theme === 'md' && fill !== 'outline' && !inItem;
-        const labelPlacement = this.getLabelPlacement();
+        const shouldRenderHighlight = mode === 'md' && fill !== 'outline' && !inItem;
+        const defaultClearIcon = mode === 'ios' ? closeCircle : closeSharp;
+        const clearIconData = clearInputIcon ?? defaultClearIcon;
         const hasValue = this.hasValue();
+        const hasOutlineFill = mode === 'md' && fill === 'outline';
         /**
          * If the label is stacked, it should always sit above the input.
          * For floating labels, the label should move above the input if
          * the input has a value or is focused.
          */
         const labelShouldFloat = labelPlacement === 'stacked' || (labelPlacement === 'floating' && (hasValue || hasFocus));
-        return (h(Host, { key: '28bc73428ada1e22a5bde4c213d6c8f151766cc0', class: createColorClasses(this.color, {
-                [theme]: true,
+        return (h(Host, { key: '0d03d37173639105b19083c0b44da25d9115a449', class: createColorClasses(this.color, {
+                [mode]: true,
                 'has-value': hasValue,
                 'has-focus': hasFocus,
                 'label-floating': labelShouldFloat,
                 [`input-fill-${fill}`]: fill !== undefined,
                 [`input-shape-${shape}`]: shape !== undefined,
-                [`input-size-${size}`]: true,
                 [`input-label-placement-${labelPlacement}`]: true,
                 'in-item': inItem,
                 'in-item-color': hostContext('ion-item.ion-color', this.el),
                 'input-disabled': disabled,
-                'input-readonly': readonly,
-            }) }, h("label", { key: '22b9673e6eac00d8855d271526d54a114773bc26', class: "input-wrapper", htmlFor: inputId, onClick: this.onLabelClick }, this.renderField(), shouldRenderHighlight && h("div", { key: '5cd692b33cb831b83b59c3872a7924686d806616', class: "input-highlight" })), this.renderBottomContent()));
+            }) }, h("label", { key: '1d62890b6a54229fccae0832eebe92e546e6e53d', class: "input-wrapper", htmlFor: inputId, onClick: this.onLabelClick }, hasOutlineFill && this.renderOutlineContainer(), h("div", { key: 'b1ceeb7666678569f6479729d556a29b8e549ce5', class: "input-start", ref: (el) => (this.startContainerEl = el) }, h("slot", { key: '1af55c89b1390ff9063a6c6d49a1e8bd01c7c78e', name: "start" })), h("div", { key: '6df6bc5521352ca87aeb400d169b0c9129521249', class: "input-control" }, this.renderLabel(), h("div", { key: '55d2b3a235332d7fbf61356b13052b5c9cda01de', class: "native-wrapper", onClick: this.onLabelClick }, h("input", { key: 'a938cb7ef2e87bde9da310817e1a48e7a5c67bc3', class: "native-input", ref: (input) => (this.nativeInput = input), id: inputId, disabled: disabled, autoCapitalize: this.autocapitalize, autoComplete: this.autocomplete, autoCorrect: this.autocorrect ? 'on' : 'off', autoFocus: this.autofocus, enterKeyHint: this.enterkeyhint, inputMode: this.inputmode, min: this.min, max: this.max, minLength: this.minlength, maxLength: this.maxlength, multiple: this.multiple, name: this.name, pattern: this.pattern, placeholder: this.placeholder || '', readOnly: readonly, required: this.required, spellcheck: this.spellcheck, step: this.step, type: this.type, value: value, onInput: this.onInput, onChange: this.onChange, onBlur: this.onBlur, onFocus: this.onFocus, onKeyDown: this.onKeydown, onCompositionstart: this.onCompositionStart, onCompositionend: this.onCompositionEnd, "aria-describedby": this.getHintTextID(), "aria-invalid": this.isInvalid ? 'true' : undefined, "aria-labelledby": this.getLabelledById(), ...this.inheritedAttributes }))), h("div", { key: 'c99685e001ee133220d74cfa877a72063d46433c', class: "input-end", ref: (el) => (this.endContainerEl = el) }, this.clearInput && !readonly && !disabled && (h("button", { key: '0e0e154182cca8b5367c1586b3c8c5b20b38006b', "aria-label": "reset", type: "button", class: "input-clear-icon", onPointerDown: (ev) => {
+                /**
+                 * This prevents mobile browsers from
+                 * blurring the input when the clear
+                 * button is activated.
+                 */
+                ev.preventDefault();
+            }, onClick: this.clearTextInput }, h("ion-icon", { key: '655e8d25940dbfb96e7e83b6e89575337e3e91d3', "aria-hidden": "true", icon: clearIconData }))), h("slot", { key: '6104c04ae34a26da62095de70c752efb2a0417ab', name: "end" })), shouldRenderHighlight && h("div", { key: 'c85cd8e07397e0bbd1e5a120014d83f391dfbc4c', class: "input-highlight" })), this.renderBottomContent()));
     }
     static get is() { return "ion-input"; }
     static get encapsulation() { return "scoped"; }
     static get originalStyleUrls() {
         return {
             "ios": ["input.ios.scss"],
-            "md": ["input.md.scss"],
-            "ionic": ["input.ionic.scss"]
+            "md": ["input.md.scss"]
         };
     }
     static get styleUrls() {
         return {
             "ios": ["input.ios.css"],
-            "md": ["input.md.css"],
-            "ionic": ["input.ionic.css"]
+            "md": ["input.md.css"]
         };
     }
     static get properties() {
@@ -964,7 +857,7 @@ export class Input {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": "The fill for the item. If `\"solid\"` the item will have a background. If\n`\"outline\"` the item will be transparent with a border. Only available when the theme is `\"md\"`."
+                    "text": "The fill for the item. If `\"solid\"` the item will have a background. If\n`\"outline\"` the item will be transparent with a border. Only available in `md` mode."
                 },
                 "getter": false,
                 "setter": false,
@@ -1030,22 +923,23 @@ export class Input {
             },
             "labelPlacement": {
                 "type": "string",
-                "mutable": true,
+                "mutable": false,
                 "complexType": {
                     "original": "'start' | 'end' | 'floating' | 'stacked' | 'fixed'",
-                    "resolved": "\"end\" | \"fixed\" | \"floating\" | \"stacked\" | \"start\" | undefined",
+                    "resolved": "\"end\" | \"fixed\" | \"floating\" | \"stacked\" | \"start\"",
                     "references": {}
                 },
                 "required": false,
-                "optional": true,
+                "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "Where to place the label relative to the input.\n`\"start\"`: The label will appear to the left of the input in LTR and to the right in RTL.\n`\"end\"`: The label will appear to the right of the input in LTR and to the left in RTL.\n`\"floating\"`: The label will appear smaller and above the input when the input is focused or it has a value. Otherwise it will appear on top of the input.\n`\"stacked\"`: The label will appear smaller and above the input regardless even when the input is blurred or has no value.\n`\"fixed\"`: The label has the same behavior as `\"start\"` except it also has a fixed width. Long text will be truncated with ellipses (\"...\").\n\nDefaults to \"stacked\" for the ionic theme, or \"start\" for all other themes.\n\nIn the ionic theme, only the values \"stacked\" and \"floating\" are supported."
+                    "text": "Where to place the label relative to the input.\n`\"start\"`: The label will appear to the left of the input in LTR and to the right in RTL.\n`\"end\"`: The label will appear to the right of the input in LTR and to the left in RTL.\n`\"floating\"`: The label will appear smaller and above the input when the input is focused or it has a value. Otherwise it will appear on top of the input.\n`\"stacked\"`: The label will appear smaller and above the input regardless even when the input is blurred or has no value.\n`\"fixed\"`: The label has the same behavior as `\"start\"` except it also has a fixed width. Long text will be truncated with ellipses (\"...\")."
                 },
                 "getter": false,
                 "setter": false,
                 "reflect": false,
-                "attribute": "label-placement"
+                "attribute": "label-placement",
+                "defaultValue": "'start'"
             },
             "max": {
                 "type": "any",
@@ -1244,15 +1138,15 @@ export class Input {
                 "type": "string",
                 "mutable": false,
                 "complexType": {
-                    "original": "'soft' | 'round' | 'rectangular'",
-                    "resolved": "\"rectangular\" | \"round\" | \"soft\" | undefined",
+                    "original": "'round'",
+                    "resolved": "\"round\" | undefined",
                     "references": {}
                 },
                 "required": false,
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": "Set to `\"soft\"` for an input with slightly rounded corners, `\"round\"` for an input with fully\nrounded corners, or `\"rectangular\"` for an input without rounded corners.\nDefaults to `\"round\"` for the ionic theme, and `undefined` for all other themes.\nOnly applies when the fill is set to `\"solid\"` or `\"outline\"`."
+                    "text": "The shape of the input. If \"round\" it will have an increased border radius."
                 },
                 "getter": false,
                 "setter": false,
@@ -1298,26 +1192,6 @@ export class Input {
                 "reflect": false,
                 "attribute": "step"
             },
-            "size": {
-                "type": "string",
-                "mutable": false,
-                "complexType": {
-                    "original": "'medium' | 'large' | 'xlarge'",
-                    "resolved": "\"large\" | \"medium\" | \"xlarge\" | undefined",
-                    "references": {}
-                },
-                "required": false,
-                "optional": true,
-                "docs": {
-                    "tags": [],
-                    "text": "The size of the input. If \"large\", it will have an increased height. By default the\nsize is medium. This property only applies to the `\"ionic\"` theme."
-                },
-                "getter": false,
-                "setter": false,
-                "reflect": false,
-                "attribute": "size",
-                "defaultValue": "'medium'"
-            },
             "type": {
                 "type": "string",
                 "mutable": false,
@@ -1370,8 +1244,7 @@ export class Input {
     static get states() {
         return {
             "hasFocus": {},
-            "isInvalid": {},
-            "isClearButtonPressed": {}
+            "isInvalid": {}
         };
     }
     static get events() {
@@ -1530,4 +1403,3 @@ export class Input {
     }
 }
 let inputIds = 0;
-const ionicThemeDefaultLabelPlacement = 'stacked';