CKTIS / HTML
koncept HTML: forms
Formuláre HTML spájajú ovládacie prvky s vlastníkom, overujú obmedzenia a zostavujú usporiadanú množinu dát na odoslanie; tieto tri fázy majú odlišné pravidlá.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
form owner → constraint validation → entry listOvládací prvok zvyčajne vlastní najbližší prvok form, atribút form však môže uvedený prvok prepojiť podľa ID aj mimo jeho podstromu. Vnorené formuláre nie sú v súlade a oprava parsera môže vytvoriť iného vlastníka, než naznačuje zdroj.
Obmedzenia ako required a min ovplyvňujú checkValidity() a interaktívne reportValidity(). Atribút novalidate môže pri odoslaní obísť interaktívne overenie, klientské overenie však nikdy nenahrádza overenie a autorizáciu na serveri.
FormData zostavuje zoznam položiek z úspešných ovládačov v poradí stromu. Ovládač bez name, s disabled, nezaškrtnutá voľba vyžadujúca checked alebo neúspešné tlačidlo nepridá bežnú položku; kódovanie a odosielateľ môžu konečnú požiadavku ďalej zmeniť.
Príklad prepojí externý ovládač cez form, pozoruje neúspešné a úspešné checkValidity() a potom vytvorí FormData. Výsledok zahrnie externý ovládač, ale vynechá zakázané a nepomenované pole bez sieťovej požiadavky.
Prí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ýsledok
owner=order; before=false; after=true; data=sku=A&qty=2&outside=yes; ignored=false
Spustený príklad potvrdzuje vlastníka, overenie a zoznam položiek; nesimuluje aktiváciu tlačidla, kódovanie požiadavky ani odpoveď servera.