Element

Интерфейс 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, или нет.

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

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()

…

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

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

[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.