ondragendEreignis

事件对象参考手册Event-Objekt

Beispiele

JavaScript ausführen, wenn der Benutzer das Ziehen eines <p>-Elements abgeschlossen hat:

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

Selbst ausprobieren »

Weitere Beispiele finden Sie am Ende dieses Artikels.


Definition und Verwendung

Das ondragend-Ereignis wird ausgelöst, wenn der Benutzer das Ziehen eines Elements oder ausgewählten Textes abgeschlossen hat.

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 auf dem Drag-Ziel ausgelöst werden(Quellelement):
    • ondragstart- Wird ausgelöst, wenn der Benutzer beginnt, ein Element zu ziehen
    • ondrag- Ausgelöst, während das Element gezogen wird
    • ondragend - Ausgelöst, nachdem der Benutzer das Ziehen des Elements abgeschlossen hat

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

Browser-Unterstützung

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

Ereignis
ondragend 4.0 9.0 3.5 6.0 12.0


Syntax

In HTML:

<element ondragend="myScript">Probieren Sie es selbst aus

In JavaScript:

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

In JavaScript unter Verwendung der addEventListener()-Methode:

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

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


Technische Details
Blubbert: Ja
Abbrechbar: No
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);
// Gibt etwas Text aus, wenn das p-Element gezogen wird
document.getElementById("demo").innerHTML = "Ziehen des p-Elements wird gestartet.";
//Deckkraft des gezogenen Elements ändern
    event.target.style.opacity = "0.4";
});
//Während das p-Element gezogen wird, die Farbe des Ausgabetexts ändern
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 das Ziehen abschließt und in das droptarget eintritt, den Rahmenstil des div ändern
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 Ablegen die Standard-Datenverarbeitung des Browsers verhindern (Links werden standardmäßig beim Ablegen geöffnet)
Ausgabetextfarbe 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-Referenz:HTML-draggable-Attribut


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