ondragEreignis
Beispiel
JavaScript ausführen, wenn das Ziehen des <p>-Elements beginnt:
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:
In JavaScript:
In JavaScript unter Verwendung der addEventListener()-Methode:
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 |

Weitere Beispiele
Beispiel
Das folgende Beispiel demonstriert alle Drag-and-Drop-Ereignisse:
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