Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

pojęcie HTML: forms

Formularze HTML łączą kontrolki z właścicielem, walidują ograniczenia i budują uporządkowany zestaw danych do wysłania; te trzy etapy mają odrębne reguły.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

form owner → constraint validation → entry list

Kontrolka jest zwykle własnością najbliższego elementu form, lecz atrybut form może powiązać wymienioną kontrolkę z formularzem o podanym identyfikatorze nawet poza jego poddrzewem. Zagnieżdżanie formularzy jest niezgodne, a naprawa parsera może dać innego właściciela niż sugeruje tekst źródłowy.

Ograniczenia takie jak required i min wpływają na checkValidity() oraz interaktywne reportValidity(). Atrybut novalidate może ominąć interaktywną walidację przy wysyłaniu, lecz walidacja klienta nigdy nie zastępuje sprawdzenia i autoryzacji na serwerze.

FormData konstruuje listę wpisów z udanych kontrolek w kolejności drzewa. Kontrolka bez name, z disabled, niezaznaczony wybór wymagający checked albo nieskuteczny przycisk nie wnosi zwykłego wpisu; sposób kodowania i przycisk wysyłający mogą dalej zmienić końcowe żądanie.

Przykład wiąże kontrolkę zewnętrzną przez form, obserwuje niepowodzenie i sukces checkValidity(), a następnie tworzy FormData. Wynik zawiera kontrolkę zewnętrzną, lecz pomija pole wyłączone i pole bez nazwy, bez wykonywania żądania sieciowego.

Przykłady

<!doctype html>
<meta charset="utf-8">
<form id="order">
  <input name="sku" value="A" required>
  <input id="qty" name="qty" type="number" min="1" value="0">
  <input name="ignored" value="x" disabled>
  <input value="no-name">
</form>
<input id="outside" form="order" name="outside" value="yes">
<output id="result"></output>
<script>
const order = document.querySelector("#order");
const qty = document.querySelector("#qty");
const outside = document.querySelector("#outside");
const before = order.checkValidity();
qty.value = "2";
const after = order.checkValidity();
const data = new URLSearchParams(new FormData(order)).toString();
result.textContent = `owner=${outside.form.id}; before=${before}; after=${after}; data=${data}; ignored=${new FormData(order).has("ignored")}`;
</script>

Wynik

owner=order; before=false; after=true; data=sku=A&qty=2&outside=yes; ignored=false

Wykonany przykład potwierdza właściciela, walidację i listę wpisów; nie symuluje aktywacji przycisku, kodowania żądania ani odpowiedzi serwera.

Źródła