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

CKTIS / JavaScript

Événements HTML dragstart, dragover, drop et dragend

Distinguez les événements de la source et de la cible pour définir les données, accepter le dépôt, lire le contenu et rétablir l’état, même après une annulation.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

source.draggable = true;
source.addEventListener("dragstart", onDragStart);
target.addEventListener("dragover", onDragOver);
target.addEventListener("drop", onDrop);
source.addEventListener("dragend", onDragEnd);

Ces événements font partie de l’API HTML de glisser-déposer du navigateur, et non d’ECMAScript. dragstart est déclenché sur la source, par exemple un élément doté de draggable="true". Dans son gestionnaire synchrone, vous pouvez lire les données et les écrire avec event.dataTransfer.setData(type, text). La source définit les opérations autorisées via effectAllowed. Appeler preventDefault() sur dragstart empêche le démarrage du glissement.

dragover est déclenché à plusieurs reprises au-dessus d’une cible potentielle. Si la cible accepte le glissement, appelez preventDefault() sur dragover et, si nécessaire, choisissez pour dropEffect une opération autorisée par la source. En mode protégé, dataTransfer.types permet de consulter les formats, mais pas de lire les données. L’exemple annule aussi dragenter pour suivre le modèle de la norme ; dans les navigateurs courants, annuler dragover suffit généralement pour une telle zone.

drop est déclenché sur la cible lorsque les données sont déposées à un endroit qui les accepte. Pour un traitement personnalisé, appelez preventDefault() pour neutraliser l’action par défaut, puis lisez les données de façon synchrone avec getData(type). Un format absent donne une chaîne vide. Considérez le contenu déposé comme non fiable : affichez le texte brut avec textContent, pas avec innerHTML.

dragend est déclenché sur la source à la fin d’un glissement commencé, même en cas d’annulation ou d’échec du dépôt. Réinitialisez ici l’état temporaire : l’événement seul ne prouve pas la réussite. Une valeur "none" de dropEffect indique qu’aucune opération de dépôt n’a été effectuée. Pour un fichier glissé depuis le système d’exploitation, la page ne reçoit pas les événements de la source. La prise en charge varie selon le navigateur et le mode de saisie ; proposez aussi une méthode sans glissement.

Exemples

(() => {
  const panel = document.createElement("section");
  panel.style.cssText = "position:fixed;top:16px;left:16px;z-index:1000;padding:16px;background:white;color:black;display:flex;gap:16px";
  const source = document.createElement("div");
  const target = document.createElement("div");
  source.draggable = true;
  source.textContent = "Drag this card";
  source.style.cssText = "padding:16px;border:1px solid;cursor:grab";
  target.textContent = "Drop here";
  target.style.cssText = "padding:16px;border:2px dashed;min-width:100px";
  panel.append(source, target);
  document.body.append(panel);

  let active = false;
  const accepts = (event) => active && event.dataTransfer?.types.includes("text/plain");

  source.addEventListener("dragstart", (event) => {
    const transfer = event.dataTransfer;
    transfer.setData("text/plain", "Card");
    transfer.effectAllowed = "copy";
    active = true;
    source.style.opacity = "0.5";
    console.log("dragstart");
  });

  target.addEventListener("dragenter", (event) => {
    if (accepts(event)) event.preventDefault();
  });

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

  target.addEventListener("drop", (event) => {
    if (!accepts(event)) return;
    event.preventDefault();
    const text = event.dataTransfer.getData("text/plain");
    target.textContent = text;
    console.log(`drop: ${text}`);
  });

  source.addEventListener("dragend", () => {
    active = false;
    source.style.opacity = "";
    console.log("dragend");
  });

  // Exercise the same handlers once without a pointer gesture.
  const transfer = new DataTransfer();
  const dispatch = (element, type) => element.dispatchEvent(new DragEvent(type, {
    bubbles: true,
    cancelable: type !== "dragend",
    dataTransfer: transfer,
  }));

  if (dispatch(source, "dragstart")) {
    dispatch(target, "dragenter");
    // dispatchEvent returns false when the handler cancels dragover.
    if (!dispatch(target, "dragover")) dispatch(target, "drop");
    dispatch(source, "dragend");
  }
})();

Résultat

dragstart
drop: Card
dragend

Exécutez le code dans la console du navigateur sur un onglet vide. Le code appelle une fois les gestionnaires à l’aide d’événements synthétiques, sans geste de votre part, et la cible affiche `Card`. Pour essayer le glisser-déposer natif, faites glisser « Drag this card » sur la cible. Appuyer sur Échap pendant un autre glissement y met fin sans `drop`. Les événements `dragover` répétés ne sont pas journalisés.

Leçons associées

  • JavaScript · Leçon 34 · Intermédiaire · Version : 3

Sources