CKTIS / HTML
koncept HTML: forms
Formuláře HTML spojují ovládací prvky s vlastníkem, ověřují omezení a sestavují uspořádanou sadu dat k odeslání; tyto tři fáze mají odlišná pravidla.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
form owner → constraint validation → entry listOvládací prvek obvykle vlastní nejbližší prvek form, atribut form však může uvedený prvek propojit podle ID i mimo jeho podstrom. Vnořené formuláře nejsou v souladu a oprava parseru může vytvořit jiného vlastníka, než naznačuje zdroj.
Omezení jako required a min ovlivňují checkValidity() a interaktivní reportValidity(). Atribut novalidate může při odeslání obejít interaktivní ověření, klientské ověření však nikdy nenahrazuje ověření a autorizaci na serveru.
FormData sestavuje seznam položek z úspěšných ovladačů v pořadí stromu. Ovladač bez name, s disabled, nezaškrtnutá volba vyžadující checked nebo neúspěšné tlačítko nepřidá běžnou položku; kódování a odesílatel mohou konečný požadavek dále změnit.
Příklad propojí externí ovladač přes form, pozoruje neúspěšné a úspěšné checkValidity() a pak vytvoří FormData. Výsledek zahrne externí ovladač, ale vynechá zakázané a nepojmenované pole bez síťového požadavku.
Příklady
<!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>
Výsledek
owner=order; before=false; after=true; data=sku=A&qty=2&outside=yes; ignored=false
Spuštěný příklad potvrzuje vlastníka, ověření a seznam položek; nesimuluje aktivaci tlačítka, kódování požadavku ani odpověď serveru.