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

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

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

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

Свойства

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

Element.assignedSlot Только для чтения
Возвращает HTMLSlotElement интерфейс, связанный с элементом.
Element.attributes Только для чтения
Возвращает NamedNodeMap, в котором перечислены все атрибуты связанные с элементом.
Element.classList Только для чтения
Возвращает DOMTokenList содержащий список атрибутов класса.
ParentNode.childElementCount
Это Number представляющее число дочерних узлов, представленных в элементе.
ParentNode.children
Is a live HTMLCollection, содержащая все дочерние элементы, в виде коллекции.
Element.className
Это DOMString, представляющая класс элемента.
Element.clientHeight Только для чтения
Возвращает Number, представляющее внутреннюю высоту элемента.
Element.clientLeft Только для чтения
Возвращает Number, предсталяющее ширину левой границы элемента.
Element.clientTop Только для чтения
Возвращает Number, представляющее ширину верхней границы элемента.
Element.clientWidth Только для чтения
Возвращает Number, представляющее внутреннюю ширину элемента.
ParentNode.firstElementChild
Возвращает Element, первый дочерний элемент элемента или null, если у элемента нет дочерних элементов.
Element.id
Возвращает DOMString, представляющий идентификатор (Id) элемента.
Element.innerHTML
Является DOMString, представляющей разметку контента элемента.
Element.namespaceURI Только для чтения
The namespace URI of the element, or null if it is no namespace.

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

ParentNode.lastElementChild
Является Element, последним непосредственным дочерним элементом данного элемента, или null, если у элемента нет дочерних элементов.
NonDocumentTypeChildNode.nextElementSibling
Является Element, элементом, непосредственно следующим за данным в древе, или null, если соседний элемент отсутствует.
Element.outerHTML
Является DOMString, представляющей разметку элемента, включая его контент. При использовании в качестве сеттера заменяет элемент узлами, структурированными из указанной строки.
NonDocumentTypeChildNode.previousElementSibling
Является Element, элементом, непосредственно предшествующим в древе данному, или null, если соседний элемент отсутствует.
Element.scrollHeight Только для чтения
Возвращает Number, представляющее высоту прокрутки элемента.
Element.scrollLeft
Является Number, представляющим количество пикселей, на которые контент элемента прокручен влево.
Element.scrollLeftMax Только для чтения
Возвращает Number, представляющее максимально возможное количество пикселей, на которые можно прокрутить контент элемента влево.
Element.scrollTop
Является Number, представляющим количество пикселей, на которые контент элемента прокручен от верха.
Element.scrollTopMax Только для чтения
Вовзращает Number, представляющее максимально возможное количество пикселей, на которые можно прокрутить контент элемента от верха.
Element.scrollWidth Только для чтения
Возвращает Number, представляющее ширину прокрутки элемента.
Element.shadowRoot Только для чтения
...
Element.tagName Только для чтения
Возвращает String с именем тега указанного элемента.
Element.undoManager Только для чтения
Returns the UndoManager associated with the element.
Element.undoScope
Представляет собой Boolean, указывающим, является элемент undo scope host, или нет.

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

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

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

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

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

Element.onwheel
Возвращает код обработчика для события wheel.
Сейчас реализован в GlobalEventHandlers.

Методы

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

EventTarget.addEventListener()
Регистрирует обработчик событий для опрделенного типа событий в элементе.
Element.closest()
Возращает Element, потомка этого элемента (или сам этот элемент), который является ближайшим предком элементов, выбраных селекторами, укащанными в параметре.
Element.createShadowRoot()
EventTarget.dispatchEvent()
Dispatches an event to this node in the DOM and returns a Boolean that indicates that at least one handler has not canceled it.
Element.find()
...
Element.findAll()
...
Animatable.getAnimationPlayers()
Element.getAttribute()
Retrieves the value of the named attribute from the current node and returns it as an Object.
Element.getAttributeNS()
Retrieves the value of the attribute with the specified name and namespace, from the current node and returns it as an Object.
Element.getAttributeNode()
Retrievse the node representation of the named attribute from the current node and returns it as an Attr.
Element.getAttributeNodeNS()
Retrieves the node representation of the attribute with the specified name and namespace, from the current node and returns it as an Attr.
Element.getBoundingClientRect()
...
Element.getClientRects() 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()
Returns a live HTMLCollection that contains all descendant of the current element that posses the list of classes given in parameter.
Element.getElementsByTagName()
Returns a live HTMLCollection containing all descendant elements, of a particular tag name, from the current element.
Element.getElementsByTagNameNS()
Returns a live HTMLCollection containing all descendant elements, of a particular tag name and namespace, from the current element.
Element.hasAttribute()
Вовзращает Boolean, указывающее, имеет элемент определенный атрибут, или нет.
Element.hasAttributeNS()
Возвращает Boolean, указывающий, имеет элемент определенный атрибут в определенном пространстве имен, или нет.
Element.insertAdjacentHTML
Parses the text as HTML or XML and inserts the resulting nodes into the tree in the position given.
Element.matches()
Returns a Boolean indicating whether or not the element would be selected by the specified selector string.
Element.querySelector()
Returns Node...
Element.querySelectorAll
Returns a NodeList...
Element.releasePointerCapture
ChildNode.remove()
Удаляет элемент из списка дочерних элементов родительского элемента.
Element.removeAttribute()
Удаляет именованный атрибут из текущего узла.
Element.removeAttributeNS()
Removes the attribute with the specified name and namespace, from the current node.
Element.removeAttributeNode()
Removes the node representation of the named attribute from the current node.
EventTarget.removeEventListener()
Removes an event listener from the element.
Element.requestFullscreen()
Asynchronously asks the browser to make the element full-screen.
Element.requestPointerLock()
Allows to asynchronously ask for the pointer to be locked on the given element.
Element.scrollIntoView()
Scrolls the page until the element gets into the view.
Element.setAttribute()
Устанавливает значение именованного атрибута из текущей узла.
Element.setAttributeNS()
Устанавливает значение атрибута с опрделенным именем и пространством имен из текущей узла.
Element.setAttributeNode()
Sets the node representation of the named attribute from the current node.
Element.setAttributeNodeNS()
Setw the node representation of the attribute with the specified name and namespace, from the current node.
Element.setCapture()
Sets up mouse event capture, redirecting all mouse events to this element.
Element.setPointerCapture()

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

Спецификация Статус Комментарий
Web Animations Рабочий черновик Добавлен метод getAnimationPlayers().
UndoManager and DOMTransaction
Определение 'Element' в этой спецификации.
Редакторский черновик Добавлены свойства undoScope и undoManager.
Pointer Events
Определение 'Element' в этой спецификации.
Рекомендация Добавлены следующие обработчики событий: ongotpointercapture и onlostpointercapture.
Добавлены следующие методы: setPointerCapture() и releasePointerCapture().
Selectors API Level 2
Определение 'Element' в этой спецификации.
Устаревшая Добавлены следующие методы: matches() (реализовано как mozMatchesSelector()), find(), findAll().
Selectors API Level 1
Определение 'Element' в этой спецификации.
Устаревшая Добавлены следующиен методы: querySelector() и querySelectorAll().
Pointer Lock
Определение 'Element' в этой спецификации.
Кандидат в рекомендации Добавлен метод requestPointerLock().
Fullscreen API
Определение 'Element' в этой спецификации.
Живой стандарт Добавлен метод requestFullscreen().
DOM Parsing and Serialization
Определение 'Element' в этой спецификации.
Рабочий черновик Добавлены следующие свойства: innerHTML, и outerHTML.
Добавлен следующий метод: insertAdjacentHTML().
CSS Object Model (CSSOM) View Module
Определение 'Element' в этой спецификации.
Рабочий черновик Добавлены следующие свойства: scrollTop, scrollLeft, scrollWidth, scrollHeight, clientTop, clientLeft, clientWidth, и clientHeight.
Добавлены следующие методы: getClientRects(), getBoundingClientRect(), и scrollIntoView().
Element Traversal Specification
Определение 'Element' в этой спецификации.
Устаревшая Добавлено наследование интерфейса ElementTraversal.
DOM
Определение 'Element' в этой спецификации.
Живой стандарт Удалены следующие методы: closest(), setIdAttribute(), setIdAttributeNS(), и setIdAttributeNode().
Удалено свойство schemaTypeInfo.
Измененно возращаемое значение getElementsByTag() и getElementsByTagNS().
Moved hasAttributes() form the Node interface to this one.
Document Object Model (DOM) Level 3 Core Specification
Определение 'Element' в этой спецификации.
Устаревшая Added the following methods: setIdAttribute(), setIdAttributeNS(), and setIdAttributeNode(). These methods were never implemented and have been removed in later specifications.
Added the schemaTypeInfo property. This property was never implemented and has been removed in later specifications.
Document Object Model (DOM) Level 2 Core Specification
Определение 'Element' в этой спецификации.
Устаревшая The normalize() method has been moved to Node.
Document Object Model (DOM) Level 1 Specification
Определение 'Element' в этой спецификации.
Устаревшая Начальное определение.

Поддержка браузерами

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!
Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 1.0 1.0 (1.7 или ранее) (Да) (Да) 1.0
children (Да) 3.0 (1.9) 7.0 with a significant bug [1]
9.0 according to the spec
(Да) Нет
childElementCount, nextElementSibling, previousElementSibling (Да) 3.5 (1.9.1) 9.0 (Да) (Да)
firstElementChild, lastElementChild (Да) 3.0 (1.9) 9.0 (Да) (Да)
classList (Да) 3.6 (1.9.2)   (Да) (Да)
outerHTML (Да) 11 (11) (Да) (Да) (Да)
clientLeft, clientTop (Да) 3.5 (1.9.1) (Да) (Да) (Да)
getBoundingClientRect(), getClientRects() (Да) 3.0 (1.9) (Да) (Да) (Да)
querySelector(), querySelectorAll() 1.0 3.5 (1.9.1) 8.0 10.0 3.2 (525.3)
insertAdjacentHTML() 1.0 8 (8) 4.0 7.0 4.0 (527)
setCapture() Нет 4.0 (2) Нет Нет Нет
oncopy, oncut, onpaste Нет 3.0 (1.9) (Да)   Нет
onwheel Нет 17 (17) Нет Нет Нет
ongotpointercapture, onlostpointercapture, setPointerCapture(), and releasePointerCapture() Нет Нет 10.0 MS Нет Нет
matches() (Да) with the non-standard name webkitMatchesSelector 3.6 (1.9.2) with the non-standard name mozMatchesSelector
34 (34) with the standard name
9.0 with the non-standard name msMatchesSelector 11.5 with the non-standard name oMatchesSelector
15.0 with the non-standard name webkitMatchesSelector
5.0 with the non-standard name webkitMatchesSelector
find() and findAll() Нет Нет Нет Нет Нет
requestPointerLock() 16.0 webkit, behind an about:flags
22.0 webkit (with special cases, progressively lifted see [2])
14 (14)moz Нет Нет Нет
requestFullscreen() 14.0 webkit 10 (10) moz 11.0 ms 12.10
15.0 webkit
5.1 webkit
undoManager and undoScope Нет (Да) (behind the dom.undo_manager.enabled pref) Нет Нет Нет
attributes ? 22 (22)
Before this it was available via the Node interface that any element inherits.
? ? ?
scrollTopMax() and scrollLeftMax() Нет 16 (16) Нет Нет Нет
closest() ? 35 (35) ? ? ?
hasAttributes() (Да) 1.0 (1.7 или ранее) (on the Node interface)
35 (35) (on this interface
(Да) (Да) (Да)
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support 1.0 1.0 (1) (Да) (Да) 1.0
scrollTopMax() and scrollLeftMax() Нет 16.0 (16) Нет Нет Нет
closest() ? 35.0 (35) ? ? ?
hasAttributes() (Да) 1.0 (1.0) (on the Node interface)
35.0 (35) (on this interface
(Да) (Да) (Да)

[1] Internet Explorer 7 и 8 неправильно возвращают комментарии как часть дочерних элементов элемента. Это исправлено в Internet Explorer 9 и более поздних версиях.

[2] Chrome 16 допускал webkitRequestPointerLock() только в полноэкранном режиме; Chrome 21 для доверенного веб-сайта (запрашивается разрешение); Chrome 22 разрешил это по умолчанию для всех документов того же происхождения; Chrome 23 разрешил это в изолированной среде <iframe> если для нестандартного значения if the non-standard webkit-allow-pointer-lock установлен атрибут sandbox.

Метки документа и участники

Метки: 
Внесли вклад в эту страницу: Akh-rman, mdnwebdocs-bot, fscholz, jarcko, Oaphi, coderoma, TemmyR, vladlipski, SedovDP, feedlike, ugg555, khalid32, datasheet
Обновлялась последний раз: Akh-rman,