CKTIS / HTML
ondragleave — gérer la sortie d’une cible de glissement
L’attribut ondragleave contient du JavaScript qui gère l’événement dragleave. Il peut, par exemple, retirer la mise en évidence de la cible précédente pendant un glissement ; il ne signifie pas que toute l’opération de glissement est terminée.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
ondragleave="JavaScript statements"ondragleave est un attribut de gestion d’événement disponible sur les éléments HTML. Sa valeur est le corps d’une fonction JavaScript, et non un nom d’événement ou une valeur booléenne. Il correspond à l’événement dragleave ; dans le code de l’attribut, event représente l’événement et this désigne l’élément qui le gère.
Le navigateur envoie dragleave à l’élément cible précédent lorsque la cible du glissement change ; l’événement peut aussi se produire si l’opération est annulée. Ne le confondez pas avec dragend, qui concerne la source et la fin du glissement. dragleave remonte dans l’arbre et n’est pas annulable : preventDefault() ne peut pas empêcher la sortie de la cible. Avec des éléments imbriqués, tenez compte des événements provenant des éléments descendants.
L’attribut HTML contient du code sous forme de texte ; la propriété element.ondragleave reçoit une fonction ou null. Une autre possibilité est addEventListener('dragleave', handler). Une Content Security Policy peut bloquer le code dans les attributs.
L’exemple déclenche délibérément un événement synthétique lorsque l’on clique sur Test, ce qui permet de répéter le résultat sans glisser avec la souris. Il vérifie l’exécution du gestionnaire, et non le mécanisme natif de glisser-déposer.
Exemples
<!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>Résultat
dragleave 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.