@ionic/core 8.8.18 → 8.8.19-dev.11786730389.1a1927bf

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

@@ -16,144 +16,187 @@ import { getCounterText } from "../input/input.utils";
  * @slot end - Content to display at the trailing edge of the textarea. (EXPERIMENTAL)
  */
 export class Textarea {
-    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';
-        // `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();
-            }
-        };
-    }
+    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;
+    notchSpacerEl;
+    slotMutationController;
+    notchController;
+    /**
+     * 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;
     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 !== null && originalIonInput !== void 0 ? originalIonInput : ionInput : debounceEvent(ionInput, debounce);
+        this.ionInput = debounce === undefined ? originalIonInput ?? ionInput : debounceEvent(ionInput, debounce);
     }
+    /**
+     * If `true`, the user cannot interact with the textarea.
+     */
+    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;
     /**
      * Update the native input element when the value changes
      */
@@ -173,9 +216,37 @@ export class Textarea {
      * to the inner `<textarea>` element.
      */
     onDirChanged(newValue) {
-        this.inheritedAttributes = Object.assign(Object.assign({}, this.inheritedAttributes), { dir: newValue });
+        this.inheritedAttributes = {
+            ...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.
@@ -236,15 +307,17 @@ export class Textarea {
         }
     }
     componentWillLoad() {
-        this.inheritedAttributes = Object.assign(Object.assign({}, inheritAriaAttributes(this.el)), inheritAttributes(this.el, ['data-form-type', 'title', 'tabindex', 'dir']));
+        this.inheritedAttributes = {
+            ...inheritAriaAttributes(this.el),
+            ...inheritAttributes(this.el, ['data-form-type', 'title', 'tabindex', 'dir']),
+        };
     }
     componentDidLoad() {
         this.originalIonInput = this.ionInput;
         this.runAutoGrow();
     }
     componentDidRender() {
-        var _a;
-        (_a = this.notchController) === null || _a === void 0 ? void 0 : _a.calculateNotchWidth();
+        this.notchController?.calculateNotchWidth();
     }
     /**
      * Sets focus on the native `textarea` in `ion-textarea`. Use this method instead of the global
@@ -294,11 +367,10 @@ 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 = (_a = this.value) !== null && _a !== void 0 ? _a : '';
+                    this.textareaWrapper.dataset.replicatedValue = this.value ?? '';
                 }
             });
         }
@@ -349,6 +421,41 @@ 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);
+        }
+        this.didTextareaClearOnEdit = false;
+        this.ionBlur.emit(ev);
+    };
+    onKeyDown = (ev) => {
+        this.checkClearOnEdit(ev);
+    };
     renderLabel() {
         const { label } = this;
         return (h("div", { class: {
@@ -372,6 +479,17 @@ export class Textarea {
     get hasLabel() {
         return this.label !== undefined || this.labelSlot !== null;
     }
+    /**
+     * Stops propagation when the label is clicked,
+     * otherwise, two clicks will be triggered.
+     */
+    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();
+        }
+    };
     /**
      * Renders the border container when fill="outline".
      */
@@ -471,7 +589,7 @@ export class Textarea {
          * TODO(FW-5592): Remove hasStartEndSlots condition
          */
         const labelShouldFloat = labelPlacement === 'stacked' || (labelPlacement === 'floating' && (hasValue || hasFocus || hasStartEndSlots));
-        return (h(Host, { key: '4257e84acd46f43390fa2413d0b8f40e16a37499', class: createColorClasses(this.color, {
+        return (h(Host, { key: 'eca1dfed53189408f614661ef3902cdb73d5f5de', class: createColorClasses(this.color, {
                 [mode]: true,
                 'has-value': hasValue,
                 'has-focus': hasFocus,
@@ -480,7 +598,7 @@ export class Textarea {
                 [`textarea-shape-${shape}`]: shape !== undefined,
                 [`textarea-label-placement-${labelPlacement}`]: true,
                 'textarea-disabled': disabled,
-            }) }, h("label", { key: '003da35bad92ab36777b7ae40855541bf900c64a', class: "textarea-wrapper", htmlFor: inputId, onClick: this.onLabelClick }, this.renderLabelContainer(), h("div", { key: '3cae2d19f96ba2b18a2d64298fdcc4b64ad34ac7', class: "textarea-wrapper-inner" }, h("div", { key: 'e26cb06763d551f7f83b6ea80349871aab18a016', class: "start-slot-wrapper" }, h("slot", { key: '135ba6db893eaca5f2a785fe61e24f33f56f3765', name: "start" })), h("div", { key: '951eabdd01c5e370790cec8578268361dcc8abdc', class: "native-wrapper", ref: (el) => (this.textareaWrapper = el) }, h("textarea", Object.assign({ key: '13d78f1a934b9f8d85cd9ed386dabc786f953f1d', 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: '699038558019470bccb4853fa65e7aeb069e0baa', class: "end-slot-wrapper" }, h("slot", { key: '19d8c212d7c718aeb6924e10bf8e48cad01314ea', name: "end" }))), shouldRenderHighlight && h("div", { key: '910a9437437ce7cab21e37a1cb4a6b309afda58f', class: "textarea-highlight" })), this.renderBottomContent()));
+            }) }, h("label", { key: 'd4d835ffedbf8b6de192096e21167ec4f7e01d30', class: "textarea-wrapper", htmlFor: inputId, onClick: this.onLabelClick }, this.renderLabelContainer(), h("div", { key: '39b03e26c23473de31a0237543eaf1e0875e6ed9', class: "textarea-wrapper-inner" }, h("div", { key: 'e9e0997e7dc6d25f09e8439d81e138590c33a151', class: "start-slot-wrapper" }, h("slot", { key: '2d88aace11d74196758e40af27a777eebb270019', name: "start" })), h("div", { key: '8434424404f9fe707f9209ac6495a33bae060538', class: "native-wrapper", ref: (el) => (this.textareaWrapper = el) }, h("textarea", { key: '5bb8eaeba76c39bccadb7c041a10fb077c422dcc', 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: '107707676552f8faca3e708285cc3266061a0394', class: "end-slot-wrapper" }, h("slot", { key: 'dc890ffdce898f3d39a315e7bc432840559be466', name: "end" }))), shouldRenderHighlight && h("div", { key: '4554ad09ac0908cea2e90bfa2301b4cd80ac7242', class: "textarea-highlight" })), this.renderBottomContent()));
     }
     static get is() { return "ion-textarea"; }
     static get encapsulation() { return "scoped"; }

package/dist/collection/components/thumbnail/thumbnail.js

@@ -5,7 +5,7 @@ import { Host, h } from "@stencil/core";
 import { getIonMode } from "../../global/ionic-global";
 export class Thumbnail {
     render() {
-        return (h(Host, { key: 'b250e01664238f1dca8f9757b15bc3d5d9387ffa', class: getIonMode(this) }, h("slot", { key: '72cb568bccabc983c5186a7596ef6c6d4ebf5ad9' })));
+        return (h(Host, { key: '833e947c683b482a78f8f0df8c9a68e99478bbaa', class: getIonMode(this) }, h("slot", { key: '6d1e9e686db88d91379f14121058dbf035d8ded2' })));
     }
     static get is() { return "ion-thumbnail"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/title/title.js

@@ -5,6 +5,22 @@ import { Host, h } from "@stencil/core";
 import { createColorClasses } from "../../utils/theme";
 import { getIonMode } from "../../global/ionic-global";
 export class ToolbarTitle {
+    el;
+    /**
+     * The color to use from your application's color palette.
+     * Default options are: `"primary"`, `"secondary"`, `"tertiary"`, `"success"`, `"warning"`, `"danger"`, `"light"`, `"medium"`, and `"dark"`.
+     * For more information on colors, see [theming](/docs/theming/basics).
+     */
+    color;
+    /**
+     * The size of the toolbar title.
+     */
+    size;
+    /**
+     * Emitted when the styles change.
+     * @internal
+     */
+    ionStyle;
     sizeChanged() {
         this.emitStyle();
     }
@@ -23,11 +39,11 @@ export class ToolbarTitle {
     render() {
         const mode = getIonMode(this);
         const size = this.getSize();
-        return (h(Host, { key: '44e63f8439df64c470692904427b417e19406476', class: createColorClasses(this.color, {
+        return (h(Host, { key: 'd9317e8e66cb6112717f5a9c252658777efbd873', class: createColorClasses(this.color, {
                 [mode]: true,
                 [`title-${size}`]: true,
                 'title-rtl': document.dir === 'rtl',
-            }) }, h("div", { key: '784cf60a0db16045391891cc8fad0c7dbeba4039', class: "toolbar-title" }, h("slot", { key: '0c720a50479ba257e8756337aeb9b0ab7516a227' }))));
+            }) }, h("div", { key: 'a4d011d6d409bf006d8efe33667002edb109820a', class: "toolbar-title" }, h("slot", { key: '4ca3303b957a0e5387f1e9058e5adb4c6275afcc' }))));
     }
     static get is() { return "ion-title"; }
     static get encapsulation() { return "shadow"; }