HTMLElement: dragover event
The dragover
event is fired when an element or text selection is being dragged over a valid drop target (every few hundred milliseconds).
The event is fired on the drop target(s).
Syntax
Use the event name in methods like addEventListener()
, or set an event handler property.
js
addEventListener("dragover", (event) => {});
ondragover = (event) => {};
Event type
Event properties
In addition to the properties listed below, properties from the parent interface, Event
, are available.
DragEvent.dataTransfer
Read only-
The data that is transferred during a drag and drop interaction.
Examples
A minimal drag and drop example
In this example, we have a draggable element inside a container. Try grabbing the element, dragging it over the other container, and then releasing it.
We use three event handlers here:
- in the
dragstart
event handler, we get a reference to the element that the user dragged - in the
dragover
event handler for the target container, we callevent.preventDefault()
, which enables it to receivedrop
events. - in the
drop
event handler for the drop zone, we handle moving the draggable element from the original container to the drop zone.
For a more complete example of drag and drop, see the page for the drag
event.
HTML
html
<div class="dropzone">
<div id="draggable" draggable="true">This div is draggable</div>
</div>
<div class="dropzone" id="droptarget"></div>
CSS
css
body {
/* Prevent the user selecting text in the example */
user-select: none;
}
#draggable {
text-align: center;
background: white;
}
.dropzone {
width: 200px;
height: 20px;
background: blueviolet;
margin: 10px;
padding: 10px;
}
JavaScript
js
let dragged = null;
const source = document.getElementById("draggable");
source.addEventListener("dragstart", (event) => {
// store a ref. on the dragged elem
dragged = event.target;
});
const target = document.getElementById("droptarget");
target.addEventListener("dragover", (event) => {
// prevent default to allow drop
event.preventDefault();
});
target.addEventListener("drop", (event) => {
// prevent default action (open as link for some elements)
event.preventDefault();
// move dragged element to the selected drop target
if (event.target.className === "dropzone") {
dragged.parentNode.removeChild(dragged);
event.target.appendChild(dragged);
}
});
Result
Specifications
Specification |
---|
HTML Standard # ix-handler-ondragover |
HTML Standard # event-dnd-dragover |
Browser compatibility
BCD tables only load in the browser