Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

HTMLButtonElement.form — il modulo associato a un pulsante

La proprietà di sola lettura HTMLButtonElement.form restituisce l’HTMLFormElement associato a un pulsante oppure null. Indica il modulo effettivo, non il valore testuale dell’attributo form.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

button.form

HTMLButtonElement.form, letto come button.form, restituisce il proprietario del modulo del pulsante: un oggetto HTMLFormElement oppure null se non esiste un’associazione. Controlla che il valore non sia null prima di accedere alle proprietà del modulo.

Per impostazione predefinita, un pulsante appartiene al modulo antenato più vicino. L’attributo form può indicare l’id di un modulo nello stesso documento, anche al di fuori di tale gerarchia, e sostituire l’associazione predefinita. button.getAttribute("form") legge il testo dell’attributo, non l’oggetto modulo.

La proprietà è di sola lettura: non assegnare un valore a button.form. Modifica invece l’attributo form o la posizione del pulsante nel DOM. L’esempio mostra l’associazione e la sua rimozione. Questa è un’API del browser definita da HTML, non una funzionalità del linguaggio ECMAScript; MDN la indica come ampiamente disponibile da luglio 2015.

Esempi

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Button form owner</title>
<form id="profile"></form>
<button type="button" id="save">Save</button>
<script>
  const button = document.getElementById("save");
  const form = document.getElementById("profile");

  console.log(button.form === null);
  button.setAttribute("form", "profile");
  console.log(button.form === form);
  console.log(button.getAttribute("form"));
  button.removeAttribute("form");
  console.log(button.form === null);
</script>
</html>

Risultato

true
true
profile
true

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