Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła