Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła