CKTIS / JavaScript
DataTransfer: datos y operaciones permitidas al arrastrar
DataTransfer transporta datos durante el arrastre. Aprende cómo effectAllowed limita las operaciones en el origen, setData() guarda los datos y dropEffect selecciona la operación en el destino, sin realizar por sí mismo la copia ni el movimiento.
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
event.dataTransfer.setData(format, data);
event.dataTransfer.effectAllowed = "copyMove";
event.dataTransfer.dropEffect = "copy";DataTransfer es una interfaz de la API Web, no forma parte de ECMAScript. Durante un arrastre está disponible como event.dataTransfer. También la utilizan otras interfaces, como las del portapapeles, pero las propiedades de operaciones de arrastre no cumplen allí la misma función. Tener Node 24 no demuestra que un navegador admita esta API; el ejemplo requiere un navegador compatible con el arrastre y la suelta nativos de HTML.
DataTransfer.setData(format, data) guarda texto bajo un tipo especificado, como text/plain, y devuelve undefined. Según el estándar HTML, al volver a escribir datos del mismo tipo, se elimina el elemento anterior y se añade el nuevo al final de la lista, lo que puede cambiar el orden de los tipos. En un arrastre real, escribe los datos en dragstart y léelos con getData() en drop.
DataTransfer.effectAllowed especifica las operaciones permitidas por el origen y debe establecerse en dragstart. Sus valores son none, copy, copyLink, copyMove, link, linkMove, move, all y el valor predeterminado uninitialized, que permite todas las operaciones. El destino elige una operación compatible mediante DataTransfer.dropEffect: none, copy, link o move. Se ignoran los valores no válidos de cualquiera de las propiedades.
En dragover, llama a preventDefault() para permitir la suelta y establece dropEffect en cada evento. Esta propiedad afecta a la respuesta visual, normalmente el cursor, pero no copia ni elimina datos por sí sola. La aplicación implementa ese comportamiento: el ejemplo lee el texto en drop y lo muestra mediante textContent, sin interpretarlo como HTML. Un efecto move también requeriría gestionar la eliminación de los datos del origen.
Ejemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>DataTransfer copy</title>
<p id="source" draggable="true">Drag this text</p>
<div id="target" style="border: 2px dashed; padding: 2rem">Drop here</div>
<pre id="output" aria-live="polite"></pre>
<script>
const source = document.getElementById("source");
const target = document.getElementById("target");
const output = document.getElementById("output");
let localDrag = false;
source.addEventListener("dragstart", (event) => {
localDrag = true;
event.dataTransfer.setData("text/plain", "CKTIS");
event.dataTransfer.effectAllowed = "copy";
});
source.addEventListener("dragend", () => {
localDrag = false;
});
target.addEventListener("dragover", (event) => {
if (!localDrag) return;
event.preventDefault();
event.dataTransfer.dropEffect = "copy";
});
target.addEventListener("drop", (event) => {
if (!localDrag) return;
event.preventDefault();
const text = event.dataTransfer.getData("text/plain");
target.textContent = text;
output.textContent = `Copied: ${text}`;
});
</script>
</html>Resultado
Copied: CKTIS
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.