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.

* 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

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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Element
DOMActivate event
Deprecated
DOMMouseScroll event
DeprecatedNon-standard
MozMousePixelScroll event
DeprecatedNon-standard
after
afterscriptexecute event
Non-standard
animate
Implicit to/from keyframes are supported
options.composite parameter
options.id parameter
options.iterationComposite parameter
Experimental
options.pseudoElement parameter
options.rangeEnd parameter
Experimental
options.rangeStart parameter
Experimental
options.timeline parameter
animationcancel event
animationend event
animationiteration event
animationstart event
append
ariaActiveDescendantElement
Experimental
ariaAtomic
ariaAutoComplete
ariaBrailleLabel
ariaBrailleRoleDescription
ariaBusy
ariaChecked
ariaColCount
ariaColIndex
ariaColIndexText
ariaColSpan
ariaControlsElements
Experimental
ariaCurrent
ariaDescribedByElements
Experimental
ariaDescription
ariaDetailsElements
Experimental
ariaDisabled
ariaErrorMessageElements
Experimental
ariaExpanded
ariaFlowToElements
Experimental
ariaHasPopup
ariaHidden
ariaInvalid
ariaKeyShortcuts
ariaLabel
ariaLabelledByElements
Experimental
ariaLevel
ariaLive
ariaModal
ariaMultiLine
ariaMultiSelectable
ariaOrientation
ariaOwnsElements
Experimental
ariaPlaceholder
ariaPosInSet
ariaPressed
ariaReadOnly
ariaRelevant
Non-standard
ariaRequired
ariaRoleDescription
ariaRowCount
ariaRowIndex
ariaRowIndexText
ariaRowSpan
ariaSelected
ariaSetSize
ariaSort
ariaValueMax
ariaValueMin
ariaValueNow
ariaValueText
assignedSlot
attachShadow
options.clonable parameter
options.delegatesFocus parameter
options.serializable parameter
Experimental
attributes
auxclick event
Is a PointerEvent
Experimental
before
beforeinput event
beforematch event
Experimental
beforescriptexecute event
Non-standard
beforexrselect event
Experimental
blur event
checkVisibility
options.checkOpacity parameter
options.checkVisibilityCSS parameter
options.contentVisibilityAuto parameter
options.opacityProperty parameter
options.visibilityProperty parameter
childElementCount
children
classList
className
click event
Is a PointerEvent
Experimental
clientHeight
clientLeft
clientTop
clientWidth
closest
compositionend event
compositionstart event
compositionupdate event
computedStyleMap
contentvisibilityautostatechange event
contextmenu event
Is a PointerEvent
Experimental
copy event
currentCSSZoom
cut event
dblclick event
elementTiming
Experimental
firstElementChild
focus event
focusin event
focusout event
fullscreenchange event
fullscreenerror event
gesturechange event
Non-standard
gestureend event
Non-standard
gesturestart event
Non-standard
getAnimations
getAttribute
getAttributeNS
getAttributeNames
getAttributeNode
getAttributeNodeNS
getBoundingClientRect
getBoxQuads
Experimental
getClientRects
getElementsByClassName
getElementsByTagName
getElementsByTagName("*")
getElementsByTagNameNS
getElementsByTagNameNS(namespaceURI, "*")
getHTML
gotpointercapture event
hasAttribute
hasAttributeNS
hasAttributes
hasPointerCapture
id
innerHTML
Can be set with a TrustedHTML instance
input event
insertAdjacentElement
insertAdjacentHTML
insertAdjacentText
keydown event
keypress event
Deprecated
keyup event
lastElementChild
localName
lostpointercapture event
matches
mousedown event
mouseenter event
mouseleave event
mousemove event
mouseout event
mouseover event
mouseup event
mousewheel event
DeprecatedNon-standard
moveBefore
Experimental
namespaceURI
nextElementSibling
outerHTML
part
paste event
pointercancel event
pointerdown event
pointerenter event
pointerleave event
pointermove event
pointerout event
pointerover event
pointerrawupdate event
Experimental
pointerup event
prefix
prepend
previousElementSibling
querySelector
querySelectorAll
releasePointerCapture
remove
removeAttribute
removeAttributeNS
removeAttributeNode
replaceChildren
replaceWith
requestFullscreen
options.navigationUI parameter
options.screen parameter
Experimental
Returns a Promise
requestPointerLock
options.unadjustedMovement parameter
ExperimentalNon-standard
role
scroll
options.behavior parameter
options.left parameter
options.top parameter
scrollBy
options.behavior parameter
options.left parameter
options.top parameter
scrollHeight
scrollIntoView
options parameter
scrollIntoViewIfNeeded
Non-standard
scrollLeft
scrollLeftMax
Non-standard
scrollTo
options.behavior parameter
options.left parameter
options.top parameter
scrollTop
scrollTopMax
Non-standard
scrollWidth
scroll event
scrollend event
scrollsnapchange event
Experimental
scrollsnapchanging event
Experimental
securitypolicyviolation event
setAttribute
setAttributeNS
setAttributeNode
setAttributeNodeNS
setCapture
DeprecatedNon-standard
setHTMLUnsafe
setPointerCapture
shadowRoot
slot
tagName
toggleAttribute
touchcancel event
touchend event
touchmove event
touchstart event
transitioncancel event
transitionend event
transitionrun event
transitionstart event
webkitmouseforcechanged event
Non-standard
webkitmouseforcedown event
Non-standard
webkitmouseforceup event
Non-standard
webkitmouseforcewillbegin event
Non-standard
wheel event

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
In development. Supported in a pre-release version.
In development. Supported in a pre-release version.
No support
No support
Experimental. Expect behavior to change in the future.
Non-standard. Check cross-browser support before using.
Deprecated. Not for use in new websites.
See implementation notes.
User must explicitly enable this feature.
Uses a non-standard name.
Requires a vendor prefix or different name for use.
Has more compatibility info.