CKTIS / HTML
koncept HTML: forms
Obrazci HTML povežejo kontrolnike z lastnikom, preverijo omejitve in zgradijo urejen nabor podatkov za pošiljanje; te tri stopnje imajo ločena pravila.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
form owner → constraint validation → entry listKontrolnik običajno pripada najbližjemu elementu form, atribut form pa lahko navedeni kontrolnik po ID poveže tudi zunaj njegovega poddrevesa. Gnezdeni obrazci niso skladni, popravek razčlenjevalnika pa lahko ustvari drugega lastnika, kot ga nakazuje vir.
Omejitve, kot sta required in min, vplivajo na checkValidity() in interaktivni reportValidity(). Atribut novalidate lahko pri pošiljanju preskoči interaktivno preverjanje, vendar preverjanje odjemalca nikoli ne nadomesti preverjanja in avtorizacije na strežniku.
FormData zgradi seznam vnosov iz uspešnih kontrolnikov v drevesnem vrstnem redu. Kontrolnik brez name, z disabled, neizbrana možnost, ki zahteva checked, ali neuspešen gumb ne prispeva običajnega vnosa; kodiranje in pošiljatelj lahko končno zahtevo še spremenita.
Primer poveže zunanji kontrolnik prek form, opazi neuspešen in uspešen checkValidity() ter nato zgradi FormData. Rezultat vključi zunanji kontrolnik, izključi pa onemogočeno in neimenovano polje brez omrežne zahteve.
Primeri
<!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 primer potrdi lastnika, preverjanje in seznam vnosov; ne simulira aktivacije gumba, kodiranja zahteve ali odgovora strežnika.