CKTIS / JavaScript
DataTransfer: Drag-and-drop-Daten und zulässige Aktionen
DataTransfer überträgt Daten beim Ziehen. Erfahre, wie effectAllowed die Aktionen an der Quelle einschränkt, setData() die Daten speichert und dropEffect die Aktion am Ziel auswählt, ohne selbst etwas zu kopieren oder zu verschieben.
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.setData(format, data);
event.dataTransfer.effectAllowed = "copyMove";
event.dataTransfer.dropEffect = "copy";DataTransfer ist eine Web-API-Schnittstelle und kein Bestandteil von ECMAScript selbst. Beim Ziehen ist sie über event.dataTransfer verfügbar. Auch andere Schnittstellen, etwa für die Zwischenablage, verwenden sie; Eigenschaften für Ziehaktionen haben dort jedoch nicht dieselbe Funktion. Node 24 allein belegt keine Browserunterstützung für diese API. Das Beispiel benötigt einen Browser mit Unterstützung für natives HTML Drag and Drop.
DataTransfer.setData(format, data) speichert Text unter einem angegebenen Typ, etwa text/plain, und gibt undefined zurück. Werden erneut Daten für denselben Typ geschrieben, wird nach dem HTML-Standard der bisherige Eintrag entfernt und der neue am Ende der Liste angefügt. Dadurch kann sich die Reihenfolge der Typen ändern. Bei einem echten Ziehvorgang werden die Daten in dragstart geschrieben und mit getData() in drop gelesen.
DataTransfer.effectAllowed legt fest, welche Aktionen die Quelle zulässt, und sollte in dragstart gesetzt werden. Mögliche Werte sind none, copy, copyLink, copyMove, link, linkMove, move, all sowie der Standardwert uninitialized, der alle Aktionen zulässt. Das Ziel wählt über DataTransfer.dropEffect eine passende Aktion: none, copy, link oder move. Ungültige Werte für eine der beiden Eigenschaften werden ignoriert.
Rufe in dragover preventDefault() auf, damit Ablegen möglich ist, und setze dropEffect bei jedem Ereignis. Die Eigenschaft beeinflusst die Rückmeldung, meist den Cursor, kopiert oder löscht aber selbst keine Daten. Dieses Verhalten muss die Anwendung umsetzen: Das Beispiel liest den Text in drop und zeigt ihn über textContent an, ohne ihn als HTML zu interpretieren. Bei einem move-Effekt müsste außerdem das Entfernen der Quelldaten behandelt werden.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>DataTransfer copy</title>
<p id="source" draggable="true">Drag this text</p>
<div id="target" style="border: 2px dashed; padding: 2rem">Drop here</div>
<pre id="output" aria-live="polite"></pre>
<script>
const source = document.getElementById("source");
const target = document.getElementById("target");
const output = document.getElementById("output");
let localDrag = false;
source.addEventListener("dragstart", (event) => {
localDrag = true;
event.dataTransfer.setData("text/plain", "CKTIS");
event.dataTransfer.effectAllowed = "copy";
});
source.addEventListener("dragend", () => {
localDrag = false;
});
target.addEventListener("dragover", (event) => {
if (!localDrag) return;
event.preventDefault();
event.dataTransfer.dropEffect = "copy";
});
target.addEventListener("drop", (event) => {
if (!localDrag) return;
event.preventDefault();
const text = event.dataTransfer.getData("text/plain");
target.textContent = text;
output.textContent = `Copied: ${text}`;
});
</script>
</html>Ergebnis
Copied: CKTIS
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.