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.formHTMLButtonElement.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.