@ionic/core 7.5.8 → 7.6.1-dev.11701921257.1d512d3c

package/dist/collection/components/select/select.js

@@ -2,7 +2,7 @@
  * (C) Ionic http://ionicframework.com - MIT License
  */
 import { Host, h, forceUpdate } from "@stencil/core";
-import { createLegacyFormController, createNotchController } from "../../utils/forms/index";
+import { compareOptions, createLegacyFormController, createNotchController, isOptionSelected } from "../../utils/forms/index";
 import { findItemLabel, focusElement, getAriaLabel, renderHiddenInput, inheritAttributes } from "../../utils/helpers";
 import { printIonWarning } from "../../utils/logging/index";
 import { actionSheetController, alertController, popoverController } from "../../utils/overlays";
@@ -16,6 +16,8 @@ import { getIonMode } from "../../global/ionic-global";
  * @virtualProp {"ios" | "md"} mode - The mode determines which platform styles to use.
  *
  * @slot label - The label text to associate with the select. Use the `labelPlacement` property to control where the label is placed relative to the select. Use this if you need to render a label with custom HTML.
+ * @slot start - Content to display at the leading edge of the select.
+ * @slot end - Content to display at the trailing edge of the select.
  *
  * @part placeholder - The text displayed in the select when there is no value.
  * @part text - The displayed value of the select.
@@ -30,8 +32,22 @@ export class Select {
         // This flag ensures we log the deprecation warning at most once.
         this.hasLoggedDeprecationWarning = false;
         this.onClick = (ev) => {
-            this.setFocus();
-            this.open(ev);
+            const target = ev.target;
+            const closestSlot = target.closest('[slot="start"], [slot="end"]');
+            if (target === this.el || closestSlot === null) {
+                this.setFocus();
+                this.open(ev);
+            }
+            else {
+                /**
+                 * Prevent clicks to the start/end slots from opening the select.
+                 * We ensure the target isn't this element in case the select is slotted
+                 * in, for example, an item. This would prevent the select from ever
+                 * being opened since the element itself has slot="start"/"end".
+                 */
+                ev.stopPropagation();
+                ev.preventDefault();
+            }
         };
         this.onFocus = () => {
             this.ionFocus.emit();
@@ -465,6 +481,8 @@ export class Select {
             style['has-placeholder'] = this.placeholder !== undefined;
             style['has-value'] = this.hasValue();
             style['has-focus'] = this.isExpanded;
+            // TODO(FW-3194): remove this
+            style['legacy'] = !!this.legacy;
         }
         this.ionStyle.emit(style);
     }
@@ -532,7 +550,27 @@ export class Select {
         const rtl = isRTL(el) ? 'rtl' : 'ltr';
         const inItem = hostContext('ion-item', this.el);
         const shouldRenderHighlight = mode === 'md' && fill !== 'outline' && !inItem;
+        const hasValue = this.hasValue();
+        const hasStartEndSlots = el.querySelector('[slot="start"], [slot="end"]') !== null;
         renderHiddenInput(true, el, name, parseValue(value), disabled);
+        /**
+         * If the label is stacked, it should always sit above the select.
+         * For floating labels, the label should move above the select if
+         * the select has a value, is open, 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 select 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 || isExpanded || hasStartEndSlots));
         return (h(Host, { onClick: this.onClick, class: createColorClasses(this.color, {
                 [mode]: true,
                 'in-item': inItem,
@@ -540,7 +578,8 @@ export class Select {
                 'select-disabled': disabled,
                 'select-expanded': isExpanded,
                 'has-expanded-icon': expandedIcon !== undefined,
-                'has-value': this.hasValue(),
+                'has-value': hasValue,
+                'label-floating': labelShouldFloat,
                 'has-placeholder': placeholder !== undefined,
                 'ion-focusable': true,
                 [`select-${rtl}`]: true,
@@ -548,7 +587,7 @@ export class Select {
                 [`select-justify-${justify}`]: justifyEnabled,
                 [`select-shape-${shape}`]: shape !== undefined,
                 [`select-label-placement-${labelPlacement}`]: true,
-            }) }, h("label", { class: "select-wrapper", id: "select-label" }, this.renderLabelContainer(), h("div", { class: "native-wrapper", ref: (el) => (this.nativeWrapperEl = el), part: "container" }, this.renderSelectText(), !hasFloatingOrStackedLabel && this.renderSelectIcon(), this.renderListbox()), hasFloatingOrStackedLabel && this.renderSelectIcon(), shouldRenderHighlight && h("div", { class: "select-highlight" }))));
+            }) }, h("label", { class: "select-wrapper", id: "select-label" }, this.renderLabelContainer(), h("div", { class: "select-wrapper-inner" }, h("slot", { name: "start" }), h("div", { class: "native-wrapper", ref: (el) => (this.nativeWrapperEl = el), part: "container" }, this.renderSelectText(), this.renderListbox()), h("slot", { name: "end" }), !hasFloatingOrStackedLabel && this.renderSelectIcon()), hasFloatingOrStackedLabel && this.renderSelectIcon(), shouldRenderHighlight && h("div", { class: "select-highlight" }))));
     }
     // TODO FW-3194 - Remove this
     renderLegacySelect() {
@@ -737,7 +776,7 @@ Developers can use the "legacy" property to continue using the legacy form marku
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": "A property name or function used to compare object values"
+                    "text": "This property allows developers to specify a custom function or property\nname for comparing objects when determining the selected option in the\nion-select. When not specified, the default behavior will use strict\nequality (===) for comparison."
                 },
                 "attribute": "compare-with",
                 "reflect": false
@@ -1215,17 +1254,6 @@ Developers can use the "legacy" property to continue using the legacy form marku
             }];
     }
 }
-const isOptionSelected = (currentValue, compareValue, compareWith) => {
-    if (currentValue === undefined) {
-        return false;
-    }
-    if (Array.isArray(currentValue)) {
-        return currentValue.some((val) => compareOptions(val, compareValue, compareWith));
-    }
-    else {
-        return compareOptions(currentValue, compareValue, compareWith);
-    }
-};
 const getOptionValue = (el) => {
     const value = el.value;
     return value === undefined ? el.textContent || '' : value;
@@ -1239,17 +1267,6 @@ const parseValue = (value) => {
     }
     return value.toString();
 };
-const compareOptions = (currentValue, compareValue, compareWith) => {
-    if (typeof compareWith === 'function') {
-        return compareWith(currentValue, compareValue);
-    }
-    else if (typeof compareWith === 'string') {
-        return currentValue[compareWith] === compareValue[compareWith];
-    }
-    else {
-        return Array.isArray(compareValue) ? compareValue.includes(currentValue) : currentValue === compareValue;
-    }
-};
 const generateText = (opts, value, compareWith) => {
     if (value === undefined) {
         return '';

package/dist/collection/components/select/select.md.css

@@ -132,6 +132,10 @@
   overflow: hidden;
 }
 
+:host(.in-item:not(.legacy-select)) {
+  flex: 1 1 0;
+}
+
 :host(.in-item.legacy-select) {
   position: static;
   max-width: 45%;
@@ -232,6 +236,12 @@ button {
   margin-top: 0;
   margin-bottom: 0;
   position: relative;
+  /**
+   * Prevent the icon from shrinking when the label and/or
+   * selected item text is long enough to fill the rest of
+   * the container.
+   */
+  flex-shrink: 0;
 }
 
 /**
@@ -315,6 +325,23 @@ button {
   transition: opacity 150ms cubic-bezier(0.4, 0, 0.2, 1);
 }
 
+.select-wrapper-inner {
+  display: flex;
+  align-items: center;
+  overflow: hidden;
+}
+
+:host(.select-label-placement-stacked) .select-wrapper-inner,
+:host(.select-label-placement-floating) .select-wrapper-inner {
+  /**
+   * When using a stacked/floating label, the inner wrapper is
+   * stacked vertically under the label container. This line
+   * ensures that the inner wrapper fills all the remaining height
+   * of the component.
+   */
+  flex-grow: 1;
+}
+
 :host(.ion-touched.ion-invalid) {
   --highlight-color: var(--highlight-color-invalid);
 }
@@ -555,11 +582,23 @@ button {
  * The placeholder should be hidden when the label
  * is on top of the select. This prevents the label
  * from overlapping any placeholder value.
+ *
+ * TODO(FW-5592): Remove :not(.label-floating) piece
  */
-:host(.select-label-placement-floating) .native-wrapper .select-placeholder {
+:host(.select-label-placement-floating:not(.label-floating)) .native-wrapper .select-placeholder {
   opacity: 0;
 }
 
+/**
+ * We don't use .label-floating here because that would
+ * also include the case where the label is floating due
+ * to content in the start/end slot. We want the opacity
+ * to remain at the default in this case, since the select
+ * isn't being actively interacted with.
+ *
+ * TODO(FW-5592): Change entire selector to:
+ * :host(.label-floating.select-label-placement-floating) .native-wrapper .select-placeholder
+ */
 :host(.select-expanded.select-label-placement-floating) .native-wrapper .select-placeholder,
 :host(.ion-focused.select-label-placement-floating) .native-wrapper .select-placeholder,
 :host(.has-value.select-label-placement-floating) .native-wrapper .select-placeholder {
@@ -569,10 +608,7 @@ button {
 /**
  * This makes the label sit above the input.
  */
-:host(.select-label-placement-stacked) .label-text-wrapper,
-:host(.select-expanded.select-label-placement-floating) .label-text-wrapper,
-:host(.ion-focused.select-label-placement-floating) .label-text-wrapper,
-:host(.has-value.select-label-placement-floating) .label-text-wrapper {
+:host(.label-floating) .label-text-wrapper {
   transform: translateY(50%) scale(0.75);
   /**
    * Label text should not extend
@@ -581,6 +617,23 @@ button {
   max-width: calc(100% / 0.75);
 }
 
+::slotted([slot=start]), ::slotted([slot=end]) {
+  /**
+   * Prevent the slots from shrinking when the label and/or
+   * selected item text is long enough to fill the rest of
+   * the container.
+   */
+  flex-shrink: 0;
+}
+
+::slotted([slot=start]) {
+  margin-inline-end: 16px;
+}
+
+::slotted([slot=end]) {
+  margin-inline-start: 16px;
+}
+
 /**
  * Convert a font size to a dynamic font size.
  * Fonts that participate in Dynamic Type should use
@@ -824,10 +877,7 @@ button {
   }
 }
 
-:host(.select-fill-solid.select-label-placement-stacked) .label-text-wrapper,
-:host(.select-expanded.select-fill-solid.select-label-placement-floating) .label-text-wrapper,
-:host(.ion-focused.select-fill-solid.select-label-placement-floating) .label-text-wrapper,
-:host(.has-value.select-fill-solid.select-label-placement-floating) .label-text-wrapper {
+:host(.label-floating.select-fill-solid) .label-text-wrapper {
   /**
    * Label text should not extend
    * beyond the bounds of the select.
@@ -983,10 +1033,7 @@ button {
 /**
  * This makes the label sit above the select.
  */
-:host(.select-expanded.select-fill-outline.select-label-placement-floating) .label-text-wrapper,
-:host(.ion-focused.select-fill-outline.select-label-placement-floating) .label-text-wrapper,
-:host(.has-value.select-fill-outline.select-label-placement-floating) .label-text-wrapper,
-:host(.select-fill-outline.select-label-placement-stacked) .label-text-wrapper {
+:host(.label-floating.select-fill-outline) .label-text-wrapper {
   transform: translateY(-32%) scale(0.75);
   margin-left: 0;
   margin-right: 0;
@@ -1131,10 +1178,7 @@ button {
  * the floating/stacked label. We simulate this "cut out"
  * by removing the top border from the notch fragment.
  */
-:host(.select-expanded.select-fill-outline.select-label-placement-floating) .select-outline-notch,
-:host(.ion-focused.select-fill-outline.select-label-placement-floating) .select-outline-notch,
-:host(.has-value.select-fill-outline.select-label-placement-floating) .select-outline-notch,
-:host(.select-fill-outline.select-label-placement-stacked) .select-outline-notch {
+:host(.label-floating.select-fill-outline) .select-outline-notch {
   border-top: none;
 }
 
@@ -1299,8 +1343,8 @@ button {
   --border-radius: 16px;
 }
 
-:host(.select-label-placement-stacked) .native-wrapper,
-:host(.select-label-placement-floating) .native-wrapper {
+:host(.select-label-placement-stacked) .select-wrapper-inner,
+:host(.select-label-placement-floating) .select-wrapper-inner {
   width: calc(100% - 0.8125rem - 4px);
 }
 

package/dist/collection/components/select/test/item/select.e2e.js

@@ -37,5 +37,20 @@ configs({ directions: ['ltr'] }).forEach(({ title, screenshot, config }) => {
             const list = page.locator('ion-list');
             await expect(list).toHaveScreenshot(screenshot(`select-inset-list-no-fill`));
         });
+        test('should render correctly in an item inside of a flex container', async ({ page }) => {
+            await page.setContent(`
+        <div id="container" style="display: flex">
+          <ion-list>
+            <ion-item>
+              <ion-select label="Fruit" value="apple">
+                <ion-select-option value="apple">Apple</ion-select-option>
+              </ion-select>
+            </ion-item>
+          <ion-list>
+        </div>
+      `, config);
+            const container = page.locator('#container');
+            await expect(container).toHaveScreenshot(screenshot(`select-item-flex-container`));
+        });
     });
 });

package/dist/collection/components/select/test/label/select.e2e.js

@@ -121,7 +121,7 @@ configs().forEach(({ title, screenshot, config }) => {
             });
             test('label should appear on top of the select when the select is expanded', async ({ page }) => {
                 await page.setContent(`
-           <ion-select class="select-expanded" label="Label" label-placement="floating" placeholder="Select a Fruit">
+           <ion-select class="select-expanded label-floating" label="Label" label-placement="floating" placeholder="Select a Fruit">
              <ion-select-option value="apples">Apples</ion-select-option>
            </ion-select>
          `, config);

package/dist/collection/components/select/test/legacy/wrapping/select.e2e.js

@@ -27,7 +27,7 @@ configs({ directions: ['ltr'] }).forEach(({ title, screenshot, config }) => {
             await page.setContent(`
         <ion-item>
           <ion-label>Really long label should not wrap</ion-label>
-          <ion-select value="wrap" class="ion-text-wrap">
+          <ion-select value="wrap" legacy="true" class="ion-text-wrap">
             <ion-select-option value="wrap">Should wrap value only when label exists and really long text exists to make it wrap the text</ion-select-option>
           </ion-select>
         </ion-item>

package/dist/collection/components/select/test/slot/select.e2e.js

@@ -0,0 +1,67 @@
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
+import { expect } from "@playwright/test";
+import { configs, test } from "../../../../utils/test/playwright/index";
+configs().forEach(({ title, screenshot, config }) => {
+    test.describe(title('select: start and end slots (visual checks)'), () => {
+        test('should not have visual regressions with a start-positioned label', async ({ page }) => {
+            await page.setContent(`
+          <ion-select label-placement="start" fill="solid" placeholder="Select weight" label="Weight">
+            <ion-icon slot="start" name="barbell" aria-hidden="true"></ion-icon>
+            <ion-label slot="end">lbs</ion-label>
+          </ion-select>
+        `, config);
+            const select = page.locator('ion-select');
+            await expect(select).toHaveScreenshot(screenshot(`select-slots-label-start`));
+        });
+        test('should not have visual regressions with a floating label', async ({ page }) => {
+            await page.setContent(`
+          <ion-select label-placement="floating" fill="solid" placeholder="Select weight" label="Weight">
+            <ion-icon slot="start" name="barbell" aria-hidden="true"></ion-icon>
+            <ion-label slot="end">lbs</ion-label>
+          </ion-select>
+        `, config);
+            const select = page.locator('ion-select');
+            await expect(select).toHaveScreenshot(screenshot(`select-slots-label-floating`));
+        });
+    });
+});
+configs({ modes: ['md'], directions: ['ltr'] }).forEach(({ title, config }) => {
+    test.describe(title('select: start and end slots (functionality checks)'), () => {
+        test('should raise floating label when there is content in the start slot', async ({ page }) => {
+            await page.setContent(`
+          <ion-select label-placement="floating" fill="solid" label="Weight">
+            <ion-icon slot="start" name="barbell" aria-hidden="true"></ion-icon>
+          </ion-select>
+        `, config);
+            const select = page.locator('ion-select');
+            await expect(select).toHaveClass(/label-floating/);
+        });
+        test('should raise floating label when there is content in the end slot', async ({ page }) => {
+            await page.setContent(`
+          <ion-select label-placement="floating" fill="solid" label="Weight">
+            <ion-icon slot="end" name="barbell" aria-hidden="true"></ion-icon>
+          </ion-select>
+        `, config);
+            const select = page.locator('ion-select');
+            await expect(select).toHaveClass(/label-floating/);
+        });
+        test('should not open select when slotted buttons are clicked', async ({ page }) => {
+            await page.setContent(`
+          <ion-select label="Favorite Pizza" placeholder="Select a pizza">
+            <ion-select-option value="pepperoni">Pepperoni</ion-select-option>
+            <ion-select-option value="supreme">Supreme</ion-select-option>
+            <ion-select-option value="chicken">Chicken</ion-select-option>
+            <ion-button fill="clear" slot="end" aria-label="Show/hide password">
+              <ion-icon slot="icon-only" name="eye" aria-hidden="true"></ion-icon>
+            </ion-button>
+          </ion-select>
+        `, config);
+            await page.click('ion-select ion-button[slot="end"]');
+            await page.waitForChanges();
+            const select = page.locator('ion-select');
+            await expect(select).not.toHaveClass(/select-expanded/);
+        });
+    });
+});

package/dist/collection/components/skeleton-text/skeleton-text.js

@@ -9,6 +9,18 @@ export class SkeletonText {
     constructor() {
         this.animated = false;
     }
+    componentWillLoad() {
+        this.emitStyle();
+    }
+    emitStyle() {
+        // The emitted property is used by item in order
+        // to add the item-skeleton-text class which applies
+        // overflow: hidden to its label
+        const style = {
+            'skeleton-text': true,
+        };
+        this.ionStyle.emit(style);
+    }
     render() {
         const animated = this.animated && config.getBoolean('animated', true);
         const inMedia = hostContext('ion-avatar', this.el) || hostContext('ion-thumbnail', this.el);
@@ -53,5 +65,32 @@ export class SkeletonText {
             }
         };
     }
+    static get events() {
+        return [{
+                "method": "ionStyle",
+                "name": "ionStyle",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [{
+                            "name": "internal",
+                            "text": undefined
+                        }],
+                    "text": "Emitted when the styles change."
+                },
+                "complexType": {
+                    "original": "StyleEventDetail",
+                    "resolved": "StyleEventDetail",
+                    "references": {
+                        "StyleEventDetail": {
+                            "location": "import",
+                            "path": "../../interface",
+                            "id": "src/interface.d.ts::StyleEventDetail"
+                        }
+                    }
+                }
+            }];
+    }
     static get elementRef() { return "el"; }
 }

package/dist/collection/components/textarea/test/slot/textarea.e2e.js

@@ -0,0 +1,51 @@
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
+import { expect } from "@playwright/test";
+import { configs, test } from "../../../../utils/test/playwright/index";
+configs().forEach(({ title, screenshot, config }) => {
+    test.describe(title('textarea: start and end slots (visual checks)'), () => {
+        test('should not have visual regressions with a start-positioned label', async ({ page }) => {
+            await page.setContent(`
+          <ion-textarea label-placement="start" fill="solid" value="100" label="Weight">
+            <ion-icon slot="start" name="barbell" aria-hidden="true"></ion-icon>
+            <ion-label slot="end">lbs</ion-label>
+          </ion-textarea>
+        `, config);
+            const textarea = page.locator('ion-textarea');
+            await expect(textarea).toHaveScreenshot(screenshot(`textarea-slots-label-start`));
+        });
+        test('should not have visual regressions with a floating label', async ({ page }) => {
+            await page.setContent(`
+          <ion-textarea label-placement="floating" fill="solid" value="100" label="Weight">
+            <ion-icon slot="start" name="barbell" aria-hidden="true"></ion-icon>
+            <ion-label slot="end">lbs</ion-label>
+          </ion-textarea>
+        `, config);
+            const textarea = page.locator('ion-textarea');
+            await expect(textarea).toHaveScreenshot(screenshot(`textarea-slots-label-floating`));
+        });
+    });
+});
+configs({ modes: ['md'], directions: ['ltr'] }).forEach(({ title, config }) => {
+    test.describe(title('textarea: start and end slots (functionality checks)'), () => {
+        test('should raise floating label when there is content in the start slot', async ({ page }) => {
+            await page.setContent(`
+          <ion-textarea label-placement="floating" fill="solid" label="Weight">
+            <ion-icon slot="start" name="barbell" aria-hidden="true"></ion-icon>
+          </ion-textarea>
+        `, config);
+            const textarea = page.locator('ion-textarea');
+            await expect(textarea).toHaveClass(/label-floating/);
+        });
+        test('should raise floating label when there is content in the end slot', async ({ page }) => {
+            await page.setContent(`
+          <ion-textarea label-placement="floating" fill="solid" label="Weight">
+            <ion-icon slot="end" name="barbell" aria-hidden="true"></ion-icon>
+          </ion-textarea>
+        `, config);
+            const textarea = page.locator('ion-textarea');
+            await expect(textarea).toHaveClass(/label-floating/);
+        });
+    });
+});

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

@@ -356,9 +356,7 @@
 }
 
 .native-wrapper {
-  display: flex;
   position: relative;
-  flex-grow: 1;
   width: 100%;
   height: 100%;
 }
@@ -429,6 +427,12 @@
   word-break: break-word;
 }
 
+.textarea-wrapper-inner {
+  display: flex;
+  width: 100%;
+  min-height: inherit;
+}
+
 :host(.ion-touched.ion-invalid) {
   --highlight-color: var(--highlight-color-invalid);
 }
@@ -704,6 +708,13 @@
   margin-bottom: 0px;
 }
 
+:host(.textarea-label-placement-stacked) ::slotted([slot=start]),
+:host(.textarea-label-placement-stacked) ::slotted([slot=end]),
+:host(.textarea-label-placement-floating) ::slotted([slot=start]),
+:host(.textarea-label-placement-floating) ::slotted([slot=end]) {
+  margin-top: 8px;
+}
+
 /**
  * This makes the label sit over the textarea
  * when the textarea is blurred and has no value.
@@ -729,9 +740,7 @@
 /**
  * This makes the label sit above the textarea.
  */
-:host(.textarea-label-placement-stacked) .label-text-wrapper,
-:host(.has-focus.textarea-label-placement-floating) .label-text-wrapper,
-:host(.has-value.textarea-label-placement-floating) .label-text-wrapper {
+:host(.label-floating) .label-text-wrapper {
   transform: translateY(50%) scale(0.75);
   /**
    * Label text should not extend
@@ -740,6 +749,29 @@
   max-width: calc(100% / 0.75);
 }
 
+.start-slot-wrapper, .end-slot-wrapper {
+  padding-left: 0;
+  padding-right: 0;
+  padding-top: var(--padding-top);
+  padding-bottom: var(--padding-bottom);
+  display: flex;
+  flex-shrink: 0;
+  align-self: start;
+}
+
+::slotted([slot=start]),
+::slotted([slot=end]) {
+  margin-top: 0;
+}
+
+::slotted([slot=start]) {
+  margin-inline-end: 16px;
+}
+
+::slotted([slot=end]) {
+  margin-inline-start: 16px;
+}
+
 /**
  * Convert a font size to a dynamic font size.
  * Fonts that participate in Dynamic Type should use

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

@@ -13,6 +13,8 @@ import { getCounterText } from "../input/input.utils";
  * @virtualProp {"ios" | "md"} mode - The mode determines which platform styles to use.
  *
  * @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)
  */
 export class Textarea {
     constructor() {
@@ -121,7 +123,7 @@ export class Textarea {
     connectedCallback() {
         const { el } = this;
         this.legacyFormController = createLegacyFormController(el);
-        this.slotMutationController = createSlotMutationController(el, 'label', () => forceUpdate(this));
+        this.slotMutationController = createSlotMutationController(el, ['label', 'start', 'end'], () => forceUpdate(this));
         this.notchController = createNotchController(el, () => this.notchSpacerEl, () => this.labelSlot);
         this.emitStyle();
         this.debounceChanged();
@@ -191,6 +193,8 @@ export class Textarea {
                 'has-placeholder': this.placeholder !== undefined,
                 'has-value': this.hasValue(),
                 'has-focus': this.hasFocus,
+                // TODO(FW-2876): remove this
+                legacy: !!this.legacy,
             });
         }
     }
@@ -362,20 +366,41 @@ Developers can use the "legacy" property to continue using the legacy form marku
         return (h("div", { class: "textarea-bottom" }, this.renderHintText(), this.renderCounter()));
     }
     renderTextarea() {
-        const { inputId, disabled, fill, shape, labelPlacement } = this;
+        const { inputId, disabled, fill, shape, labelPlacement, el, hasFocus } = this;
         const mode = getIonMode(this);
         const value = this.getValue();
         const inItem = hostContext('ion-item', this.el);
         const shouldRenderHighlight = mode === 'md' && fill !== 'outline' && !inItem;
+        const hasValue = this.hasValue();
+        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, 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 || hasStartEndSlots));
         return (h(Host, { class: createColorClasses(this.color, {
                 [mode]: true,
-                'has-value': this.hasValue(),
-                'has-focus': this.hasFocus,
+                'has-value': hasValue,
+                'has-focus': hasFocus,
+                'label-floating': labelShouldFloat,
                 [`textarea-fill-${fill}`]: fill !== undefined,
                 [`textarea-shape-${shape}`]: shape !== undefined,
                 [`textarea-label-placement-${labelPlacement}`]: true,
                 'textarea-disabled': disabled,
-            }) }, h("label", { class: "textarea-wrapper" }, this.renderLabelContainer(), h("div", { class: "native-wrapper", ref: (el) => (this.textareaWrapper = el) }, h("textarea", Object.assign({ 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 }, this.inheritedAttributes), value)), shouldRenderHighlight && h("div", { class: "textarea-highlight" })), this.renderBottomContent()));
+            }) }, h("label", { class: "textarea-wrapper", htmlFor: inputId }, this.renderLabelContainer(), h("div", { class: "textarea-wrapper-inner" }, h("div", { class: "start-slot-wrapper" }, h("slot", { name: "start" })), h("div", { class: "native-wrapper", ref: (el) => (this.textareaWrapper = el) }, h("textarea", Object.assign({ 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 }, this.inheritedAttributes), value)), h("div", { class: "end-slot-wrapper" }, h("slot", { name: "end" }))), shouldRenderHighlight && h("div", { class: "textarea-highlight" })), this.renderBottomContent()));
     }
     render() {
         const { legacyFormController } = this;