CKTIS / JavaScript
Eventos HTML dragstart, dragover, drop y dragend
Distingue los eventos del origen y del destino para preparar los datos, aceptar la entrega, leer el contenido y restaurar el estado incluso si se cancela el arrastre.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
source.draggable = true;
source.addEventListener("dragstart", onDragStart);
target.addEventListener("dragover", onDragOver);
target.addEventListener("drop", onDrop);
source.addEventListener("dragend", onDragEnd);Estos eventos pertenecen a la API HTML de arrastrar y soltar del navegador, no a ECMAScript. dragstart se dispara en el origen, por ejemplo, un elemento con draggable="true". En su manejador síncrono puedes leer los datos del arrastre y escribirlos con event.dataTransfer.setData(type, text). El origen define las operaciones permitidas con effectAllowed. Llamar a preventDefault() en dragstart impide que se inicie el arrastre.
dragover se dispara repetidamente sobre un posible destino. Si el destino acepta el arrastre, llama a preventDefault() en dragover y, si lo necesitas, asigna a dropEffect una operación permitida por el origen. En modo protegido puedes consultar los formatos mediante dataTransfer.types, pero no leer los datos. El ejemplo también cancela dragenter según el modelo del estándar; en los navegadores habituales, cancelar dragover suele bastar para una zona como esta.
drop se dispara en el destino cuando se sueltan los datos en un lugar que los acepta. Para aplicar tu propio comportamiento, llama a preventDefault() para impedir la acción predeterminada y lee los datos de forma síncrona con getData(type). Si el formato no está presente, el método devuelve una cadena vacía. Trata el contenido recibido como no confiable: muestra texto plano con textContent, no con innerHTML.
dragend se dispara en el origen al terminar un arrastre que llegó a iniciarse, incluso si se canceló o no se pudo soltar. Elimina aquí el estado temporal: el evento por sí solo no demuestra que la operación se completara. Si dropEffect vale "none", no se realizó ninguna operación de entrega. Si se arrastra un archivo desde el sistema operativo, la página no recibe los eventos del origen. La compatibilidad depende del navegador y del método de entrada; ofrece una alternativa que no requiera arrastrar.
Ejemplos
(() => {
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");
}
})();Resultado
dragstart drop: Card dragend
Ejecuta el código en la consola del navegador en una pestaña vacía. El código ejecuta una vez los manejadores mediante eventos sintéticos, sin necesidad de arrastrar nada, y el destino muestra `Card`. Para probar el arrastre nativo, arrastra «Drag this card» hasta el destino. Pulsa Escape durante otro arrastre para terminarlo sin `drop`. Los eventos `dragover` repetidos no se registran.
Lecciones relacionadas
- JavaScript · Lección 34 · Intermedio · Versión: 3