ondragEreignis

事件对象参考手册Event-Objekt

Beispiel

JavaScript ausführen, wenn das Ziehen des <p>-Elements beginnt:

<p draggable="true" ondrag="myFunction(event)">Zieh mich!</p>

Selbst ausprobieren »

Weitere Beispiele finden Sie am Ende dieses Artikels.


Definition und Verwendung

Das ondrag-Ereignis wird ausgelöst, wenn ein Element oder ausgewählter Text gezogen wird.

Drag and Drop ist eine sehr verbreitete Funktion in HTML5. Weitere Informationen finden Sie in unserem HTML-Tutorial zuHTML5 Drag and Drop。

Hinweis:Um ein Element ziehbar zu machen, müssen Sie das HTML5-draggable-Attribut verwenden.

Tipp:Links und Bilder sind standardmäßig ziehbar und benötigen nicht das draggable-Attribut.

Die folgenden Ereignisse werden während des Drag-and-Drop-Vorgangs ausgelöst:

  • Ereignisse, die am Drag-Ziel ausgelöst werden(Quellelement):
    • ondragstart- Wird ausgelöst, wenn der Benutzer beginnt, ein Element zu ziehen
    • ondrag - Wird ausgelöst, während das Element gezogen wird
    • ondragend- Wird ausgelöst, nachdem der Benutzer das Ziehen des Elements abgeschlossen hat

  • Auf dem Drop-Ziel ausgelöste Ereignisse:
    • ondragenter- Dieses Ereignis wird ausgelöst, wenn ein gezogenes Objekt den Bereich seines Containers betritt
    • ondragover- Dieses Ereignis wird ausgelöst, wenn ein gezogenes Objekt innerhalb des Bereichs des Containers eines anderen Objekts gezogen wird
    • ondragleave- Dieses Ereignis wird ausgelöst, wenn ein gezogenes Objekt den Bereich seines Containers verlässt
    • ondrop- Dieses Ereignis wird ausgelöst, wenn die Maustaste während eines Ziehvorgangs losgelassen wird

Hinweis:Das ondrag-Ereignis wird alle 350 Millisekunden ausgelöst, während ein Element gezogen wird.


Browser-Unterstützung

Die Zahlen in der Tabelle geben die erste Browserversion an, die das Ereignis vollständig unterstützt.

Ereignis
ondrag 4.0 9.0 3.5 6.0 12.0


Syntax

In HTML:

<element ondrag="myScript">Probieren Sie es selbst

In JavaScript:

object.ondrag=function(){myScript};Probieren Sie es selbst

In JavaScript unter Verwendung der addEventListener()-Methode:

object.addEventListener("drag", myScript);Probieren Sie es selbst

Hinweis:Internet Explorer 8 und frühere IE-Versionen unterstützen dieaddEventListener()Methode nicht.


Technische Details
Blubbert: Ja
Abbrechbar: Ja
Ereignistyp: DragEvent
Unterstützte HTML-Tags: Alle HTML-Elemente


Examples

Weitere Beispiele

Beispiel

Das folgende Beispiel demonstriert alle Drag-and-Drop-Ereignisse:

/* Wird beim Ziehen ausgelöst */
document.addEventListener("dragstart", function(event) {
// Die Methode dataTransfer.setData() legt den Datentyp und die gezogenen Daten fest
    event.dataTransfer.setData("Text", event.target.id);
// Etwas Text ausgeben, wenn das p-Element gezogen wird
document.getElementById("demo").innerHTML = "Beginnen Sie, das p-Element zu ziehen.";
// Die Deckkraft des gezogenen Elements ändern
    event.target.style.opacity = "0.4";
});
// Die Farbe des Ausgabetexts ändern, während das p-Element gezogen wird
document.addEventListener("drag", function(event) {
    document.getElementById("demo").style.color = "red";
});
// Wenn das Ziehen des p-Elements beendet ist, etwas Text ausgeben und die Deckkraft zurücksetzen
document.addEventListener("dragend", function(event) {
document.getElementById("demo").innerHTML = "Das Ziehen des p-Elements wurde abgeschlossen.";
    event.target.style.opacity = "1";
});
/* Wird ausgelöst, nachdem das Ziehen abgeschlossen ist */
// Wenn das p-Element in das droptarget gezogen wird, ändere den Rahmenstil des div.
document.addEventListener("dragenter", function(event) {
    if ( event.target.className == "droptarget" ) {
        event.target.style.border = "3px dotted red";
    }
});
// Standardmäßig können Daten/Elemente nicht in andere Elemente abgelegt werden. Zum Ablegen müssen wir das Standardverhalten des Elements verhindern.
document.addEventListener("dragover", function(event) {
    event.preventDefault();
});
// Wenn das ziehbare p-Element das droptarget verlässt, setze den Rahmenstil des div zurück.
document.addEventListener("dragleave", function(event) {
    if ( event.target.className == "droptarget" ) {
        event.target.style.border = "";
    }
});
/* Beim Drop: Verhindern Sie die Standardbehandlung von Daten durch den Browser (Links werden standardmäßig beim Drop geöffnet)
Farbe des Ausgabetexts und Rahmenfarbe des DIV zurücksetzen
Verwenden Sie die Methode dataTransfer.getData(), um die gezogenen Daten abzurufen
Die ID des gezogenen Datenelements ("drag1")
Das gezogene Element an das Drop-Element anhängen*/
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));
    }
});

Selbst ausprobieren »


Verwandte

HTML-Tutorial:HTML5 Drag and Drop

HTML-Referenzhandbuch:HTML-Attribut draggable


事件对象参考手册Event-Objekt Weitere Erweiterungen