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

CKTIS / JavaScript

DataTransfer.effectAllowed — opérations de glisser-déposer autorisées

DataTransfer.effectAllowed indique quelles opérations la source du glisser-déposer autorise. Cette propriété ne choisit pas l’opération finale : dropEffect décrit cette opération et doit être compatible avec l’ensemble autorisé.

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

dataTransfer.effectAllowed
 dataTransfer.effectAllowed = "copyMove";

DataTransfer.effectAllowed est une propriété de type chaîne de caractères d’une interface de navigateur, et non une fonctionnalité ECMAScript. Lors d’un glisser-déposer, la source la définit dans le gestionnaire de l’événement dragstart, lorsque le magasin de données du glisser-déposer est en mode lecture-écriture. Dans les autres modes ou avec une valeur invalide, l’affectation ne modifie pas la valeur précédente.

Les valeurs autorisées sont none (aucune opération), copy, link, move, les paires copyLink, copyMove, linkMove, ainsi que all (les trois) et uninitialized (l’état par défaut, sans restriction explicite). La casse est prise en compte. Un véritable glisser-déposer commence avec uninitialized.

dropEffect décrit l’opération sélectionnée, et non l’ensemble des opérations autorisées. La cible annule généralement dragover avec preventDefault() et définit un dropEffect compatible. En cas d’incompatibilité, le dépôt est empêché ; effectAllowed seul ne copie ni ne déplace les données de l’application.

Lors de l’exécution vérifiée dans Chromium, la console montre que, pour l’objet autonome créé avec new DataTransfer(), la valeur reste none aussi bien après l’affectation de la valeur valide copyMove qu’après celle de la valeur invalide COPY. Ce résultat diffère de ce que prévoit le standard HTML : le magasin de données d’un objet créé avec new DataTransfer() est en mode lecture-écriture, de sorte que l’affectation valide devrait donner à effectAllowed la valeur copyMove, et que l’affectation invalide suivante, COPY, devrait laisser cette valeur inchangée. La sortie de la console montre le comportement observé lors de cette exécution dans Chromium, et non la règle d’affectation définie pour tous les navigateurs.

Lorsque l’utilisateur commence à faire glisser l’élément, le gestionnaire de dragstart définit la valeur copyMove sur event.dataTransfer ; l’affectation ultérieure de COPY ne la modifie pas. L’exemple est destiné aux navigateurs ; la présence de Node 24 dans un dépôt ne prouve pas que cette API est prise en charge.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>DataTransfer.effectAllowed</title>
</head>
<body>
  <h1>Allowed drag operations</h1>
  <p id="source" draggable="true">Drag this text, then press Escape to cancel.</p>
  <p id="status" role="status">Start a drag to see which operations the source allows.</p>
  <script>
    const standalone = new DataTransfer();
    standalone.effectAllowed = 'copyMove';
    console.log('Standalone after copyMove: ' + standalone.effectAllowed);
    standalone.effectAllowed = 'COPY';
    console.log('Standalone after COPY: ' + standalone.effectAllowed);

    document.getElementById('source').addEventListener('dragstart', (event) => {
      const transfer = event.dataTransfer;
      transfer.setData('text/plain', 'Example drag');
      transfer.effectAllowed = 'copyMove';
      const accepted = transfer.effectAllowed;
      transfer.effectAllowed = 'COPY';
      document.getElementById('status').textContent =
        'Drag source after copyMove: ' + accepted +
        '. After invalid COPY: ' + transfer.effectAllowed + '.';
    });
  </script>
</body>
</html>

Résultat

Standalone after copyMove: none
Standalone after COPY: none

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