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

CKTIS / HTML

ondragleave — gestionar la salida de un destino de arrastre

El atributo ondragleave contiene JavaScript que gestiona el evento dragleave. Por ejemplo, permite quitar el resaltado del destino anterior durante un arrastre; no significa que haya terminado toda la operación de arrastre.

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

Sintaxis

ondragleave="JavaScript statements"

ondragleave es un atributo de gestión de eventos disponible en los elementos HTML. Su valor es el cuerpo de una función JavaScript, no un nombre de evento ni un valor booleano. Corresponde al evento dragleave; en el código del atributo, event representa el evento y this hace referencia al elemento que lo gestiona.

El navegador envía dragleave al elemento de destino anterior cuando cambia el destino del arrastre; también puede producirse si se cancela la operación. No lo confundas con dragend, que se refiere al origen y al final del arrastre. dragleave se propaga hacia arriba por el árbol y no se puede cancelar: preventDefault() no puede impedir que se abandone el destino. Con elementos anidados, ten en cuenta los eventos que se originan en elementos descendientes.

El atributo HTML almacena código como texto; a la propiedad element.ondragleave se le asigna una función o null. Otra opción es addEventListener('dragleave', handler). Una Content Security Policy puede bloquear el código de los atributos.

El ejemplo dispara deliberadamente un evento sintético al hacer clic en Test, de modo que el resultado se puede repetir sin arrastrar con el ratón. Comprueba la ejecución del gestor, no el mecanismo nativo de arrastrar y soltar.

Ejemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragleave test</title>
<div id="zone" ondragleave="this.textContent = 'dragleave received'">Waiting</div>
<button type="button" id="test">Test</button>
<script>
  const zone = document.getElementById('zone');
  document.getElementById('test').addEventListener('click', () => {
    zone.dispatchEvent(new DragEvent('dragleave', {
      bubbles: true,
      cancelable: false
    }));
  });
</script>
</html>

Resultado

dragleave received

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