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

CKTIS / JavaScript

Événements du cycle de glisser-déposer HTML

Découvrez les sept événements de glisser-déposer HTML, leur répartition entre la source et la cible, ainsi que les moments où DataTransfer peut être lu ou modifié. Comprenez pourquoi dragover nécessite preventDefault() et pourquoi dragend ne prouve pas qu’un dépôt a réussi.

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

source.addEventListener("dragstart", handler);
source.addEventListener("drag", handler);
source.addEventListener("dragend", handler);
target.addEventListener("dragenter", handler);
target.addEventListener("dragover", handler);
target.addEventListener("dragleave", handler);
target.addEventListener("drop", handler);

Les événements du cycle de glisser-déposer HTML sont sept événements de l’API HTML Drag and Drop du navigateur, et non une fonctionnalité d’une édition particulière d’ECMAScript. La source reçoit dragstart au début du glissement, des événements drag répétés pendant celui-ci, puis dragend à la fin. Les cibles potentielles reçoivent dragenter à l’entrée, des événements dragover répétés, dragleave à la sortie et drop lorsqu’un élément est déposé sur une cible valide. Le nombre de répétitions et leur intervalle ne sont pas fixes.

Rendez un élément ordinaire déplaçable avec draggable = true. Dans dragstart, écrivez du texte avec event.dataTransfer.setData(). Les données ne peuvent être modifiées que dans dragstart, et leur contenu peut être lu dans dragstart et drop ; dans dragover, vérifiez les types disponibles plutôt que le contenu. En pratique, dans les navigateurs, il suffit d’appeler preventDefault() dans dragover lorsqu’une cible personnalisée accepte les données déplacées. La norme HTML exige toutefois d’annuler également dragenter pour qu’un élément ordinaire soit sélectionné comme cible de dépôt personnalisée. Dans drop, annulez également le comportement par défaut et lisez les données avec getData().

Utilisez dragend pour le nettoyage, même si le geste est annulé, par exemple avec Escape ; sa présence ne prouve pas la réussite. effectAllowed définit les opérations autorisées par la source, tandis que dropEffect indique l’opération sélectionnée ; aucun des deux ne déplace automatiquement des éléments DOM. Considérez les données externes comme non fiables : validez les valeurs et affichez le texte avec textContent.

L’exemple copie uniquement token-1 et propose un bouton comme solution de remplacement au glissement. Testez un vrai geste dans le navigateur cible : un DragEvent synthétique ne reproduit pas toute l’opération gérée par le navigateur. Faire glisser un fichier depuis le système d’exploitation ne déclenche pas sur la page les événements source dragstart ou dragend. La disponibilité de Node 24 ne garantit pas la prise en charge de ces interfaces de navigateur.

Exemples

const panel = document.createElement("section");
const source = document.createElement("p");
const target = document.createElement("p");
const alternative = document.createElement("button");
const output = document.createElement("p");

source.textContent = "Drag token-1";
source.draggable = true;
target.textContent = "Drop here";
target.style.cssText = "padding: 2rem; border: 2px dashed;";
alternative.type = "button";
alternative.textContent = "Copy token-1 without dragging";
output.setAttribute("role", "status");
output.textContent = "Ready";
panel.append(source, target, alternative, output);
document.body.append(panel);

function accept(value) {
  if (value === "token-1") {
    output.textContent = `Dropped: ${value}`;
  }
}

source.addEventListener("dragstart", (event) => {
  event.dataTransfer.setData("text/plain", "token-1");
  event.dataTransfer.effectAllowed = "copy";
  source.style.opacity = "0.5";
});

target.addEventListener("dragover", (event) => {
  if (event.dataTransfer.types.includes("text/plain")) {
    event.preventDefault();
    event.dataTransfer.dropEffect = "copy";
  }
});

target.addEventListener("drop", (event) => {
  event.preventDefault();
  accept(event.dataTransfer.getData("text/plain"));
});

source.addEventListener("dragend", () => {
  source.style.opacity = "";
});

alternative.addEventListener("click", () => accept("token-1"));

Résultat

Dropped: token-1

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