CKTIS / HTML
concetto HTML: forms
I moduli HTML collegano i controlli a un proprietario, convalidano vincoli e costruiscono un insieme ordinato di dati da inviare; le tre fasi hanno regole distinte.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
form owner → constraint validation → entry listUn controllo appartiene normalmente all’elemento form più vicino, ma l’attributo form può associare per ID un controllo elencato anche fuori dal suo sottoalbero. I moduli annidati non sono conformi e la correzione del parser può produrre un proprietario diverso da quello suggerito dal sorgente.
Vincoli come required e min influenzano checkValidity() e l’interattivo reportValidity(). L’attributo novalidate può evitare la convalida interattiva durante l’invio, ma la convalida client non sostituisce mai convalida e autorizzazione sul server.
FormData costruisce un elenco di voci dai controlli riusciti in ordine d’albero. Un controllo senza name, con disabled, una scelta non selezionata che richiede checked o un pulsante non riuscito non aggiunge una voce normale; codifica e mittente possono modificare ulteriormente la richiesta.
L’esempio associa un controllo esterno tramite form, osserva fallimento e successo di checkValidity() e poi costruisce FormData. Il risultato include il controllo esterno ma esclude i campi disabilitato e senza nome, senza richiesta di rete.
Esempi
<!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>
Risultato
owner=order; before=false; after=true; data=sku=A&qty=2&outside=yes; ignored=false
L’esempio eseguito verifica proprietario, convalida ed elenco delle voci; non simula attivazione del pulsante, codifica della richiesta o risposta del server.