CKTIS / JavaScript
DragEvent.dataTransfer — données de glissement
DragEvent.dataTransfer expose l’objet DataTransfer d’un événement de glissement. L’accès à ses données dépend de la phase de l’opération ; un événement créé par un script peut renvoyer null.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
event.dataTransfer // DataTransfer | nullDragEvent.dataTransfer est une propriété en lecture seule qui renvoie DataTransfer ou null. Le navigateur associe un objet aux événements de glissement natifs. Avec new DragEvent("drop"), dataTransfer vaut null par défaut ; le constructeur accepte un objet explicite. C’est la référence qui est en lecture seule, et non l’ensemble du contenu de l’objet.
Lors d’un glisser-déposer natif, il est possible d’écrire des données avec setData() pendant dragstart. Pendant drop, elles peuvent être lues avec getData(), mais pas modifiées. Pour les autres événements de cette opération, le magasin de données est en mode protégé : les formats peuvent être vérifiés avec types, mais getData() renvoie une chaîne vide. files expose les fichiers et items les éléments de données.
Créer un événement dragover par script en lui fournissant un nouvel objet DataTransfer ne fait pas passer le magasin de données en mode protégé. getData() peut toujours renvoyer les données écrites avec setData().
Pour qu’un élément ordinaire accepte un dépôt, annulez dragover avec preventDefault(). Lors d’un glisser-déposer natif, lisez les données de manière synchrone dans le gestionnaire drop, avant que l’accès au magasin ne prenne fin. Copiez les valeurs nécessaires avant tout traitement asynchrone.
Il s’agit d’une API de navigateur définie par HTML, et non d’une fonctionnalité d’une édition particulière d’ECMAScript. Sa disponibilité dans Node 24 ne prouve pas sa prise en charge par les navigateurs. L’exemple nécessite les constructeurs DragEvent et DataTransfer ; créer un événement dans un script ne déclenche pas un glissement natif.
Exemples
(() => {
const transfer = new DataTransfer();
transfer.setData("text/plain", "CKTIS");
const event = new DragEvent("drop", { dataTransfer: transfer });
const emptyEvent = new DragEvent("drop");
console.log(event.dataTransfer === transfer);
console.log(event.dataTransfer.getData("text/plain"));
console.log(emptyEvent.dataTransfer === null);
})();Résultat
true CKTIS true
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.