Element
=======

Интерфейс **`Element`** представляет собой один из объектов в `Document`. Этот интерфейс описывает методы и свойства, общие для всех видов элементов. Конкретные модели поведения описаны в интерфейсах, которые наследуют от `Element`, и добавляют дополнительную функциональность.

Например, интерфейс `HTMLElement` является базовым интерфейсом для HTML-элементов, в то время как интерфейс `SVGElement` (en-US) является основой для всех SVG-элементов.

Языки, находящиеся вне области веб-платформы, также используют его. Например, `XUL` — через `интерфейс XULElement`.

EventTarget

Node

ElementСвойства
--------

*Наследует свойства от родительского узла `Node` и от собственного родителя `EventTarget` и реализует свойства `ParentNode`, `ChildNode`, `NonDocumentTypeChildNode` (en-US),* and `Animatable`.

`Element.assignedSlot` (en-US) 
Экспериментальная возможность
 Только для чтения 

Возвращает `HTMLSlotElement` интерфейс, связанный с элементом.

`Element.attributes` Только для чтения 

Возвращает `NamedNodeMap`, в котором перечислены все атрибуты связанные с элементом.

`Element.classList` Только для чтения 

Возвращает `DOMTokenList` содержащий список атрибутов класса.

`ParentNode.childElementCount`

Это `Number` представляющее число дочерних узлов, представленных в элементе.

`ParentNode.children` (en-US)

Is a live `HTMLCollection`, содержащая все дочерние элементы, в виде коллекции.

`Element.className`

Это `DOMString`, представляющая класс элемента.

`Element.clientHeight` 
Экспериментальная возможность
 Только для чтения 

Возвращает `Number`, представляющее внутреннюю высоту элемента.

`Element.clientLeft` 
Экспериментальная возможность
 Только для чтения 

Возвращает `Number`, представляющее ширину левой границы элемента.

`Element.clientTop` 
Экспериментальная возможность
 Только для чтения 

Возвращает `Number`, представляющее ширину верхней границы элемента.

`Element.clientWidth` 
Экспериментальная возможность
 Только для чтения 

Возвращает `Number`, представляющее внутреннюю ширину элемента.

`ParentNode.firstElementChild` (en-US)

Возвращает `Element`, первый дочерний элемент элемента или `null`, если у элемента нет дочерних элементов.

`Element.id`

Возвращает `DOMString`, представляющий идентификатор (Id) элемента.

`Element.innerHTML` 
Экспериментальная возможность

Является `DOMString`, представляющей разметку контента элемента.

`Element.namespaceURI` Только для чтения 

Пространство имён URI элемента или null, если это не пространство имён.

**Примечание:** В Firefox версии 3.5 и ранее, HTML-элементы не находятся в пространстве имён. В более поздних версиях, HTML-элементы находятся в пространстве имён `http://www.w3.org/1999/xhtml` как в деревьях HTML, так и XML.

`ParentNode.lastElementChild` (en-US)

Является `Element`, последним непосредственным дочерним элементом данного элемента, или `null`, если у элемента нет дочерних элементов.

`NonDocumentTypeChildNode.nextElementSibling`

Является `Element`, элементом, непосредственно следующим за данным в древе, или `null`, если соседний элемент отсутствует.

`Element.outerHTML` 
Экспериментальная возможность

Является `DOMString`, представляющей разметку элемента, включая его контент. При использовании в качестве сеттера заменяет элемент узлами, структурированными из указанной строки.

`NonDocumentTypeChildNode.previousElementSibling`

Является `Element`, элементом, непосредственно предшествующим в древе данному, или `null`, если соседний элемент отсутствует.

`Element.scrollHeight` 
Экспериментальная возможность
 Только для чтения 

Возвращает `Number`, представляющее высоту прокрутки элемента.

`Element.scrollLeft` 
Экспериментальная возможность

Является `Number`, представляющим количество пикселей, на которые контент элемента прокручен влево.

`Element.scrollLeftMax` (en-US) 
Non-standard
 Только для чтения 

Возвращает `Number`, представляющее максимально возможное количество пикселей, на которые можно прокрутить контент элемента влево.

`Element.scrollTop` 
Экспериментальная возможность

Является `Number`, представляющим количество пикселей, на которые контент элемента прокручен от верха.

`Element.scrollTopMax` (en-US) 
Non-standard
 Только для чтения 

Возвращает `Number`, представляющее максимально возможное количество пикселей, на которые можно прокрутить контент элемента от верха.

`Element.scrollWidth` (en-US) 
Экспериментальная возможность
 Только для чтения 

Возвращает `Number`, представляющее ширину прокрутки элемента.

`Element.shadowRoot` 
Экспериментальная возможность
 Только для чтения 

...

`Element.tagName` Только для чтения 

Возвращает `String` с именем тега указанного элемента.

`Element.undoManager` 
Экспериментальная возможность
 Только для чтения 

Returns the `UndoManager` associated with the element.

`Element.undoScope` 
Экспериментальная возможность

Представляет собой `Boolean`, указывающим, является элемент undo scope host, или нет.


**Примечание:** В DOM3 `namespaceURI`, `localName` и `prefix` определялись в интерфейсе `Node`. В DOM4 они были перенесены в `Element`.

Данное изменение поддерживается в Chrome начиная с версии 46.0 и в Firefox с версии 48.0.

### Обработчики событий

`Element.ongotpointercapture` (en-US)

Возвращает обработчик событий для событий типа `gotpointercapture`.

`Element.onlostpointercapture` (en-US)

Возвращает обработчик событий для событий типа `lostpointercapture`.

#### Устаревшие обработчики событий

`Element.onwheel` (en-US) 
Non-standard

 Возвращает код обработчика для события `wheel`.
 **Сейчас реализован в `GlobalEventHandlers` (en-US).**

Методы
------

*Наследует методы от своих родителей `Node`, и своего собственного родителя `EventTarget`*, и реализует методы `ParentNode`, `ChildNode`*, `NonDocumentTypeChildNode` (en-US),* *и `Animatable`.*

`EventTarget.addEventListener()`

Регистрирует обработчик событий для определённого типа событий в элементе.

`Element.closest()` 
Экспериментальная возможность

Возвращает `Element`, потомка этого элемента (или сам этот элемент), который является ближайшим предком элементов, выбранных селекторами, указанными в параметре.

`Element.createShadowRoot()` 
Экспериментальная возможность

…

`EventTarget.dispatchEvent()`

Отправляет событие для этого узла в DOM и возвращает `Boolean`, который указывает, что по крайней мере один обработчик не отменил его.

`Element.find()`
Экспериментальная возможность

...

`Element.findAll()`
Экспериментальная возможность

...

`Animatable.getAnimationPlayers()` 
Экспериментальная возможность

…

`Element.getAttribute()`

Извлекает значение именованного атрибута из текущего узла и возвращает его в виде`Object`.

`Element.getAttributeNS()` (en-US)

Извлекает значение атрибута с указанным именем и пространством имён из текущего узла и возвращает его как `Object`.

`Element.getAttributeNode()` (en-US)

Извлекает представление узла именованного атрибута из текущего узла и возвращает его в виде `Attr`.

`Element.getAttributeNodeNS()` (en-US)

Извлекает представление узла атрибута с указанным именем и пространством имён из текущего узла и возвращает его в виде `Attr`.

`Element.getBoundingClientRect()` 
Экспериментальная возможность

...

`Element.getClientRects()` (en-US) 
Экспериментальная возможность
 TYPE of returnvalue????

Returns a collection of rectangles that indicate the bounding rectangles for each line of text in a client.

`Element.getDestinationInsertionPoints()` 
Экспериментальная возможность

…

`Element.getElementsByClassName()`

Возвращает коллекцию `HTMLCollection`, которая содержит все элементы, у которых название класса совпадает с тем, что заданно в параметрах функции.

`Element.getElementsByTagName()`

Возвращает коллекцию `HTMLCollection`, которая содержит все элементы, у которых название тега совпадает с тем, что заданно в параметрах функции.

`Element.getElementsByTagNameNS()` (en-US)

Возвращает коллекцию `HTMLCollection`, которая содержит все элементы, у которых название тега и пространства имён совпадает с тем, что заданно в параметрах функции.

`Element.hasAttribute()`

Возвращает `Boolean`, указывающее, имеет элемент определённый атрибут, или нет.

`Element.hasAttributeNS()` (en-US)

Возвращает `Boolean`, указывающий, имеет элемент определённый атрибут в определённом пространстве имён, или нет.

`Element.insertAdjacentHTML` 
Экспериментальная возможность

Анализирует текст как HTML или XML и вставляет полученные узлы в указанную позицию дерева элементов.

`Element.matches()` 
Экспериментальная возможность

Возвращает `Boolean`, указывающий, будет ли элемент выбран указанной строкой селектора.

`Element.querySelector()`

Возвращает первый `Node`, который соответствует указанной строке селектора элемента.

`Element.querySelectorAll`

Возвращает список `NodeList` узлов, которые соответствуют указанной строке селектора элемента.

`Element.releasePointerCapture` (en-US) 
Экспериментальная возможность

Позволяет понять, имеет ли элемент с указанным ID захват указателя для указателя

`ChildNode.remove()` (en-US)

Удаляет элемент из списка дочерних элементов родительского элемента.

`Element.removeAttribute()`

Удаляет именованный атрибут из текущего узла.

`Element.removeAttributeNS()` (en-US)

Удаляет атрибут с указанным именем и пространством имён, из текущего узла.

`Element.removeAttributeNode()` (en-US)

Удаляет представление узла именованного атрибута из текущего узла.

`EventTarget.removeEventListener()`

Удаляет обработчик событий из элемента.

`Element.requestFullscreen()` (en-US) 
Экспериментальная возможность

Асинхронно запрашивает браузер, чтобы сделать элемент полноэкранным.

`Element.requestPointerLock()` 
Экспериментальная возможность

Позволяет асинхронно запрашивать блокировку указателя для данного элемента.


`Element.scrollIntoView()` 
Экспериментальная возможность

Прокручивает страницу до тех пор, пока элемент не попадёт в представление.

`Element.setAttribute()`

Устанавливает значение именованного атрибута из текущей узла.

`Element.setAttributeNS()` (en-US)

Устанавливает значение атрибута с определённым именем и пространством имён из текущей узла.

`Element.setAttributeNode()` (en-US)

Задаёт представление узла именованного атрибута из текущего узла.

`Element.setAttributeNodeNS()` (en-US)

Установите представление узла атрибута с указанным именем и пространством имён из текущего узла.

`Element.setCapture()` (en-US) 
Non-standard

Настройка захвата событий мыши, перенаправление всех событий мыши на этот элемент.

`Element.setPointerCapture()` (en-US)

Определяет указанный элемент как цель захвата будущих событий указателя.

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

| Specification |
| --- |
| DOM Standard # interface-element |
| Pointer Events # extensions-to-the-element-interface |
| Pointer Lock 2.0 # extensions-to-the-element-interface |
| Fullscreen API Standard # api |
| DOM Parsing and Serialization # extensions-to-the-element-interface |
| CSSOM View Module # extension-to-the-element-interface |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.