Spec-Zone.ru › Web APIs

HTMLElement

Базовая Широко доступная *

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

* Некоторые части этой функции могут иметь различный уровень поддержки.

  • Узнать больше
  • См. полную совместимость
  • Отправить отзыв

Интерфейс HTMLElement представляет любое HTML элемент. Некоторые элементы напрямую реализуют этот интерфейс, в то время как другие реализуют его через интерфейс, который его наследует.

EventTarget Node Element HTMLElement

Свойства экземпляра

Также наследует свойства от своего родителя, Element.

HTMLElement.accessKey

Строка, представляющая назначенный элементу ключ доступа.

HTMLElement.accessKeyLabel Только для чтения

Возвращает строку, содержащую назначенный элементу ключ доступа.

HTMLElement.anchorElement Только для чтения Нестандартный Экспериментальный

Возвращает ссылку на элемент якоря элемента, или null, если такового нет.

HTMLElement.attributeStyleMap Только для чтения

StylePropertyMap, представляющий объявления атрибута элемента style.

HTMLElement.autocapitalize

Строка, представляющая поведение капитализации элемента для пользовательского ввода. Допустимые значения: none, off, on, characters, words, sentences.

HTMLElement.autofocus

Булево значение, отражающее autofocus HTML-глобальный атрибут, который указывает, нужно ли сфокусировать элемент при загрузке страницы или при отображении диалога или всплывающего окна, если указано в элементе внутри <dialog> элементов или элементов, у которых установлен атрибут всплывающего окна.

HTMLElement.autocorrect Экспериментальный

Булево значение, определяющее, следует ли автоматически исправлять текст, введенный пользователем. Это отражает autocorrect HTML-глобальный атрибут.

HTMLElement.contentEditable

Строка, где значение true означает, что элемент редактируемый, а значение false означает, что он не редактируемый.

HTMLElement.dataset Только для чтения

Возвращает DOMStringMap, с помощью которого скрипт может читать и записывать пользовательские данные атрибуты элемента (data-*).

HTMLElement.dir

Строка, отражающая dir глобальный атрибут, представляющий направленность элемента. Возможные значения: "ltr", "rtl", и "auto".

HTMLElement.draggable

Булево значение, указывающее, можно ли перетаскивать элемент.

HTMLElement.editContext Экспериментальный

Возвращает связанный с элементом EditContext, или null, если такового нет.

HTMLElement.enterKeyHint

Строка, определяющая метку действия (или значок) для клавиши Enter на виртуальных клавиатурах.

HTMLElement.hidden

Строковое или булево значение, отражающее значение атрибута элемента hidden.

HTMLElement.inert

Булево значение, указывающее, нужно ли агенту пользователя действовать так, как будто данный узел отсутствует для целей событий пользовательского взаимодействия, поиска текста на странице ("найти на странице") и выделения текста.

HTMLElement.innerText

Представляет отображаемое текстовое содержимое узла и его потомков. В качестве геттера он приблизительно соответствует тексту, который получит пользователь, если он выделит содержимое элемента курсором и скопирует его в буфер обмена. В качестве сеттера он заменяет содержимое внутри выбранного элемента, преобразуя все переводы строк в элементы <br>.

HTMLElement.inputMode

Строковое значение, отражающее значение атрибута элемента inputmode.

HTMLElement.isContentEditable Только для чтения

Возвращает булево значение, указывающее, можно ли редактировать содержимое элемента.

HTMLElement.lang

Строка, представляющая язык атрибутов, текста и содержимого элемента.

HTMLElement.nonce

Возвращает одноразовое криптографическое число, используемое политикой безопасности контента для определения того, разрешено ли продолжать запрос.

HTMLElement.offsetHeight Только для чтения

Возвращает double, содержащее высоту элемента относительно макета.

HTMLElement.offsetLeft Только для чтения

Возвращает double, расстояние от левой границы этого элемента до левой границы его offsetParent.

HTMLElement.offsetParent Только для чтения

Элемент Element, от которого в настоящее время вычисляются все вычисления смещения.

HTMLElement.offsetTop Только для чтения

Возвращает double, расстояние от верхней границы этого элемента до верхней границы его offsetParent.

HTMLElement.offsetWidth Только для чтения

Возвращает double, содержащее ширину элемента относительно макета.

HTMLElement.outerText

Представляет отображаемое текстовое содержимое узла и его потомков. В качестве геттера он такой же, как HTMLElement.innerText (он представляет отображаемое текстовое содержимое элемента и его потомков). В качестве сеттера он заменяет выбранный узел и его содержимое заданным значением, преобразуя все переводы строк в элементы <br>.

HTMLElement.popover

Получает и устанавливает состояние всплывающего окна элемента через JavaScript ("auto" или "manual") и может использоваться для обнаружения функциональных возможностей. Отражает значение popover глобального HTML-атрибута.

HTMLElement.spellcheck

Булево значение, которое управляет подсказкой проверки орфографии. Оно доступно для всех HTML-элементов, хотя не влияет на все из них.

HTMLElement.style

CSSStyleDeclaration, представляющий объявления атрибута элемента style.

HTMLElement.tabIndex

long представляющий позицию элемента в порядке табуляции.

HTMLElement.title

Строка, содержащая текст, который отображается в всплывающем окне при наведении курсора на элемент.

HTMLElement.translate

Булево значение, представляющее перевод.

HTMLElement.virtualKeyboardPolicy Экспериментальный

Строка, указывающая поведение виртуальной клавиатуры на экране на устройствах, таких как планшеты, мобильные телефоны или других устройствах, где может отсутствовать физическая клавиатура, если содержимое элемента редактируется (например, это элемент <input> или <textarea>, или элемент с атрибутом contenteditable).

HTMLElement.writingSuggestions

Строка, указывающая, следует ли включать предложения по написанию, предоставляемые браузером, в области действия элемента.

Методы экземпляра

Также наследует методы от своего родителя, Element.

HTMLElement.attachInternals()

Возвращает объект ElementInternals и позволяет пользовательскому элементу участвовать в HTML-формах.

HTMLElement.blur()

Удаляет фокус клавиатуры с текущего фокусированного элемента.

HTMLElement.click()

Отправляет событие щелчка мыши элементу.

HTMLElement.focus()

Делает элемент текущим элементом фокуса клавиатуры.

HTMLElement.hidePopover()

Скрывает элемент всплывающей подсказки (popover), удаляя его с верхнего уровня и применяя стили display: none.

HTMLElement.showPopover()

Отображает элемент всплывающей подсказки (popover), добавляя его на верхний уровень и удаляя стили display: none;.

HTMLElement.togglePopover()

Переключает состояние элемента всплывающей подсказки (popover) между скрытым и отображаемым.

События

Прислушивайтесь к этим событиям, используя addEventListener() или назначив обработчик события свойству oneventname этого интерфейса.

Также наследует события от своего родителя, Element.

cancel

Срабатывает для элементов <input> и <dialog>, когда пользователь отменяет открытый диалог, закрывая его клавишей Esc.

change

Срабатывает, когда value элемента <input>, <select> или <textarea> был изменён и подтверждён пользователем. В отличие от события input, событие change не обязательно срабатывает для каждого изменения value элемента.

error

Срабатывает, когда ресурс не загрузился или не может быть использован.

load

Срабатывает для элементов, содержащих ресурс, когда ресурс успешно загружен.

События буфера обмена

copy

Срабатывает, когда пользователь инициирует копирование через интерфейс браузера.

cut

Срабатывает, когда пользователь инициирует вырезку через интерфейс браузера.

paste

Срабатывает, когда пользователь инициирует вставку через интерфейс браузера.

События перетаскивания и выгрузки

drag

Это событие срабатывает, когда элемент или выделение текста перетаскивается.

dragend

Это событие срабатывает, когда операция перетаскивания завершается (путем отпускания кнопки мыши или нажатия клавиши Escape).

dragenter

Это событие срабатывает, когда перетаскиваемый элемент или выделение текста попадает в допустимую зону выгрузки.

dragleave

Это событие срабатывает, когда перетаскиваемый элемент или выделение текста покидает допустимую зону выгрузки.

dragover

Это событие постоянно срабатывает, когда элемент или выделение текста перетаскиваются, и указатель мыши находится над допустимой зоной выгрузки (каждые 50 мс, ЕСЛИ мышь не перемещается ИНАЧЕ намного быстрее, примерно между 5 мс (медленное движение) и 1 мс (быстрое движение). Этот порядок срабатывания отличается от mouseover).

dragstart

Это событие срабатывает, когда пользователь начинает перетаскивать элемент или выделение текста.

drop

Это событие срабатывает, когда элемент или выделение текста отпускается в допустимую зону выгрузки.

События переключения

beforetoggle

Срабатывает, когда элемент является всплывающей подсказкой (popover) или <dialog>, до того, как он будет скрыт или показан.

toggle

Срабатывает, когда элемент является всплывающей подсказкой (popover), <dialog> или элементом <details>, сразу после того, как он будет скрыт или показан.

Спецификации

Спецификация
HTML
# htmlelement

Совместимость с браузерами

Рабочий стол Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на IOS Samsung Internet WebView Android
HTMLElement 1 12 1 8 1 18 4 10.1 1 1.0 1
accessKey 17 12 5 ≤12.1 6 18 5 ≤12.1 6 1.0 4.4
accessKeyLabel Нет Нет 8 Нет 14 Нет 8 Нет 14 Нет Нет
anchorElement предварительный просмотр Нет Нет Нет Нет Нет Нет Нет Нет Нет Нет
attachInternals 77 79 93 64 16.4 77 93 55 16.4 12.0 77
attributeStyleMap 66 79 Нет 53 16.4 66 Нет 47 16.4 9.0 66
autocapitalize 66
43–66Поддерживается только на HTMLInputElement и HTMLTextAreaElement.
79 111 53
30–53Поддерживается только на HTMLInputElement и HTMLTextAreaElement.
Нет 66
43–66Поддерживается только на HTMLInputElement и HTMLTextAreaElement.
111 47
30–47Поддерживается только на HTMLInputElement и HTMLTextAreaElement.
10.3
≤3–10.3Поддерживается только на HTMLFormElement, HTMLInputElement и HTMLTextAreaElement.
9.0
4.0–9.0Поддерживается только на HTMLInputElement и HTMLTextAreaElement.
66
43–66Поддерживается только на HTMLInputElement и HTMLTextAreaElement.
autocorrect Нет Нет предварительный просмотр Нет 14.1 Нет Нет Нет 14.5 Нет Нет
autofocus 79
1–79Поддерживается для HTMLButtonElement, HTMLInputElement, HTMLSelectElement и HTMLTextAreaElement.
79
12–79Поддерживается для HTMLButtonElement, HTMLInputElement, HTMLSelectElement и HTMLTextAreaElement.
110
1–110Поддерживается для HTMLButtonElement, HTMLInputElement, HTMLSelectElement и HTMLTextAreaElement.
66
≤12.1–66Поддерживается для HTMLButtonElement, HTMLInputElement, HTMLSelectElement и HTMLTextAreaElement.
15.4
4–15.4Поддерживается для HTMLButtonElement, HTMLInputElement, HTMLSelectElement и HTMLTextAreaElement.
79
18–79Поддерживается для HTMLButtonElement, HTMLInputElement, HTMLSelectElement и HTMLTextAreaElement.
110
4–110Поддерживается для HTMLButtonElement, HTMLInputElement, HTMLSelectElement и HTMLTextAreaElement.
57
≤12.1–57Поддерживается для HTMLButtonElement, HTMLInputElement, HTMLSelectElement и HTMLTextAreaElement.
15.4
3.2–15.4Поддерживается для HTMLButtonElement, HTMLInputElement, HTMLSelectElement и HTMLTextAreaElement.
12.0
1.0–12.0Поддерживается для HTMLButtonElement, HTMLInputElement, HTMLSelectElement и HTMLTextAreaElement.
79
≤37–79Поддерживается для HTMLButtonElement, HTMLInputElement, HTMLSelectElement и HTMLTextAreaElement.
beforetoggle_event 114 114 125 100 17 114 125 76 17 23.0 114
blur 1 12 1.5 8 3 18 4 10.1 1 1.0 4.4
change_event 1 12 1 9 3 18 4 10.1 2 1.0 4.4
click
9До Chrome 19, click() определено только для кнопок и полей ввода.
12
3["До Firefox 5, click() определено только для кнопок и полей ввода и не влияет на текстовые и файловые поля ввода.", "Начиная с Firefox 75, функция click() работает даже если элемент не присоединен к DOM дереву."]
10.5 6
18До Chrome Android 25, click() определено только для кнопок и полей ввода.
4["До Firefox 5, click() определено только для кнопок и полей ввода и не влияет на текстовые и файловые поля ввода.", "Начиная с Firefox for Android 79, функция click() работает даже если элемент не присоединен к DOM дереву."]
11 6
1.0До Samsung Internet 1.5, click() определено только для кнопок и полей ввода.
4.4До WebView Android 4.4, click() определено только для кнопок и полей ввода.
command_event предварительный просмотр Нет предварительный просмотр Нет предварительный просмотр Нет Нет Нет Нет Нет Нет
contentEditable 1 12 3 9 3 18 4 10.1 1 1.0 4.4
dataset 7 12 6 11 5.1 18 6 11 5 1.0 3
dir 1 12 1 ≤12.1 3 18 4 ≤12.1 1 1.0 4.4
drag_event 1 12 9 12 3.1 18 9 12 2 1.0 4.4
dragend_event 1 12 9 12 3.1 18 9 12 2 1.0 4.4
dragenter_event 1 12 9 12 3.1 18 9 12 2 1.0 4.4
dragexit_event Нет 12–79 3.5 12 3.1 Нет 4 Нет Нет Нет Нет
draggable 4 12 2 12 5 18 4 12 4 1.0 4.4
dragleave_event 1 12 9 12 3.1 18 9 12 2 1.0 4.4
dragover_event 1 12 9 12 3.1 18 9 12 2 1.0 4.4
dragstart_event 1 12 9 12 3.1 18 9 12 2 1.0 4.4
drop_event 1 12 9 12 3.1 18 9 12 2 1.0 4.4
editContext 121 121 Нет 107 Нет 121 Нет 81 Нет 25.0 121
enterKeyHint 77 79 94 64 13.1 77 94 55 13.4 12.0 77
error_event 1 12 1 ≤12.1 1 18 4 ≤12.1 1 1.0 4.4
focus 1 12 1.5 8 3 18 4 10.1
1Если к компьютеру не подключена аппаратная клавиатура и пользователь ещё не взаимодействовал со страницей, то вызов focus() для элемента <input> не оказывает никакого действия (например, элемент не соответствует селектору :focus).
1.0 4.4
hidden 6 12 4 11.6 5.1 18 4 12 5 1.0 3
hidePopover 114 114 125 100 17 114 125 76 17 23.0 114
inert 102 102 112 88 15.5 102 112 70 15.5 19.0 102
innerText 1 12 45 9.6 1 18 45 10.1 1 1.0 1
inputMode 66 79 95 53 12.1 66 79 47 12.2 9.0 66
isContentEditable 1 12 4 ≤12.1 3 18 4 ≤12.1 1 1.0 4.4
lang 1 12 1 ≤12.1 3 18 4 ≤12.1 1 1.0 4.4
nonce 61 79 75 48 15.4
10–15.4Свойство определено только для своих полезных элементов: <link>, <script> и <style>; для всех остальных элементов оно не определено.
61 79 45 15.4
10–15.4Свойство определено только для своих полезных элементов: <link>, <script> и <style>; для всех остальных элементов оно не определено.
8.0 61
offsetHeight 1 12 1 8 3 18 4 10.1 1 1.0 4.4
offsetLeft 1 12 1 8 3 18 4 10.1 1 1.0 4.4
offsetParent 1 12 1 8 3 18 4 10.1 1 1.0 4.4
offsetTop 1 12 1 8 3 18 4 10.1 1 1.0 4.4
offsetWidth 1 12 1 8 3 18 4 10.1 1 1.0 4.4
outerText 1 12 98 ≤12.1 1.3 18 98 ≤12.1 1 1.0 1
popover 114 114 125 100 17 114 125 76 18.3
17–18.3В iOS и iPadOS всплывающие окна не закрываются при нажатии за пределами области всплывающего окна, см. ошибку 267688.
23.0 114
showPopover 114 114 125 100 17 114 125 76 17 23.0 114
spellcheck 9 12 2 ≤12.1 5.1 18 4 ≤12.1 5 1.0 3
style 1 12 1 8 3 18 4 10.1 1 1.0 4.4
tabIndex 1 18
12Возвращает неверное значение для элементов без явного атрибута tabindex. Подробности см. в вопросе 4365703.
1 ≤12.1 3.1 18 4 ≤12.1 2 1.0 4.4
title 1 12 1 ≤12.1 3 18 4 ≤12.1 1 1.0 4.4
togglePopover 114 114 125 100 17 114 125 76 17 23.0 114
toggle_event 36 79 49 23 10.1 36 49 24 10.3 3.0 37
translate 19 79 111 15 6 25 111 14 6 1.5 4.4
virtualKeyboardPolicy 94 94 Нет 80 Нет 94 Нет 66 Нет 17.0 94
writingSuggestions 124 124 Нет 110 18 124 Нет 82 18 27.0 124

См. также

  • Element

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API