Element
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since июль 2015 г..
* Some parts of this feature may have varying levels of support.
Интерфейс 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
UndoManagerassociated 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()-
Определяет указанный элемент как цель захвата будущих событий указателя.