Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Události HTML dragstart, dragover, drop a dragend

Rozlišuj události zdroje a cíle, abys mohl nastavit data, povolit upuštění, načíst obsah a obnovit dočasný stav i při zrušení přetahování.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

source.draggable = true;
source.addEventListener("dragstart", onDragStart);
target.addEventListener("dragover", onDragOver);
target.addEventListener("drop", onDrop);
source.addEventListener("dragend", onDragEnd);

Tyto události patří k prohlížečovému API HTML pro přetahování, nikoli k ECMAScriptu. dragstart se vyvolá na zdroji, například na prvku s draggable="true". V jeho synchronní obsluze můžeš data číst i zapisovat pomocí event.dataTransfer.setData(type, text). Zdroj nastavuje povolené operace přes effectAllowed. Volání preventDefault() při dragstart zabrání zahájení přetahování.

dragover se opakovaně vyvolává nad možným cílem. Pokud cíl operaci přijímá, zavolej při dragover metodu preventDefault() a případně nastav dropEffect na operaci povolenou zdrojem. V chráněném režimu lze přes dataTransfer.types zkontrolovat formáty, ale ne číst samotná data. Příklad podle modelu standardu ruší také dragenter; v běžných prohlížečích u takové zóny zpravidla stačí zrušit dragover.

drop se vyvolá na cíli, když uživatel upustí data na místo, které je přijímá. Při vlastním zpracování potlač výchozí akci voláním preventDefault() a načti data synchronně pomocí getData(type). Chybějící formát vrátí prázdný řetězec. S přijatým obsahem zacházej jako s nedůvěryhodným: prostý text zobraz přes textContent, nikoli přes innerHTML.

dragend se vyvolá na zdroji po skončení zahájeného přetahování, i když bylo zrušeno nebo upuštění selhalo. Zruš zde dočasný stav; samotná událost nepotvrzuje úspěch. Hodnota "none" v dropEffect znamená, že se žádná operace upuštění neprovedla. Při přetažení souboru z operačního systému stránka neobdrží události zdroje. Podpora závisí na prohlížeči a způsobu ovládání; nabídni i možnost provést akci bez přetahování.

Příklady

(() => {
  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");
  }
})();

Výsledek

dragstart
drop: Card
dragend

Spusť kód v konzoli prohlížeče na prázdné kartě. Kód jednou spustí obsluhu událostí pomocí syntetických událostí, aniž bys musel něco přetahovat. V cíli se zobrazí `Card`. Pokud chceš vyzkoušet nativní přetahování, přetáhni „Drag this card“ na cíl. Stisk Esc při dalším přetahování je ukončí bez `drop`. Opakované události `dragover` se nevypisují.

Související lekce

  • JavaScript · Lekce 34 · Středně pokročilá · Verze: 3

Zdroje