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.