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
Только для чтения-
Пространство имён 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
UndoManager
associated with the element. Element.undoScope
Экспериментальная возможность-
Представляет собой
Boolean
, указывающим, является элемент undo scope host, или нет.
Примечание:
В DOM3 namespaceURI
, localName
и prefix
определялись в интерфейсе Node
. В DOM4 они были перенесены в Element
.
Данное изменение поддерживается в Chrome начиная с версии 46.0 и в Firefox с версии 48.0.
Обработчики событий
Element.ongotpointercapture
-
Возвращает обработчик событий для событий типа
unsupported templ: event. Element.onlostpointercapture
-
Возвращает обработчик событий для событий типа
unsupported templ: event.
Устаревшие обработчики событий
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()
-
Определяет указанный элемент как цель захвата будущих событий указателя.
Спецификации
Совместимость с браузерами
BCD tables only load in the browser