DOM event reference

  • Revision slug: DOM/DOM_event_reference
  • Revision title: DOM event reference
  • Revision id: 6257
  • Created:
  • Creator: Masayuki
  • Is current revision? No
  • Comment 3 words added, 3 words removed

Revision Content

{{ draft() }}

Following events can be captured by adding event handlers by calling a DOM element's {{ domxref("element.addEventListener()") }} method.

Note: This page needs content, and the child pages need filling out.

DOM events

Event name Event type Description
{{ domevent("DOMActivate") }}   Specification: W3C Draft
{{ domevent("DOMAttrModified") }} {{ domxref("MutationEvent") }} Specification: W3C Draft
{{ domevent("DOMAttributeNameChanged") }} {{ domxref("MutationEvent") }} Specification: W3C Draft
{{ domevent("DOMCharacterDataModified") }} {{ domxref("MutationEvent") }} Specification: W3C Draft
{{ domevent("DOMContentLoaded") }} ? Specification: HTML5
{{ domevent("DOMElementNameChanged") }} {{ domxref("MutationEvent") }} Specification: W3C Draft
{{ domevent("DOMFocusIn") }}   Specification: W3C Draft
{{ domevent("DOMFocusOut") }}   Specification: W3C Draft
{{ domevent("DOMNodeInserted") }} {{ domxref("MutationEvent") }} Specification: W3C Draft
{{ domevent("DOMNodeInsertedIntoDocument") }} {{ domxref("MutationEvent") }} Specification: W3C Draft
{{ domevent("DOMNodeRemoved") }} {{ domxref("MutationEvent") }} Specification: W3C Draft
{{ domevent("DOMNodeRemovedFromDocument") }} {{ domxref("MutationEvent") }} Specification: W3C Draft {{ deprecated_inline() }}
{{ domevent("DOMSubtreeModified") }} {{ domxref("MutationEvent") }} A general event for notifications of any changes to the document. Specification: (W3C Draft) {{ deprecated_inline() }}
{{ domevent("abort") }}   Fired when the user abort the download of a resource.
{{ domevent("afterprint") }}   Fired after printing a document has finished. See Detecting print requests for an example. {{ gecko_minversion_inline("6.0") }} {{ non-standard_inline() }}
{{ domevent("beforeprint") }}   Fired before printing of a document begins. See Detecting print requests for an example. {{ gecko_minversion_inline("6.0") }} {{ non-standard_inline() }}
{{ domeventxref("beforeunload") }}   IE-specific. Fired before a resource is unloaded (while unload is fired afterward)
{{ domevent("blur") }} {{ domxref("FocusEvent") }} Fired when an element target loses focus.
{{ domevent("click") }} {{ domxref("MouseEvent") }} Specification: W3C Draft
{{ domeventxref("compositionend") }} {{ domxref("CompositionEvent") }} Specification: W3C Draft {{ gecko_minversion_inline("9.0") }}
{{ domeventxref("compositionstart") }} {{ domxref("CompositionEvent") }} Specification: W3C Draft {{ gecko_minversion_inline("9.0") }}
{{ domeventxref("compositionupdate") }} {{ domxref("CompositionEvent") }} Specification: W3C Draft {{ gecko_minversion_inline("9.0") }}
{{ domevent("dblclick") }} {{ domxref("MouseEvent") }} Specification: W3C Draft
{{ domeventxref("error") }} {{ domxref("UIEvent") }} Fired when a resource fails to load (network error, script execution error, etc.)
{{ domevent("focus") }} {{ domxref("FocusEvent") }} Fired when an element receives focus.
{{ domevent("focusin") }} {{ domxref("FocusEvent") }} Fired when an event target is about to receive focus but before the focus is shifted. This event occurs right before the focus event.
{{ domevent("focusout") }} {{ domxref("FocusEvent") }} Fired when an event target is about to loose focus but before the focus is shifted. This is fired right before the blur event.
{{ domevent("keydown") }} {{ domxref("KeyboardEvent") }} Fired when a key is initially pressed. This is sent after any key mapping is performed, but before any input method editors receive the keypress. This is sent for any key, even if it doesn't generate a character code.
{{ domevent("keypress") }} {{ domxref("KeyboardEvent") }}

Fired when a key is initially pressed, but only if that key normally produces a character value. This is sent after any key mapping is performed, but before any input method editors receive the keypress.

Note: This is sent in addition to, not instead of, the {{ domevent("keydown") }} event.

This event has been deprecated in favor of {{ domevent("textinput") }}.

{{ domevent("keyup") }} {{ domxref("KeyboardEvent") }} Fired when a key is released. This is sent after any key mapping is performed, and always follows the corresponding {{ domevent("keydown") }} and {{ domevent("keypress") }} events.
{{ domevent("load") }} {{ domxref("UIEvent") }} Fired when the resource (document, element, defaultView) and depending resources (images, script downloading and execution, css loading, etc.) are loaded.
{{ domevent("mousedown") }} {{ domxref("MouseEvent") }} Specification: W3C Draft
{{ domeventxref("mouseenter") }} {{ domxref("MouseEvent") }} Fired when entering an element or any of its descendants. Specification: W3C Draft
{{ domeventxref("mouseleave") }} {{ domxref("MouseEvent") }} Fired when leaving an element and all of its descendants. Specification: W3C Draft
{{ domevent("mousemove") }} {{ domxref("MouseEvent") }} Specification: W3C Draft
{{ domevent("mouseout") }} {{ domxref("MouseEvent") }} Specification: W3C Draft
{{ domevent("mouseover") }} {{ domxref("MouseEvent") }} Specification: W3C Draft
{{ domevent("mouseup") }} {{ domxref("MouseEvent") }} Specification: W3C Draft
{{ domevent("mozfullscreenchange") }}   Sent to an element when it's granted full-screen mode, or to a document when it leaves full-screen mode.
{{ domevent("offline") }}   Can be used on window, document, or document.body, see Online_and_offline_events. Specification: WHATWG HTML 5 DRAFT {{ gecko_minversion_inline("1.9") }}
{{ domevent("online") }}   Can be used on window, document, or document.body, see Online_and_offline_events. Specification: WHATWG HTML 5 DRAFT {{ gecko_minversion_inline("1.9") }}
{{ domevent("resize") }} {{ domxref("UIEvent") }} Fired when the browser window is resized. May apply to <iframe>s.
{{ domevent("select") }} {{ domxref("UIEvent") }} Fired when a user selects some text
{{ domevent("scroll") }} {{ domxref("UIEvent") }} Fired when a user scrolls a document or an element.
{{ domevent("textinput") }} {{ domxref("TextInput") }} Similar to keypress, except it works with all text input methods and not just keyboards. Pasting text into an input box may also fire this event. Specification: W3C Draft {{ unimplemented_inline() }}
{{ domevent("unload") }} {{ domxref("UIEvent") }} Fired when the resource (document, element, defaultView) or any depending resources (images, css file, etc.) is removed from the environment.

Specifications

DOM Level 3 Events (W3C Working Draft)

See also

{{ languages( { "ja": "ja/DOM/DOM_event_reference" } ) }}

Revision Source

<p>{{ draft() }}</p>
<p>Following events can be captured by adding event handlers by calling a DOM element's {{ domxref("element.addEventListener()") }} method.</p>
<div class="note"><strong>Note:</strong> This page needs content, and the child pages need filling out.</div>
<h2>DOM events</h2>
<table class="standard-table" style="width: auto;"> <tbody> <tr> <td class="header">Event name</td> <td class="header">Event type</td> <td class="header">Description</td> </tr> <tr> <td>{{ domevent("DOMActivate") }}</td> <td> </td> <td>Specification: <a class="external" href="http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMActivate">W3C Draft</a></td> </tr> <tr> <td>{{ domevent("DOMAttrModified") }}</td> <td>{{ domxref("MutationEvent") }}</td> <td>Specification: <a class="external" href="http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMAttrModified">W3C Draft</a></td> </tr> <tr> <td>{{ domevent("DOMAttributeNameChanged") }}</td> <td>{{ domxref("MutationEvent") }}</td> <td>Specification: <a class="external" href="http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMAttributeNameChanged">W3C Draft</a></td> </tr> <tr> <td>{{ domevent("DOMCharacterDataModified") }}</td> <td>{{ domxref("MutationEvent") }}</td> <td>Specification: <a class="external" href="http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMCharacterDataModified">W3C Draft</a></td> </tr> <tr> <td>{{ domevent("DOMContentLoaded") }}</td> <td>?</td> <td>Specification: <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/the-end.html#the-end">HTML5</a></td> </tr> <tr> <td>{{ domevent("DOMElementNameChanged") }}</td> <td>{{ domxref("MutationEvent") }}</td> <td>Specification: <a class="external" href="http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMElementNameChanged">W3C Draft</a></td> </tr> <tr> <td>{{ domevent("DOMFocusIn") }}</td> <td> </td> <td>Specification: <a class="external" href="http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMFocusIn">W3C Draft</a></td> </tr> <tr> <td>{{ domevent("DOMFocusOut") }}</td> <td> </td> <td>Specification: <a class="external" href="http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMFocusOut">W3C Draft</a></td> </tr> <tr> <td>{{ domevent("DOMNodeInserted") }}</td> <td>{{ domxref("MutationEvent") }}</td> <td>Specification: <a class="external" href="http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMNodeInserted">W3C Draft</a></td> </tr> <tr> <td>{{ domevent("DOMNodeInsertedIntoDocument") }}</td> <td>{{ domxref("MutationEvent") }}</td> <td>Specification: <a class="external" href="http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMNodeInsertedIntoDocument">W3C Draft</a></td> </tr> <tr> <td>{{ domevent("DOMNodeRemoved") }}</td> <td>{{ domxref("MutationEvent") }}</td> <td>Specification: <a class="external" href="http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMNodeRemoved">W3C Draft</a></td> </tr> <tr> <td>{{ domevent("DOMNodeRemovedFromDocument") }}</td> <td>{{ domxref("MutationEvent") }}</td> <td>Specification: <a class="external" href="http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMNodeRemovedFromDocument">W3C Draft</a> {{ deprecated_inline() }}</td> </tr> <tr> <td>{{ domevent("DOMSubtreeModified") }}</td> <td>{{ domxref("MutationEvent") }}</td> <td>A general event for notifications of any changes to the document. Specification: (<a class="external" href="http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMSubtreeModified">W3C Draft</a>) {{ deprecated_inline() }}</td> </tr> <tr> <td>{{ domevent("abort") }}</td> <td> </td> <td>Fired when the user abort the download of a resource.</td> </tr> <tr> <td>{{ domevent("afterprint") }}</td> <td> </td> <td>Fired after printing a document has finished. See <a href="/en/Printing#Detecting_print_requests" title="https://developer.mozilla.org/en/Printing#Detecting_print_requests">Detecting print requests</a> for an example. {{ gecko_minversion_inline("6.0") }} {{ non-standard_inline() }}</td> </tr> <tr> <td>{{ domevent("beforeprint") }}</td> <td> </td> <td>Fired before printing of a document begins. See <a href="/en/Printing#Detecting_print_requests" title="https://developer.mozilla.org/en/Printing#Detecting_print_requests">Detecting print requests</a> for an example. {{ gecko_minversion_inline("6.0") }} {{ non-standard_inline() }}</td> </tr> <tr> <td>{{ domeventxref("beforeunload") }}</td> <td> </td> <td>IE-specific. Fired before a resource is unloaded (while unload is fired afterward)</td> </tr> <tr> <td>{{ domevent("blur") }}</td> <td>{{ domxref("FocusEvent") }}</td> <td>Fired when an element target loses focus.</td> </tr> <tr> <td>{{ domevent("click") }}</td> <td>{{ domxref("MouseEvent") }}</td> <td>Specification: <a class="external" href="http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMAttributeNameChanged">W3C Draft</a></td> </tr> <tr> <td>{{ domeventxref("compositionend") }}</td> <td>{{ domxref("CompositionEvent") }}</td> <td>Specification: <a class="external" href="http://dev.w3.org/2006/webapi/DOM-Level-3-Events/html/DOM3-Events.html#event-type-compositionend">W3C Draft</a> {{ gecko_minversion_inline("9.0") }}</td> </tr> <tr> <td>{{ domeventxref("compositionstart") }}</td> <td>{{ domxref("CompositionEvent") }}</td> <td>Specification: <a class="external" href="http://dev.w3.org/2006/webapi/DOM-Level-3-Events/html/DOM3-Events.html#event-type-compositionstart">W3C Draft</a> {{ gecko_minversion_inline("9.0") }}</td> </tr> <tr> <td>{{ domeventxref("compositionupdate") }}</td> <td>{{ domxref("CompositionEvent") }}</td> <td>Specification: <a class="external" href="http://dev.w3.org/2006/webapi/DOM-Level-3-Events/html/DOM3-Events.html#event-type-compositionupdate">W3C Draft</a> {{ gecko_minversion_inline("9.0") }}</td> </tr> <tr> <td>{{ domevent("dblclick") }}</td> <td>{{ domxref("MouseEvent") }}</td> <td>Specification: <a class="external" href="http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMAttributeNameChanged">W3C Draft</a></td> </tr> <tr> <td>{{ domeventxref("error") }}</td> <td>{{ domxref("UIEvent") }}</td> <td>Fired when a resource fails to load (network error, script execution error, etc.)</td> </tr> <tr> <td>{{ domevent("focus") }}</td> <td>{{ domxref("FocusEvent") }}</td> <td>Fired when an element receives focus.</td> </tr> <tr> <td>{{ domevent("focusin") }}</td> <td>{{ domxref("FocusEvent") }}</td> <td>Fired when an event target is about to receive focus but before the focus is shifted. This event occurs right before the focus event.</td> </tr> <tr> <td>{{ domevent("focusout") }}</td> <td>{{ domxref("FocusEvent") }}</td> <td>Fired when an event target is about to loose focus but before the focus is shifted. This is fired right before the blur event.</td> </tr> <tr> <td>{{ domevent("keydown") }}</td> <td>{{ domxref("KeyboardEvent") }}</td> <td>Fired when a key is initially pressed. This is sent after any key mapping is performed, but before any input method editors receive the keypress. This is sent for any key, even if it doesn't generate a character code.</td> </tr> <tr> <td>{{ domevent("keypress") }}</td> <td>{{ domxref("KeyboardEvent") }}</td> <td> <p>Fired when a key is initially pressed, but only if that key normally produces a character value. This is sent after any key mapping is performed, but before any input method editors receive the keypress.</p> <div class="note"><strong>Note:</strong> This is sent in addition to, not instead of, the {{ domevent("keydown") }} event.</div> <p>This event has been deprecated in favor of {{ domevent("textinput") }}.</p> </td> </tr> <tr> <td>{{ domevent("keyup") }}</td> <td>{{ domxref("KeyboardEvent") }}</td> <td>Fired when a key is released. This is sent after any key mapping is performed, and always follows the corresponding {{ domevent("keydown") }} and {{ domevent("keypress") }} events.</td> </tr> <tr> <td>{{ domevent("load") }}</td> <td>{{ domxref("UIEvent") }}</td> <td>Fired when the resource (document, element, defaultView) and depending resources (images, script downloading and execution, css loading, etc.) are loaded.</td> </tr> <tr> <td>{{ domevent("mousedown") }}</td> <td>{{ domxref("MouseEvent") }}</td> <td>Specification: <a class="external" href="http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMAttributeNameChanged">W3C Draft</a></td> </tr> <tr> <td>{{ domeventxref("mouseenter") }}</td> <td>{{ domxref("MouseEvent") }}</td> <td>Fired when entering an element or any of its descendants. Specification: <a class="external" href="http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMAttributeNameChanged">W3C Draft</a></td> </tr> <tr> <td>{{ domeventxref("mouseleave") }}</td> <td>{{ domxref("MouseEvent") }}</td> <td>Fired when leaving an element and all of its descendants. Specification: <a class="external" href="http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMAttributeNameChanged">W3C Draft</a></td> </tr> <tr> <td>{{ domevent("mousemove") }}</td> <td>{{ domxref("MouseEvent") }}</td> <td>Specification: <a class="external" href="http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMAttributeNameChanged">W3C Draft</a></td> </tr> <tr> <td>{{ domevent("mouseout") }}</td> <td>{{ domxref("MouseEvent") }}</td> <td>Specification: <a class="external" href="http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMAttributeNameChanged">W3C Draft</a></td> </tr> <tr> <td>{{ domevent("mouseover") }}</td> <td>{{ domxref("MouseEvent") }}</td> <td>Specification: <a class="external" href="http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMAttributeNameChanged">W3C Draft</a></td> </tr> <tr> <td>{{ domevent("mouseup") }}</td> <td>{{ domxref("MouseEvent") }}</td> <td>Specification: <a class="external" href="http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMAttributeNameChanged">W3C Draft</a></td> </tr> <tr> <td>{{ domevent("mozfullscreenchange") }}</td> <td> </td> <td>Sent to an element when it's granted full-screen mode, or to a document when it leaves full-screen mode.</td> </tr> <tr> <td>{{ domevent("offline") }}</td> <td> </td> <td>Can be used on window, document, or document.body, see <a href="/en/Online_and_offline_events" title="en/Online_and_offline_events">Online_and_offline_events</a>. Specification: <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/#offline">WHATWG HTML 5 DRAFT</a> {{ gecko_minversion_inline("1.9") }}</td> </tr> <tr> <td>{{ domevent("online") }}</td> <td> </td> <td>Can be used on window, document, or document.body, see <a href="/en/Online_and_offline_events" title="en/Online_and_offline_events">Online_and_offline_events</a>. Specification: <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/#offline">WHATWG HTML 5 DRAFT</a> {{ gecko_minversion_inline("1.9") }}</td> </tr> <tr> <td>{{ domevent("resize") }}</td> <td>{{ domxref("UIEvent") }}</td> <td>Fired when the browser window is resized. May apply to &lt;iframe&gt;s.</td> </tr> <tr> <td>{{ domevent("select") }}</td> <td>{{ domxref("UIEvent") }}</td> <td>Fired when a user selects some text</td> </tr> <tr> <td>{{ domevent("scroll") }}</td> <td>{{ domxref("UIEvent") }}</td> <td>Fired when a user scrolls a document or an element.</td> </tr> <tr> <td>{{ domevent("textinput") }}</td> <td>{{ domxref("TextInput") }}</td> <td>Similar to <code>keypress</code>, except it works with all text input methods and not just keyboards. Pasting text into an input box may also fire this event. Specification: <a class="external" href="http://www.w3.org/TR/DOM-Level-3-Events/#event-type-textInput">W3C Draft</a> {{ unimplemented_inline() }}</td> </tr> <tr> <td>{{ domevent("unload") }}</td> <td>{{ domxref("UIEvent") }}</td> <td>Fired when the resource (document, element, defaultView) or any depending resources (images, css file, etc.) is removed from the environment.</td> </tr> </tbody>
</table>
<h2>Specifications</h2>
<p><a class="external" href="http://www.w3.org/TR/DOM-Level-3-Events/">DOM Level 3 Events</a> (W3C Working Draft)</p>
<h2>See also</h2>
<ul> <li><a href="/en/DOM/element#Event_Handlers" title="en/DOM/element#Event_Handlers">Event Handlers</a></li> <li><a href="/en/Gecko-Specific_DOM_Events" title="en/Gecko-Specific_DOM_Events">Gecko-Specific DOM Events</a></li>
</ul>
<p>{{ languages( { "ja": "ja/DOM/DOM_event_reference" } ) }}</p>
Revert to this revision