HTMLElement: dragenter event
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("HTML Drag and Drop API")}}
The dragenter event is fired when a dragged element or text selection enters a valid drop target. The target object is the _immediate user selection_ (the element directly indicated by the user as the drop target), or the {{HTMLElement("body")}} element.
This event is cancelable and may bubble up to the {{domxref("Document")}} and {{domxref("Window")}} objects.
Syntax
Use the event name in {{domxref("EventTarget/addEventListener", "addEventListener()")}}:
addEventListener("dragenter", (event) => { })Alternatively, assign to the event handler property of the interface:
ondragenter = (event) => { }Event type
A {{domxref("DragEvent")}}. Inherits from {{domxref("Event")}}.
{{InheritanceDiagram("DragEvent")}}
Examples
Styling drop zones on dragenter
In this example, we have a draggable element inside a container. Try grabbing the element, dragging it over the other container, and releasing it.
We listen for the dragenter event to give the other container a purple background while the draggable element is over it to signal that the draggable element could be dropped onto the container.
However, in this partial example, we haven't implemented dropping: for a complete example of drag and drop, see the page for the [drag](/en-US/docs/Web/API/HTMLElement/drag_event) event.
HTML
<div class="dropzone">
<div id="draggable" draggable="true">This div is draggable</div>
</div>
<div class="dropzone" id="drop-target"></div>CSS
body {
/* Prevent the user from 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;
}
.dropzone.dragover {
background-color: purple;
}JavaScript
const target = document.getElementById("drop-target");
target.addEventListener("dragenter", (event) => {
// highlight potential drop target when the draggable element enters it
if (event.target.classList.contains("dropzone")) {
event.target.classList.add("dragover");
}
});
target.addEventListener("dragleave", (event) => {
// reset background of potential drop target when the draggable element leaves it
if (event.target.classList.contains("dropzone")) {
event.target.classList.remove("dragover");
}
});Result
{{EmbedLiveSample('Styling drop zones on dragenter')}}
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- Other drag and drop events:
- {{domxref("HTMLElement/drag_event", "drag")}}
- {{domxref("HTMLElement/dragstart_event", "dragstart")}}
- {{domxref("HTMLElement/dragend_event", "dragend")}}
- {{domxref("HTMLElement/dragover_event", "dragover")}}
- {{domxref("HTMLElement/dragleave_event", "dragleave")}}
- {{domxref("HTMLElement/drop_event", "drop")}}