KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

DragEvent.dataTransfer — sleepgegevens

DragEvent.dataTransfer biedt toegang tot het DataTransfer-object van een sleepgebeurtenis. Welke gegevens toegankelijk zijn, hangt af van de fase van de sleepactie. Bij een gebeurtenis die met een script is aangemaakt, kan de eigenschap null teruggeven.

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 // DataTransfer | null

DragEvent.dataTransfer is een alleen-lezen eigenschap die DataTransfer of null teruggeeft. De browser koppelt een object aan native sleepgebeurtenissen. Bij new DragEvent("drop") is dataTransfer standaard null; je kunt wel een object meegeven aan de constructor. Alleen de verwijzing is alleen-lezen, niet de inhoud van het object als geheel.

Bij een native sleepactie kun je tijdens dragstart gegevens opslaan met setData(). Tijdens drop kun je ze met getData() uitlezen, maar niet wijzigen. Bij de overige gebeurtenissen van die sleepactie staat de gegevensopslag in de beschermde modus: via types kun je zien welke formaten beschikbaar zijn, maar getData() geeft een lege tekenreeks terug. Via files heb je toegang tot de bestanden en via items tot de afzonderlijke gegevensitems.

Als je met een script een dragover-gebeurtenis aanmaakt en een nieuw DataTransfer-object meegeeft, gaat de gegevensopslag daardoor niet over naar de beschermde modus. getData() kan nog steeds gegevens teruggeven die met setData() zijn opgeslagen.

Om iets op een gewoon element te kunnen neerzetten, annuleer je de dragover-gebeurtenis met preventDefault(). Lees bij een native sleepactie de gegevens synchroon uit in de drop-handler, zolang je nog toegang hebt tot de gegevensopslag. Kopieer de waarden die je nodig hebt voordat je met asynchrone bewerkingen begint.

Deze browser-API is vastgelegd in de HTML-standaard en hoort niet bij een specifieke ECMAScript-editie. Beschikbaarheid in Node 24 zegt niets over ondersteuning in browsers. Voor het voorbeeld zijn de constructors DragEvent en DataTransfer nodig. Als je met een script een gebeurtenis aanmaakt, start je daarmee geen native sleepactie.

Voorbeelden

(() => {
  const transfer = new DataTransfer();
  transfer.setData("text/plain", "CKTIS");

  const event = new DragEvent("drop", { dataTransfer: transfer });
  const emptyEvent = new DragEvent("drop");

  console.log(event.dataTransfer === transfer);
  console.log(event.dataTransfer.getData("text/plain"));
  console.log(emptyEvent.dataTransfer === null);
})();

Resultaat

true
CKTIS
true

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