CKTIS / JavaScript
DragEvent.dataTransfer — Drag-and-drop-Daten
DragEvent.dataTransfer stellt das DataTransfer-Objekt eines Drag-Ereignisses bereit. Der Zugriff auf dessen Nutzdaten hängt von der Phase des Vorgangs ab; ein per Skript erstelltes Ereignis kann null zurückgeben.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
event.dataTransfer // DataTransfer | nullDragEvent.dataTransfer ist eine schreibgeschützte Eigenschaft, die DataTransfer oder null zurückgibt. Der Browser fügt nativen Drag-Ereignissen ein Objekt hinzu. Bei new DragEvent("drop") ist dataTransfer standardmäßig null; dem Konstruktor kann ein Objekt explizit übergeben werden. Schreibgeschützt ist die Referenz, nicht der gesamte Inhalt des Objekts.
Bei einem nativen Drag-Vorgang können Daten während dragstart mit setData() geschrieben werden. Während drop können sie mit getData() gelesen, aber nicht geändert werden. Bei den übrigen Ereignissen dieses Vorgangs befindet sich der Datenspeicher im geschützten Modus: Formate lassen sich über types prüfen, aber getData() gibt eine leere Zeichenfolge zurück. files stellt Dateien bereit, items die Datenelemente.
Wenn du per Skript ein dragover-Ereignis erstellst und ihm ein neues DataTransfer-Objekt übergibst, wechselt der Datenspeicher dadurch nicht in den geschützten Modus. getData() kann weiterhin Daten zurückgeben, die mit setData() geschrieben wurden.
Damit ein gewöhnliches Element ein Drop-Ereignis annimmt, muss dragover mit preventDefault() abgebrochen werden. Lies bei einem nativen Drag-Vorgang die Nutzdaten synchron im drop-Handler aus, bevor der Zugriff auf den Speicher endet. Kopiere benötigte Werte, bevor du asynchrone Arbeit ausführst.
Dies ist eine vom HTML-Standard definierte Browser-API und keine Funktion einer bestimmten ECMAScript-Ausgabe. Die Verfügbarkeit in Node 24 belegt keine Browser-Unterstützung. Das Beispiel benötigt die Konstruktoren DragEvent und DataTransfer; ein per Skript erstelltes Ereignis startet keinen nativen Drag-Vorgang.
Beispiele
(() => {
const transfer = new DataTransfer();
transfer.setData("text/plain", "CKTIS");
const event = new DragEvent("drop", { dataTransfer: transfer });
const emptyEvent = new DragEvent("drop");
console.log(event.dataTransfer === transfer);
console.log(event.dataTransfer.getData("text/plain"));
console.log(emptyEvent.dataTransfer === null);
})();Ergebnis
true CKTIS true
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.