Element

Интерфейс Element представляет собой один из объектов в Document. Этот интерфейс описывает методы и свойства, общие для всех видов элементов. Конкретные модели поведения описаны в интерфейсах, которые наследуют от Element, и добавляют дополнительную функциональность.

Например, интерфейс HTMLElement является базовым интерфейсом для HTML-элементов, в то время как интерфейс SVGElement является основой для всех SVG-элементов.

Языки, находящиеся вне области веб-платформы, также используют его. Например, XUL — через интерфейс XULElement.

Свойства

Наследует свойства от родительского узла Node и от собственного родителя EventTarget и реализует свойства ParentNode, ChildNode, NonDocumentTypeChildNode, and Animatable.

Element.attributes Только для чтения

Возвращает NamedNodeMap, в котором перечислены все атрибуты связанные с элементом.

ParentNode.childElementCount

Это Number представляющее число дочерних узлов, представленных в элементе.

ParentNode.children

Is a live HTMLCollection containing all child elements of the element, as a collection.

Element.classList Только для чтения

Возвращает DOMTokenList содержащий список атрибутов класса.

Element.className

Это DOMString представляющая класс элемента.

Element.clientHeight Только для чтения

Returns a Number representing the inner height of the element.

Element.clientLeft Только для чтения

Returns a Number representing the width of the left border of the element.

Element.clientTop Только для чтения

Returns a Number representing the width of the top border of the element.

Element.clientWidth Только для чтения

Returns a Number representing the inner width of the element.

ParentNode.firstElementChild

Is a Element, the first direct child element of an element, or null if the element has no child elements.

Element.id

Is a DOMString representing the id of the element.

Element.innerHTML

Is a DOMString representing the markup of the element's content.

ParentNode.lastElementChild

Is a Element, the last direct child element of an element, or null if the element has no child elements.

NonDocumentTypeChildNode.nextElementSibling

Is a Element, the element immediately following the given one in the tree, or null if there's no sibling node.

Element.outerHTML

Is a DOMString representing the markup of the element including its content. When used as a setter, replaces the element with nodes parsed from the given string.

NonDocumentTypeChildNode.previousElementSibling

Is a Element, the element immediately preceding the given one in the tree, or null if there is no sibling element.

Element.scrollHeight Только для чтения

Returns a Number representing the scroll view height of an element.

Element.scrollLeft

Is a Number representing the left scroll offset of the element.

Element.scrollLeftMax Только для чтения

Returns a Number representing the maximum left scroll offset possible for the element.

Element.scrollTop

Is a Number representing the top scroll offset the an element.

Element.scrollTopMax Только для чтения

Returns aNumber representing the maximum top scroll offset possible for the element.

Element.scrollWidth Только для чтения

Returns a Number representing the scroll view width of the element.

Element.shadowRoot Только для чтения

...

Element.tagName Только для чтения

Returns a String with the name of the tag for the given element.

Element.undoManager Только для чтения

Returns the UndoManager associated with the element.

Element.undoScope

Is a Boolean indicating if the element is an undo scope host, or not.

Event handlers

Element.ongotpointercapture

…

Element.onlostpointercapture

…

Element.onwheel

Returns the event handling code for the wheel event.

Методы

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

EventTarget.addEventListener()

Регистрация an event handler to a specific event type on the element.

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

Returns a Boolean indicating if the element has the specified attribute or not.

Element.hasAttributeNS()

Returns a Boolean indicating if the element has the specified attribute, in the specified namespace, or not.

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

Removes the element from the children list of its parent.

Element.removeAttribute()

Removes the named attribute from the current node.

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

Sets the value of a named attribute of the current node.

Element.setAttributeNS()

Sets the value of the attribute with the specified name and namespace, from the current node.

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

…

Specifications

Browser compatibility

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