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

CKTIS / HTML

ondragenter — gestionar la entrada de un elemento arrastrado

El atributo ondragenter define el código JavaScript que se ejecuta con el evento dragenter cuando un elemento arrastrado llega a un elemento de destino. Permite reaccionar a esa entrada, pero no gestiona lo que sucede al soltar el elemento.

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

Sintaxis

ondragenter="JavaScript statements"

ondragenter es un atributo de gestión del evento dragenter, disponible en los elementos HTML. Su valor contiene instrucciones JavaScript, no solo el nombre de una función: para llamar a una función hacen falta paréntesis. Dentro del código del atributo, event hace referencia al evento proporcionado. La propiedad JavaScript correspondiente, element.ondragenter, acepta una función o null.

dragenter señala que un elemento arrastrado ha llegado a un destino; no significa que se haya soltado. El evento se propaga hacia arriba en el árbol y se puede cancelar. En el modelo de procesamiento del estándar HTML, cancelar dragenter es una forma de establecer el destino actual de la operación de arrastrar y soltar. En la práctica, los navegadores actuales no exigen cancelar dragenter para que se pueda soltar el elemento. Para que un destino personalizado permita soltar el elemento, llama a event.preventDefault() en el controlador de dragover y gestiona la acción de soltar en el controlador de drop. A diferencia de ondragenter, ondragover se ejecuta repetidamente mientras el elemento permanece sobre el destino.

El ejemplo envía un evento dragenter sintético para que el resultado se pueda repetir sin arrastrar manualmente. Al hacer clic en Run test, el resultado es dragenter: true. Esto solo confirma que la llamada a event.preventDefault() en el código del atributo canceló el evento enviado. La prueba no comprueba un arrastre real, si el destino permite soltar el elemento ni la transferencia de datos. Las políticas de seguridad de la página pueden bloquear el código incluido en atributos; una alternativa es addEventListener('dragenter', handler).

Ejemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragenter demo</title>
<div id="target" ondragenter="event.preventDefault(); document.getElementById('result').textContent = event.type + ': ' + event.defaultPrevented;">Target</div>
<button id="test" type="button">Run test</button>
<output id="result"></output>
<script>
  document.getElementById('test').addEventListener('click', () => {
    document.getElementById('target').dispatchEvent(
      new DragEvent('dragenter', { bubbles: true, cancelable: true })
    );
  });
</script>
</html>

Resultado

dragenter: true

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