Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

ondragenter — gérer l’entrée d’un élément déplacé

L’attribut ondragenter définit le code JavaScript exécuté lors de l’événement dragenter, quand un élément glissé arrive au-dessus d’un élément cible. Il permet à la cible de réagir à cette arrivée, mais ne gère pas le dépôt lui-même.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

ondragenter="JavaScript statements"

ondragenter est un attribut de gestion de l’événement dragenter, disponible sur les éléments HTML. Sa valeur contient des instructions JavaScript, et pas seulement le nom d’une fonction : il faut des parenthèses pour appeler une fonction. Dans le code de l’attribut, event désigne l’événement transmis. La propriété JavaScript correspondante, element.ondragenter, accepte une fonction ou null.

dragenter signale qu’un élément glissé est arrivé au-dessus d’une cible, pas qu’un dépôt a eu lieu. L’événement remonte dans l’arborescence et peut être annulé. Dans le modèle de traitement de la norme HTML, annuler dragenter est l’un des moyens de définir la cible courante de l’opération de glisser-déposer. En pratique, les navigateurs actuels n’exigent pas l’annulation de dragenter pour qu’un dépôt puisse avoir lieu. Pour qu’une cible personnalisée accepte un dépôt, appelez event.preventDefault() dans le gestionnaire de dragover, puis gérez le dépôt dans le gestionnaire de drop. Contrairement à ondragenter, ondragover s’exécute à plusieurs reprises tant que l’élément reste au-dessus de la cible.

L’exemple déclenche un événement dragenter synthétique afin que le résultat puisse être reproduit sans glisser manuellement un élément. Après un clic sur Run test, le résultat affiché est dragenter: true. Cela confirme uniquement que l’appel à event.preventDefault() dans le code de l’attribut a annulé l’événement déclenché. Ce test ne vérifie ni un glissement réel, ni l’acceptation d’un dépôt, ni le transfert de données. Les règles de sécurité de la page peuvent bloquer le code placé dans les attributs ; une autre possibilité est addEventListener('dragenter', handler).

Exemples

<!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>

Résultat

dragenter: true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources