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

CKTIS / HTML

ondragover — gérer le glissement au-dessus d’un élément

L’attribut ondragover contient du code JavaScript qui gère les événements dragover lorsqu’un glissement survole une cible. L’annulation de l’événement avec event.preventDefault() permet à un élément ordinaire d’accepter un dépôt.

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

Syntaxe

ondragover="event.preventDefault()"

ondragover est l’attribut de contenu du gestionnaire d’événement dragover. Sa valeur est du code JavaScript, et non une valeur booléenne. Le gestionnaire peut accéder à event ; l’événement se déclenche de façon répétée pendant le survol d’une cible, et pas seulement à son entrée.

Pour une cible de dépôt ordinaire, appelez event.preventDefault() lors du traitement de dragover. L’annulation de l’événement indique que l’opération est acceptée ; définir uniquement event.dataTransfer.dropEffect ne suffit pas. La valeur de dropEffect, par exemple copy, doit être compatible avec effectAllowed de la source. Certains éléments modifiables ont un comportement par défaut pour le dépôt de texte.

ondragover ne lit ni n’insère automatiquement le contenu glissé. Lisez les données avec getData() dans le gestionnaire drop ; pendant dragover, le magasin de données est en mode protégé. Dans l’exemple, dragstart stocke du texte, dragenter et dragover annulent leurs événements, et drop met à jour le résultat avec textContent.

Distinguez l’attribut de la propriété JavaScript element.ondragover, à laquelle on affecte une fonction, et de addEventListener('dragover', handler), qui enregistre un écouteur avec le nom de l’événement sans le préfixe on.

Exemples

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

Résultat

HELLO

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