ondragEvent

事件对象参考手册Event Object

Example

Execute JavaScript when the <p> element starts to be dragged:

<p draggable="true" ondrag="myFunction(event)">Drag me!</p>

Try it Yourself »

More examples are included at the bottom of this article.


Definition and Usage

The ondrag event is triggered when an element or selected text is being dragged.

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 HTML5draggableattribute.

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 triggered on the drag target(source element):
    • ondragstart- Fired when the user starts dragging an element
    • ondrag - Fired while the element is being dragged
    • ondragend- Fired after the user completes dragging the element

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

Note:The ondrag event is triggered every 350 milliseconds while an element is being dragged.


Browser Support

The numbers in the table specify the first browser version that fully supports the event.

Event
ondrag 4.0 9.0 3.5 6.0 12.0


Syntax

In HTML:

<element ondrag="myScript">Try it Yourself

In JavaScript:

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

In JavaScript, using the addEventListener() method:

object.addEventListener("drag", 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 drag and drop events:

/* Triggered 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 the p element is dragged
document.getElementById("demo").innerHTML = "Start dragging the p element.";
// Modify 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 is done being dragged, output some text and reset the opacity
document.addEventListener("dragend", function(event) {
document.getElementById("demo").innerHTML = "Completed dragging the p element";
    event.target.style.opacity = "1";
});
/* Triggered after the drag is completed */
// When the p element is dragged into the droptarget, change the div's border style
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 element's default handling
document.addEventListener("dragover", function(event) {
    event.preventDefault();
});
// When the draggable p element leaves the droptarget, reset the div's border style
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 get 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