WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

HTML-Ereignisse im Drag-and-drop-Ablauf

Lerne die sieben HTML-Drag-Ereignisse, ihre Aufteilung zwischen Quelle und Ziel und wann DataTransfer gelesen oder beschrieben werden kann. Erfahre, warum dragover preventDefault() benötigt und weshalb dragend keinen erfolgreichen Drop bestätigt.

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

source.addEventListener("dragstart", handler);
source.addEventListener("drag", handler);
source.addEventListener("dragend", handler);
target.addEventListener("dragenter", handler);
target.addEventListener("dragover", handler);
target.addEventListener("dragleave", handler);
target.addEventListener("drop", handler);

Die HTML-Ereignisse im Drag-and-drop-Ablauf sind sieben Ereignisse der HTML-Drag-and-Drop-API des Browsers und keine Funktion einer bestimmten ECMAScript-Version. An der Quelle tritt dragstart zu Beginn des Ziehens auf, während des Ziehens wiederholt drag und am Ende dragend. Potenzielle Ziele erhalten beim Betreten dragenter, wiederholt dragover, beim Verlassen dragleave und drop, wenn ein Element auf einem gültigen Ziel abgelegt wird. Anzahl und Zeitabstände der Wiederholungen sind nicht festgelegt.

Mache ein gewöhnliches Element mit draggable = true ziehbar. Schreibe in dragstart Text mit event.dataTransfer.setData(). Daten lassen sich nur in dragstart ändern; ihren Inhalt kann man in dragstart und drop lesen. Prüfe in dragover die verfügbaren Typen statt des Inhalts. Wenn ein eigenes Ziel die gezogenen Daten akzeptiert, genügt es in der Browserpraxis, in dragover preventDefault() aufzurufen. Der HTML-Standard verlangt jedoch, auch dragenter abzubrechen, damit ein gewöhnliches Element als eigenes Ablageziel ausgewählt wird. Unterbinde in drop ebenfalls das Standardverhalten und lies die Daten mit getData() aus.

Verwende dragend zum Aufräumen, auch wenn die Geste abgebrochen wird, etwa mit Escape; das Ereignis allein bestätigt keinen Erfolg. effectAllowed legt die zulässigen Vorgänge der Quelle fest, während dropEffect den ausgewählten Vorgang angibt; keines der beiden verschiebt automatisch DOM-Elemente. Behandle externe Daten als nicht vertrauenswürdig: Prüfe Werte und gib Text mit textContent aus.

Das Beispiel kopiert ausschließlich token-1 und bietet eine Schaltfläche als Alternative zum Ziehen. Teste eine echte Geste im Zielbrowser: Ein synthetisches DragEvent bildet den gesamten vom Browser verwalteten Vorgang nicht nach. Beim Ziehen einer Datei aus dem Betriebssystem werden auf der Seite keine quellseitigen dragstart- oder dragend-Ereignisse ausgelöst. Die Verfügbarkeit von Node 24 belegt keine Unterstützung dieser Browser-Schnittstellen.

Beispiele

const panel = document.createElement("section");
const source = document.createElement("p");
const target = document.createElement("p");
const alternative = document.createElement("button");
const output = document.createElement("p");

source.textContent = "Drag token-1";
source.draggable = true;
target.textContent = "Drop here";
target.style.cssText = "padding: 2rem; border: 2px dashed;";
alternative.type = "button";
alternative.textContent = "Copy token-1 without dragging";
output.setAttribute("role", "status");
output.textContent = "Ready";
panel.append(source, target, alternative, output);
document.body.append(panel);

function accept(value) {
  if (value === "token-1") {
    output.textContent = `Dropped: ${value}`;
  }
}

source.addEventListener("dragstart", (event) => {
  event.dataTransfer.setData("text/plain", "token-1");
  event.dataTransfer.effectAllowed = "copy";
  source.style.opacity = "0.5";
});

target.addEventListener("dragover", (event) => {
  if (event.dataTransfer.types.includes("text/plain")) {
    event.preventDefault();
    event.dataTransfer.dropEffect = "copy";
  }
});

target.addEventListener("drop", (event) => {
  event.preventDefault();
  accept(event.dataTransfer.getData("text/plain"));
});

source.addEventListener("dragend", () => {
  source.style.opacity = "";
});

alternative.addEventListener("click", () => accept("token-1"));

Ergebnis

Dropped: token-1

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