ondropEvent

事件对象参考手册Event Object

Example

Execute JavaScript when a draggable element is placed in a <div> element:

<div ondrop="myFunction(event)"></div>

Try it Yourself »

More examples are included at the bottom of this article.


Definition and Usage

The ondrop event is triggered when a draggable element or selected text is dropped on the target area.

Drag and drop is a very common feature in HTML5. For more information, see our HTML tutorial onHTML5 Drag and Drop。

Note:To make an element draggable, you need to use the HTML5draggabledraggable attribute.

Tip:Links and images are draggable by default, and do not need the draggable attribute.

The following events are triggered during the drag and drop process:

  • Events fired on the drag target(source element):
    • ondragstart- Fired when the user starts dragging an element
    • ondrag- Fired while an element is being dragged
    • ondragend- Fired when the user finishes dragging an element

  • Events fired on the drop target:
    • ondragenter- This event is fired when the dragged object enters its container range
    • ondragover- This event is fired when a dragged object is dragged within the range of another object's container
    • ondragleave- This event is fired when the dragged object leaves its container range
    • ondrop - This event is fired when the mouse button is released during a drag operation

Browser Support

Note:While dragging an element, the ondragover event is fired every 350 milliseconds.

Event
ondrop 4.0 9.0 3.5 6.0 12.0


Syntax

In HTML:

<element ondrop="myScript">Try it Yourself

In JavaScript:

object.ondrop=function(){myScript};Try it Yourself

In JavaScript, using the addEventListener() method:

object.addEventListener("drop", myScript);Try it Yourself

Note:Internet Explorer 8 and earlier IE versions do not support theaddEventListener()method.


Technical Details
Bubbles: Yes
Cancelable: Yes
Event type: DragEvent
Supported HTML tags: All HTML elements


Examples

More Examples

Example

The following example demonstrates all the drag and drop events:

/* Fired when dragging */
document.addEventListener("dragstart", function(event) {
//The dataTransfer.setData() method sets the data type and the dragged data
    event.dataTransfer.setData("Text", event.target.id);
// Output some text when dragging the p element
document.getElementById("demo").innerHTML = "Started to drag the p element.";
// Change the opacity of the dragged element
    event.target.style.opacity = "0.4";
});
// While dragging the p element, change the color of the output text
document.addEventListener("drag", function(event) {
    document.getElementById("demo").style.color = "red";
});
// When the p element has been dragged, output some text and reset the opacity
document.addEventListener("dragend", function(event) {
document.getElementById("demo").innerHTML = "Finished dragging the p element";
    event.target.style.opacity = "1";
});
/* Fired after the drag is completed */
// When the p element is dragged into droptarget, change the border style of the div
document.addEventListener("dragenter", function(event) {
    if ( event.target.className == "droptarget" ) {
        event.target.style.border = "3px dotted red";
    }
});
// By default, data/elements cannot be dropped in other elements. For drop, we must prevent the default handling of the element
document.addEventListener("dragover", function(event) {
    event.preventDefault();
});
// When the draggable p element leaves droptarget, reset the border style of the div
document.addEventListener("dragleave", function(event) {
    if ( event.target.className == "droptarget" ) {
        event.target.style.border = "";
    }
});
/* For drop, prevent the browser's default handling of data (links are opened by default on drop)
Reset the color of the output text and the border color of the DIV
Use the dataTransfer.getData() method to obtain the dragged data
The dragged data element id ("drag1")
Append the dragged element to the drop element*/
document.addEventListener("drop", function(event) {
    event.preventDefault();
    if ( event.target.className == "droptarget" ) {
        document.getElementById("demo").style.color = "";
        event.target.style.border = "";
        var data = event.dataTransfer.getData("Text");
        event.target.appendChild(document.getElementById(data));
    }
});

Try it Yourself »


Related Pages

HTML Tutorial:HTML5 Drag and Drop

HTML Reference Manual:HTML draggable Attribute


事件对象参考手册Event Object Other Extensions