Element
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Интерфейс 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()
-
Определяет указанный элемент как цель захвата будущих событий указателя.
Спецификации
Совместимость с браузерами
BCD tables only load in the browser