CKTIS / JavaScript
Zdarzenia cyklu przeciągania HTML
Poznaj siedem zdarzeń przeciągania HTML, ich podział między źródło i cel oraz zasady używania DataTransfer. Dowiedz się, dlaczego obsługa dragover wymaga preventDefault() i dlaczego dragend nie oznacza udanego upuszczenia.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
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);Zdarzenia cyklu przeciągania w HTML to siedem zdarzeń przeglądarkowego HTML Drag and Drop API, a nie funkcja określonej edycji ECMAScript. Na źródle występują dragstart przy rozpoczęciu, powtarzane drag podczas przeciągania i dragend po zakończeniu. Na potencjalnych celach występują dragenter przy wejściu, powtarzane dragover, dragleave przy wyjściu oraz drop po upuszczeniu na poprawny cel. Liczba powtórzeń i odstępy czasowe nie są stałe.
Zwykły element ustaw jako przeciągalny przez draggable = true. W dragstart zapisz tekst przez event.dataTransfer.setData(). Dane można modyfikować tylko w dragstart, a ich treść odczytywać w dragstart i drop; w dragover sprawdzaj dostępne typy zamiast treści. W praktyce w przeglądarkach wystarczy wywołać preventDefault() w dragover, gdy własny cel akceptuje przeciągane dane. Standard HTML wymaga jednak anulowania również dragenter, aby zwykły element został wybrany jako własny cel upuszczenia. W drop także anuluj zachowanie domyślne i odczytaj dane przez getData().
dragend służy do sprzątania także po anulowaniu gestu, np. klawiszem Escape; samo jego wystąpienie nie potwierdza sukcesu. effectAllowed określa dozwolone operacje źródła, a dropEffect wskazuje wybraną operację; nie przenoszą automatycznie elementów DOM. Dane z zewnątrz traktuj jako niezaufane: sprawdzaj wartości i wyświetlaj tekst przez textContent.
Przykład kopiuje wyłącznie token-1 i udostępnia przycisk jako alternatywę dla przeciągania. Testuj prawdziwy gest w docelowej przeglądarce: syntetyczny DragEvent nie odtwarza całej operacji zarządzanej przez przeglądarkę. Przeciąganie pliku z systemu nie wywołuje na stronie źródłowych dragstart ani dragend. Dostępność Node 24 nie potwierdza obsługi tych interfejsów przeglądarkowych.
Przykłady
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"));Wynik
Dropped: token-1
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.