HTMLElement
Базовая Широко доступная *
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.
* Некоторые части этой функции могут иметь различный уровень поддержки.
Интерфейс HTMLElement представляет любое HTML элемент. Некоторые элементы напрямую реализуют этот интерфейс, в то время как другие реализуют его через интерфейс, который его наследует.
Свойства экземпляра
Также наследует свойства от своего родителя, Element.
HTMLElement.accessKey-
Строка, представляющая назначенный элементу ключ доступа.
-
HTMLElement.accessKeyLabelТолько для чтения -
Возвращает строку, содержащую назначенный элементу ключ доступа.
-
HTMLElement.anchorElementТолько для чтения Нестандартный Экспериментальный -
Возвращает ссылку на элемент якоря элемента, или
null, если такового нет. -
HTMLElement.attributeStyleMapТолько для чтения -
StylePropertyMap, представляющий объявления атрибута элементаstyle. HTMLElement.autocapitalize-
Строка, представляющая поведение капитализации элемента для пользовательского ввода. Допустимые значения:
none,off,on,characters,words,sentences. HTMLElement.autofocus-
Булево значение, отражающее
autofocusHTML-глобальный атрибут, который указывает, нужно ли сфокусировать элемент при загрузке страницы или при отображении диалога или всплывающего окна, если указано в элементе внутри<dialog>элементов или элементов, у которых установлен атрибут всплывающего окна. -
HTMLElement.autocorrectЭкспериментальный -
Булево значение, определяющее, следует ли автоматически исправлять текст, введенный пользователем. Это отражает
autocorrectHTML-глобальный атрибут. HTMLElement.contentEditable-
Строка, где значение
trueозначает, что элемент редактируемый, а значениеfalseозначает, что он не редактируемый. -
HTMLElement.datasetТолько для чтения -
Возвращает
DOMStringMap, с помощью которого скрипт может читать и записывать пользовательские данные атрибуты элемента (data-*). HTMLElement.dir-
Строка, отражающая
dirглобальный атрибут, представляющий направленность элемента. Возможные значения:"ltr","rtl", и"auto". HTMLElement.draggable-
Булево значение, указывающее, можно ли перетаскивать элемент.
-
HTMLElement.editContextЭкспериментальный -
Возвращает связанный с элементом
EditContext, илиnull, если такового нет. HTMLElement.enterKeyHint-
Строка, определяющая метку действия (или значок) для клавиши Enter на виртуальных клавиатурах.
-
Строковое или булево значение, отражающее значение атрибута элемента
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-
Срабатывает для элементов, содержащих ресурс, когда ресурс успешно загружен.
События буфера обмена
События перетаскивания и выгрузки
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 |
6643–66Поддерживается только наHTMLInputElement и HTMLTextAreaElement. |
79 | 111 | 5330–53Поддерживается только наHTMLInputElement и HTMLTextAreaElement. |
Нет | 6643–66Поддерживается только наHTMLInputElement и HTMLTextAreaElement. |
111 | 4730–47Поддерживается только наHTMLInputElement и HTMLTextAreaElement. |
10.3≤3–10.3Поддерживается только наHTMLFormElement, HTMLInputElement и HTMLTextAreaElement. |
9.04.0–9.0Поддерживается только наHTMLInputElement и HTMLTextAreaElement. |
6643–66Поддерживается только наHTMLInputElement и HTMLTextAreaElement. |
autocorrect |
Нет | Нет | предварительный просмотр | Нет | 14.1 | Нет | Нет | Нет | 14.5 | Нет | Нет |
autofocus |
791–79Поддерживается дляHTMLButtonElement, HTMLInputElement, HTMLSelectElement и HTMLTextAreaElement. |
7912–79Поддерживается дляHTMLButtonElement, HTMLInputElement, HTMLSelectElement и HTMLTextAreaElement. |
1101–110Поддерживается дляHTMLButtonElement, HTMLInputElement, HTMLSelectElement и HTMLTextAreaElement. |
66≤12.1–66Поддерживается дляHTMLButtonElement, HTMLInputElement, HTMLSelectElement и HTMLTextAreaElement. |
15.44–15.4Поддерживается дляHTMLButtonElement, HTMLInputElement, HTMLSelectElement и HTMLTextAreaElement. |
7918–79Поддерживается дляHTMLButtonElement, HTMLInputElement, HTMLSelectElement и HTMLTextAreaElement. |
1104–110Поддерживается дляHTMLButtonElement, HTMLInputElement, HTMLSelectElement и HTMLTextAreaElement. |
57≤12.1–57Поддерживается дляHTMLButtonElement, HTMLInputElement, HTMLSelectElement и HTMLTextAreaElement. |
15.43.2–15.4Поддерживается дляHTMLButtonElement, HTMLInputElement, HTMLSelectElement и HTMLTextAreaElement. |
12.01.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.410–15.4Свойство определено только для своих полезных элементов:<link>, <script> и <style>; для всех остальных элементов оно не определено. |
61 | 79 | 45 | 15.410–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.317–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 | 1812Возвращает неверное значение для элементов без явного атрибута 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 |
См. также
© 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