Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Eventos del ciclo de arrastre de HTML

Conoce los siete eventos de arrastre de HTML, cómo se reparten entre el origen y el destino y cuándo se puede leer o modificar DataTransfer. Entiende por qué dragover necesita preventDefault() y por qué dragend no demuestra que el elemento se haya soltado correctamente.

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

Sintaxis

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

Los eventos del ciclo de arrastre de HTML son siete eventos de la API HTML Drag and Drop del navegador, no una función de una edición concreta de ECMAScript. El origen recibe dragstart al comenzar el arrastre, eventos drag repetidos mientras dura y dragend al terminar. Los posibles destinos reciben dragenter al entrar, eventos dragover repetidos, dragleave al salir y drop cuando se suelta un elemento en un destino válido. La cantidad y el intervalo de las repeticiones no son fijos.

Haz que un elemento normal se pueda arrastrar con draggable = true. En dragstart, escribe texto mediante event.dataTransfer.setData(). Los datos solo se pueden modificar en dragstart, y su contenido se puede leer en dragstart y drop; en dragover, comprueba los tipos disponibles en vez del contenido. En la práctica, en los navegadores basta con llamar a preventDefault() en dragover cuando un destino personalizado acepta los datos arrastrados. Sin embargo, el estándar HTML exige cancelar también dragenter para que un elemento normal se seleccione como destino personalizado donde soltar los datos. En drop, cancela también el comportamiento predeterminado y lee los datos con getData().

Usa dragend para realizar tareas de limpieza incluso si se cancela el gesto, por ejemplo con Escape; que se produzca no demuestra que haya tenido éxito. effectAllowed define las operaciones permitidas por el origen, mientras que dropEffect indica la operación seleccionada; ninguno mueve automáticamente elementos DOM. Trata los datos externos como no confiables: valida los valores y muestra el texto con textContent.

El ejemplo copia únicamente token-1 y ofrece un botón como alternativa al arrastre. Prueba un gesto real en el navegador de destino: un DragEvent sintético no reproduce toda la operación gestionada por el navegador. Arrastrar un archivo desde el sistema operativo no dispara en la página los eventos dragstart o dragend del lado del origen. La disponibilidad de Node 24 no demuestra que estas interfaces del navegador sean compatibles.

Ejemplos

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

Resultado

Dropped: token-1

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes