Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

DataTransfer: dane i dozwolone operacje przeciągania

DataTransfer przenosi dane podczas przeciągania. Poznaj różnicę między effectAllowed, które ogranicza operacje po stronie źródła, setData(), które zapisuje dane, oraz dropEffect, które określa wybraną operację po stronie celu.

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.setData(format, data);
event.dataTransfer.effectAllowed = "copyMove";
event.dataTransfer.dropEffect = "copy";

DataTransfer to interfejs Web API, a nie element samego ECMAScript. Podczas przeciągania jest dostępny jako event.dataTransfer. Występuje też w innych interfejsach, np. schowka, ale właściwości operacji przeciągania nie mają tam tego samego zastosowania. Obecność Node 24 nie dowodzi obsługi tego API w przeglądarce; przykład wymaga przeglądarki z obsługą natywnego HTML Drag and Drop.

DataTransfer.setData(format, data) zapisuje tekst pod określonym typem, np. text/plain, i zwraca undefined. Zgodnie ze standardem HTML ponowny zapis danych tego samego typu usuwa poprzednią pozycję z listy i dodaje nową na końcu, co może zmienić kolejność typów. W rzeczywistym przeciąganiu zapis wykonuj w dragstart; odczyt za pomocą getData() wykonuj w drop.

DataTransfer.effectAllowed określa operacje dopuszczone przez źródło i należy je ustawić w dragstart. Wartości to none, copy, copyLink, copyMove, link, linkMove, move, all oraz domyślne uninitialized, dopuszczające wszystkie operacje. Cel wybiera zgodną operację przez DataTransfer.dropEffect: none, copy, link albo move. Niepoprawne wartości obu właściwości są ignorowane.

W dragover wywołaj preventDefault(), aby umożliwić upuszczenie, i ustawiaj dropEffect przy każdym zdarzeniu. Wpływa ono na informację zwrotną, zwykle kursor, ale samo nie kopiuje ani nie usuwa danych. Logikę wykonuje aplikacja: przykład odczytuje tekst w drop i wyświetla go przez textContent, bez interpretowania jako HTML. Efekt move wymagałby także obsługi usunięcia danych ze źródła.

Przykłady

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

Wynik

Copied: CKTIS

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

Źródła