Document: forms-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die schreibgeschützte forms-Eigenschaft des Document-Interfaces gibt eine HTMLCollection zurück, die alle im Dokument enthaltenen <form>-Elemente auflistet.

Hinweis: Ähnlich können Sie auf eine Liste der Benutzerkomponenten-Eingabeelemente eines Formulars mithilfe der HTMLFormElement.elements-Eigenschaft zugreifen.

Wert

Ein HTMLCollection-Objekt, das alle Formulare des Dokuments auflistet. Jedes Element in der Sammlung ist ein HTMLFormElement, das ein einzelnes <form>-Element darstellt.

Wenn das Dokument keine Formulare enthält, ist die zurückgegebene Sammlung leer und hat eine Länge von null.

Beispiele

Formularinformationen abrufen

html
<!doctype html>
<html lang="en">
  <head>
    <title>document.forms example</title>
  </head>

  <body>
    <form id="robby">
      <input
        type="button"
        onclick="alert(document.forms[0].id);"
        value="robby's form" />
    </form>

    <form id="dave">
      <input
        type="button"
        onclick="alert(document.forms[1].id);"
        value="dave's form" />
    </form>

    <form id="paul">
      <input
        type="button"
        onclick="alert(document.forms[2].id);"
        value="paul's form" />
    </form>
  </body>
</html>

Ein Element innerhalb eines Formulars abrufen

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

Zugriff auf benannte Formulare

html
<!doctype html>
<html lang="en">
  <head>
    <title>document.forms example</title>
  </head>

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

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

Spezifikationen

Specification
HTML Standard
# dom-document-forms-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch