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

CKTIS / HTML

ondragend — gestionar el final de un arrastre

El atributo ondragend ejecuta JavaScript cuando termina una operación de arrastre, incluso si se cancela o el intento de soltar no tiene éxito. Sirve para limpiar el estado del elemento de origen, no para confirmar que un destino haya aceptado los datos.

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

Sintaxis

ondragend="JavaScript statements"

ondragend es un atributo de contenido de controlador de eventos para dragend, permitido en todos los elementos HTML. Su valor es código JavaScript, no un valor booleano. En el código del atributo, el parámetro event proporciona el objeto del evento. El atributo no activa el arrastre por sí mismo; el ejemplo usa draggable="true" para ello.

El evento dragend se envía al origen cuando termina la operación de arrastre, también si se cancela o se rechaza el intento de soltar. A diferencia de drop, no es el evento que indica que el destino acepta los datos. Sirve para quitar los indicadores visuales de arrastre. Consulta event.dataTransfer.dropEffect para comprobar el resultado de la operación; none significa que no se realizó ninguna operación.

En JavaScript, también puedes asignar una función a la propiedad element.ondragend o registrar un listener con element.addEventListener('dragend', handler). El nombre del evento es dragend, sin el prefijo on. La política Content Security Policy puede bloquear el código escrito directamente en un atributo; en ese entorno, usa un script permitido con addEventListener.

El ejemplo establece el texto de estado en Drag ended, tanto si soltar tiene éxito como si no. No implementa un destino donde soltar ni el traslado de datos.

Ejemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragend example</title>
<p draggable="true"
   ondragstart="event.dataTransfer.setData('text/plain', 'Sample')"
   ondragend="document.getElementById('status').textContent = 'Drag ended'">
  Drag this text
</p>
<p id="status" role="status">Ready</p>
</html>

Resultado

Drag ended

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