This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

Element

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since июль 2015 г..

* Some parts of this feature may have varying levels of support.

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

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

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

EventTarget Node Element

Свойства

Наследует свойства от родительского узла 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 Только для чтения

Пространство имён 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

Является 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 namespaceURI, localName и 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()

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

Element.find()

...

Element.findAll()

...

Animatable.getAnimationPlayers()

Element.getAttribute()

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

Element.getAttributeNS()

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

Element.getAttributeNode()

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

Element.getAttributeNodeNS()

Извлекает представление узла атрибута с указанным именем и пространством имён из текущего узла и возвращает его в виде 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()

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

Element.getElementsByTagName()

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

Element.getElementsByTagNameNS()

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

Element.hasAttribute()

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

Element.hasAttributeNS()

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

Element.insertAdjacentHTML

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

Element.matches()

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

Element.querySelector()

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

Element.querySelectorAll

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

Element.releasePointerCapture

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

ChildNode.remove()

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

Element.removeAttribute()

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

Element.removeAttributeNS()

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

Element.removeAttributeNode()

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

EventTarget.removeEventListener()

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

Element.requestFullscreen()

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

Element.requestPointerLock()

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

Element.scrollIntoView()

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

Element.setAttribute()

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

Element.setAttributeNS()

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

Element.setAttributeNode()

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

Element.setAttributeNodeNS()

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

Element.setCapture()

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

Element.setPointerCapture()

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

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

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

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