CKTIS / HTML
onformdata — obsługa tworzenia danych formularza
Atrybut onformdata definiuje kod obsługi zdarzenia formdata. Pozwala odczytać i zmienić dane formularza po zbudowaniu listy wpisów, zarówno podczas wysyłania formularza, jak i przy wywołaniu new FormData(form).
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<form onformdata="event.formData.set('source', 'demo')">…</form>onformdata to atrybut obsługi zdarzenia formdata. Choć jest dostępny na elementach HTML, jego typowym miejscem użycia jest formularz, na którym powstaje to zdarzenie. Wartością atrybutu jest kod JavaScript, a nie wartość logiczna. Odpowiada mu właściwość JavaScript form.onformdata, do której przypisuje się funkcję; alternatywą jest form.addEventListener('formdata', handler).
Zdarzenie jest wywoływane po zbudowaniu listy wpisów formularza, między innymi podczas wysyłania oraz przez new FormData(form). Obiekt event jest typu FormDataEvent, a event.formData udostępnia zebrane dane jako FormData. Metody set(), append() i delete() pozwalają zmieniać te dane. Przy wysyłaniu zmiany wpływają na wysyłany zestaw danych, ale nie zmieniają wartości kontrolek formularza.
Nie należy mylić formdata ze zdarzeniem submit: samo new FormData(form) nie wysyła formularza. Zdarzenie formdata propaguje się do przodków, lecz nie można go anulować; preventDefault() nie zatrzyma wysyłania. Do anulowania wysyłania służy obsługa submit.
Przykład tworzy dane bez wysyłania formularza. Kod w onformdata dodaje wpis source, zanim konstruktor zwróci wynik. Polityka Content Security Policy może blokować kod obsługi zapisany w atrybutach; w takim środowisku należy użyć addEventListener() w dozwolonym skrypcie.
Przykłady
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onformdata demo</title>
<form id="demo" onformdata="event.formData.set('source', 'demo')">
<input type="hidden" name="topic" value="html">
</form>
<pre id="result"></pre>
<script>
const form = document.getElementById('demo');
const data = new FormData(form);
document.getElementById('result').textContent =
JSON.stringify(Array.from(data.entries()));
</script>
</html>Wynik
[["topic","html"],["source","demo"]]
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.