CKTIS / HTML
conceito HTML: forms
Os formulários HTML ligam controlos a um proprietário, validam restrições e constroem um conjunto ordenado de dados para envio; as três etapas têm regras distintas.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
form owner → constraint validation → entry listUm controlo pertence normalmente ao elemento form mais próximo, mas o atributo form pode associar por ID um controlo listado mesmo fora da sua subárvore. Formulários aninhados não são conformes e a correção do analisador pode produzir um proprietário diferente do sugerido pelo código.
Restrições como required e min afetam checkValidity() e o interativo reportValidity(). O atributo novalidate pode ignorar a validação interativa no envio, mas a validação cliente nunca substitui validação e autorização no servidor.
FormData constrói uma lista de entradas a partir de controlos bem-sucedidos em ordem da árvore. Um controlo sem name, com disabled, uma opção não marcada que requer checked ou um botão sem sucesso não acrescenta entrada normal; codificação e remetente podem alterar mais o pedido final.
O exemplo associa um controlo externo através de form, observa falha e sucesso de checkValidity() e depois constrói FormData. O resultado inclui o controlo externo, mas exclui os campos desativado e sem nome, sem pedido de rede.
Exemplos
<!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>
Resultado
owner=order; before=false; after=true; data=sku=A&qty=2&outside=yes; ignored=false
O exemplo executado confirma proprietário, validação e lista de entradas; não simula ativação de botão, codificação do pedido ou resposta do servidor.