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

package/dist/collection/components/textarea/textarea.js

@@ -2,203 +2,181 @@
  * (C) Ionic http://ionicframework.com - MIT License
  */
 import { Build, Host, forceUpdate, h, writeTask, } from "@stencil/core";
-import { createNotchController, createStartContainerController, checkInvalidState } from "../../utils/forms/index";
+import { createNotchController, checkInvalidState, reportValidityToElementInternals } from "../../utils/forms/index";
 import { inheritAriaAttributes, debounceEvent, inheritAttributes, componentOnReady } from "../../utils/helpers";
 import { createSlotMutationController } from "../../utils/slot-mutation-controller";
 import { createColorClasses, hostContext } from "../../utils/theme";
-import { getIonMode } from "../../global/ionic-global";
+import { getIonTheme } from "../../global/ionic-global";
 import { getCounterText } from "../input/input.utils";
 /**
- * @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 label - The label text to associate with the textarea. Use the `labelPlacement` property to control where the label is placed relative to the textarea. Use this if you need to render a label with custom HTML. (EXPERIMENTAL)
  * @slot start - Content to display at the leading edge of the textarea. (EXPERIMENTAL)
  * @slot end - Content to display at the trailing edge of the textarea. (EXPERIMENTAL)
+ *
+ * @part wrapper - The clickable label element that wraps the entire form field (label text, slots, and native textarea).
+ * @part container - The inner wrapper element that directly contains the native textarea element.
+ * @part label - The label text describing the textarea.
+ * @part native - The native textarea element.
+ * @part supporting-text - Supporting text displayed beneath the textarea label.
+ * @part helper-text - Supporting text displayed beneath the textarea label when the textarea is valid.
+ * @part error-text - Supporting text displayed beneath the textarea label when the textarea is invalid and touched.
+ * @part counter - The character counter displayed when the counter property is set.
+ * @part bottom - The container element for helper text, error text, and counter.
  */
 export class Textarea {
-    nativeInput;
-    inputId = `ion-textarea-${textareaIds++}`;
-    helperTextId = `${this.inputId}-helper-text`;
-    errorTextId = `${this.inputId}-error-text`;
-    /**
-     * `true` if the textarea was cleared as a result of the user typing
-     * with `clearOnEdit` enabled.
-     *
-     * Resets when the textarea loses focus.
-     */
-    didTextareaClearOnEdit = false;
-    textareaWrapper;
-    inheritedAttributes = {};
-    originalIonInput;
-    slotMutationController;
-    notchController;
-    notchSpacerEl;
-    startContainerController;
-    startContainerEl;
-    /**
-     * The value of the textarea when the textarea is focused.
-     */
-    focusedValue;
-    el;
-    /**
-     * The `hasFocus` state ensures the focus class is
-     * added regardless of how the element is focused.
-     * The `ion-focused` class only applies when focused
-     * via tabbing, not by clicking.
-     * The `has-focus` logic was added to ensure the class
-     * is applied in both cases.
-     */
-    hasFocus = false;
-    /**
-     * Track validation state for proper aria-live announcements
-     */
-    isInvalid = false;
-    validationObserver;
-    /**
-     * 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;
-    /**
-     * 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"`.
-     */
-    autocapitalize = 'none';
-    /**
-     * Sets the [`autofocus` attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/autofocus) on the native input element.
-     *
-     * This may not be sufficient for the element to be focused on page load. See [managing focus](/docs/developing/managing-focus) for more information.
-     */
-    autofocus = false;
-    /**
-     * If `true`, the value will be cleared after focus upon edit.
-     */
-    clearOnEdit = false;
-    /**
-     * Set the amount of time, in milliseconds, to wait to trigger the `ionInput` event after each keystroke.
-     */
-    debounce;
+    constructor() {
+        this.inputId = `ion-textarea-${textareaIds++}`;
+        this.helperTextId = `${this.inputId}-helper-text`;
+        this.errorTextId = `${this.inputId}-error-text`;
+        /**
+         * `true` if the textarea was cleared as a result of the user typing
+         * with `clearOnEdit` enabled.
+         *
+         * Resets when the textarea loses focus.
+         */
+        this.didTextareaClearOnEdit = false;
+        this.inheritedAttributes = {};
+        /**
+         * The `hasFocus` state ensures the focus class is
+         * added regardless of how the element is focused.
+         * The `ion-focused` class only applies when focused
+         * via tabbing, not by clicking.
+         * The `has-focus` logic was added to ensure the class
+         * is applied in both cases.
+         */
+        this.hasFocus = false;
+        /**
+         * Track validation state for proper aria-live announcements
+         */
+        this.isInvalid = false;
+        /**
+         * 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"`.
+         */
+        this.autocapitalize = 'none';
+        /**
+         * Sets the [`autofocus` attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/autofocus) on the native input element.
+         *
+         * This may not be sufficient for the element to be focused on page load. See [managing focus](/docs/developing/managing-focus) for more information.
+         */
+        this.autofocus = false;
+        /**
+         * If `true`, the value will be cleared after focus upon edit.
+         */
+        this.clearOnEdit = false;
+        /**
+         * If `true`, the user cannot interact with the textarea.
+         */
+        this.disabled = false;
+        /**
+         * The name of the control, which is submitted with the form data.
+         */
+        this.name = this.inputId;
+        /**
+         * If `true`, the user cannot modify the value.
+         */
+        this.readonly = false;
+        /**
+         * If `true`, the user must fill in a value before submitting a form.
+         */
+        this.required = false;
+        /**
+         * If `true`, the element will have its spelling and grammar checked.
+         */
+        this.spellcheck = false;
+        /**
+         * If `true`, the textarea container will grow and shrink based
+         * on the contents of the textarea.
+         */
+        this.autoGrow = false;
+        /**
+         * The value of the textarea.
+         */
+        this.value = '';
+        /**
+         * If `true`, a character counter will display the ratio of characters used and the total character limit.
+         * Developers must also set the `maxlength` property for the counter to be calculated correctly.
+         */
+        this.counter = false;
+        /**
+         * Where to place the label relative to the textarea.
+         * `"start"`: The label will appear to the left of the textarea in LTR and to the right in RTL.
+         * `"end"`: The label will appear to the right of the textarea in LTR and to the left in RTL.
+         * `"floating"`: The label will appear smaller and above the textarea when the textarea is focused or it has a value. Otherwise it will appear on top of the textarea.
+         * `"stacked"`: The label will appear smaller and above the textarea regardless even when the textarea 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 size of the textarea. If "large" it will increase the height of the textarea, while
+         * "small" and "medium" provide progressively smaller heights. The default size is "medium".
+         * This property only applies to the `"ionic"` theme.
+         */
+        this.size = 'medium';
+        // `Event` type is used instead of `InputEvent`
+        // since the types from Stencil are not derived
+        // from the element (e.g. textarea and input
+        // should be InputEvent, but all other elements
+        // should be Event).
+        this.onInput = (ev) => {
+            const input = ev.target;
+            if (input) {
+                this.value = input.value || '';
+            }
+            this.emitInputChange(ev);
+        };
+        this.onChange = (ev) => {
+            this.emitValueChange(ev);
+        };
+        this.onFocus = (ev) => {
+            this.hasFocus = true;
+            this.focusedValue = this.value;
+            this.ionFocus.emit(ev);
+        };
+        this.onBlur = (ev) => {
+            this.hasFocus = false;
+            if (this.focusedValue !== this.value) {
+                /**
+                 * Emits the `ionChange` event when the textarea value
+                 * is different than the value when the textarea was focused.
+                 */
+                this.emitValueChange(ev);
+            }
+            this.didTextareaClearOnEdit = false;
+            this.ionBlur.emit(ev);
+        };
+        this.onKeyDown = (ev) => {
+            this.checkClearOnEdit(ev);
+        };
+        /**
+         * Stops propagation when the label is clicked,
+         * otherwise, two clicks will be triggered.
+         */
+        this.onLabelClick = (ev) => {
+            // Only stop propagation if the click was directly on the label
+            // and not on the input or other child elements
+            if (ev.target === ev.currentTarget) {
+                ev.stopPropagation();
+            }
+        };
+    }
     debounceChanged() {
         const { ionInput, debounce, originalIonInput } = this;
         /**
          * If debounce is undefined, we have to manually revert the ionInput emitter in case
          * debounce used to be set to a number. Otherwise, the event would stay debounced.
          */
-        this.ionInput = debounce === undefined ? originalIonInput ?? ionInput : debounceEvent(ionInput, debounce);
+        this.ionInput = debounce === undefined ? originalIonInput !== null && originalIonInput !== void 0 ? originalIonInput : ionInput : debounceEvent(ionInput, debounce);
     }
     /**
-     * If `true`, the user cannot interact with the textarea.
+     * Update element internals when disabled prop changes
      */
-    disabled = false;
-    /**
-     * The fill for the item. If `"solid"` the item will have a background. If
-     * `"outline"` the item will be transparent with a border. Only available in `md` mode.
-     */
-    fill;
-    /**
-     * A hint to the browser for which keyboard to display.
-     * Possible values: `"none"`, `"text"`, `"tel"`, `"url"`,
-     * `"email"`, `"numeric"`, `"decimal"`, and `"search"`.
-     */
-    inputmode;
-    /**
-     * A hint to the browser for which enter key to display.
-     * Possible values: `"enter"`, `"done"`, `"go"`, `"next"`,
-     * `"previous"`, `"search"`, and `"send"`.
-     */
-    enterkeyhint;
-    /**
-     * This attribute specifies the maximum number of characters that the user can enter.
-     */
-    maxlength;
-    /**
-     * This attribute specifies the minimum number of characters that the user can enter.
-     */
-    minlength;
-    /**
-     * The name of the control, which is submitted with the form data.
-     */
-    name = this.inputId;
-    /**
-     * Instructional text that shows before the input has a value.
-     */
-    placeholder;
-    /**
-     * If `true`, the user cannot modify the value.
-     */
-    readonly = false;
-    /**
-     * If `true`, the user must fill in a value before submitting a form.
-     */
-    required = false;
-    /**
-     * If `true`, the element will have its spelling and grammar checked.
-     */
-    spellcheck = false;
-    /**
-     * The visible width of the text control, in average character widths. If it is specified, it must be a positive integer.
-     */
-    cols;
-    /**
-     * The number of visible text lines for the control.
-     */
-    rows;
-    /**
-     * Indicates how the control wraps text.
-     */
-    wrap;
-    /**
-     * If `true`, the textarea container will grow and shrink based
-     * on the contents of the textarea.
-     */
-    autoGrow = false;
-    /**
-     * The value of the textarea.
-     */
-    value = '';
-    /**
-     * If `true`, a character counter will display the ratio of characters used and the total character limit.
-     * Developers must also set the `maxlength` property for the counter to be calculated correctly.
-     */
-    counter = false;
-    /**
-     * A callback used to format the counter text.
-     * By default the counter text is set to "itemLength / maxLength".
-     *
-     * See https://ionicframework.com/docs/troubleshooting/runtime#accessing-this
-     * if you need to access `this` from within the callback.
-     */
-    counterFormatter;
-    /**
-     * Text that is placed under the textarea and displayed when an error is detected.
-     */
-    errorText;
-    /**
-     * Text that is placed under the textarea and displayed when no error is detected.
-     */
-    helperText;
-    /**
-     * The visible label associated with the textarea.
-     *
-     * Use this if you need to render a plaintext label.
-     *
-     * The `label` property will take priority over the `label` slot if both are used.
-     */
-    label;
-    /**
-     * Where to place the label relative to the textarea.
-     * `"start"`: The label will appear to the left of the textarea in LTR and to the right in RTL.
-     * `"end"`: The label will appear to the right of the textarea in LTR and to the left in RTL.
-     * `"floating"`: The label will appear smaller and above the textarea when the textarea is focused or it has a value. Otherwise it will appear on top of the textarea.
-     * `"stacked"`: The label will appear smaller and above the textarea regardless even when the textarea 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 ("...").
-     */
-    labelPlacement = 'start';
-    /**
-     * The shape of the textarea. If "round" it will have an increased border radius.
-     */
-    shape;
+    disabledChanged() {
+        this.updateElementInternals();
+    }
     /**
      * Update the native input element when the value changes
      */
@@ -208,8 +186,22 @@ export class Textarea {
         if (nativeInput && nativeInput.value !== value) {
             nativeInput.value = value;
         }
+        this.updateElementInternals();
         this.runAutoGrow();
     }
+    /**
+     * Update native input and element internals when required prop changes
+     */
+    requiredChanged() {
+        // Explicitly update the native element's required attribute to ensure
+        // browser validation works correctly when required changes dynamically.
+        // While the template binding should handle this, we need to update it
+        // synchronously for the browser's validation to recognize the change.
+        if (this.nativeInput) {
+            this.nativeInput.required = this.required;
+        }
+        this.updateElementInternals();
+    }
     /**
      * dir is a globally enumerated attribute.
      * As a result, creating these as properties
@@ -218,37 +210,9 @@ export class Textarea {
      * to the inner `<textarea>` element.
      */
     onDirChanged(newValue) {
-        this.inheritedAttributes = {
-            ...this.inheritedAttributes,
-            dir: newValue,
-        };
+        this.inheritedAttributes = Object.assign(Object.assign({}, this.inheritedAttributes), { dir: newValue });
         forceUpdate(this);
     }
-    /**
-     * The `ionChange` event is fired when the user modifies the textarea's value.
-     * Unlike the `ionInput` event, the `ionChange` event is fired when
-     * the element loses focus after its value has been modified.
-     *
-     * This event will not emit when programmatically setting the `value` property.
-     */
-    ionChange;
-    /**
-     * The `ionInput` event is fired each time the user modifies the textarea's value.
-     * Unlike the `ionChange` event, the `ionInput` event is fired for each alteration
-     * to the textarea's value. This typically happens for each keystroke as the user types.
-     *
-     * When `clearOnEdit` is enabled, the `ionInput` event will be fired when
-     * the user clears the textarea by performing a keydown event.
-     */
-    ionInput;
-    /**
-     * Emitted when the input loses focus.
-     */
-    ionBlur;
-    /**
-     * Emitted when the input has focus.
-     */
-    ionFocus;
     /**
      * This prevents the native input from emitting the click event.
      * Instead, the click event from the ion-textarea is emitted.
@@ -262,15 +226,8 @@ export class Textarea {
     }
     connectedCallback() {
         const { el } = this;
-        this.slotMutationController = createSlotMutationController(el, ['label', 'start', 'end'], () => {
-            this.startContainerController?.calculateStartContainerWidth();
-            forceUpdate(this);
-        });
+        this.slotMutationController = createSlotMutationController(el, ['label', 'start', 'end'], () => forceUpdate(this));
         this.notchController = createNotchController(el, () => this.notchSpacerEl, () => this.labelSlot);
-        this.startContainerController = createStartContainerController(el, () => this.startContainerEl, () => {
-            return Build.isBrowser && getIonMode(this) === 'md' && this.fill === 'outline';
-        });
-        this.startContainerController.calculateStartContainerWidth();
         // Watch for class changes to update validation state
         if (Build.isBrowser && typeof MutationObserver !== 'undefined') {
             this.validationObserver = new MutationObserver(() => {
@@ -309,10 +266,6 @@ export class Textarea {
             this.notchController.destroy();
             this.notchController = undefined;
         }
-        if (this.startContainerController) {
-            this.startContainerController.destroy();
-            this.startContainerController = undefined;
-        }
         // Clean up validation observer to prevent memory leaks
         if (this.validationObserver) {
             this.validationObserver.disconnect();
@@ -320,18 +273,22 @@ export class Textarea {
         }
     }
     componentWillLoad() {
-        this.inheritedAttributes = {
-            ...inheritAriaAttributes(this.el),
-            ...inheritAttributes(this.el, ['data-form-type', 'title', 'tabindex', 'dir']),
-        };
+        this.inheritedAttributes = Object.assign(Object.assign({}, inheritAriaAttributes(this.el)), inheritAttributes(this.el, ['data-form-type', 'title', 'tabindex', 'dir']));
     }
     componentDidLoad() {
         this.originalIonInput = this.ionInput;
+        this.updateElementInternals();
         this.runAutoGrow();
+        // Override focus() to delegate to the native textarea.
+        // This is needed for Safari and Firefox which don't properly
+        // delegate focus when calling focus() directly on the host.
+        this.el.focus = () => {
+            this.setFocus();
+        };
     }
     componentDidRender() {
-        this.notchController?.calculateNotchWidth();
-        this.startContainerController?.calculateStartContainerWidth();
+        var _a;
+        (_a = this.notchController) === null || _a === void 0 ? void 0 : _a.calculateNotchWidth();
     }
     /**
      * Sets focus on the native `textarea` in `ion-textarea`. Use this method instead of the global
@@ -381,10 +338,11 @@ export class Textarea {
     runAutoGrow() {
         if (this.nativeInput && this.autoGrow) {
             writeTask(() => {
+                var _a;
                 if (this.textareaWrapper) {
                     // Replicated value is an attribute to be used in the stylesheet
                     // to set the inner contents of a pseudo element.
-                    this.textareaWrapper.dataset.replicatedValue = this.value ?? '';
+                    this.textareaWrapper.dataset.replicatedValue = (_a = this.value) !== null && _a !== void 0 ? _a : '';
                 }
             });
         }
@@ -435,47 +393,43 @@ export class Textarea {
     getValue() {
         return this.value || '';
     }
-    // `Event` type is used instead of `InputEvent`
-    // since the types from Stencil are not derived
-    // from the element (e.g. textarea and input
-    // should be InputEvent, but all other elements
-    // should be Event).
-    onInput = (ev) => {
-        const input = ev.target;
-        if (input) {
-            this.value = input.value || '';
-        }
-        this.emitInputChange(ev);
-    };
-    onChange = (ev) => {
-        this.emitValueChange(ev);
-    };
-    onFocus = (ev) => {
-        this.hasFocus = true;
-        this.focusedValue = this.value;
-        this.ionFocus.emit(ev);
-    };
-    onBlur = (ev) => {
-        this.hasFocus = false;
-        if (this.focusedValue !== this.value) {
-            /**
-             * Emits the `ionChange` event when the textarea value
-             * is different than the value when the textarea was focused.
-             */
-            this.emitValueChange(ev);
+    /**
+     * Called when the form state is restored.
+     * Restores the component's value.
+     */
+    formStateRestoreCallback(value) {
+        this.value = value;
+    }
+    /**
+     * Called when the form is reset.
+     * Resets the component's value.
+     */
+    formResetCallback() {
+        this.value = '';
+    }
+    /**
+     * Updates the form value and reports validity state to the browser via
+     * ElementInternals. This should be called when the component loads, when
+     * the required prop changes, when the disabled prop changes, and when the value
+     * changes to ensure the form value stays in sync and validation state is updated.
+     */
+    updateElementInternals() {
+        // Disabled form controls should not be included in form data
+        // Pass null to setFormValue when disabled to exclude it from form submission
+        const value = this.disabled ? null : this.getValue();
+        // ElementInternals may not be fully available in test environments
+        // so we need to check if the method exists before calling it
+        if (typeof this.internals.setFormValue === 'function') {
+            this.internals.setFormValue(value);
         }
-        this.didTextareaClearOnEdit = false;
-        this.ionBlur.emit(ev);
-    };
-    onKeyDown = (ev) => {
-        this.checkClearOnEdit(ev);
-    };
+        reportValidityToElementInternals(this.nativeInput, this.internals);
+    }
     renderLabel() {
         const { label } = this;
         return (h("div", { class: {
                 'label-text-wrapper': true,
                 'label-text-wrapper-hidden': !this.hasLabel,
-            } }, label === undefined ? h("slot", { name: "label" }) : h("div", { class: "label-text" }, label)));
+            }, part: "label" }, label === undefined ? h("slot", { name: "label" }) : h("div", { class: "label-text" }, label)));
     }
     /**
      * Gets any content passed into the `label` slot,
@@ -493,30 +447,50 @@ export class Textarea {
     get hasLabel() {
         return this.label !== undefined || this.labelSlot !== null;
     }
-    /**
-     * Stops propagation for clicks on the textarea's own content (label text,
-     * textarea field) to prevent double-click events. Allows clicks on slotted
-     * content to propagate so event delegation works for parent handlers.
-     *
-     * Only slots belonging directly to this textarea should be considered.
-     * The textarea itself may have a slot attribute when placed in an item
-     * or toolbar, which does not make its content slotted content.
-     */
-    onLabelClick = (ev) => {
-        const target = ev.target;
-        const slotted = target.closest('[slot="start"], [slot="end"]');
-        if (slotted === null || slotted === this.el || !this.el.contains(slotted)) {
-            ev.stopPropagation();
+    getFill() {
+        const theme = getIonTheme(this);
+        const { fill } = this;
+        if (theme === 'ionic' && fill === undefined) {
+            return 'outline';
+        }
+        return fill;
+    }
+    getShape() {
+        const theme = getIonTheme(this);
+        const { shape } = this;
+        // TODO(ROU-11050): Update theme check when shapes are defined for all themes.
+        if (theme === 'ionic' && shape === undefined) {
+            return 'round';
         }
-    };
+        return shape;
+    }
     /**
-     * Renders the outline border with a notch for the label.
+     * Renders the border container when fill="outline".
      */
-    renderOutlineContainer() {
-        return (h("div", { class: "textarea-outline-container" }, h("div", { class: "textarea-outline-start" }), h("div", { class: {
-                'textarea-outline-notch': true,
-                'textarea-outline-notch-hidden': !this.hasLabel,
-            } }, h("div", { class: "notch-spacer", "aria-hidden": "true", ref: (el) => (this.notchSpacerEl = el) }, this.label)), h("div", { class: "textarea-outline-end" })));
+    renderLabelContainer() {
+        const theme = getIonTheme(this);
+        const hasOutlineFill = theme === 'md' && this.fill === 'outline';
+        if (hasOutlineFill) {
+            /**
+             * The outline fill has a special outline
+             * that appears around the textarea and the label.
+             * Certain stacked and floating label placements cause the
+             * label to translate up and create a "cut out"
+             * inside of that border by using the notch-spacer element.
+             */
+            return [
+                h("div", { class: "textarea-outline-container" }, h("div", { class: "textarea-outline-start" }), h("div", { class: {
+                        'textarea-outline-notch': true,
+                        'textarea-outline-notch-hidden': !this.hasLabel,
+                    } }, h("div", { class: "notch-spacer", "aria-hidden": "true", ref: (el) => (this.notchSpacerEl = el) }, this.label)), h("div", { class: "textarea-outline-end" })),
+                this.renderLabel(),
+            ];
+        }
+        /**
+         * If not using the outline style,
+         * we can render just the label.
+         */
+        return this.renderLabel();
     }
     /**
      * Renders the helper text or error text values
@@ -524,8 +498,8 @@ export class Textarea {
     renderHintText() {
         const { helperText, errorText, helperTextId, errorTextId, isInvalid } = this;
         return [
-            h("div", { id: helperTextId, class: "helper-text", "aria-live": "polite" }, !isInvalid ? helperText : null),
-            h("div", { id: errorTextId, class: "error-text", role: "alert" }, isInvalid ? errorText : null),
+            h("div", { id: helperTextId, class: "helper-text", part: "supporting-text helper-text", "aria-live": "polite" }, !isInvalid ? helperText : null),
+            h("div", { id: errorTextId, class: "error-text", part: "supporting-text error-text", role: "alert" }, isInvalid ? errorText : null),
         ];
     }
     getHintTextID() {
@@ -543,7 +517,7 @@ export class Textarea {
         if (counter !== true || maxlength === undefined) {
             return;
         }
-        return h("div", { class: "counter" }, getCounterText(value, maxlength, counterFormatter));
+        return (h("div", { class: "counter", part: "counter" }, getCounterText(value, maxlength, counterFormatter)));
     }
     /**
      * Responsible for rendering helper text,
@@ -561,45 +535,76 @@ export class Textarea {
         if (!hasHintText && !hasCounter) {
             return;
         }
-        return (h("div", { class: "textarea-bottom" }, this.renderHintText(), this.renderCounter()));
+        return (h("div", { class: "textarea-bottom", part: "bottom" }, this.renderHintText(), this.renderCounter()));
     }
     render() {
-        const { inputId, disabled, fill, shape, labelPlacement, hasFocus } = this;
-        const mode = getIonMode(this);
+        const { inputId, disabled, readonly, size, labelPlacement, el, hasFocus } = this;
+        const fill = this.getFill();
+        const theme = getIonTheme(this);
+        const shape = this.getShape();
         const value = this.getValue();
         const inItem = hostContext('ion-item', this.el);
-        const shouldRenderHighlight = mode === 'md' && fill !== 'outline' && !inItem;
+        const shouldRenderHighlight = theme === 'md' && fill !== 'outline' && !inItem;
         const hasValue = this.hasValue();
-        const hasOutlineFill = mode === 'md' && fill === 'outline';
+        const hasStartEndSlots = el.querySelector('[slot="start"], [slot="end"]') !== null;
         /**
          * If the label is stacked, it should always sit above the textarea.
          * For floating labels, the label should move above the textarea if
-         * the textarea has a value or is focused.
+         * the textarea has a value, is focused, or has anything in either
+         * the start or end slot.
+         *
+         * If there is content in the start slot, the label would overlap
+         * it if not forced to float. This is also applied to the end slot
+         * because with the default or solid fills, the textarea is not
+         * vertically centered in the container, but the label is. This
+         * causes the slots and label to appear vertically offset from each
+         * other when the label isn't floating above the input. This doesn't
+         * apply to the outline fill, but this was not accounted for to keep
+         * things consistent.
+         *
+         * TODO(FW-5592): Remove hasStartEndSlots condition
          */
-        const labelShouldFloat = labelPlacement === 'stacked' || (labelPlacement === 'floating' && (hasValue || hasFocus));
-        return (h(Host, { key: '78da9c96e6a29f19b237f268dd8bfd044afe27b6', class: createColorClasses(this.color, {
-                [mode]: true,
+        const labelShouldFloat = labelPlacement === 'stacked' || (labelPlacement === 'floating' && (hasValue || hasFocus || hasStartEndSlots));
+        return (h(Host, { key: 'b613bb449100c5d7a982ffb0a39ea6324e8eb6ea', class: createColorClasses(this.color, {
+                [theme]: true,
                 'has-value': hasValue,
                 'has-focus': hasFocus,
                 'label-floating': labelShouldFloat,
                 [`textarea-fill-${fill}`]: fill !== undefined,
                 [`textarea-shape-${shape}`]: shape !== undefined,
+                [`textarea-size-${size}`]: true,
                 [`textarea-label-placement-${labelPlacement}`]: true,
+                'in-item': inItem,
                 'textarea-disabled': disabled,
-            }) }, h("label", { key: 'c5ea3f26e01e66b857d3a1c88dbafbf2dbb81fdb', class: "textarea-wrapper", htmlFor: inputId, onClick: this.onLabelClick }, hasOutlineFill && this.renderOutlineContainer(), h("div", { key: '5a9d0efc8c13d9bd4ec4ceadf1bdb84205c47b3d', class: "textarea-start", ref: (el) => (this.startContainerEl = el) }, h("slot", { key: 'da08262e33f3a5b454847297338a74f07c5b60c9', name: "start" })), h("div", { key: '6461dc7381929eb83679ec07563b7bdf8bfc3f9f', class: "textarea-control" }, this.renderLabel(), h("div", { key: '8f7902a9e6040384d25d0e2061c04f6b49acf187', class: "native-wrapper", ref: (el) => (this.textareaWrapper = el) }, h("textarea", { key: '2149d8b2c23a164c536327c98d7a632e1e85428a', class: "native-textarea", ref: (el) => (this.nativeInput = el), id: inputId, disabled: disabled, autoCapitalize: this.autocapitalize, autoFocus: this.autofocus, enterKeyHint: this.enterkeyhint, inputMode: this.inputmode, minLength: this.minlength, maxLength: this.maxlength, name: this.name, placeholder: this.placeholder || '', readOnly: this.readonly, required: this.required, spellcheck: this.spellcheck, cols: this.cols, rows: this.rows, wrap: this.wrap, onInput: this.onInput, onChange: this.onChange, onBlur: this.onBlur, onFocus: this.onFocus, onKeyDown: this.onKeyDown, "aria-describedby": this.getHintTextID(), "aria-invalid": this.isInvalid ? 'true' : undefined, ...this.inheritedAttributes }, value))), h("div", { key: '84f5f42add89875c3f0cce734b512a9e7be81e03', class: "textarea-end" }, h("slot", { key: 'ea654d78013a00b8af33deb89d42c2b7f6c9cb99', name: "end" })), shouldRenderHighlight && h("div", { key: 'b72195d2606816b3b71e65214d78cef1740f4804', class: "textarea-highlight" })), this.renderBottomContent()));
+                'textarea-readonly': readonly,
+            }) }, h("label", { key: '08a603a3fa102701d756d36d4d5d2d5e01f2895f', class: "textarea-wrapper", htmlFor: inputId, onClick: this.onLabelClick, part: "wrapper" }, this.renderLabelContainer(), h("div", { key: '076362fb04fa45e89c2ecb46b51937ab80026e34', class: "textarea-wrapper-inner" }, 
+        /**
+         * For the ionic theme, we render the outline container here
+         * instead of higher up, so it can be positioned relative to
+         * the native wrapper instead of the <label> element or the
+         * entire component. This allows the label text to be positioned
+         * above the outline, while staying within the bounds of the
+         * <label> element, ensuring that clicking the label text
+         * focuses the textarea.
+         */
+        theme === 'ionic' && fill === 'outline' && h("div", { key: '2baacd12528f1da1e8442cf73367e985831d30fa', class: "textarea-outline" }), h("div", { key: '2cbb11940c93eefa3c8aee37a4abec1287600cdc', class: "start-slot-wrapper" }, h("slot", { key: 'a5036f96342252e34440e1c69147179f433b65cf', name: "start" })), h("div", { key: '7fe6ef38994528bda8f60ef05ce63172220a19f3', class: "native-wrapper", ref: (el) => (this.textareaWrapper = el), part: "container" }, h("textarea", Object.assign({ key: '3b34140264bda8dea770c26b6918c837028e249f', class: "native-textarea", part: "native", ref: (el) => (this.nativeInput = el), id: inputId, disabled: disabled, autoCapitalize: this.autocapitalize, autoFocus: this.autofocus, enterKeyHint: this.enterkeyhint, inputMode: this.inputmode, minLength: this.minlength, maxLength: this.maxlength, name: this.name, placeholder: this.placeholder || '', readOnly: this.readonly, required: this.required, spellcheck: this.spellcheck, cols: this.cols, rows: this.rows, wrap: this.wrap, onInput: this.onInput, onChange: this.onChange, onBlur: this.onBlur, onFocus: this.onFocus, onKeyDown: this.onKeyDown, "aria-describedby": this.getHintTextID(), "aria-invalid": this.isInvalid ? 'true' : undefined }, this.inheritedAttributes), value)), h("div", { key: 'fdc551f7e180ca3b8a147453710a330cd28ca60f', class: "end-slot-wrapper" }, h("slot", { key: '135cef89f5341fd1cbbe5e54540cc29308338335', name: "end" }))), shouldRenderHighlight && h("div", { key: '8ffde39c6795139dd50100e09acdccd993a85ed8', class: "textarea-highlight" })), this.renderBottomContent()));
     }
     static get is() { return "ion-textarea"; }
-    static get encapsulation() { return "scoped"; }
+    static get encapsulation() { return "shadow"; }
+    static get delegatesFocus() { return true; }
+    static get formAssociated() { return true; }
     static get originalStyleUrls() {
         return {
             "ios": ["textarea.ios.scss"],
-            "md": ["textarea.md.scss"]
+            "md": ["textarea.md.scss"],
+            "ionic": ["textarea.ionic.scss"]
         };
     }
     static get styleUrls() {
         return {
             "ios": ["textarea.ios.css"],
-            "md": ["textarea.md.css"]
+            "md": ["textarea.md.css"],
+            "ionic": ["textarea.ionic.css"]
         };
     }
     static get properties() {
@@ -741,7 +746,7 @@ export class Textarea {
                 "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 in `md` mode."
+                    "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\"`."
                 },
                 "getter": false,
                 "setter": false,
@@ -899,7 +904,7 @@ export class Textarea {
                 },
                 "getter": false,
                 "setter": false,
-                "reflect": false,
+                "reflect": true,
                 "attribute": "required",
                 "defaultValue": "false"
             },
@@ -1138,20 +1143,40 @@ export class Textarea {
                 "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": "The shape of the textarea. If \"round\" it will have an increased border radius."
+                    "text": "Set to `\"soft\"` for a textarea with slightly rounded corners,\n`\"round\"` for a textarea with fully rounded corners, or `\"rectangular\"`\nfor a textarea without rounded corners.\n\nDefaults to `\"round\"` for the `ionic` theme, undefined for all other themes."
                 },
                 "getter": false,
                 "setter": false,
                 "reflect": false,
                 "attribute": "shape"
+            },
+            "size": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "'small' | 'medium' | 'large'",
+                    "resolved": "\"large\" | \"medium\" | \"small\" | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "The size of the textarea. If \"large\" it will increase the height of the textarea, while\n\"small\" and \"medium\" provide progressively smaller heights. The default size is \"medium\".\nThis property only applies to the `\"ionic\"` theme."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "size",
+                "defaultValue": "'medium'"
             }
         };
     }
@@ -1295,9 +1320,15 @@ export class Textarea {
         return [{
                 "propName": "debounce",
                 "methodName": "debounceChanged"
+            }, {
+                "propName": "disabled",
+                "methodName": "disabledChanged"
             }, {
                 "propName": "value",
                 "methodName": "valueChanged"
+            }, {
+                "propName": "required",
+                "methodName": "requiredChanged"
             }, {
                 "propName": "dir",
                 "methodName": "onDirChanged"
@@ -1312,5 +1343,6 @@ export class Textarea {
                 "passive": false
             }];
     }
+    static get attachInternalsMemberName() { return "internals"; }
 }
 let textareaIds = 0;