WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

ondrop — Verarbeitung abgelegter Daten

Das Attribut ondrop legt JavaScript-Code fest, der das drop-Ereignis beim Ziehen und Ablegen verarbeitet. Allein erstellt es kein Ablageziel: Üblicherweise muss auch die Standardbehandlung von dragover abgebrochen werden.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

ondrop="JavaScript statements"
element.ondrop = function (event) { /* handler */ };

ondrop ist ein globales HTML-Ereignis-Handler-Attribut und kann auf jedem HTML-Element stehen. Sein Wert ist JavaScript-Code, der ausgeführt wird, wenn ein drop-Ereignis eintritt, also Daten auf einem akzeptierten Ziel abgelegt werden. Das Objekt event stellt das Ereignis bereit; event.dataTransfer enthält die übertragenen Daten.

Ein ondrop-Handler allein richtet kein übliches Ablageziel ein. Rufe im dragover-Handler event.preventDefault() auf, um das Ablegen zu erlauben. Das Beispiel bricht auch dragenter ab. Verwende im drop-Handler erneut event.preventDefault(), um die Standardaktion zu übernehmen, und lies Text mit event.dataTransfer.getData('text/plain') aus.

Unterscheide das HTML-Attribut ondrop, dessen Wert JavaScript-Quelltext ist, von der DOM-Eigenschaft element.ondrop, der eine Funktion oder null zugewiesen wird. Der Ereignisname ist drop, nicht ondrop; bei addEventListener verwendest du drop. Eine erneute Zuweisung an element.ondrop ersetzt die zuvor über diesen Mechanismus registrierte Funktion.

Das Beispiel überträgt den festen Text Hello und zeigt ihn über textContent an, ohne die Daten als HTML zu interpretieren. Es erfordert eine Umgebung, die Skripte und Inline-Ereignis-Handler erlaubt; Sicherheitsbeschränkungen des Dokuments können diese blockieren.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondrop example</title>
<p draggable="true"
   ondragstart="event.dataTransfer.setData('text/plain', 'Hello'); event.dataTransfer.effectAllowed = 'copy'">Drag Hello</p>
<div ondragenter="event.preventDefault()"
     ondragover="event.preventDefault(); event.dataTransfer.dropEffect = 'copy'"
     ondrop="event.preventDefault(); document.getElementById('result').textContent = event.dataTransfer.getData('text/plain')"
     style="padding: 2rem; border: 2px dashed">Drop here</div>
<p id="result">Waiting</p>
</html>

Ergebnis

Hello

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.

Quellen