CKTIS / HTML
ondrag — Drag-Ereignisse behandeln
Das Attribut ondrag enthält JavaScript zur Behandlung des drag-Ereignisses, das während des Ziehens wiederholt am Quellelement ausgelöst wird. Das Attribut allein macht ein Element weder ziehbar noch legt es ein Ablageziel fest.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<element ondrag="JavaScript statements"></element>ondrag ist ein Ereignisbehandlungsattribut, das für alle HTML-Elemente verfügbar ist. Sein Wert ist JavaScript, das ausgeführt wird, wenn ein drag-Ereignis empfangen wird. Im Attributcode stellt der Parameter event das Ereignisobjekt bereit. Außerdem gibt es die entsprechende JavaScript-Eigenschaft element.ondrag.
Beim nativen Ziehen löst der Browser am Quellelement regelmäßig drag aus. Dieses Ereignis wird nicht bei jeder Zeigerbewegung ausgelöst; gehe nicht von einer festen Häufigkeit aus. Setze bei einem gewöhnlichen Element draggable="true", um das Ziehen zu ermöglichen — ondrag allein bewirkt das nicht.
Unterscheide zwischen ondragstart (Beginn), ondrag (fortlaufendes Ziehen), ondragover (Ziehen über einem möglichen Ziel), ondrop (Ablegen) und ondragend (Ende). ondrag ersetzt nicht die Behandlung des Ablageziels. Lege die Ziehdaten in dragstart fest; während drag befindet sich der Datenspeicher im geschützten Modus, sodass die Dateninhalte nicht verfügbar sind.
Das Beispiel ändert den Statustext in drag received, sobald drag empfangen wird. Weitere Ereignisse lassen denselben Text stehen, sodass das erwartete Ergebnis unabhängig von ihrer Anzahl ist. Speichere die HTML-Datei, öffne sie in einem Browser und ziehe Drag me.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondrag example</title>
<p draggable="true"
ondragstart="event.dataTransfer.setData('text/plain', 'demo')"
ondrag="document.getElementById('status').textContent = 'drag received'">Drag me</p>
<output id="status">ready</output>
</html>Ergebnis
ready → drag received
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.