Element: mouseup event

BaselineWidely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers sinceJuly 2015.

Themouseupevent is fired at anElementwhen a button on a pointing device (such as a mouse or trackpad) is released while the pointer is located inside it.

mouseupevents are the counterpoint tomousedownevents.

Syntax

Use the event name in methods likeaddEventListener(),or set an event handler property.

js
addEventListener("mouseup",(event)=>{});

onmouseup=(event)=>{};

Event type

Event properties

This interface also inherits properties of its parents,UIEventandEvent.

MouseEvent.altKeyRead only

Returnstrueif thealtkey was down when the mouse event was fired.

MouseEvent.buttonRead only

The button number that was pressed (if applicable) when the mouse event was fired.

MouseEvent.buttonsRead only

The buttons being pressed (if any) when the mouse event was fired.

MouseEvent.clientXRead only

The X coordinate of the mouse pointer inviewport coordinates.

MouseEvent.clientYRead only

The Y coordinate of the mouse pointer inviewport coordinates.

MouseEvent.ctrlKeyRead only

Returnstrueif thecontrolkey was down when the mouse event was fired.

MouseEvent.layerX Non-standard Read only

Returns the horizontal coordinate of the event relative to the current layer.

MouseEvent.layerY Non-standard Read only

Returns the vertical coordinate of the event relative to the current layer.

MouseEvent.metaKeyRead only

Returnstrueif themetakey was down when the mouse event was fired.

MouseEvent.movementXRead only

The X coordinate of the mouse pointer relative to the position of the lastmousemoveevent.

MouseEvent.movementYRead only

The Y coordinate of the mouse pointer relative to the position of the lastmousemoveevent.

MouseEvent.offsetXRead only

The X coordinate of the mouse pointer relative to the position of the padding edge of the target node.

MouseEvent.offsetYRead only

The Y coordinate of the mouse pointer relative to the position of the padding edge of the target node.

MouseEvent.pageXRead only

The X coordinate of the mouse pointer relative to the whole document.

MouseEvent.pageYRead only

The Y coordinate of the mouse pointer relative to the whole document.

MouseEvent.relatedTargetRead only

The secondary target for the event, if there is one.

MouseEvent.screenXRead only

The X coordinate of the mouse pointer inscreen coordinates.

MouseEvent.screenYRead only

The Y coordinate of the mouse pointer inscreen coordinates.

MouseEvent.shiftKeyRead only

Returnstrueif theshiftkey was down when the mouse event was fired.

MouseEvent.mozInputSource Non-standard Read only

The type of device that generated the event (one of theMOZ_SOURCE_*constants). This lets you, for example, determine whether a mouse event was generated by an actual mouse or by a touch event (which might affect the degree of accuracy with which you interpret the coordinates associated with the event).

MouseEvent.webkitForce Non-standard Read only

The amount of pressure applied when clicking.

MouseEvent.xRead only

Alias forMouseEvent.clientX.

MouseEvent.yRead only

Alias forMouseEvent.clientY.

Examples

Seemousemoveeventfor example code.

Specifications

Specification
UI Events
#event-type-mouseup
HTML Standard
#handler-onmouseup

Browser compatibility

BCD tables only load in the browser

See also