CKTIS / JavaScript
HTML-Ereignisse dragstart, dragover, drop und dragend
Unterscheide Ereignisse an Quelle und Ziel, um Ziehdaten zu setzen, das Ablegen zuzulassen, Daten zu lesen und den temporären Zustand auch bei einem Abbruch zurückzusetzen.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
source.draggable = true;
source.addEventListener("dragstart", onDragStart);
target.addEventListener("dragover", onDragOver);
target.addEventListener("drop", onDrop);
source.addEventListener("dragend", onDragEnd);Diese Ereignisse gehören zur Drag-and-drop-API von HTML im Browser, nicht zu ECMAScript. dragstart wird an der Quelle ausgelöst, etwa an einem Element mit draggable="true". Im synchronen Handler kannst du die Ziehdaten lesen und mit event.dataTransfer.setData(type, text) schreiben. Die Quelle legt erlaubte Operationen über effectAllowed fest. preventDefault() bei dragstart verhindert den Start.
dragover wird wiederholt über einem möglichen Ziel ausgelöst. Wenn das Ziel den Vorgang akzeptiert, rufe bei dragover preventDefault() auf und setze optional dropEffect auf eine von der Quelle erlaubte Operation. Im geschützten Modus lassen sich die Formate über dataTransfer.types prüfen, nicht aber die übertragenen Inhalte lesen. Das Beispiel bricht auch dragenter ab, wie es das Modell des Standards vorsieht; in gängigen Browsern reicht für eine solche Zone meist das Abbrechen von dragover.
drop wird am Ziel ausgelöst, wenn die Daten an einer Stelle abgelegt werden, die sie annimmt. Verwende bei eigener Verarbeitung preventDefault(), um die Standardaktion zu unterdrücken, und lies die Daten synchron mit getData(type). Für ein fehlendes Format erhältst du eine leere Zeichenkette. Behandle abgelegte Inhalte als nicht vertrauenswürdig: Zeige Klartext mit textContent statt mit innerHTML an.
dragend wird an der Quelle ausgelöst, wenn ein begonnener Ziehvorgang endet, auch bei Abbruch oder fehlgeschlagenem Ablegen. Setze hier temporären Zustand zurück; das Ereignis allein belegt keinen Erfolg. dropEffect mit dem Wert "none" bedeutet, dass keine Ablageoperation stattfand. Wird eine Datei aus dem Betriebssystem hereingezogen, erhält die Seite keine Quellereignisse. Die Unterstützung hängt von Browser und Eingabemethode ab; biete auch eine Bedienmöglichkeit ohne Ziehen an.
Beispiele
(() => {
const panel = document.createElement("section");
panel.style.cssText = "position:fixed;top:16px;left:16px;z-index:1000;padding:16px;background:white;color:black;display:flex;gap:16px";
const source = document.createElement("div");
const target = document.createElement("div");
source.draggable = true;
source.textContent = "Drag this card";
source.style.cssText = "padding:16px;border:1px solid;cursor:grab";
target.textContent = "Drop here";
target.style.cssText = "padding:16px;border:2px dashed;min-width:100px";
panel.append(source, target);
document.body.append(panel);
let active = false;
const accepts = (event) => active && event.dataTransfer?.types.includes("text/plain");
source.addEventListener("dragstart", (event) => {
const transfer = event.dataTransfer;
transfer.setData("text/plain", "Card");
transfer.effectAllowed = "copy";
active = true;
source.style.opacity = "0.5";
console.log("dragstart");
});
target.addEventListener("dragenter", (event) => {
if (accepts(event)) event.preventDefault();
});
target.addEventListener("dragover", (event) => {
if (!accepts(event)) return;
event.preventDefault();
event.dataTransfer.dropEffect = "copy";
});
target.addEventListener("drop", (event) => {
if (!accepts(event)) return;
event.preventDefault();
const text = event.dataTransfer.getData("text/plain");
target.textContent = text;
console.log(`drop: ${text}`);
});
source.addEventListener("dragend", () => {
active = false;
source.style.opacity = "";
console.log("dragend");
});
// Exercise the same handlers once without a pointer gesture.
const transfer = new DataTransfer();
const dispatch = (element, type) => element.dispatchEvent(new DragEvent(type, {
bubbles: true,
cancelable: type !== "dragend",
dataTransfer: transfer,
}));
if (dispatch(source, "dragstart")) {
dispatch(target, "dragenter");
// dispatchEvent returns false when the handler cancels dragover.
if (!dispatch(target, "dragover")) dispatch(target, "drop");
dispatch(source, "dragend");
}
})();Ergebnis
dragstart drop: Card dragend
Führe den Code in der Browserkonsole eines leeren Tabs aus. Der Code ruft die Handler einmal über synthetische Ereignisse auf, ohne dass du selbst ziehen musst. Das Ziel zeigt `Card` an. Um natives Ziehen und Ablegen auszuprobieren, ziehe „Drag this card“ auf das Ziel. Escape beendet einen weiteren Ziehvorgang ohne `drop`. Wiederholte `dragover`-Ereignisse werden nicht protokolliert.
Zugehörige Lektionen
- JavaScript · Lektion 34 · Mittlere Stufe · Version: 3