Document: forms property - Web APIs | MDN (original) (raw)

Baseline

Widely available

The forms read-only property of the Document interface returns an HTMLCollection listing all the elements contained in the document.

**Note:**Similarly, you can access a list of a form's component user input elements using the HTMLFormElement.elements property.

Value

An HTMLCollection object listing all of the document's forms. Each item in the collection is a HTMLFormElement representing a single<form> element.

If the document has no forms, the returned collection is empty, with a length of zero.

Examples

Getting form information

<form id="robby">
  <input type="button" value="robby's form" />
</form>

<form id="dave">
  <input type="button" value="dave's form" />
</form>

<form id="paul">
  <input type="button" value="paul's form" />
</form>

document.querySelectorAll("input[type=button]").forEach((button, i) => {
  button.addEventListener("click", (event) => {
    console.log(document.forms[i].id);
  });
});

Getting an element from within a form

const selectForm = document.forms[index];
const selectFormElement = document.forms[index].elements[index];

Named form access

<form name="login">
  <input name="email" type="email" />
  <input name="password" type="password" />
  <button type="submit">Log in</button>
</form>

const loginForm = document.forms.login; // Or document.forms['login']
loginForm.elements.email.placeholder = "test@example.com";
loginForm.elements.password.placeholder = "password";

Specifications

Browser compatibility

See also