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

CKTIS / HTML

ondragend — gérer la fin d’un glissement

L’attribut ondragend exécute du JavaScript lorsque l’opération de glissement se termine, y compris en cas d’annulation ou d’échec du dépôt. Il sert à nettoyer l’état de l’élément source, et non à confirmer qu’une cible a accepté des données.

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

Syntaxe

ondragend="JavaScript statements"

ondragend est un attribut de contenu gestionnaire d’événement pour dragend, autorisé sur chaque élément HTML. Sa valeur est du code JavaScript, et non une valeur booléenne. Dans le code de l’attribut, le paramètre event fournit l’objet événement. L’attribut n’active pas le glissement à lui seul ; l’exemple utilise draggable="true" à cette fin.

L’événement dragend est envoyé à la source lorsque l’opération de glissement se termine, y compris après une annulation ou un dépôt refusé. Contrairement à drop, il ne signale pas l’acceptation des données par la cible. Il convient pour retirer les indicateurs visuels de glissement. Consulte event.dataTransfer.dropEffect pour connaître le résultat de l’opération ; none signifie qu’aucune opération n’a été effectuée.

En JavaScript, tu peux aussi affecter une fonction à la propriété element.ondragend ou enregistrer un écouteur avec element.addEventListener('dragend', handler). Le nom de l’événement est dragend, sans le préfixe on. La politique Content Security Policy peut bloquer le code écrit directement dans un attribut ; dans ce cas, utilise un script autorisé avec addEventListener.

L’exemple définit le texte d’état sur Drag ended, que le dépôt réussisse ou non. Il ne met en œuvre ni cible de dépôt ni transfert de données.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragend example</title>
<p draggable="true"
   ondragstart="event.dataTransfer.setData('text/plain', 'Sample')"
   ondragend="document.getElementById('status').textContent = 'Drag ended'">
  Drag this text
</p>
<p id="status" role="status">Ready</p>
</html>

Résultat

Drag ended

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