Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes