Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

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

Źródła