KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

DataTransfer: sleepgegevens en toegestane bewerkingen

DataTransfer vervoert gegevens tijdens het slepen. Lees hoe effectAllowed de bewerkingen aan de bron beperkt, setData() de gegevens opslaat en dropEffect de bewerking aan het doel kiest, zonder zelf te kopiëren of te verplaatsen.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

event.dataTransfer.setData(format, data);
event.dataTransfer.effectAllowed = "copyMove";
event.dataTransfer.dropEffect = "copy";

DataTransfer is een Web API-interface en maakt geen deel uit van ECMAScript zelf. Tijdens het slepen is deze beschikbaar als event.dataTransfer. Ook andere interfaces, zoals die voor het klembord, gebruiken deze, maar eigenschappen voor sleepbewerkingen hebben daar niet dezelfde rol. De aanwezigheid van Node 24 bewijst niet dat een browser deze API ondersteunt; het voorbeeld vereist een browser met ondersteuning voor native HTML Drag and Drop.

DataTransfer.setData(format, data) slaat tekst op onder een opgegeven type, zoals text/plain, en retourneert undefined. Als je opnieuw gegevens van hetzelfde type schrijft, wordt volgens de HTML-standaard het oude item verwijderd en het nieuwe achteraan de lijst toegevoegd. Daardoor kan de volgorde van de typen veranderen. Schrijf bij een echte sleepactie in dragstart en lees met getData() in drop.

DataTransfer.effectAllowed geeft aan welke bewerkingen de bron toestaat en moet in dragstart worden ingesteld. De waarden zijn none, copy, copyLink, copyMove, link, linkMove, move, all en de standaardwaarde uninitialized, die alle bewerkingen toestaat. Het doel kiest via DataTransfer.dropEffect een passende bewerking: none, copy, link of move. Ongeldige waarden voor beide eigenschappen worden genegeerd.

Roep in dragover preventDefault() aan om neerzetten mogelijk te maken en stel dropEffect bij elke gebeurtenis in. Dit beïnvloedt de feedback, meestal de cursor, maar kopieert of verwijdert zelf geen gegevens. De toepassing voert dat gedrag uit: het voorbeeld leest tekst in drop en toont die via textContent, zonder de tekst als HTML te interpreteren. Bij een move-effect moet ook het verwijderen van de gegevens aan de bron worden afgehandeld.

Voorbeelden

<!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>

Resultaat

Copied: CKTIS

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen