CKTIS / JavaScript
HTMLButtonElement.form — formularz powiązany z przyciskiem
Właściwość HTMLButtonElement.form tylko do odczytu zwraca obiekt HTMLFormElement powiązany z przyciskiem albo null. Wskazuje faktyczny formularz, a nie tekstową wartość atrybutu form.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
button.formHTMLButtonElement.form odczytywana jako button.form zwraca formularz powiązany z przyciskiem: obiekt HTMLFormElement albo null, jeśli powiązania nie ma. Przed użyciem właściwości formularza sprawdź wynik pod kątem null.
Domyślnie przycisk należy do najbliższego formularza będącego jego przodkiem. Atrybut form może wskazać id formularza w tym samym dokumencie, również poza tą hierarchią, i zastąpić domyślne powiązanie. button.getAttribute("form") odczytuje tekst atrybutu, nie obiekt formularza.
Właściwość jest tylko do odczytu: nie przypisuj do button.form. Zmień atrybut form lub położenie przycisku w DOM. Przykład pokazuje powiązanie i jego usunięcie. To API przeglądarki zdefiniowane w standardzie HTML, nie funkcja samego ECMAScript; MDN oznacza je jako szeroko dostępne od lipca 2015 r.
Przykłady
<!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>Wynik
true true profile true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.