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

CKTIS / JavaScript

DataTransfer : données de glisser-déposer et opérations autorisées

DataTransfer transporte des données pendant le glissement. Découvrez comment effectAllowed limite les opérations à la source, comment setData() stocke les données et comment dropEffect choisit l’opération à la cible, sans effectuer lui-même la copie ou le déplacement.

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.setData(format, data);
event.dataTransfer.effectAllowed = "copyMove";
event.dataTransfer.dropEffect = "copy";

DataTransfer est une interface d’API Web, et non une partie d’ECMAScript lui-même. Pendant un glissement, elle est accessible via event.dataTransfer. D’autres interfaces, comme celles du presse-papiers, l’utilisent aussi, mais les propriétés liées aux opérations de glissement n’y ont pas le même rôle. La présence de Node 24 ne prouve pas la prise en charge de cette API par un navigateur ; l’exemple nécessite un navigateur prenant en charge le glisser-déposer HTML natif.

DataTransfer.setData(format, data) stocke du texte sous un type indiqué, comme text/plain, et renvoie undefined. Selon le standard HTML, lorsqu’on écrit à nouveau des données pour le même type, l’ancien élément est supprimé et son remplaçant est ajouté à la fin de la liste, ce qui peut modifier l’ordre des types. Lors d’un glissement réel, écrivez les données dans dragstart et lisez-les avec getData() dans drop.

DataTransfer.effectAllowed précise les opérations autorisées par la source et doit être défini dans dragstart. Ses valeurs sont none, copy, copyLink, copyMove, link, linkMove, move, all et la valeur par défaut uninitialized, qui autorise toutes les opérations. La cible choisit une opération compatible via DataTransfer.dropEffect : none, copy, link ou move. Les valeurs non valides de l’une ou l’autre propriété sont ignorées.

Dans dragover, appelez preventDefault() pour autoriser le dépôt et définissez dropEffect à chaque événement. Cette propriété influe sur le retour visuel, généralement le curseur, mais ne copie ni ne supprime les données à elle seule. C’est à l’application de réaliser cette action : l’exemple lit le texte dans drop et l’affiche avec textContent, sans l’interpréter comme du HTML. Un effet move nécessiterait aussi de gérer la suppression des données à la source.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>DataTransfer copy</title>
<p id="source" draggable="true">Drag this text</p>
<div id="target" style="border: 2px dashed; padding: 2rem">Drop here</div>
<pre id="output" aria-live="polite"></pre>
<script>
  const source = document.getElementById("source");
  const target = document.getElementById("target");
  const output = document.getElementById("output");
  let localDrag = false;

  source.addEventListener("dragstart", (event) => {
    localDrag = true;
    event.dataTransfer.setData("text/plain", "CKTIS");
    event.dataTransfer.effectAllowed = "copy";
  });

  source.addEventListener("dragend", () => {
    localDrag = false;
  });

  target.addEventListener("dragover", (event) => {
    if (!localDrag) return;
    event.preventDefault();
    event.dataTransfer.dropEffect = "copy";
  });

  target.addEventListener("drop", (event) => {
    if (!localDrag) return;
    event.preventDefault();
    const text = event.dataTransfer.getData("text/plain");
    target.textContent = text;
    output.textContent = `Copied: ${text}`;
  });
</script>
</html>

Résultat

Copied: CKTIS

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