Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła