CKTIS / HTML
HTML koncept: forms
HTML obrasci povezuju kontrole s vlasnikom, provjeravaju ograničenja i grade uređeni skup podataka za slanje; te tri faze imaju različita pravila.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
form owner → constraint validation → entry listKontrola obično pripada najbližem elementu form, ali atribut form može navedenu kontrolu po ID-u povezati i izvan njegova podstabla. Ugniježđeni obrasci nisu sukladni, a popravak parsera može stvoriti drugog vlasnika nego što izvor sugerira.
Ograničenja poput required i min utječu na checkValidity() i interaktivni reportValidity(). Atribut novalidate može pri slanju zaobići interaktivnu provjeru, ali klijentska provjera nikada ne zamjenjuje provjeru i autorizaciju na poslužitelju.
FormData gradi popis stavki iz uspješnih kontrola u redoslijedu stabla. Kontrola bez name, s disabled, neoznačen izbor koji zahtijeva checked ili neuspješan gumb ne dodaje običnu stavku; kodiranje i pošiljatelj mogu dalje promijeniti završni zahtjev.
Primjer povezuje vanjsku kontrolu putem form, opaža neuspješan i uspješan checkValidity() te zatim gradi FormData. Rezultat uključuje vanjsku kontrolu, ali isključuje onemogućeno i neimenovano polje bez mrežnog zahtjeva.
Primjeri
<!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>
Rezultat
owner=order; before=false; after=true; data=sku=A&qty=2&outside=yes; ignored=false
Izvedeni primjer potvrđuje vlasnika, provjeru i popis stavki; ne oponaša aktivaciju gumba, kodiranje zahtjeva ni odgovor poslužitelja.