setFormValue() method of the
ElementInternals interface sets the element's submission value and state, communicating these to the user agent.
ElementInternals.setFormValue(value); ElementInternals.setFormValue(value, state);
File, or a
FormDatarepresenting the input made by the user. This allows the application to re-display the information that the user submitted, in the form that they submitted it, if required.
Note: In general,
state is used to pass information specified by a user, the
value is suitable for submission to a server, post sanitization. For example, if a custom element asked a user to submit a date, the user might enter "3/15/2019". This would be the
state. The server expects a date format of
2019-03-15, the date in this format would be passed as the
Thrown if the element does not have its
formAssociatedproperty set to
In the following example, a checkbox custom element sets
on as the value to send to the server, and
checked as the state.
|HTML Standard (HTML)|
BCD tables only load in the browser