CKTIS / HTML
Atributo form — associação explícita a um formulário
O atributo form identifica o formulário proprietário de um controlo, mesmo quando este se encontra fora do formulário. O valor é o id do formulário na mesma árvore, não o seu name nem um seletor CSS.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
form="form-id"O atributo form="form-id" identifica explicitamente o formulário proprietário de um elemento. O seu valor tem de corresponder ao id de um elemento form na mesma árvore; não acrescentes #. A associação não desloca o elemento no DOM e permite colocar um controlo fora do respetivo formulário.
O atributo é suportado por button, fieldset, input, object, output, select, textarea e elementos personalizados associados a formulários. Não é um atributo global. A associação, por si só, não significa que um elemento forneça um valor quando o formulário é enviado: por exemplo, fieldset e output não o fazem.
Sem este atributo, o proprietário é normalmente o elemento form antepassado mais próximo. Quando se volta a determinar o formulário proprietário, só se procura o ID indicado no atributo se o elemento estiver ligado a um documento. Nesse caso, se a pesquisa não identificar um formulário, o elemento fica sem proprietário, em vez de ser associado ao formulário antepassado. Nesse caso, um valor vazio não repõe a associação predefinida — remove o atributo. Numa subárvore desligada do documento, o elemento pode ainda ser associado ao elemento form antepassado mais próximo, mesmo que o atributo não identifique nenhum formulário. Utiliza IDs únicos.
O atributo não é herdado: definir form num fieldset não associa automaticamente os respetivos controlos ao formulário indicado. Os elementos incorporados que suportam este atributo expõem uma propriedade .form, que devolve o formulário ou null. No exemplo, o input externo pertence a order, aparece em order.elements e fornece o seu valor a FormData(order).
Exemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Explicit form association</title>
<form id="order"></form>
<label>Item <input id="item" name="item" value="book" form="order"></label>
<pre id="result"></pre>
<script>
const order = document.getElementById('order');
const item = document.getElementById('item');
document.getElementById('result').textContent = [
item.form === order,
order.elements.namedItem('item') === item,
new FormData(order).get('item')
].join('\n');
</script>
</html>Resultado
true true book
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.