Интерфейс 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
Только для чтения- Пространство имён 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()
- Определяет указанный элемент как цель захвата будущих событий указателя.
Спецификации
Спецификация | Статус | Комментарий |
---|---|---|
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' в этой спецификации. |
Устаревшая | Мнтод normalize() был перемещён в Node . |
Document Object Model (DOM) Level 1 Specification Определение 'Element' в этой спецификации. |
Устаревшая | Начальное определение. |
Совместимость с браузерами
BCD tables only load in the browser