База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

HTMLButtonElement.form — формулярът, свързан с бутон

Свойството HTMLButtonElement.form само за четене връща HTMLFormElement, свързан с даден бутон, или null. То указва действителния формуляр, а не текстовата стойност на атрибута form.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

button.form

HTMLButtonElement.form, прочетено като button.form, връща формуляра-собственик на бутона: обект HTMLFormElement или null, когато няма такава връзка. Проверете дали стойността е null, преди да достъпите свойствата на формуляра.

По подразбиране бутонът принадлежи към най-близкия си родителски формуляр. Атрибутът form може да посочи id на формуляр в същия документ, дори извън тази йерархия, и да замени връзката по подразбиране. button.getAttribute("form") прочита текста на атрибута, а не обекта на формуляра.

Свойството е само за четене: не присвоявайте стойност на button.form. Вместо това променете атрибута form или DOM позицията на бутона. Примерът показва свързването и премахването му. Това е API на браузъра, дефинирано от HTML, а не функция на езика ECMAScript; MDN го отбелязва като широко достъпно от юли 2015 г.

Примери

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

Резултат

true
true
profile
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници