Skip to content

Commit

Permalink
[ru] update Web/API/HTMLFormElement/elements translation (#17473)
Browse files Browse the repository at this point in the history
[ru] update 'Web/API/HTMLFormElement/elements' translation
  • Loading branch information
leon-win authored Dec 14, 2023
1 parent e3e7277 commit d030c8b
Showing 1 changed file with 51 additions and 35 deletions.
86 changes: 51 additions & 35 deletions files/ru/web/api/htmlformelement/elements/index.md
Original file line number Diff line number Diff line change
@@ -1,84 +1,100 @@
---
title: HTMLFormElement.elements
title: "HTMLFormElement: свойство elements"
slug: Web/API/HTMLFormElement/elements
l10n:
sourceCommit: a3d9f61a8990ba7b53bda9748d1f26a9e9810b18
---

{{APIRef("HTML DOM")}}

The {{domxref("HTMLFormElement")}} property **`elements`** returns an {{domxref("HTMLFormControlsCollection")}} listing all the form controls contained in the {{HTMLElement("form")}} element. Independently, you can obtain just the number of form controls using the {{domxref("HTMLFormElement.length", "length")}} property.
Свойство **`elements`** интерфейса {{domxref("HTMLFormElement")}} возвращает список {{domxref("HTMLFormControlsCollection")}}, содержащий все элементы управления {{HTMLElement("form")}}.

You can access a particular form control in the returned collection by using either an index or the element's {{domxref("Element.name", "name")}} or {{domxref("Element.id", "id")}}.
Для получения только количества элементов управления формы можно использовать свойство {{domxref("HTMLFormElement.length")}}.

Prior to HTML 5, the returned object was an {{domxref("HTMLCollection")}}, on which `HTMLFormControlsCollection` is based.
Для получения доступа к определенному элементу управления в возвращаемой коллекции используйте индекс или атрибуты `name` и `id`.

> **Примечание:** Similarly, you can get a list of all of the forms contained within a given document using the document's {{domxref("Document.forms", "forms")}} property.
До HTML 5 возвращаемым объектом был {{domxref("HTMLCollection")}}, на котором основан `HTMLFormControlsCollection`.

## Syntax
> **Примечание:** Аналогичным образом можно получить список всех форм, содержащихся в документе, используя свойство документа {{domxref("Document.forms", "forms")}}.
```
nodeList = HTMLFormElement.elements
```
## Значение

### Value
{{domxref("HTMLFormControlsCollection")}}, которое содержит все элементы управления, не являющиеся изображениями.
Это «живой» список, если у формы добавляются или удаляются элементы, то список обновляется.

An {{domxref("HTMLFormControlsCollection")}} containing all non-image controls in the form. This is a live collection; if form controls are added to or removed from the form, this collection will update to reflect the change.
Элементы управления в возвращаемом списке расположены в порядке, в котором они появляются в форме, после предварительного порядка обхода дерева в глубину. Это называется **порядок дерева**.

The form controls in the returned collection are in the same order in which they appear in the form by following a preorder, depth-first traversal of the tree. This is called **tree order**.
Возвращаются только следующе элементы:

{{page("/en-US/docs/Web/API/HTMLFormElement", "Elements that are considered form controls")}}
- {{HTMLElement("button")}}
- {{HTMLElement("fieldset")}}
- {{HTMLElement("input")}} (за исключением элементов, у которых атрибут [`type`](/ru/docs/Web/HTML/Element/input#type) равен `"image"`, по историческим причинам)
- {{HTMLElement("object")}}
- {{HTMLElement("output")}}
- {{HTMLElement("select")}}
- {{HTMLElement("textarea")}}

## Example
## Примеры

### Quick syntax example
### Простой пример синтаксиса

In this example, we see how to obtain the list of form controls as well as how to access its members by index and by name or ID.
В этом примере мы получаем список элементов управления формы, а также доступ к его членам по индексу, имени или идентификатору.

```html
<form id="my-form">
<input type="text" name="username" />
<input type="text" name="full-name" />
<input type="password" name="password" />
<label>
Username:
<input type="text" name="username" />
</label>
<label>
Full name:
<input type="text" name="full-name" />
</label>
<label>
Password:
<input type="password" name="password" />
</label>
</form>
```

```js
var inputs = document.getElementById("my-form").elements;
var inputByIndex = inputs[0];
var inputByName = inputs["username"];
const inputs = document.getElementById("my-form").elements;
const inputByIndex = inputs[0];
const inputByName = inputs["username"];
```

### Accessing form controls
### Доступ к элементам управления

This example gets the form's element list, then iterates over the list, looking for {{HTMLElement("input")}} elements of type [`"text"`](/ru/docs/Web/HTML/Element/input/text) so that some form of processing can be performed on them.
В этом примере мы получаем список элементов формы, а затем выполняем поиск элементов {{HTMLElement("input")}} c типом {{HTMLElement("input/text")}}, чтобы обработать их.

```js
var inputs = document.getElementById("my-form").elements;
const inputs = document.getElementById("my-form").elements;

// Iterate over the form controls
for (i = 0; i < inputs.length; i++) {
// Получаем элементы формы
for (let i = 0; i < inputs.length; i++) {
if (inputs[i].nodeName === "INPUT" && inputs[i].type === "text") {
// Update text input
// Изменяем значение
inputs[i].value.toLocaleUpperCase();
}
}
```

### Disabling form controls
### Отключение элементов управления

```js
var inputs = document.getElementById("my-form").elements;
const inputs = document.getElementById("my-form").elements;

// Iterate over the form controls
for (i = 0; i < inputs.length; i++) {
// Disable all form controls
// Получаем элементы формы
for (let i = 0; i < inputs.length; i++) {
// Отключаем все элементы формы
inputs[i].setAttribute("disabled", "");
}
```

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

{{Specifications}}

## Browser compatibility
## Совместимость с браузерами

{{Compat}}

0 comments on commit d030c8b

Please sign in to comment.