This page was translated from English by the community.Learn more and join the MDN Web Docs community.
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.
In this article
Свойства
Наследует свойства от родительского узлаNode и от собственного родителяEventTarget и реализует свойстваParentNode,ChildNode,NonDocumentTypeChildNode, andAnimatable.
Element.assignedSlotЭкспериментальная возможностьТолько для чтенияВозвращает
HTMLSlotElementинтерфейс, связанный с элементом.Element.attributesТолько для чтенияВозвращает
NamedNodeMap, в котором перечислены все атрибуты связанные с элементом.Element.classListТолько для чтенияВозвращает
DOMTokenListсодержащий список атрибутов класса.ParentNode.childElementCountЭто
Numberпредставляющее число дочерних узлов, представленных в элементе.ParentNode.childrenIs 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, или нет.
Примечание:В DOM3namespaceURI,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()Определяет указанный элемент как цель захвата будущих событий указателя.