ElementInternals: setFormValue()-Methode

Baseline 2023

Newly available

Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die setFormValue()-Methode des ElementInternals-Interfaces setzt den Übermittlungswert und den Zustand des Elements und kommuniziert diese an den Benutzeragenten.

Syntax

js
setFormValue(value)
setFormValue(value, state)

Parameter

value

Eine File-, eine String- oder eine FormData-Instanz als zu übermittelnder Wert an den Server.

state Optional

Eine File-, eine String- oder eine FormData-Instanz, die die Eingabe des Nutzers darstellt. Dies ermöglicht es der Anwendung, die Informationen, die der Nutzer übermittelt hat, in der von ihm übermittelten Form erneut anzuzeigen, falls erforderlich.

Hinweis: Im Allgemeinen wird state verwendet, um Informationen zu übermitteln, die von einem Nutzer angegeben wurden, während value nach der Bereinigung für die Übermittlung an einen Server geeignet ist. Wenn zum Beispiel ein benutzerdefiniertes Element einen Nutzer bitten würde, ein Datum einzugeben, könnte der Nutzer "15.3.2019" eingeben. Dies wäre der state. Der Server erwartet ein Datumsformat von 2019-03-15, das Datum in diesem Format würde als value übergeben.

Rückgabewert

Undefined.

Ausnahmen

NotSupportedError DOMException

Ausgelöst, wenn das Element seine formAssociated-Eigenschaft nicht auf true gesetzt hat.

Beispiele

Im folgenden Beispiel setzt ein benutzerdefiniertes Checkbox-Element on als Wert, der an den Server gesendet wird, und checked als Zustand.

js
this.internals_.setFormValue("on", "checked");

Spezifikationen

Specification
HTML Standard
# dom-elementinternals-setformvalue

Browser-Kompatibilität

BCD tables only load in the browser