ElementInternals: setFormValue()-Methode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since März 2023.
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
| Specification |
|---|
| HTML # dom-elementinternals-setformvalue |
Browser-Kompatibilität
Loading…