@nectary/components 4.9.1 → 4.10.1

package/input/index.js

@@ -1,4 +1,5 @@
 import { Context, defineCustomElement, getAttribute, getBooleanAttribute, getLiteralAttribute, getReactEventHandler, isAttrEqual, isAttrTrue, isElementFocused, NectaryElement, setClass, subscribeContext, updateAttribute, updateBooleanAttribute, updateLiteralAttribute } from '../utils';
+import { requestSubmitForm, setFormValue } from '../utils/form';
 import { DEFAULT_SIZE, sizeValues } from '../utils/size';
 const templateHTML = '<style>:host{all:initial;display:inline-block;vertical-align:middle}#wrapper{position:relative;display:flex;flex-direction:row;align-items:center;box-sizing:border-box;border-radius:var(--sinch-local-shape-radius);width:100%;height:var(--sinch-local-size);background-color:var(--sinch-comp-input-color-default-background-initial);--sinch-local-size:var(--sinch-comp-input-size-container-m);--sinch-global-size-icon:var(--sinch-comp-input-size-icon-m);--sinch-local-shape-radius:var(--sinch-comp-input-shape-radius-size-m)}:host([data-size="l"])>#wrapper{--sinch-local-size:var(--sinch-comp-input-size-container-l);--sinch-global-size-icon:var(--sinch-comp-input-size-icon-l);--sinch-local-shape-radius:var(--sinch-comp-input-shape-radius-size-l)}:host([data-size="m"])>#wrapper{--sinch-local-size:var(--sinch-comp-input-size-container-m);--sinch-global-size-icon:var(--sinch-comp-input-size-icon-m);--sinch-local-shape-radius:var(--sinch-comp-input-shape-radius-size-m)}:host([data-size="s"])>#wrapper{--sinch-local-size:var(--sinch-comp-input-size-container-s);--sinch-global-size-icon:var(--sinch-comp-input-size-icon-s);--sinch-local-shape-radius:var(--sinch-comp-input-shape-radius-size-s)}#input-wrapper{position:relative;flex:1;flex-basis:0;min-width:0;align-self:stretch}#input{all:initial;width:100%;height:100%;padding:0 12px;box-sizing:border-box;font:var(--sinch-comp-input-font-input);color:var(--sinch-comp-input-color-default-text-initial)}#input::placeholder{font:var(--sinch-comp-input-font-placeholder)!important;color:var(--sinch-comp-input-color-default-text-placeholder);opacity:1}#input:disabled{color:var(--sinch-comp-input-color-disabled-text-initial);-webkit-text-fill-color:var(--sinch-comp-input-color-disabled-text-initial)}#input-mask{display:none;position:absolute;inset:0;padding:0 12px;pointer-events:none;color:var(--sinch-comp-input-color-default-text-placeholder);white-space:pre;height:fit-content;margin:auto 0;overflow:hidden}#border{position:absolute;border:1px solid var(--sinch-comp-input-color-default-border-initial);border-radius:var(--sinch-local-shape-radius);inset:0;pointer-events:none}:host([disabled]) #border{border-color:var(--sinch-comp-input-color-disabled-border-initial)}#input-wrapper:focus-within+#border{border-color:var(--sinch-comp-input-color-default-border-focus);border-width:2px}#input-mask,:host([mask]) #input{font:var(--sinch-sys-font-body-monospace-m)}:host([mask]) #input-mask{display:block}:host([invalid]:not([disabled])) #input-wrapper:not(:focus-within)+#border{border-color:var(--sinch-comp-input-color-invalid-border-initial)}#input[type=password]:not(:placeholder-shown){font-size:1.5em;letter-spacing:.1em}#icon-wrapper{position:relative;height:100%}#icon{position:absolute;display:flex;align-items:center;left:12px;top:0;bottom:0;pointer-events:none;--sinch-global-color-icon:var(--sinch-comp-input-color-default-icon-initial)}:host([disabled]) #icon{--sinch-global-color-icon:var(--sinch-comp-input-color-disabled-icon-initial)}#icon-wrapper.empty{display:none}#icon-wrapper.empty~#input-wrapper>#input,#icon-wrapper.empty~#input-wrapper>#input-mask{padding-left:12px}#icon-wrapper:not(.empty)~#input-wrapper>#input,#icon-wrapper:not(.empty)~#input-wrapper>#input-mask{padding-left:calc(var(--sinch-global-size-icon) + 20px)}#right{display:flex;flex-direction:row;align-self:stretch;align-items:center;gap:4px;padding-right:4px}#right.empty{display:none}#left{display:flex;flex-direction:row;align-self:stretch;align-items:center;gap:4px;padding-left:4px}#left.empty{display:none}</style><div id="wrapper"><div id="left"><slot name="left"></slot></div><div id="icon-wrapper"><div id="icon"><slot name="icon"></slot></div></div><div id="input-wrapper"><div id="input-mask"></div><input id="input" type="text"/></div><div id="border"></div><div id="right"><slot name="right"></slot></div></div>';
 import { deleteContentBackward, deleteContentForward, getMaskSymbols, inputTypes, insertText, beginMaskedComposition, endMaskedComposition, splitValueAndMask, getMergedValueSliced, insertFromPaste } from './utils';
@@ -22,12 +23,15 @@ defineCustomElement('sinch-input', class extends NectaryElement {
   #controller = null;
   #sizeContext;
   #maskSymbols = null;
+  #internals;
+  static formAssociated = true;
   constructor() {
     super();
     const shadowRoot = this.attachShadow({
       delegatesFocus: true
     });
     shadowRoot.appendChild(template.content.cloneNode(true));
+    this.#internals = this.attachInternals();
     this.#$input = shadowRoot.querySelector('#input');
     this.#$inputMask = shadowRoot.querySelector('#input-mask');
     this.#$iconSlot = shadowRoot.querySelector('slot[name="icon"]');
@@ -43,12 +47,14 @@ defineCustomElement('sinch-input', class extends NectaryElement {
   connectedCallback() {
     super.connectedCallback();
     this.setAttribute('role', 'textbox');
+    this.#internals.role = 'textbox';
     if (this.#controller === null) {
       this.#controller = new AbortController();
     }
     const options = {
       signal: this.#controller.signal
     };
+    this.#$input.addEventListener('keydown', this.#onKeyDown, options);
     this.#$input.addEventListener('input', this.#onInput, options);
     this.#$input.addEventListener('cut', this.#onCut, options);
     this.#$input.addEventListener('copy', this.#onCopy, options);
@@ -80,11 +86,53 @@ defineCustomElement('sinch-input', class extends NectaryElement {
     this.#controller.abort();
     this.#controller = null;
   }
+  formAssociatedCallback() {
+    setFormValue(this.#internals, this.#$input.value);
+  }
+  formResetCallback() {
+    this.#$input.value = '';
+    setFormValue(this.#internals, '');
+  }
+  formStateRestoreCallback(state) {
+    if (this.#internals.form === null || getBooleanAttribute(this.#internals.form, 'data-form-state-restore') === false) {
+      return;
+    }
+    if (state !== null) {
+      const value = typeof state === 'string' ? state : state.get(this.name);
+      this.#$input.value = value?.toString() ?? '';
+      setFormValue(this.#internals, value?.toString() ?? '');
+    }
+  }
+  #onKeyDown = e => {
+    const form = this.#internals.form;
+    if (form === null) {
+      return;
+    }
+    if (form.disabled === true) {
+      return;
+    }
+    if (e.key === 'Enter') {
+      const submitSelectors = ['sinch-button[form-type="submit"]'];
+      const formSubmitters = Array.from(form.querySelectorAll(submitSelectors.join(',')));
+      const formSubmitter = formSubmitters.find(submitter => !submitter.disabled) ?? null;
+      if (formSubmitter !== null) {
+        requestSubmitForm(form, formSubmitter);
+      }
+    }
+  };
   static get observedAttributes() {
-    return ['type', 'value', 'placeholder', 'mask', 'invalid', 'disabled', 'size', 'autocomplete', 'autofocus', 'data-size', 'aria-label'];
+    return ['name', 'type', 'value', 'placeholder', 'mask', 'invalid', 'disabled', 'size', 'autocomplete', 'autofocus', 'data-size', 'aria-label'];
   }
   attributeChangedCallback(name, oldVal, newVal) {
     switch (name) {
+      case 'name':
+        {
+          if (isAttrEqual(oldVal, newVal)) {
+            return;
+          }
+          updateAttribute(this.#$input, 'name', newVal);
+          break;
+        }
       case 'type':
         {
           updateLiteralAttribute(this.#$input, inputTypes, 'type', newVal);
@@ -107,6 +155,7 @@ defineCustomElement('sinch-input', class extends NectaryElement {
               placeholder
             } = splitValueAndMask(nextVal, this.#maskSymbols);
             this.#$input.value = value;
+            setFormValue(this.#internals, value);
             this.#$inputMask.textContent = placeholder;
             if (isElementFocused(this.#$input)) {
               this.#setSelectionRange(this.#selectionEnd, this.#selectionEnd);
@@ -115,6 +164,7 @@ defineCustomElement('sinch-input', class extends NectaryElement {
           }
           if (nextVal !== prevVal) {
             this.#$input.value = nextVal;
+            setFormValue(this.#internals, nextVal);
             if (isElementFocused(this.#$input)) {
               this.#setSelectionRange(this.#selectionEnd, this.#selectionEnd);
             }
@@ -139,6 +189,7 @@ defineCustomElement('sinch-input', class extends NectaryElement {
           const isInvalid = isAttrTrue(newVal);
           this.ariaInvalid = isInvalid.toString();
           this.#$input.ariaInvalid = this.ariaInvalid;
+          this.#internals.ariaInvalid = this.ariaInvalid;
           updateBooleanAttribute(this, name, isInvalid);
           break;
         }
@@ -180,10 +231,17 @@ defineCustomElement('sinch-input', class extends NectaryElement {
       case 'aria-label':
         {
           this.#$input.ariaLabel = newVal;
+          this.#internals.ariaLabel = newVal;
           break;
         }
     }
   }
+  set name(value) {
+    updateAttribute(this, 'name', value);
+  }
+  get name() {
+    return getAttribute(this, 'name', '');
+  }
   set type(value) {
     updateAttribute(this, 'type', value);
   }
@@ -411,11 +469,14 @@ defineCustomElement('sinch-input', class extends NectaryElement {
     }
     const nextValue = this.#$input.value;
     const prevValue = this.value;
+    setFormValue(this.#internals, nextValue);
     if (prevValue !== nextValue) {
       const nextSelectionStart = this.#$input.selectionStart;
       const nextSelectionEnd = this.#$input.selectionEnd;
-      this.#$input.value = prevValue;
-      this.#setSelectionRange(this.#selectionStart, this.#selectionEnd);
+      if (this.hasAttribute('value')) {
+        this.#$input.value = prevValue;
+        this.#setSelectionRange(this.#selectionStart, this.#selectionEnd);
+      }
       this.#selectionStart = nextSelectionStart;
       this.#selectionEnd = nextSelectionEnd;
       this.#dispatchChangeEvent(nextValue);
@@ -595,10 +656,12 @@ defineCustomElement('sinch-input', class extends NectaryElement {
     if (this.#maskSymbols === null) {
       const value = this.placeholder;
       this.#$input.placeholder = value ?? '';
+      this.#internals.ariaPlaceholder = value ?? '';
       updateAttribute(this, 'aria-placeholder', value);
     } else {
       updateAttribute(this, 'aria-placeholder', null);
       this.#$input.placeholder = '';
+      this.#internals.ariaPlaceholder = '';
     }
   }
   #onIconSlotChange = () => {

package/input/types.d.ts

@@ -6,8 +6,10 @@ export type TSinchInputClipboardEvent = CustomEvent<{
     replaceWith: (value: string) => void;
 }>;
 export type TSinchInputProps = {
+    /** Identification for uncontrolled form submissions */
+    name?: string;
     /** Controlled value, doesn't change on its own and requres an onChange-value state loop */
-    value: string;
+    value?: string;
     /** Mask */
     mask?: string | null;
     /** Label that is used for a11y – might be different from `label` */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nectary/components",
-  "version": "4.9.1",
+  "version": "4.10.1",
   "files": [
     "**/*/*.css",
     "**/*/*.json",
@@ -20,7 +20,7 @@
   },
   "dependencies": {
     "@babel/runtime": "^7.22.15",
-    "@nectary/assets": "2.3.1"
+    "@nectary/assets": "2.4.0"
   },
   "devDependencies": {
     "@babel/cli": "^7.22.15",
@@ -34,6 +34,6 @@
     "typescript": "^5.2.2"
   },
   "peerDependencies": {
-    "@nectary/theme-base": "1.4.2"
+    "@nectary/theme-base": "1.4.3"
   }
 }

package/radio/index.js

@@ -1,14 +1,20 @@
 import { defineCustomElement, getAttribute, getBooleanAttribute, getReactEventHandler, getTargetByAttribute, isAttrTrue, NectaryElement, updateAttribute, updateBooleanAttribute } from '../utils';
+import { setFormValue } from '../utils/form';
 const templateHTML = '<style>:host{display:block}#wrapper{display:flex;flex-direction:var(--sinch-comp-radio-direction,column);gap:var(--sinch-comp-radio-gap,8px);box-sizing:border-box;width:100%}</style><div id="wrapper"><slot></slot></div>';
 const template = document.createElement('template');
 template.innerHTML = templateHTML;
 defineCustomElement('sinch-radio', class extends NectaryElement {
   #$slot;
   #controller = null;
+  #internals;
+  static formAssociated = true;
   constructor() {
     super();
-    const shadowRoot = this.attachShadow();
+    const shadowRoot = this.attachShadow({
+      delegatesFocus: true
+    });
     shadowRoot.appendChild(template.content.cloneNode(true));
+    this.#internals = this.attachInternals();
     this.#$slot = shadowRoot.querySelector('slot');
   }
   connectedCallback() {
@@ -20,6 +26,7 @@ defineCustomElement('sinch-radio', class extends NectaryElement {
       signal
     };
     this.setAttribute('role', 'radiogroup');
+    this.#internals.role = 'radiogroup';
     this.#$slot.addEventListener('slotchange', this.#onSlotChange, options);
     this.#$slot.addEventListener('keydown', this.#onOptionKeyDown, options);
     this.#$slot.addEventListener('click', this.#onOptionClick, options);
@@ -29,9 +36,32 @@ defineCustomElement('sinch-radio', class extends NectaryElement {
     this.#controller.abort();
     this.#controller = null;
   }
+  formAssociatedCallback() {
+    setFormValue(this.#internals, this.value);
+  }
+  formResetCallback() {
+    this.value = '';
+    setFormValue(this.#internals, '');
+  }
+  formStateRestoreCallback(state) {
+    if (this.#internals.form === null || getBooleanAttribute(this.#internals.form, 'data-form-state-restore') === false) {
+      return;
+    }
+    if (state !== null) {
+      const value = typeof state === 'string' ? state : state.get(this.name);
+      this.value = value?.toString() ?? '';
+      setFormValue(this.#internals, value?.toString() ?? '');
+    }
+  }
   static get observedAttributes() {
     return ['value', 'invalid'];
   }
+  set name(value) {
+    updateAttribute(this, 'name', value);
+  }
+  get name() {
+    return getAttribute(this, 'name', '');
+  }
   set value(value) {
     updateAttribute(this, 'value', value);
   }
@@ -49,6 +79,7 @@ defineCustomElement('sinch-radio', class extends NectaryElement {
       case 'value':
         {
           this.#onValueChange(newVal ?? '');
+          setFormValue(this.#internals, newVal ?? '');
           break;
         }
       case 'invalid':

package/radio/types.d.ts

@@ -1,7 +1,12 @@
 import type { NectaryComponentReactByType, NectaryComponentVanillaByType } from '../types';
 export type TSinchRadioProps = {
-    value: string;
+    /** Identification for uncontrolled form submissions */
+    name?: string;
+    /** Value */
+    value?: string;
+    /** Invalid state */
     invalid?: boolean;
+    /** Label that is used for a11y – might be different from `label` */
     'aria-label': string;
 };
 export type TSinchRadioEvents = {

package/select-menu/index.js

@@ -3,6 +3,7 @@ import '../icon';
 import '../text';
 import { isSelectMenuOption } from '../select-menu-option/utils';
 import { attrValueToPixels, defineCustomElement, getAttribute, getBooleanAttribute, unpackCsv, getFirstCsvValue, getIntegerAttribute, getReactEventHandler, isAttrTrue, NectaryElement, updateAttribute, updateBooleanAttribute, updateCsv, updateExplicitBooleanAttribute, updateIntegerAttribute, debounceTimeout, setClass, subscribeContext, hasClass, isTargetEqual } from '../utils';
+import { CSVToFormData, setFormValue } from '../utils/form';
 const templateHTML = '<style>:host{display:block;outline:0}#listbox{overflow-y:auto;max-height:var(--sinch-comp-select-menu-font-max-height)}#search{display:none;margin:10px}#search.active{display:block}#search-clear:not(.active){display:none}#not-found{display:flex;align-items:center;justify-content:center;width:100%;height:30px;margin-bottom:10px;pointer-events:none;user-select:none;--sinch-comp-text-font:var(--sinch-comp-select-menu-font-not-found-text);--sinch-global-color-text:var(--sinch-comp-select-menu-color-default-not-found-text-initial)}#not-found:not(.active){display:none}::slotted(.hidden){display:none}::slotted(sinch-title){padding:8px 16px;--sinch-global-color-text:var(--sinch-comp-select-menu-color-default-title-initial)}</style><sinch-input id="search" size="s" placeholder="Search"><sinch-icon icons-version="2" name="magnifying-glass" id="icon-search" slot="icon"></sinch-icon><sinch-button id="search-clear" slot="right"><sinch-icon icons-version="2" name="fa-xmark" slot="icon"></sinch-icon></sinch-button></sinch-input><div id="not-found"><sinch-text type="m">No results</sinch-text></div><div id="listbox" role="presentation"><slot></slot></div>';
 const ITEM_HEIGHT = 40;
 const NUM_ITEMS_SEARCH = 7;
@@ -16,11 +17,14 @@ defineCustomElement('sinch-select-menu', class extends NectaryElement {
   #$notFound;
   #controller = null;
   #searchDebounce;
+  #internals;
   #userManagedSearch = false;
+  static formAssociated = true;
   constructor() {
     super();
     const shadowRoot = this.attachShadow();
     shadowRoot.appendChild(template.content.cloneNode(true));
+    this.#internals = this.attachInternals();
     this.#$optionSlot = shadowRoot.querySelector('slot');
     this.#$listbox = shadowRoot.querySelector('#listbox');
     this.#$search = shadowRoot.querySelector('#search');
@@ -34,6 +38,7 @@ defineCustomElement('sinch-select-menu', class extends NectaryElement {
       signal: this.#controller.signal
     };
     this.setAttribute('role', 'listbox');
+    this.#internals.role = 'listbox';
     this.tabIndex = 0;
     this.addEventListener('keydown', this.#onListboxKeyDown, options);
     this.addEventListener('focus', this.#onFocus, options);
@@ -53,6 +58,23 @@ defineCustomElement('sinch-select-menu', class extends NectaryElement {
     this.#controller.abort();
     this.#controller = null;
   }
+  formAssociatedCallback() {
+    setFormValue(this.#internals, CSVToFormData(this.name, this.value));
+  }
+  formResetCallback() {
+    this.value = '';
+    setFormValue(this.#internals, '');
+  }
+  formStateRestoreCallback(state) {
+    if (this.#internals.form === null || getBooleanAttribute(this.#internals.form, 'data-form-state-restore') === false) {
+      return;
+    }
+    if (state !== null) {
+      const value = typeof state === 'string' ? state : state.get(this.name);
+      this.value = value?.toString() ?? '';
+      setFormValue(this.#internals, CSVToFormData(this.name, value?.toString() ?? ''));
+    }
+  }
   static get observedAttributes() {
     return ['value', 'rows', 'multiple', 'search-value', 'search-placeholder', 'search-autocomplete'];
   }
@@ -62,6 +84,7 @@ defineCustomElement('sinch-select-menu', class extends NectaryElement {
         {
           this.#onValueChange(this.value);
           updateExplicitBooleanAttribute(this, 'aria-multiselectable', isAttrTrue(newVal));
+          this.#internals.ariaMultiSelectable = isAttrTrue(newVal).toString();
           break;
         }
       case 'search-autocomplete':
@@ -99,6 +122,12 @@ defineCustomElement('sinch-select-menu', class extends NectaryElement {
         }
     }
   }
+  set name(value) {
+    updateAttribute(this, 'name', value);
+  }
+  get name() {
+    return getAttribute(this, 'name', '');
+  }
   set value(value) {
     updateAttribute(this, 'value', value);
   }
@@ -265,12 +294,18 @@ defineCustomElement('sinch-select-menu', class extends NectaryElement {
         const isChecked = !getBooleanAttribute($option, 'disabled') && values.includes(getAttribute($option, 'value', ''));
         updateBooleanAttribute($option, 'data-checked', isChecked);
       }
+      const formData = new FormData();
+      values.forEach(value => {
+        formData.append(this.name, value);
+      });
+      setFormValue(this.#internals, formData);
     } else {
       const value = getFirstCsvValue(csv);
       for (const $option of this.#getOptionElements()) {
         const isChecked = !getBooleanAttribute($option, 'disabled') && value === getAttribute($option, 'value', '');
         updateBooleanAttribute($option, 'data-checked', isChecked);
       }
+      setFormValue(this.#internals, value ?? '');
     }
   }
   #getFirstOption() {

package/select-menu/types.d.ts

@@ -1,5 +1,7 @@
 import type { NectaryComponentReactByType, NectaryComponentVanillaByType } from '../types';
 export type TSinchSelectMenuProps = {
+    /** Identification for uncontrolled form submissions */
+    name?: string;
     /** Selected value, CSV when multiple */
     value: string;
     /** How many rows to show and scroll the rest */

package/textarea/index.js

@@ -1,4 +1,5 @@
 import { Context, defineCustomElement, getAttribute, getBooleanAttribute, getIntegerAttribute, getReactEventHandler, getRect, hasClass, isAttrEqual, isAttrTrue, NectaryElement, setClass, updateAttribute, updateBooleanAttribute } from '../utils';
+import { setFormValue } from '../utils/form';
 import { DEFAULT_SIZE } from '../utils/size';
 const templateHTML = '<style>:host{display:block}#wrapper{display:flex;flex-direction:column;position:relative;width:100%;box-sizing:border-box;background-color:var(--sinch-comp-textarea-color-default-background-initial);border-radius:var(--sinch-local-shape-radius);padding-right:2px;overflow:hidden;--sinch-local-shape-radius:var(--sinch-comp-textarea-shape-radius)}#input{all:initial;display:block;font:var(--sinch-comp-textarea-font-input);color:var(--sinch-comp-textarea-color-default-text-initial);resize:none;white-space:pre-wrap;overflow-wrap:break-word;padding:8px 10px 8px 12px;border:none;box-sizing:border-box}#input::placeholder{color:var(--sinch-comp-textarea-color-default-text-placeholder);opacity:1}#input:disabled{color:var(--sinch-comp-textarea-color-disabled-text-initial);-webkit-text-fill-color:var(--sinch-comp-textarea-color-disabled-text-initial)}#border{position:absolute;border:1px solid var(--sinch-comp-textarea-color-default-border-initial);border-radius:var(--sinch-local-shape-radius);inset:0;pointer-events:none}:host([invalid]) #border{border-color:var(--sinch-comp-textarea-color-invalid-border-initial)}#input:focus+#border{border-color:var(--sinch-comp-textarea-color-default-border-focus);border-width:2px}#input:disabled+#border{border-color:var(--sinch-comp-textarea-color-disabled-border-initial)}#bottom{display:flex;flex-direction:row;align-items:center;gap:8px;padding:12px 4px 4px}#bottom.empty{display:none}:host([resizable]) #bottom{padding-right:calc(var(--sinch-comp-textarea-size-resize-handle) + 4px)}#resize-handle{display:none;position:absolute;width:var(--sinch-comp-textarea-size-resize-handle);height:var(--sinch-comp-textarea-size-resize-handle);bottom:0;right:0;cursor:ns-resize}:host([resizable]) #resize-handle{display:block}#resize-icon{display:block;pointer-events:none;fill:var(--sinch-comp-textarea-color-default-border-initial)}</style><div id="wrapper"><textarea id="input"></textarea><div id="border"></div><div id="bottom"><slot name="bottom"></slot><div id="resize-handle"><svg id="resize-icon" width="16" height="16"><path d="m14.833 4.724-9.61 9.61-.942-.944 9.61-9.609.942.943ZM15.443 10 10.5 14.943 9.557 14 14.5 9.057l.943.943Z"/></svg></div></div></div>';
 const template = document.createElement('template');
@@ -15,12 +16,15 @@ defineCustomElement('sinch-textarea', class extends NectaryElement {
   #prevContentHeight = 0;
   #dragStartY = 0;
   #intersectionObserver = null;
+  #internals;
+  static formAssociated = true;
   constructor() {
     super();
     const shadowRoot = this.attachShadow({
       delegatesFocus: true
     });
     shadowRoot.appendChild(template.content.cloneNode(true));
+    this.#internals = this.attachInternals();
     this.#$input = shadowRoot.querySelector('#input');
     this.#$bottomSlot = shadowRoot.querySelector('slot[name="bottom"]');
     this.#$bottomWrapper = shadowRoot.querySelector('#bottom');
@@ -34,7 +38,9 @@ defineCustomElement('sinch-textarea', class extends NectaryElement {
       signal: this.#controller.signal
     };
     this.setAttribute('role', 'textbox');
+    this.#internals.role = 'textbox';
     this.ariaMultiLine = 'true';
+    this.#internals.ariaMultiLine = 'true';
     this.#$input.addEventListener('input', this.#onInput, options);
     this.#$input.addEventListener('compositionstart', this.#onCompositionStart, options);
     this.#$input.addEventListener('mousedown', this.#onSelectionChange, options);
@@ -60,6 +66,23 @@ defineCustomElement('sinch-textarea', class extends NectaryElement {
       this.#intersectionObserver = null;
     }
   }
+  formAssociatedCallback() {
+    setFormValue(this.#internals, this.#$input.value);
+  }
+  formResetCallback() {
+    this.#$input.value = '';
+    setFormValue(this.#internals, '');
+  }
+  formStateRestoreCallback(state) {
+    if (this.#internals.form === null || getBooleanAttribute(this.#internals.form, 'data-form-state-restore') === false) {
+      return;
+    }
+    if (state !== null) {
+      const value = typeof state === 'string' ? state : state.get(this.name);
+      this.#$input.value = value?.toString() ?? '';
+      setFormValue(this.#internals, value?.toString() ?? '');
+    }
+  }
   static get observedAttributes() {
     return ['value', 'placeholder', 'invalid', 'disabled', 'rows', 'minrows', 'resizable'];
   }
@@ -74,6 +97,7 @@ defineCustomElement('sinch-textarea', class extends NectaryElement {
             const isPrevCursorEnd = prevCursorPos === prevVal.length;
             const isShrinkingContent = nextVal.length < prevVal.length;
             this.#$input.value = nextVal;
+            setFormValue(this.#internals, nextVal);
             if (!this.resizable) {
               if (isShrinkingContent) {
                 this.#$input.style.removeProperty('height');
@@ -94,6 +118,7 @@ defineCustomElement('sinch-textarea', class extends NectaryElement {
         {
           this.#$input.placeholder = newVal ?? '';
           updateAttribute(this, 'aria-placeholder', newVal);
+          this.#internals.ariaPlaceholder = newVal ?? '';
           break;
         }
       case 'invalid':
@@ -103,6 +128,7 @@ defineCustomElement('sinch-textarea', class extends NectaryElement {
           }
           const isInvalid = isAttrTrue(newVal);
           this.ariaInvalid = isInvalid.toString();
+          this.#internals.ariaInvalid = isInvalid.toString();
           updateBooleanAttribute(this, 'invalid', isInvalid);
           break;
         }
@@ -140,6 +166,12 @@ defineCustomElement('sinch-textarea', class extends NectaryElement {
         }
     }
   }
+  set name(value) {
+    updateAttribute(this, 'name', value);
+  }
+  get name() {
+    return getAttribute(this, 'name', '');
+  }
   set value(value) {
     updateAttribute(this, 'value', value);
   }
@@ -250,6 +282,7 @@ defineCustomElement('sinch-textarea', class extends NectaryElement {
     e.stopPropagation();
     const nextValue = this.#$input.value;
     const prevValue = this.value;
+    setFormValue(this.#internals, nextValue);
     if (prevValue !== nextValue) {
       const nextCursorPos = this.#$input.selectionEnd;
       if (!this.#isPendingDk) {

package/textarea/types.d.ts

@@ -1,5 +1,7 @@
 import type { NectaryComponentReactByType, NectaryComponentVanillaByType } from '../types';
 export type TSinchTextareaProps = {
+    /** Identification for uncontrolled form submissions */
+    name?: string;
     /** Value */
     value: string;
     /** Text that appears in the text field when it has no value set */

package/utils/form.d.ts

@@ -0,0 +1,8 @@
+import type { NectaryComponentVanilla } from '../types';
+export declare const setFormValue: (internals: ElementInternals, value: File | string | FormData | null) => void;
+/**
+ *  The ElementInternals API currently does not support web components as form submitters,
+ *  so we need to create a native button and copy form-related options to it.
+ */
+export declare const requestSubmitForm: (form: HTMLFormElement, submitter: NectaryComponentVanilla<"sinch-button">) => void;
+export declare const CSVToFormData: (name: string, csv: string) => "" | FormData;

package/utils/form.js

@@ -0,0 +1,36 @@
+export const setFormValue = (internals, value) => {
+  let formValue = value ?? '';
+  if (formValue instanceof FormData && [...formValue.keys()].length === 0) {
+    formValue = '';
+  }
+  if (formValue instanceof File && formValue.size === 0) {
+    formValue = '';
+  }
+  if (internals.form !== null) {
+    internals.setFormValue(formValue);
+  }
+};
+export const requestSubmitForm = (form, submitter) => {
+  const submitterProxy = document.createElement('button');
+  submitterProxy.style.display = 'none';
+  submitterProxy.type = submitter.formType;
+  Array.from(submitter.attributes).filter(attr => attr.name.startsWith('aria-')).forEach(attr => {
+    submitterProxy.setAttribute(attr.name, attr.value);
+  });
+  form.appendChild(submitterProxy);
+  try {
+    form.requestSubmit(submitterProxy);
+  } finally {
+    form.removeChild(submitterProxy);
+  }
+};
+export const CSVToFormData = (name, csv) => {
+  if (csv.length === 0) {
+    return '';
+  }
+  const formData = new FormData();
+  csv.split(',').forEach(value => {
+    formData.append(name, value);
+  });
+  return formData;
+};