CKTIS / HTML
ondragend — das Ende eines Ziehvorgangs behandeln
Das Attribut ondragend führt JavaScript aus, wenn ein Ziehvorgang endet, auch wenn er abgebrochen wird oder das Ablegen nicht gelingt. Es eignet sich zum Bereinigen des Zustands des Quellelements, nicht zum Bestätigen, dass ein Ziel Daten angenommen hat.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
ondragend="JavaScript statements"ondragend ist ein Event-Handler-Content-Attribut für dragend, das auf jedem HTML-Element zulässig ist. Sein Wert ist JavaScript-Code, kein boolescher Wert. Im Attributcode stellt der Parameter event das Ereignisobjekt bereit. Das Attribut aktiviert das Ziehen nicht selbst; im Beispiel wird dafür draggable="true" verwendet.
Das Ereignis dragend wird an die Quelle gesendet, wenn der Ziehvorgang endet, auch bei einem Abbruch oder einem abgewiesenen Ablegen. Anders als drop ist es kein Ereignis zur Annahme von Daten durch das Ziel. Es eignet sich zum Entfernen visueller Zieh-Markierungen. Prüfe event.dataTransfer.dropEffect, um das Ergebnis des Vorgangs zu ermitteln; none bedeutet, dass kein Vorgang ausgeführt wurde.
In JavaScript kannst du auch der Eigenschaft element.ondragend eine Funktion zuweisen oder mit element.addEventListener('dragend', handler) einen Listener registrieren. Der Ereignisname lautet dragend, ohne das Präfix on. Eine Content Security Policy kann direkt in einem Attribut notierten Code blockieren; verwende in dieser Umgebung ein zulässiges Skript mit addEventListener.
Das Beispiel setzt den Statustext auf Drag ended, unabhängig davon, ob das Ablegen erfolgreich ist. Es implementiert weder ein Ablageziel noch eine Datenübertragung.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragend example</title>
<p draggable="true"
ondragstart="event.dataTransfer.setData('text/plain', 'Sample')"
ondragend="document.getElementById('status').textContent = 'Drag ended'">
Drag this text
</p>
<p id="status" role="status">Ready</p>
</html>Ergebnis
Drag ended
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.