CKTIS / JavaScript
Zdarzenia HTML dragstart, dragover, drop i dragend
Rozróżnij zdarzenia źródła i celu, aby zapisać dane na początku przeciągania, zaakceptować upuszczenie, odczytać dane i przywrócić stan interfejsu.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
source.draggable = true;
source.addEventListener("dragstart", onDragStart);
target.addEventListener("dragover", onDragOver);
target.addEventListener("drop", onDrop);
source.addEventListener("dragend", onDragEnd);Te zdarzenia należą do przeglądarkowego API HTML Drag and Drop, a nie do ECMAScriptu. Zdarzenie dragstart jest kierowane do źródła, na przykład elementu z draggable="true". W jego synchronicznej obsłudze można odczytywać dane i zapisywać je przez event.dataTransfer.setData(type, text). Źródło ustawia dozwolone operacje w effectAllowed. Wywołanie preventDefault() na dragstart przerywa rozpoczęcie przeciągania.
dragover występuje wielokrotnie nad potencjalnym celem. Gdy cel akceptuje operację, wywołaj preventDefault() na dragover i opcjonalnie ustaw dropEffect na operację dozwoloną przez źródło. W trybie chronionym można sprawdzać formaty przez dataTransfer.types, ale nie można odczytać samych danych. Przykład anuluje też dragenter zgodnie z modelem standardu; w najczęściej używanych przeglądarkach dla takiej strefy zwykle wystarcza anulowanie dragover.
drop jest kierowane do celu, gdy użytkownik upuści dane w miejscu, które je przyjmuje. Przy własnej obsłudze wywołaj preventDefault(), aby pominąć działanie domyślne, i odczytaj dane synchronicznie przez getData(type). Brak danego formatu daje pusty ciąg. Traktuj odebraną treść jako niezaufaną: do wyświetlenia zwykłego tekstu użyj textContent, a nie innerHTML.
dragend jest kierowane do źródła po zakończeniu rozpoczętego przeciągania, także gdy operację anulowano lub upuszczenie się nie powiodło. Wyczyść tutaj stan tymczasowy; samo zdarzenie nie potwierdza sukcesu. dropEffect równe "none" oznacza, że nie wykonano operacji upuszczenia. Przy przeciąganiu pliku z systemu operacyjnego strona nie dostaje zdarzeń źródłowych. Obsługa zależy od przeglądarki i sposobu wprowadzania; zapewnij alternatywę niewymagającą przeciągania.
Przykłady
(() => {
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");
}
})();Wynik
dragstart drop: Card dragend
Uruchom kod w konsoli przeglądarki na pustej karcie. Kod raz wywołuje procedury obsługi za pomocą zdarzeń syntetycznych, bez użycia myszy, a w polu docelowym pojawia się `Card`. Aby sprawdzić natywne przeciąganie, przeciągnij „Drag this card” na pole docelowe. Naciśnięcie Escape w trakcie kolejnego przeciągania kończy je bez `drop`. Powtarzające się zdarzenia `dragover` nie są wypisywane.
Powiązane lekcje
- JavaScript · Lekcja 34 · Średniozaawansowany · Wersja: 3