Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

DragEvent.dataTransfer — dane przeciągania

DragEvent.dataTransfer udostępnia obiekt DataTransfer zdarzenia przeciągania. Dostęp do jego danych zależy od etapu operacji; zdarzenie utworzone skryptem może zwrócić null.

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

Składnia

event.dataTransfer // DataTransfer | null

DragEvent.dataTransfer jest właściwością tylko do odczytu zwracającą DataTransfer albo null. Przeglądarka dołącza obiekt do zdarzeń natywnego przeciągania. new DragEvent("drop") domyślnie ma dataTransfer równe null; konstruktor pozwala przekazać obiekt. Tylko do odczytu jest odwołanie, nie cała zawartość obiektu.

W natywnej operacji przeciągania podczas dragstart można zapisywać dane przez setData(). Podczas drop można je odczytać przez getData(), ale nie zmieniać. Przy pozostałych zdarzeniach tej operacji magazyn danych działa w trybie chronionym: można sprawdzać formaty przez types, lecz getData() zwraca pusty ciąg. files udostępnia pliki, a items elementy danych.

Jeśli skrypt utworzy zdarzenie dragover i przekaże mu nowy obiekt DataTransfer, magazyn danych nie przechodzi przez to w tryb chroniony. getData() nadal może zwrócić dane zapisane przez setData().

Aby zwykły element przyjmował upuszczenie, anuluj dragover przez preventDefault(). Przy natywnym przeciąganiu odczytaj dane synchronicznie w obsłudze drop, zanim zakończy się dostęp do magazynu. Skopiuj potrzebne wartości przed pracą asynchroniczną.

To API przeglądarkowe standardu HTML, nie funkcja określonej edycji ECMAScript. Dostępność w Node 24 nie dowodzi obsługi przeglądarkowej. Przykład wymaga konstruktorów DragEvent i DataTransfer; tworzenie zdarzenia skryptem nie rozpoczyna natywnego przeciągania.

Przykłady

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

Wynik

true
CKTIS
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła