The mouseout
event is fired at an Element
when a pointing device (usually a mouse) is used to move the cursor so that it is no longer contained within the element or one of its children. mouseout
is also delivered to an element if the cursor enters a child element, because the child element obscures the visible area of the element.
Bubbles | Yes |
Cancelable | Yes |
Interface | MouseEvent
|
Event handler property | onmouseout
|
Examples
The following examples show the use of the mouseout
event.
mouseout and mouseleave
The following example illustrates the difference between mouseout
and mouseleave
events. The mouseleave
event is added to the <ul>
to color the list purple whenever the mouse exits the <ul>
. mouseout
is added to the list to color the targeted element orange when the mouse exits it.
When you try this out, you'll find that mouseout
is delivered to the individual list items, while mouseleave
goes to the overall list, courtesy of the hierarchy of the items and the fact that list items obscure the underlying <ul>
.
HTML
<ul id="test">
<li>item 1</li>
<li>item 2</li>
<li>item 3</li>
</ul>
JavaScript
let test = document.getElementById("test");
// Briefly make the list purple when the mouse moves off the
// <ul> element
test.addEventListener("mouseleave", function( event ) {
// highlight the mouseleave target
event.target.style.color = "purple";
// reset the color after a short delay
setTimeout(function() {
event.target.style.color = "";
}, 1000);
}, false);
// Briefly make an <li> orange when the mouse moves off of it
test.addEventListener("mouseout", function( event ) {
// highlight the mouseout target
event.target.style.color = "orange";
// reset the color after a short delay
setTimeout(function() {
event.target.style.color = "";
}, 500);
}, false);
Result
Specifications
Specification
Status
UI EventsThe definition of 'mouseout' in that specification.
Working Draft
Obsolete
Browser compatibility
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
mouseout event
|
Chrome
Full support Yes |
Edge
Full support 12 |
Firefox
Full support Yes |
IE
Full support Yes |
Opera
Full support Yes |
Safari
Full support Yes |
WebView Android
Full support Yes |
Chrome Android
Full support Yes |
Firefox Android
Full support Yes |
Opera Android
Full support Yes |
Safari iOS
Full support Yes |
Samsung Internet Android
Full support Yes |
Legend
- Full support
- Full support
See also
- [[../../../../Learn/JavaScript/Building_blocks/Events|Introduction to events]]
mousedown
mouseup
mousemove
click
dblclick
mouseover
mouseenter
mouseleave
contextmenu
Element: mouseout event by Mozilla Contributors is licensed under CC-BY-SA 2.5.