CKTIS / HTML
ondrag — gérer les événements de glissement
L’attribut ondrag contient du JavaScript qui gère l’événement drag, déclenché à plusieurs reprises sur la source pendant le glissement. À lui seul, cet attribut ne rend pas un élément déplaçable et ne définit pas de cible de dépôt.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<element ondrag="JavaScript statements"></element>ondrag est un attribut de gestion d’événement disponible sur tous les éléments HTML. Sa valeur est du code JavaScript exécuté lorsqu’un événement drag est reçu. Dans le code de l’attribut, le paramètre event fournit l’objet événement. Il existe également une propriété JavaScript correspondante, element.ondrag.
Lors d’un glissement natif, le navigateur déclenche périodiquement drag sur le nœud source. Cet événement ne correspond pas à chaque mouvement du pointeur ; ne partez pas du principe que sa fréquence est fixe. Pour un élément ordinaire, définissez draggable="true" afin de permettre le glissement — ondrag seul ne le fait pas.
Distinguez ondragstart (début), ondrag (glissement en cours), ondragover (glissement au-dessus d’une cible potentielle), ondrop (dépôt) et ondragend (fin). ondrag ne remplace pas la gestion de la cible de dépôt. Définissez les données de glissement dans dragstart ; pendant drag, le magasin de données est en mode protégé et son contenu n’est donc pas accessible.
L’exemple remplace le texte d’état par drag received lorsque drag est reçu. Les événements suivants conservent le même texte, de sorte que le résultat attendu ne dépend pas de leur nombre. Enregistrez le fichier HTML, ouvrez-le dans un navigateur et faites glisser Drag me.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondrag example</title>
<p draggable="true"
ondragstart="event.dataTransfer.setData('text/plain', 'demo')"
ondrag="document.getElementById('status').textContent = 'drag received'">Drag me</p>
<output id="status">ready</output>
</html>Résultat
ready → drag received
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.