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

CKTIS / JavaScript

DataTransfer.effectAllowed — operaciones de arrastre permitidas

DataTransfer.effectAllowed especifica qué operaciones permite el origen del arrastre. No selecciona la operación final: dropEffect describe esa operación y debe ser compatible con el conjunto permitido.

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

dataTransfer.effectAllowed
 dataTransfer.effectAllowed = "copyMove";

DataTransfer.effectAllowed es una propiedad de cadena de una interfaz del navegador, no una característica de ECMAScript. Durante un arrastre, el origen la establece en el manejador de dragstart, cuando el almacén de datos del arrastre está en modo de lectura y escritura. En otros modos o con un valor no válido, la asignación no modifica el valor anterior.

Los valores permitidos son none (ninguna operación), copy, link, move, los pares copyLink, copyMove, linkMove, además de all (las tres) y uninitialized (el estado predeterminado, sin una restricción explícita). Se distingue entre mayúsculas y minúsculas. Un arrastre real comienza con uninitialized.

dropEffect describe la operación seleccionada, no el conjunto de operaciones permitidas. Normalmente, el destino cancela dragover mediante preventDefault() y establece un dropEffect compatible. Si no son compatibles, se impide la operación de soltar; effectAllowed por sí solo no copia ni mueve datos de la aplicación.

En la ejecución verificada en Chromium, la consola muestra que, en el objeto independiente creado con new DataTransfer(), el valor sigue siendo none tanto después de asignar el valor válido copyMove como después de asignar el valor no válido COPY. Este resultado difiere de lo que establece el estándar HTML: el almacén de datos de un objeto creado con new DataTransfer() está en modo de lectura y escritura, por lo que la asignación válida debería establecer effectAllowed en copyMove y la posterior asignación no válida de COPY debería dejarlo en copyMove. La salida de la consola muestra el comportamiento de esa ejecución en Chromium, no la regla de asignación especificada para todos los navegadores.

Cuando el usuario inicia un arrastre, el manejador de dragstart establece copyMove en event.dataTransfer; la asignación posterior de COPY no cambia ese valor. El ejemplo está pensado para navegadores; la presencia de Node 24 en un repositorio no demuestra que esta API sea compatible.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>DataTransfer.effectAllowed</title>
</head>
<body>
  <h1>Allowed drag operations</h1>
  <p id="source" draggable="true">Drag this text, then press Escape to cancel.</p>
  <p id="status" role="status">Start a drag to see which operations the source allows.</p>
  <script>
    const standalone = new DataTransfer();
    standalone.effectAllowed = 'copyMove';
    console.log('Standalone after copyMove: ' + standalone.effectAllowed);
    standalone.effectAllowed = 'COPY';
    console.log('Standalone after COPY: ' + standalone.effectAllowed);

    document.getElementById('source').addEventListener('dragstart', (event) => {
      const transfer = event.dataTransfer;
      transfer.setData('text/plain', 'Example drag');
      transfer.effectAllowed = 'copyMove';
      const accepted = transfer.effectAllowed;
      transfer.effectAllowed = 'COPY';
      document.getElementById('status').textContent =
        'Drag source after copyMove: ' + accepted +
        '. After invalid COPY: ' + transfer.effectAllowed + '.';
    });
  </script>
</body>
</html>

Resultado

Standalone after copyMove: none
Standalone after COPY: none

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