ElementInternals: setFormValue()-Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2023 browserübergreifend verfügbar.
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 eineFormData-Instanz als zu übermittelnder Wert an den Server. stateOptional-
Eine
File-, eine String- oder eineFormData-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
NotSupportedErrorDOMException-
Ausgelöst, wenn das Element seine
formAssociated-Eigenschaft nicht auftruegesetzt 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
| Spezifikation |
|---|
| HTML # dom-elementinternals-setformvalue |