English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

События HTML DOM

Отправка DOM событий предназначена для уведомления кода о发生的 интересных событиях.

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

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

Название действияОписаниеТип события
abortЭтот事件 происходит, когда загрузка ресурса была прерванаUiEvent, Event
afterprintЭтот事件 происходит, когда связанный документ已经开始打印 или предварительный просмотр для печати закрытСобытие
animationendЭтот事件 происходит при завершении CSS анимацииAnimationEvent
animationiterationЭтот事件 происходит при повторении CSS анимацииAnimationEvent
animationstartЭтот事件 происходит при начале CSS анимацииAnimationEvent
beforeprintЭтот事件 происходит, когда связанный документ готов к печати или предварительному просмотру для печатиСобытие
beforeunloadПроисходит событие при即将щем выгрузке окна, документа и его ресурсовUiEvent, Event
blurПроисходит событие при потере элементом фокуса (не пузырится)FocusEvent
canplayПроисходит событие при возможности начала воспроизведения媒体 (при достаточном буферизованном контенте для начала воспроизведения)Событие
canplaythroughПроисходит событие при возможности воспроизведения媒体 без остановки буферизацииСобытие
changeПроисходит событие при изменении содержимого элемента формы, выбора или выделения (для <input>, <select> и <textarea>)Событие
clickПроисходит событие при клике по элементуMouseEvent
contextmenuПроисходит событие при правом клике по элементу для открытия контекстного менюMouseEvent
copyПроисходит событие при копировании содержимого элемента пользователемClipboardEvent
cutПроисходит событие при вырезании содержимого элемента пользователемClipboardEvent
dblclickПроисходит событие при двойном щелчке по элементуMouseEvent
dragПроисходит событие при перемещении элементаDragEvent
dragendПроисходит событие при завершении перемещения элемента пользователемDragEvent
dragenterПроисходит событие при подходе перемещаемого элемента к целевой точкеDragEvent
dragleaveПроисходит событие при отрыве перемещаемого элемента от целевой точкиDragEvent
dragoverПроисходит событие при перемещении перемещаемого элемента над целевой точкойDragEvent
dragstartПроисходит событие при начале перемещения элемента пользователемDragEvent
dropПроисходит событие при放置е перемещаемого элемента на целевую точкуDragEvent
durationchangeПроисходит событие при изменении продолжительности медиаСобытие
endedДанное событие происходит при завершении воспроизведения медиа (полезно для сообщений типа «Спасибо за прослушивание»)Событие
errorПроисходит при неудачной загрузке ресурсаProgressEvent, UiEvent, Event
focusПроисходит событие при получении элементом фокуса (не пузырится)FocusEvent
focusinДанное событие происходит при即将щем получении фокуса элементомFocusEvent
focusoutДанное событие происходит при即将щем потере фокуса элементомFocusEvent
fullscreenchangeПроисходит событие при отображении элемента в полноэкранном режимеСобытие
fullscreenerrorПроисходит событие при невозможности отображения элемента в полноэкранном режимеСобытие
hashchangeПроисходит данное событие при изменении части URL с锚омHashChangeEvent
inputПроисходит событие при получении элементом ввода пользователяInputEvent, Event
invalidПроисходит при признаке неактивности элементаСобытие
keydownДанное событие происходит при нажатии пользователем определенной клавишиKeyboardEvent
keypressПроисходит событие при нажатии клавиши пользователемKeyboardEvent
keyupЭто событие происходит при отпускании клавиши.KeyboardEvent
loadЭто событие происходит, когда объект уже загружен.UiEvent, Event
loadeddataЭто событие происходит при загрузке данных媒体.Событие
loadedmetadataЭто событие происходит при загрузке метаданных (например, размер и продолжительность).Событие
loadstartЭто событие происходит при начале поиска指定的媒体.ProgressEvent
messageЭто событие происходит при получении сообщения через источник события.Событие
mousedownЭто событие происходит при нажатии кнопки мыши на элементе.MouseEvent
mouseenterЭто событие происходит, когда указатель мыши перемещается на элемент.MouseEvent
mouseleaveЭто событие происходит, когда указатель мыши выходит из элемента.MouseEvent
mousemoveЭто событие происходит, когда указатель мыши перемещается над элементом.MouseEvent
mouseoverЭто событие происходит, когда указатель мыши перемещается на элемент или один из его подэлементов.MouseEvent
mouseoutЭто событие происходит, когда указатель мыши выходит из элемента или одного из его подэлементов.MouseEvent
mouseupЭто событие происходит при отпускании кнопки мыши на элементе.MouseEvent
mousewheelНе рекомендуется использовать.Использование的事件 wheel не рекомендуется.WheelEvent
offlineЭто событие происходит при начале работы браузера в офлайн-режиме.Событие
onlineЭто событие происходит при начале работы браузера в онлайн-режиме.Событие
openЭто событие происходит при открытии соединения с источником события.Событие
pagehideЭто событие происходит, когда пользователь покидает навигацию по странице.PageTransitionEvent
Появление страницыЭто событие происходит при навигации пользователя по веб-странице.PageTransitionEvent
pasteЭто событие происходит, когда пользователь вставляет содержимое в элемент.ClipboardEvent
pauseЭто событие происходит, когда пользователь или программно приостанавливает媒体.Событие
playЭто событие происходит, когда媒体已经开始 или больше не приостановлен.Событие
playingЭто событие происходит при воспроизведении媒体的 после приостановки или остановки буферизации.Событие
popstateЭто событие происходит при изменении истории окна.PopStateEvent
progressЭто событие происходит, когда браузер получает данные媒体 (загружает媒体).Событие
ratechangeЭто событие происходит при изменении скорости воспроизведения媒体的.Событие
resizeЭто событие происходит при изменении размера документа.UiEvent, Event
resetЭто событие происходит при сбросе формы.Событие
scrollСобытие происходит при прокрутке полосы прокрутки элемента.UiEvent, Event
searchЭто событие происходит, когда пользователь вводит содержимое в поле поиска (для <input="search">).Событие
seekedЭто событие происходит, когда пользователь завершает передвижение/перепрыгивание к новому положению в媒体.Событие
seekingЭто событие происходит, когда пользователь начинает передвигаться/перепрыгивать к новому положению в媒体.Событие
selectПользователь выбирает некоторый текст (для <input> и <textarea>) после чего происходит это событие.UiEvent, Event
showЭто событие occurs, когда элемент <menu> отображается как контекстное менюСобытие
stalledЭто событие occurs, когда браузер пытается получить данные媒体的, но данные недоступныСобытие
storageЭто событие occurs при обновлении области Web-хранилищаStorageEvent
submitЭто событие occurs при отправке формыСобытие
suspendЭто событие occurs, когда браузер намеренно не загружает данные媒体的Событие
timeupdateЭто событие occurs, когда изменяется позиция воспроизведения (например, когда пользователь быстро перебирается к другому месту в媒体)Событие
toggleЭто событие occurs, когда пользователь открывает или закрывает элемент <details>Событие
touchcancelЭто событие occurs, когда触摸 прерванTouchEvent
touchendЭто событие occurs, когда палец удаляется с экранаTouchEvent
touchmoveЭто событие occurs, когда палец тянется по экрануTouchEvent
touchstartЭто событие occurs, когда палец放在 экранеTouchEvent
transitionendЭто событие occurs, когда завершается CSS-транзит.TransitionEvent
unloadЭто событие occurs, когда документ или зависимые ресурсы будут отключеныUiEvent, Event
volumechangeЭто событие occurs, когда изменяется громкость媒体的 (включая установку громкости в «тихо»)Событие
waitingЭто событие occurs, когда媒体 приостановлен, но ожидается, что он будет восстановлен (например, когда媒体 приостанавливается для буферизации дополнительных данных)Событие
wheelЭто событие occurs, когда колеса мыши прокручивается вверх или вниз по элементуWheelEvent

Свойства HTML DOM событий

В таблице ниже перечислены свойства DOM событий:

СвойстваОписаниеТип события
altKeyВозвратит, был ли нажат клавиша «ALT» при вызове события мышиMouseEvent
altKeyВозвратит, был ли нажат клавиша «ALT» при вызове клавишного событияKeyboardEvent, TouchEvent
animationNameВозвратит имя анимацииAnimationEvent
bubblesВозвратит, является ли конкретное событие событием бубнежаСобытие
buttonВозвращает нажатую кнопку мыши при возникновении события мыши.MouseEvent
buttonsВозвращает нажатую кнопку мыши при возникновении события мыши.MouseEvent
cancelableВозвратит, можно ли предотвратить выполнение стандартной операции событияСобытие
charCodeВозвратит Unicode код символа клавиши, которая вызвала событие onkeypressKeyboardEvent
changeTouchesВозвратит список всех объектов касания, чье состояние изменилось между последним касанием и текущимTouchEvent
clientXВозвратит горизонтальную координату указателя мыши относительно текущего окна при вызове события мышиMouseEvent, TouchEvent
clientYВозвратит вертикальную координату указателя мыши относительно текущего окна при вызове события мышиMouseEvent, TouchEvent
clipboardDataВозвращает объект, который содержит данные,受到影响 от операций с буфером обменаClipboardData
кодВозвратит код клавиши, которая вызвала событиеKeyboardEvent
composerВозвратит, является ли событие составнымСобытие
ctrlKeyВозвратит, был ли нажат клавиша «CTRL» при вызове события мышиMouseEvent
ctrlKeyВозврат флага, указывающего, был ли нажат клавиша 'CTRL'KeyboardEvent, TouchEvent
currentTargetВозврат элемента, который вызвал событие у его слушателяСобытие
dataВозврат вставленного символаInputEvent
dataTransferВозврат объекта, содержащего данные для drag/drop или вставки/удаленияDragEvent, InputEvent
defaultPreventedВозврат флага, указывающего, был ли вызван метод preventDefault() для событияСобытие
deltaXВозврат горизонтального приращения скролла мыши (по оси X)WheelEvent
deltaYВозврат вертикального приращения скролла мыши (по оси Y)WheelEvent
deltaZВозврат приращения скролла мыши по Z-осиWheelEvent
deltaModeВозврат числа, показывающего размер единицы измерения приращения (пиксели, строки или страницы)WheelEvent
detailВозврат числа, показывающего, сколько раз был щелчком мышиUiEvent
elapsedTimeВозврат секунд, проведенных в анимацииAnimationEvent
elapsedTimeВозврат секунд, проведенных в транзите 
eventPhaseВозврат текущей фазы оценки потока событийСобытие
inputTypeВозврат типа изменения (например, 'вставка' или 'удаление')InputEvent
isComposingВозврат флага, указывающего, находится ли состояние события в процессе составленияInputEvent, KeyboardEvent
isTrustedВозврат флага, указывающего, является ли событие довереннымСобытие
keyВозврат значения клавиши, которую представляет событиеKeyboardEvent
keyВозврат ключа измененного значения хранимой в памятиitemStorageEvent
keyCodeВозвращает код Unicode символа клавиши, который вызвал событие onkeypress, или код Unicode клавиши клавиши, которая вызывала событие onkeydown или onkeyup.KeyboardEvent
locationВозврат позиции клавиши на клавиатуре или устройствеKeyboardEvent
lengthComputableВозврат флага, указывающего, можно ли вычислить длину прогрессаProgressEvent
loadedВозврат количества работы, уже загруженнойProgressEvent
metaKeyВозврат флага, указывающего, был ли нажат клавиша 'META'MouseEvent
metaKeyВозврат флага, указывающего, был ли нажат клавиша 'meta'KeyboardEvent, TouchEvent
MovementXВозврат горизонтальной координаты мыши относительно предыдущего события mousemoveMouseEvent
MovementYВозврат вертикальной координаты мыши относительно предыдущего события mousemoveMouseEvent
newValueВозврат нового значения хранимой в памятиitem, изменившегосяStorageEvent
newURLВозврат URL документа после изменения хэш-значенияHasChangeEvent
offsetXВозврат горизонтальной координаты мыши относительно края целевого элементаMouseEvent
offsetYВозврат вертикальной координаты мыши относительно края целевого элементаMouseEvent
oldValueВозврат старого значения хранимой в памятиitem, изменившегосяStorageEvent
oldURLВозврат URL документа до изменения хэш-значенияHasChangeEvent
onemptiedЭто событие occurs, когда происходит不良 ситуация и медиафайл внезапно становится недоступным (например, неожиданное разрывное соединение). 
pageXВозвращает горизонтальную координату курсора мыши относительно документа при возникновении события.MouseEvent
pageYВозвращает вертикальную координату курсора мыши относительно документа при возникновении события.MouseEvent
persistedВозвращает, был ли веб-страница сохранена в кэше браузера.PageTransitionEvent
propertyNameВозвращает имя CSS-свойства, связанного с анимацией или переходом.AnimationEvent, TransitionEvent
pseudoElementВозвращает имя псевдоэлемента анимации или перехода.AnimationEvent, TransitionEvent
region
MouseEvent
relatedTargetВозвращает элемент, связанный с элементом, который вызвал событие мыши.MouseEvent
relatedTargetВозвращает элемент, связанный с элементом, который вызвал событие.FocusEvent
repeatВозвращает, повторяется ли нажатие某个 клавиши.KeyboardEvent
screenXВозвращает горизонтальную координату курсора мыши относительно экрана при возникновении события.MouseEvent
screenYВозвращает вертикальную координату курсора мыши относительно экрана при возникновении события.MouseEvent
shiftKeyВозвращает, нажата ли клавиша «SHIFT» при возникновении события.MouseEvent
shiftKeyВозвращает, нажата ли клавиша «SHIFT» при возникновении события клавиатуры.KeyboardEvent, TouchEvent
stateВозвращает объект, содержащий копию записи истории.PopStateEvent
storageAreaВозвращает объект, представляющийaffected storage object.StorageEvent
targetВозвращает элемент, который вызвал событие.Событие
targetTouchesВозвращает список всех объектов касания, которые соприкасаются с поверхностью и touchstart событие происходит на элементе-мишени, который в настоящее время является целевым элементом.TouchEvent
timeStampВозвращает время создания события (в миллисекундах по отношению к эре).Событие
totalВозвращает общее количество работы, которая будет загружена.ProgressEvent
touchesВозвращает список всех объектов касания, которые в настоящее время контактируют с поверхностью.TouchEvent
transitionendЭто событие occurs, когда завершается CSS-транзит.TransitionEvent
typeВозвращает имя события.Событие
urlВозвращает URL документа, изменившегося.StorageEvent
whichВозвращает нажатую кнопку мыши при возникновении события мыши.MouseEvent
whichВозвращает код Unicode символа клавиши, который вызвал событие onkeypress, или код Unicode клавиши клавиши, которая вызывала событие onkeydown или onkeyup.KeyboardEvent
viewВернуть ссылку на окно, в котором произошло событиеUiEvent

Методы событий HTML DOM

В таблице ниже перечислены методы событий DOM:

МетодОписаниеТип события
createEvent()Создать новый事件Событие
getTargetRanges()Вернуть массив, содержащий диапазон целевых значений, которые будут затронуты вставкой/удалениемInputEvent
getModifierState()Вернуть массив, содержащий диапазон целевых значений, которые будут затронуты вставкой/удалениемMouseEvent
preventDefault()Предотвратить выполнение выбранного элемента по умолчанию браузеромСобытие
stopImmediatePropagation()Предотвратить вызов других слушателей событияСобытие
stopPropagation()Предотвратить дальнейшее распространение события в потоке событийСобытие

См. также

Учебник Javascript:События Javascript

Учебник Javascript:Слушатель событий

Учебник Javascript:Распространение событий