CKTIS / HTML
ondrop — traiter les données déposées
L’attribut ondrop définit le code JavaScript qui traite l’événement drop lors d’un glisser-déposer. À lui seul, il ne crée pas de cible de dépôt : il faut généralement aussi annuler le comportement par défaut de dragover.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
ondrop="JavaScript statements"
element.ondrop = function (event) { /* handler */ };ondrop est un attribut global de gestionnaire d’événement HTML : il peut être placé sur n’importe quel élément HTML. Sa valeur est du code JavaScript exécuté lorsqu’un événement drop est reçu, c’est-à-dire lorsque des données sont déposées sur une cible acceptée. L’objet event expose l’événement, et event.dataTransfer expose les données transférées.
Un gestionnaire ondrop seul ne définit pas une cible de dépôt classique. Appelez event.preventDefault() dans le gestionnaire dragover pour autoriser le dépôt. L’exemple annule également dragenter. Dans le gestionnaire drop, appelez de nouveau event.preventDefault() pour prendre en charge l’action par défaut, et lisez le texte avec event.dataTransfer.getData('text/plain').
Distinguez l’attribut HTML ondrop, dont la valeur est du code source, de la propriété DOM element.ondrop, à laquelle on affecte une fonction ou null. Le nom de l’événement est drop, et non ondrop ; avec addEventListener, utilisez drop. Réaffecter element.ondrop remplace la fonction précédente enregistrée par ce mécanisme.
L’exemple transfère le texte fixe Hello et l’affiche avec textContent, sans interpréter les données comme du HTML. Il nécessite un environnement qui autorise les scripts et les gestionnaires d’événements intégrés aux attributs ; les restrictions de sécurité du document peuvent les bloquer.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondrop example</title>
<p draggable="true"
ondragstart="event.dataTransfer.setData('text/plain', 'Hello'); event.dataTransfer.effectAllowed = 'copy'">Drag Hello</p>
<div ondragenter="event.preventDefault()"
ondragover="event.preventDefault(); event.dataTransfer.dropEffect = 'copy'"
ondrop="event.preventDefault(); document.getElementById('result').textContent = event.dataTransfer.getData('text/plain')"
style="padding: 2rem; border: 2px dashed">Drop here</div>
<p id="result">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.