Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

Attributo form — associazione esplicita a un modulo

L’attributo form indica il modulo proprietario di un controllo, anche quando il controllo si trova al di fuori del modulo. Il suo valore è l’id del modulo nello stesso albero, non il suo name né un selettore CSS.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

form="form-id"

L’attributo form="form-id" indica esplicitamente il modulo proprietario di un elemento. Il suo valore deve corrispondere all’id di un elemento form nello stesso albero; non aggiungere #. L’associazione non sposta l’elemento nel DOM e permette di collocare un controllo al di fuori del suo modulo.

L’attributo è supportato da button, fieldset, input, object, output, select, textarea e dagli elementi personalizzati associati ai moduli. Non è un attributo globale. La sola associazione non significa che un elemento contribuisca un valore all’invio del modulo: per esempio, fieldset e output non lo fanno.

Senza questo attributo, il proprietario è normalmente l’elemento form antenato più vicino. Quando si determina di nuovo il modulo proprietario, l’ID indicato nell’attributo viene cercato soltanto se l’elemento è connesso a un documento. In tal caso, se la ricerca non individua un modulo, l’elemento rimane senza proprietario anziché essere associato al modulo antenato. In questo caso un valore vuoto non ripristina l’associazione predefinita: rimuovi l’attributo. In un sottoalbero scollegato dal documento, l’elemento può comunque essere associato all’elemento form antenato più vicino, anche se l’attributo non identifica alcun modulo. Usa ID univoci.

L’attributo non è ereditato: impostare form su un fieldset non assegna automaticamente i suoi controlli al modulo indicato. Gli elementi integrati che supportano questo attributo espongono una proprietà .form, che restituisce il modulo oppure null. Nell’esempio, l’input esterno appartiene a order, compare in order.elements e contribuisce il proprio valore a FormData(order).

Esempi

<!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>

Risultato

true
true
book

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti