ElementInternals: метод setFormValue()

Базовая версия 2023

Новое

С марта 2023 года данная функция работает на последних версиях устройств и браузеров. Возможно, эта функция не будет работать на старых устройствах или браузерах.

Метод setFormValue() интерфейса ElementInternals устанавливает значение и состояние отправки элемента, передавая эти данные пользовательскому агенту.

Синтаксис

setFormValue(value)
setFormValue(value, state)

Параметры

value: Значение, отправляемое на сервер: File, строка или FormData.
state Необязательно: File, строка или FormData, представляющие ввод пользователя. Это позволяет приложению повторно отобразить информацию, отправленную пользователем, в том формате, в котором она была им отправлена, если это необходимо.

Примечание: В общем случае, state используется для передачи информации, указанной пользователем, value — для отправки на сервер после очистки. Например, если пользовательский элемент попросил пользователя отправить дату, пользователь может ввести "3/15/2019". Это будет state. Сервер ожидает формат даты 2019-03-15, в этом формате дата будет передана как value.

Возвращаемое значение

Неопределено.

Исключения

NotSupportedError DOMException: Выбрасывается, если свойство formAssociated элемента не установлено в значение true.

Примеры

В следующем примере пользовательский элемент типа флажка устанавливает on в качестве значения для отправки на сервер и checked в качестве состояния.

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

Спецификации

Спецификация
HTML # dom-elementinternals-setformvalue

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`setFormValue`	77	79	98	64	16.4	77	98	55	16.4	12.0	77

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/setFormValue