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

CKTIS / HTML

ondrop — gestionar los datos soltados

El atributo ondrop define código JavaScript que gestiona el evento drop durante el arrastre y la suelta. Por sí solo no crea un destino para soltar: normalmente también hay que cancelar el comportamiento predeterminado de dragover.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

ondrop="JavaScript statements"
element.ondrop = function (event) { /* handler */ };

ondrop es un atributo global de controlador de eventos de HTML: puede aparecer en cualquier elemento HTML. Su valor es código JavaScript que se ejecuta cuando se recibe un evento drop, es decir, cuando se sueltan datos sobre un destino aceptado. El objeto event expone el evento, y event.dataTransfer expone los datos transferidos.

Un controlador ondrop por sí solo no establece un destino de suelta habitual. Llama a event.preventDefault() en el controlador dragover para permitir la suelta. El ejemplo también cancela dragenter. En el controlador drop, vuelve a usar event.preventDefault() para hacerse cargo de la acción predeterminada y lee el texto con event.dataTransfer.getData('text/plain').

Distingue el atributo HTML ondrop, cuyo valor es texto de código fuente, de la propiedad DOM element.ondrop, a la que se asigna una función o null. El nombre del evento es drop, no ondrop; con addEventListener se usa drop. Volver a asignar element.ondrop reemplaza la función anterior registrada mediante ese mecanismo.

El ejemplo transfiere el texto fijo Hello y lo muestra mediante textContent, sin interpretar los datos como HTML. Requiere un entorno que permita scripts y controladores de eventos en línea; las restricciones de seguridad del documento pueden bloquearlos.

Ejemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondrop example</title>
<p draggable="true"
   ondragstart="event.dataTransfer.setData('text/plain', 'Hello'); event.dataTransfer.effectAllowed = 'copy'">Drag Hello</p>
<div ondragenter="event.preventDefault()"
     ondragover="event.preventDefault(); event.dataTransfer.dropEffect = 'copy'"
     ondrop="event.preventDefault(); document.getElementById('result').textContent = event.dataTransfer.getData('text/plain')"
     style="padding: 2rem; border: 2px dashed">Drop here</div>
<p id="result">Waiting</p>
</html>

Resultado

Hello

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