Element

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

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

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

Свойства

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

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

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

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

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

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

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

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

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

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

Методы

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

EventTarget.addEventListener()
Регистрирует обработчик событий для определённого типа событий в элементе.
Element.closest() Это экспериментальное API, которое не должно использоваться в рабочем коде.
Возвращает Element, потомка этого элемента (или сам этот элемент), который является ближайшим предком элементов, выбранных селекторами, указанными в параметре.
Element.createShadowRoot() Это экспериментальное API, которое не должно использоваться в рабочем коде.
EventTarget.dispatchEvent()
Отправляет событие для этого узла в DOM и возвращает Boolean, который указывает, что по крайней мере один обработчик не отменил его.
Element.find() Это экспериментальное API, которое не должно использоваться в рабочем коде.
...
Element.findAll() Это экспериментальное API, которое не должно использоваться в рабочем коде.
...
Animatable.getAnimationPlayers() Это экспериментальное API, которое не должно использоваться в рабочем коде.
Element.getAttribute()
Извлекает значение именованного атрибута из текущего узла и возвращает его в видеObject.
Element.getAttributeNS() (en-US)
Извлекает значение атрибута с указанным именем и пространством имён из текущего узла и возвращает его как Object.
Element.getAttributeNode() (en-US) Этот API вышел из употребления и его работа больше не гарантируется.
Извлекает представление узла именованного атрибута из текущего узла и возвращает его в виде Attr.
Element.getAttributeNodeNS() (en-US) Этот API вышел из употребления и его работа больше не гарантируется.
Извлекает представление узла атрибута с указанным именем и пространством имён из текущего узла и возвращает его в виде Attr.
Element.getBoundingClientRect() Это экспериментальное API, которое не должно использоваться в рабочем коде.
...
Element.getClientRects() (en-US) Это экспериментальное API, которое не должно использоваться в рабочем коде. TYPE of returnvalue????
Returns a collection of rectangles that indicate the bounding rectangles for each line of text in a client.
Element.getDestinationInsertionPoints() Это экспериментальное API, которое не должно использоваться в рабочем коде.
Element.getElementsByClassName()
Возвращает коллекцию HTMLCollection, которая содержит все элементы, у которых название класса совпадает с тем, что заданно в параметрах функции.
Element.getElementsByTagName()
Возвращает коллекцию HTMLCollection, которая содержит все элементы, у которых название тега совпадает с тем, что заданно в параметрах функции.
Element.getElementsByTagNameNS() (en-US)
Возвращает коллекцию HTMLCollection, которая содержит все элементы, у которых название тега и пространства имён совпадает с тем, что заданно в параметрах функции.
Element.hasAttribute()
Возвращает Boolean, указывающее, имеет элемент определённый атрибут, или нет.
Element.hasAttributeNS() (en-US)
Возвращает Boolean, указывающий, имеет элемент определённый атрибут в определённом пространстве имён, или нет.
Element.insertAdjacentHTML Это экспериментальное API, которое не должно использоваться в рабочем коде.
Анализирует текст как HTML или XML и вставляет полученные узлы в указанную позицию дерева элементов.
Element.matches() Это экспериментальное API, которое не должно использоваться в рабочем коде.
Возвращает Boolean, указывающий, будет ли элемент выбран указанной строкой селектора.
Element.querySelector()
Возвращает первый Node, который соответствует указанной строке селектора элемента.
Element.querySelectorAll
Возвращает список NodeList узлов, которые соответствуют указанной строке селектора элемента.
Element.releasePointerCapture (en-US) Это экспериментальное API, которое не должно использоваться в рабочем коде.
Позволяет понять, имеет ли элемент с указанным ID  захват указателя для указателя
ChildNode.remove()
Удаляет элемент из списка дочерних элементов родительского элемента.
Element.removeAttribute()
Удаляет именованный атрибут из текущего узла.
Element.removeAttributeNS() (en-US)
Удаляет атрибут с указанным именем и пространством имён, из текущего узла.
Element.removeAttributeNode() (en-US) Этот API вышел из употребления и его работа больше не гарантируется.
Удаляет представление узла именованного атрибута из текущего узла.
EventTarget.removeEventListener()
Удаляет обработчик событий из элемента.
Element.requestFullscreen() (en-US) Это экспериментальное API, которое не должно использоваться в рабочем коде.
Асинхронно запрашивает браузер, чтобы сделать элемент полноэкранным.
Element.requestPointerLock() Это экспериментальное API, которое не должно использоваться в рабочем коде.
Позволяет асинхронно запрашивать блокировку указателя для данного элемента.
Element.scrollIntoView() Это экспериментальное API, которое не должно использоваться в рабочем коде.
Прокручивает страницу до тех пор, пока элемент не попадёт в представление.
Element.setAttribute()
Устанавливает значение именованного атрибута из текущей узла.
Element.setAttributeNS() (en-US)
Устанавливает значение атрибута с определённым именем и пространством имён из текущей узла.
Element.setAttributeNode() (en-US) Этот API вышел из употребления и его работа больше не гарантируется.
Задаёт представление узла именованного атрибута из текущего узла.
Element.setAttributeNodeNS() (en-US) Этот API вышел из употребления и его работа больше не гарантируется.
Установите представление узла атрибута с указанным именем и пространством имён из текущего узла.
Element.setCapture() (en-US) Это API не было стандартизировано.
Настройка захвата событий мыши, перенаправление всех событий мыши на этот элемент.
Element.setPointerCapture() (en-US)
Определяет указанный элемент как цель захвата будущих событий указателя.

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

Спецификация Статус Комментарий
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 (en-US).
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' в этой спецификации.
Устаревшая Метод normalize() был перемещён в Node.
Document Object Model (DOM) Level 1 Specification
Определение 'Element' в этой спецификации.
Устаревшая Начальное определение.

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

BCD tables only load in the browser