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

CKTIS / JavaScript

Události životního cyklu přetahování v HTML

Seznamte se se sedmi událostmi přetahování v HTML, jejich rozdělením mezi zdroj a cíl a s tím, kdy lze DataTransfer číst nebo měnit. Pochopte, proč dragover vyžaduje preventDefault() a proč dragend nedokazuje úspěšné puštění.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

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);

Mezi události životního cyklu přetahování v HTML patří sedm událostí rozhraní HTML Drag and Drop v prohlížeči; nejde o funkci konkrétní edice ECMAScriptu. Zdroj obdrží dragstart při zahájení přetahování, opakované události drag během něj a dragend po jeho skončení. Potenciální cíle obdrží při vstupu dragenter, opakované události dragover, při opuštění dragleave a drop, když je položka puštěna na platný cíl. Počet opakování ani časové rozestupy nejsou pevně dané.

Běžný prvek nastavte jako přetahovatelný pomocí draggable = true. V dragstart zapište text pomocí event.dataTransfer.setData(). Data lze měnit pouze v dragstart a jejich obsah číst v dragstart a drop; v dragover kontrolujte dostupné typy, nikoli obsah. Pokud vlastní cíl přetahovaná data přijímá, v prohlížečích stačí zavolat preventDefault() v dragover. Standard HTML však vyžaduje zrušit i dragenter, aby byl běžný prvek vybrán jako vlastní cíl puštění. V drop také zrušte výchozí chování a přečtěte data pomocí getData().

Událost dragend použijte k úklidu i tehdy, když je gesto zrušeno, například klávesou Escape; její výskyt nedokazuje úspěch. effectAllowed určuje povolené operace zdroje, zatímco dropEffect označuje vybranou operaci; žádná z těchto vlastností automaticky nepřesouvá prvky DOM. S externími daty zacházejte jako s nedůvěryhodnými: ověřujte hodnoty a text zobrazujte pomocí textContent.

Příklad kopíruje pouze token-1 a nabízí tlačítko jako alternativu k přetahování. Otestujte skutečné gesto v cílovém prohlížeči: syntetická událost DragEvent nereprodukuje celý proces řízený prohlížečem. Přetažení souboru z operačního systému na stránce nevyvolá události zdroje dragstart ani dragend. Dostupnost Node 24 nepotvrzuje podporu těchto rozhraní prohlížeče.

Příklady

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"));

Výsledek

Dropped: token-1

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje