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
setFormValue(value)
setFormValue(value, state)
Parameter
value
-
Eine
File
-, eine String- oder eineFormData
-Instanz als zu übermittelnder Wert an den Server. state
Optional-
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
NotSupportedError
DOMException
-
Ausgelöst, wenn das Element seine
formAssociated
-Eigenschaft nicht auftrue
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
Specification |
---|
HTML Standard # dom-elementinternals-setformvalue |
Browser-Kompatibilität
BCD tables only load in the browser