ElementInternals: setFormValue()-Methode

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

Syntax

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.

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.

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

Spezifikationen

Browser-Kompatibilität