JavaScript интерфейс Element
Интерфейсы веб APIОписание интерфейса
Интерфейс Element описывает методы и свойства, которые являются общими для всех видов элементов, представляет собой один из объектов в Document.
Более конкретные классы наследуются от интерфейса Element, задавая дополнительные функциональные возможности ниже по иерархии классов. Например, интерфейс HTMLElement является основным интерфейсом для HTML элементов, в то время как интерфейс SVGElement является основой для всех элементов SVG.
Полный перечень свойств и методов объекта Element представлен ниже:
Методы интерфейса
| Метод | Описание |  Chrome |  Firefox |  Opera |  Safari |  IExplorer |  Edge |
|---|---|---|---|---|---|---|---|
| EventTarget.addEventListener() | Позволяет зарегистрировать обработчик событий определенного типа для конкретной цели. | Да | Да | Да | Да | 9.0* | Да |
| attachShadow() | Метод присоединяет теневое дерево DOM к указанному элементу и возвращает ссылку на его теневой корень (shadow root). | 43.0 | 63.0 | 40.0 | 10.0 | Нет | Нет |
| EventTarget.dispatchEvent() | Позволяет отправить искусственно созданное событие элементу. | Да | Да | Да | Да | 9.0 | Да |
| getAttribute() | Возвращает значение указанного атрибута элемента. | Да | Да | Да | Да | Да | Да |
| getAttributeNames() | Позволяет возвратить имена всех атрибутов элемента в виде массива строк. | 61.0 | 45.0 | 48.0 | 10.0 | Нет | 18.0 |
| getAttributeNS() | Возвращает строковое значение атрибута с указанным пространством имен и именем. | Да | Да | Да | Да | Да | Да |
| getBoundingClientRect() | Возвращает объект DOMRect, который содержит размеры элемента и его положение относительно видимой области просмотра. | Да | Да | Да | Да* | Да* | Да* |
| getClientRects() | Возвращает массивоподобный объект, который содержит коллекцию объектов DOMRect, которые необходимы для определения координат относительно видимой области просмотра и размеров отдельных прямоугольников, занимаемых строчными элементами. | Да | Да | Да | Да* | Да* | Да* |
| getElementsByClassName() | Возвращает живую коллекцию HTMLCollection, которая содержит каждый элемент, который имеет указанное имя, или имена класса, поиск элементов при этом ведется внутри указанного элемента. | Да | Да | Да | Да | Да | Да |
| getElementsByTagName() | Возвращает живую коллекцию HTMLCollection элементов с заданным именем тега, поиск элементов при этом ведется внутри указанного элемента. | Да | Да | Да | Да | Да | Да |
| getElementsByTagNameNS() | Возвращает живую коллекцию HTMLCollection элементов с заданным именем тега, принадлежащих заданному пространству имен, поиск элементов при этом ведется внутри указанного элемента. | Да | Да | Да | Да | Да | Да |
| hasAttribute() | Возвращает логическое значение, указывающее на то, имеет ли указанный элемент заданный атрибут или нет. | Да | Да | Да | Да | Да | Да |
| hasAttributeNS() | Возвращает логическое значение, указывающее, имеет ли элемент указанный атрибут в указанном пространстве имен или нет. | Да | Да | Да | Да | Да | Да |
| hasAttributes() | Возвращает логическое значение, указывающее на то, имеет ли элемент один или несколько любых атрибутов HTML. | Да | Да | Да | Да | 9.0 | Да |
| hasPointerCapture() | Указывает, имеет ли элемент, на котором он вызывается, захват указателя. | 55.0 | 59.0 | 42.0 | ? | 11.0 | Да |
| insertAdjacentElement() | Позволяет вставить указанный узел элемента в заданную позицию относительно элемента, на котором он вызывается. | Да | 48.0 | Да | Да | Да | Да |
| insertAdjacentHTML() | Производит анализ указанного текста как HTML или XML, и вставляет полученные узлы в дерево DOM в указанной позиции. | Да | Да | Да | Да | Да | Да |
| insertAdjacentText() | Позволяет вставить указанный текстовый узел в заданную позицию относительно элемента на котором он вызывается. | Да | 48.0 | Да | Да | Да | Да |
| querySelector() | Возвращает первый элемент, соответствующий указанной группе селекторов, который является потомком элемента на котором был вызван метод. | Да | Да | Да | Да | 9.0 | Да |
| querySelectorAll() | Возвращает статический (не живой) объект NodeList, представляющий список элементов, соответствующих указанной группе селекторов, которые являются потомками элемента на котором был вызван метод. | Да | Да | Да | Да | 9.0 | Да |
| releasePointerCapture() | Освобождает (останавливает) захват указателя, который ранее был установлен для определенного события указателя. | 55.0 | 59.0 | 42.0 | ? | 11.0 | Да |
| removeAttribute() | Позволяет удалить из элемента атрибут с указанным именем. | Да | Да | Да | Да | Да | Да |
| removeAttributeNS() | Удаляет из элемента атрибут с указанным именем и пространством имен. | Да | Да | Да | Да | Да | Да |
| EventTarget.removeEventListener() | Позволяет удалить обработчик событий определенного типа для конкретного элемента. | Да | Да | Да | Да | 9.0* | Да |
| scroll() | Позволяет прокрутить страницу в соответствии с заданными координатами внутри указанного элемента. | 45.0 | Да | 32.0 | 10.0 | Нет | Нет |
| scrollBy() | Позволяет прокрутить элемент на заданные величины. | 45.0 | Да | 32.0 | 10.0 | Нет | Нет |
| scrollTo() | Позволяет прокрутить страницу к определенному набору координат внутри данного элемента. | 45.0 | Да | 32.0 | 10.0 | Нет | Нет |
| setAttribute() | Позволяет добавить новый атрибут, или значение атрибута с указанным именем текущему элементу. | Да | Да | Да | Да | Да | Да |
| setAttributeNS() | Позволяет добавить новый атрибут или значение атрибута с заданным пространством имен и именем текущего элемента. | Да | Да | Да | Да | Да | Да |
| setPointerCapture() | Используется для назначения определенного элемента в качестве цели захвата будущих событий указателя. | 55.0 | 59.0 | 42.0 | ? | 11.0 | Да |
| toggleAttribute() | Позволяет добавить элементу логический атрибут, если его нет, или удалить его, если он присутствует у данного элемента. | 69.0 | 63.0 | 56.0 | ? | ? | 18.0 |
Свойства интерфейса
| Свойство | Описание | Chrome | Firefox | Opera | Safari | IExplorer | Edge |
|---|---|---|---|---|---|---|---|
| attributes | Возвращает динамическую коллекцию всех узлов атрибута (объект NamedNodeMap), зарегистрированных на указанном узле. | 26.0 | 22.0 | Да | 6.0 | Да | 16.0 |
| ParentNode.childElementCount | Возвращает количество дочерних элементов конкретного узла. | Да | Да | Да | Да | 9.0 | Да |
| ParentNode.children | Возвращает живую коллекцию (HTMLCollection), которая содержит все дочерние элементы узла, на котором он был вызван. | Да | Да | Да | Да | 9.0* | Да |
| classList | Является свойством только для чтения, которое возвращает живую коллекцию DOMTokenList, содержащую значение глобального атрибута class (классы элемента). | Да | Да | Да | Да | 10.0* | Да |
| className | Задает значение атрибута class, или возвращает строковое значение этого атрибута, содержащее класс, или классы текущего элемента, разделенные пробелами. | Да | Да | Да | Да | Да | Да |
| clientHeight | Свойство, доступное только для чтения возвращает число, которое соответствует значению внутренней высоты элемента в пикселях (значение свойства height), включая пространство между содержимым элемента и его границей (значение свойства padding), но исключая высоту полосы горизонтальной прокрутки. Для элементов без CSS стилей, или элементов строчной разметки значение будет соответствовать нулю. | Да | Да | Да | Да | Да | Да |
| clientLeft | Свойство, доступное только для чтения возвращает число, которое соответствует ширине левой границы элемента в пикселях. Оно включает ширину вертикальной полосы прокрутки, если направление текста элемента справа налево и если есть переполнение, вызывающее левую вертикальную полосу прокрутки для визуализации. | Да | Да | Да | Да | Да | Да |
| clientTop | Свойство, доступное только для чтения возвращает число, которое соответствует ширине верхней границы элемента в пикселях. | Да | Да | Да | Да | Да | Да |
| clientWidth | Свойство, доступное только для чтения возвращает число, которое соответствует значению внутренней ширины элемента в пикселях (значение свойства width), включая пространство между содержимым элемента и его границей (значение свойства padding), но исключает границы (border), внешние отступы (значение свойства margin) и вертикальные полосы прокрутки (если они есть). Для элементов без CSS стилей, или элементов строчной разметки значение будет соответствовать нулю. | Да | Да | Да | Да | Да | Да |
| ParentNode.firstElementChild | Возвращает первый дочерний элемент (объект Element) конкретного узла, или null, если дочерних элементов нет. | Да | Да | Да | Да | 9.0 | Да |
| id | Является свойством только для чтения, которое возвращает значение глобального атрибута id элемента (идентификатор элемента). | Да | Да | Да | Да | Да | Да |
| innerHTML | Позволяет установить или возвратить содержимое элемента. | Да | Да | Да | Да | Да | Да |
| ParentNode.lastElementChild | Возвращает последний дочерний элемент (объект Element) конкретного узла, или null, если дочерних элементов нет. | Да | Да | Да | Да | 9.0 | Да |
| localName | Является свойством только для чтения, которое возвращает локальную часть имени элемента. | 31.0 | 48.0 | Да | 10.0 | Нет | 17.0 |
| namespaceURI | Является свойством только для чтения, которое URI пространства имен элемента, или null, если элемент не находится в пространстве имен. | 31.0 | 48.0 | Да | 10.0 | Нет | 17.0 |
| NonDocument TypeChildNode.nextElementSibling | Является свойством только для чтения, которое возвращает элемент (объект Element), следующий сразу за указанным в списке дочерних элементов родительского элемента, или null, если указанный элемент является последним в списке. | Да | Да | Да | Да | 9.0 | Да |
| outerHTML | Возвращает сериализованный HTML фрагмент, описывающий элемент, включая его потомков. Он также может быть установлен, чтобы заменить элемент с узлами, проанализированных из данной строки. | Да | Да | Да | Да | Да | Да |
| prefix | Является свойством только для чтения, которое возвращает префикс пространства имен указанного элемента или null, если префикс не указан. | 31.0 | 48.0 | Да | 10.0 | Нет | Да |
| NonDocument TypeChildNode.previousElementSibling | Является свойством только для чтения, которое возвращает элемент (объект Element), находящийся непосредственно перед указанным в родительском списке дочерних элементом, или null, если указанный элемент является первым в списке. | Да | Да | Да | Да | 9.0 | Да |
| scrollHeight | Является свойством только для чтения, которое соответствует измерению высоты содержимого элемента, включая содержимое, не видимое на экране из-за переполнения. | Да | Да | Да | Да | Да | Да |
| scrollLeft | Возвращает или задает количество пикселей, на которое прокручивается содержимое элемента от его левого края. | Да | Да | Да | Да | Да | Да |
| scrollTop | Возвращает или задает количество пикселей, в которых содержимое элемента прокручивается по вертикали. | Да | Да | Да | Да | Да | Да |
| scrollWidth | Является свойством только для чтения, которое соответствует измерению ширины содержимого элемента, включая содержимое, не видимое на экране из-за переполнения. | Да | Да | Да | Да | Да | Да |
| shadowRoot | Свойство только для чтения, которое представляет из себя теневой корень (shadow root), размещенный элементом. | 43.0 | 63.0 | 40.0 | 10.0 | Нет | Нет |
| slot | Возвращает имя слота shadow DOM, в который вставлен элемент. | 53.0 | ? | ? | 10.0 | ? | ? |
| tagName | Является свойством только для чтения, которое возвращает имя тега элемента, на котором он вызывается. | Да | Да | Да | Да | Да | Да |