KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

HTML-events dragstart, dragover, drop en dragend

Maak onderscheid tussen bron- en doelevents om sleepgegevens in te stellen, neerzetten toe te staan, gegevens uit te lezen en tijdelijke status op te ruimen.

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

Syntax

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

Deze events horen bij de HTML Drag and Drop API van de browser, niet bij ECMAScript. dragstart treedt op bij de bron, bijvoorbeeld een element met draggable="true". In de synchrone handler kun je sleepgegevens lezen en schrijven met event.dataTransfer.setData(type, text). De bron stelt toegestane bewerkingen in via effectAllowed. Met preventDefault() op dragstart voorkom je dat het slepen begint.

dragover treedt herhaaldelijk op boven een mogelijk doel. Als het doel het slepen accepteert, roep je preventDefault() aan op dragover en stel je dropEffect eventueel in op een door de bron toegestane bewerking. In de beschermde modus kun je de formaten bekijken via dataTransfer.types, maar niet de inhoud lezen. Het voorbeeld annuleert ook dragenter volgens het model van de standaard; in gangbare browsers volstaat het voor zo’n zone meestal om dragover te annuleren.

drop treedt op bij het doel wanneer de gebruiker de gegevens neerzet op een plek die ze accepteert. Voor aangepaste verwerking roep je preventDefault() aan om de standaardactie te onderdrukken en lees je de inhoud synchroon met getData(type). Een ontbrekend formaat levert een lege tekenreeks op. Beschouw de ontvangen inhoud als onbetrouwbaar: toon platte tekst met textContent, niet met innerHTML.

dragend treedt op bij de bron als een begonnen sleepactie eindigt, ook wanneer die is afgebroken of het neerzetten is mislukt. Ruim hier tijdelijke status op; het event alleen bewijst niet dat de bewerking is gelukt. Een dropEffect van "none" betekent dat er niets is neergezet. Wanneer je een bestand vanuit het besturingssysteem naar de pagina sleept, ontvangt de pagina de bronevents niet. Ondersteuning verschilt per browser en invoermethode; bied ook een manier aan om de actie zonder slepen uit te voeren.

Voorbeelden

(() => {
  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");
  }
})();

Resultaat

dragstart
drop: Card
dragend

Voer de code uit in de browserconsole van een leeg tabblad. De code doorloopt de handlers één keer met synthetische events, zonder dat je zelf hoeft te slepen. Het doel toont `Card`. Sleep ‘Drag this card’ naar het doel om de ingebouwde sleepfunctie van de browser te proberen. Druk tijdens een volgende sleepactie op Escape om die zonder `drop` te beëindigen. Herhaalde `dragover`-events worden niet gelogd.

Gerelateerde lessen

  • JavaScript · Les 34 · Gemiddeld · Versie: 3

Bronnen