We're looking for a user researcher to understand the needs of developers and designers. Is this you or someone you know? Check out the post: https://mzl.la/2IGzdXS

Перевод не завершен. Пожалуйста, помогите перевести эту статью с английского.

Интерфейс 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 Только для чтения
The namespace URI of the element, or null if it is no namespace.

Примечание: В 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 namespaceURIlocalName и prefix определялись в интерфейсе Node. В DOM4 они были перенесены в Element.

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

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

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

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

Element.onwheel
Возвращает код обработчика для события wheel.
Сейчас реализован в GlobalEventHandlers.

Методы

Inherits methods from its parents Node, and its own parent, EventTarget, and implements those of ParentNode, ChildNode, NonDocumentTypeChildNode, and Animatable.

EventTarget.addEventListener()
Регистрирует обработчик событий для опрделенного типа событий в элементе.
Element.closest()
Returns the Element, descendant of this element (or this element itself), that is the closest ancestor of the elements selected by the selectors given in parameter.
Element.createShadowRoot()
EventTarget.dispatchEvent()
Dispatches an event to this node in the DOM and returns a Boolean that indicates that at least one handler has not canceled it.
Element.find()
...
Element.findAll()
...
Animatable.getAnimationPlayers()
Element.getAttribute()
Retrieves the value of the named attribute from the current node and returns it as an Object.
Element.getAttributeNS()
Retrieves the value of the attribute with the specified name and namespace, from the current node and returns it as an Object.
Element.getAttributeNode()
Retrievse the node representation of the named attribute from the current node and returns it as an Attr.
Element.getAttributeNodeNS()
Retrieves the node representation of the attribute with the specified name and namespace, from the current node and returns it as an 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()
Returns a live HTMLCollection that contains all descendant of the current element that posses the list of classes given in parameter.
Element.getElementsByTagName()
Returns a live HTMLCollection containing all descendant elements, of a particular tag name, from the current element.
Element.getElementsByTagNameNS()
Returns a live HTMLCollection containing all descendant elements, of a particular tag name and namespace, from the current element.
Element.hasAttribute()
Вовзращает Boolean, указывающее, имеет элемент определенный атрибут, или нет.
Element.hasAttributeNS()
Возвращает Boolean, указывающий, имеет элемент определенный атрибут в определенном пространстве имен, или нет.
Element.insertAdjacentHTML
Parses the text as HTML or XML and inserts the resulting nodes into the tree in the position given.
Element.matches()
Returns a Boolean indicating whether or not the element would be selected by the specified selector string.
Element.querySelector()
Returns Node...
Element.querySelectorAll
Returns a NodeList...
Element.releasePointerCapture
ChildNode.remove()
Удаляет элемент из списка дочерних элементов родительского элемента.
Element.removeAttribute()
Удаляет именованный атрибут из текущего узла.
Element.removeAttributeNS()
Removes the attribute with the specified name and namespace, from the current node.
Element.removeAttributeNode()
Removes the node representation of the named attribute from the current node.
EventTarget.removeEventListener()
Removes an event listener from the element.
Element.requestFullscreen()
Asynchronously asks the browser to make the element full-screen.
Element.requestPointerLock()
Allows to asynchronously ask for the pointer to be locked on the given element.
Element.scrollIntoView()
Scrolls the page until the element gets into the view.
Element.setAttribute()
Устанавливает значение именованного атрибута из текущей узла.
Element.setAttributeNS()
Устанавливает значение атрибута с опрделенным именем и пространством имен из текущей узла.
Element.setAttributeNode()
Sets the node representation of the named attribute from the current node.
Element.setAttributeNodeNS()
Setw the node representation of the attribute with the specified name and namespace, from the current node.
Element.setCapture()
Sets up mouse event capture, redirecting all mouse events to this element.
Element.setPointerCapture()

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

Specification Status Comment
Web Animations Рабочий черновик Added the getAnimationPlayers() method.
UndoManager and DOMTransaction
Определение 'Element' в этой спецификации.
Редакторский черновик Added the undoScope and undoManager properties.
Pointer Events
Определение 'Element' в этой спецификации.
Рекомендация Added the following event handlers: ongotpointercapture and onlostpointercapture.
Added the following methods: setPointerCapture() and releasePointerCapture().
Selectors API Level 2
Определение 'Element' в этой спецификации.
Устаревшая Added the following methods: matches() (implemented as mozMatchesSelector()), find(), findAll().
Selectors API Level 1
Определение 'Element' в этой спецификации.
Устаревшая Added the following methods: querySelector() and querySelectorAll().
Pointer Lock
Определение 'Element' в этой спецификации.
Кандидат в рекомендации Added the requestPointerLock() method.
Fullscreen API
Определение 'Element' в этой спецификации.
Живой стандарт Added the requestFullscreen() method.
DOM Parsing and Serialization
Определение 'Element' в этой спецификации.
Рабочий черновик Added the following properties: innerHTML, and outerHTML.
Added the following method: insertAdjacentHTML().
CSS Object Model (CSSOM) View Module
Определение 'Element' в этой спецификации.
Рабочий черновик Added the following properties: scrollTop, scrollLeft, scrollWidth, scrollHeight, clientTop, clientLeft, clientWidth, and clientHeight.
Added the following methods: getClientRects(), getBoundingClientRect(), and scrollIntoView().
Element Traversal Specification
Определение 'Element' в этой спецификации.
Устаревшая Added inheritance of the ElementTraversal interface.
DOM
Определение 'Element' в этой спецификации.
Живой стандарт Removed the following methods: closest(), setIdAttribute(), setIdAttributeNS(), and setIdAttributeNode().
Removed the schemaTypeInfo property.
Modified the return value of getElementsByTag() and 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' в этой спецификации.
Устаревшая The normalize() method has been moved to Node.
Document Object Model (DOM) Level 1 Specification
Определение 'Element' в этой спецификации.
Устаревшая Initial definition.

Поддержка браузерами

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 1.0 1.0 (1.7 или ранее) (Да) (Да) 1.0
children (Да) 3.0 (1.9) 7.0 with a significant bug [1]
9.0 according to the spec
(Да) Нет
childElementCount, nextElementSibling, previousElementSibling (Да) 3.5 (1.9.1) 9.0 (Да) (Да)
firstElementChild, lastElementChild (Да) 3.0 (1.9) 9.0 (Да) (Да)
classList (Да) 3.6 (1.9.2)   (Да) (Да)
outerHTML (Да) 11 (11) (Да) (Да) (Да)
clientLeft, clientTop (Да) 3.5 (1.9.1) (Да) (Да) (Да)
getBoundingClientRect(), getClientRects() (Да) 3.0 (1.9) (Да) (Да) (Да)
querySelector(), querySelectorAll() 1.0 3.5 (1.9.1) 8.0 10.0 3.2 (525.3)
insertAdjacentHTML() 1.0 8 (8) 4.0 7.0 4.0 (527)
setCapture() Нет 4.0 (2) Нет Нет Нет
oncopy, oncut, onpaste Нет 3.0 (1.9) (Да)   Нет
onwheel Нет 17 (17) Нет Нет Нет
ongotpointercapture, onlostpointercapture, setPointerCapture(), and releasePointerCapture() Нет Нет 10.0 MS Нет Нет
matches() (Да) with the non-standard name webkitMatchesSelector 3.6 (1.9.2) with the non-standard name mozMatchesSelector
34 (34) with the standard name
9.0 with the non-standard name msMatchesSelector 11.5 with the non-standard name oMatchesSelector
15.0 with the non-standard name webkitMatchesSelector
5.0 with the non-standard name webkitMatchesSelector
find() and findAll() Нет Нет Нет Нет Нет
requestPointerLock() 16.0 webkit, behind an about:flags
22.0 webkit (with special cases, progressively lifted see [2])
14 (14)moz Нет Нет Нет
requestFullscreen() 14.0 webkit 10 (10) moz 11.0 ms 12.10
15.0 webkit
5.1 webkit
undoManager and undoScope Нет (Да) (behind the dom.undo_manager.enabled pref) Нет Нет Нет
attributes ? 22 (22)
Before this it was available via the Node interface that any element inherits.
? ? ?
scrollTopMax() and scrollLeftMax() Нет 16 (16) Нет Нет Нет
closest() ? 35 (35) ? ? ?
hasAttributes() (Да) 1.0 (1.7 или ранее) (on the Node interface)
35 (35) (on this interface
(Да) (Да) (Да)
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support 1.0 1.0 (1) (Да) (Да) 1.0
scrollTopMax() and scrollLeftMax() Нет 16.0 (16) Нет Нет Нет
closest() ? 35.0 (35) ? ? ?
hasAttributes() (Да) 1.0 (1.0) (on the Node interface)
35.0 (35) (on this interface
(Да) (Да) (Да)

[1] Internet Explorer 7 and 8 incorrectly return the comments as part of the children of an Element. This is fixed in Internet Explorer 9 and later.

[2] Chrome 16 allowed webkitRequestPointerLock() only in fullscreen; Chrome 21 for trusted web site (permission asked); Chrome 22 allowed it by default for all same-origin document; Chrome 23 allowed it in sandboxed <iframe> if the non-standard value webkit-allow-pointer-lock is set to the sandbox attribute.

Метки документа и участники

Метки: 
Внесли вклад в эту страницу: Oaphi, coderoma, TemmyR, vladlipski, SedovDP, feedlike, ugg555, fscholz, khalid32, datasheet
Обновлялась последний раз: Oaphi,