Document.forms

Этот перевод не завершён. Пожалуйста, помогите перевести эту статью с английского

forms возвращает коллекцию (HTMLCollection) форм в текущем документе

На заметку: Точно также Вы можете получить список элементов выбранной формы, используя свойство HTMLFormElement.elements.

Синтаксис

collection = document.forms;

Значение

Объект HTMLCollection содержит все формы, имеющиеся на странице. Каждый элемент этой коллекции - это HTMLFormElement, представленный отдельным тегом <form>.

Если на странице форм нет, тогда возвращённый результат будет пустым, а длина коллекции равна нулю.

Примеры

Получение информации с формы

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

Получение элемента формы

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

Обращение к форме по её имени

<!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>
  var loginForm = document.forms.login; // Or document.forms['login']
  loginForm.elements.email.placeholder = 'test@example.com';
  loginForm.elements.password.placeholder = 'password';
</script>
</body>
</html>

Спецификации

Спецификация Статус Комментарий
HTML Living Standard
Определение 'Document.forms' в этой спецификации.
Живой стандарт
Document Object Model (DOM) Level 2 HTML Specification
Определение 'Document.forms' в этой спецификации.
Устаревшая Начальное определение

Браузерная поддержка

Update compatibility data on GitHub
КомпьютерыМобильные
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome для AndroidFirefox для AndroidOpera для AndroidSafari on iOSSamsung Internet
formsChrome Полная поддержка 1Edge Полная поддержка 12Firefox Полная поддержка 1IE Полная поддержка 4Opera Полная поддержка ≤12.1Safari Полная поддержка 1WebView Android Полная поддержка 1Chrome Android Полная поддержка 18Firefox Android Полная поддержка 4Opera Android Полная поддержка ≤12.1Safari iOS Полная поддержка 1Samsung Internet Android Полная поддержка 1.0

Легенда

Полная поддержка  
Полная поддержка

Смотрите также