База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

DataTransfer: данни и разрешени операции при плъзгане

DataTransfer пренася данни при плъзгане. Научете как effectAllowed ограничава операциите при източника, setData() съхранява данните, а dropEffect избира операцията при целта, без самостоятелно да копира или премества данни.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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

DataTransfer е интерфейс на Web API, а не част от самия ECMAScript. По време на плъзгане е достъпен като event.dataTransfer. Използва се и от други интерфейси, например тези за клипборда, но свойствата за операциите при плъзгане нямат същата роля там. Наличието на Node 24 не доказва поддръжка на този API от браузър; примерът изисква браузър с поддръжка на нативния HTML Drag and Drop.

DataTransfer.setData(format, data) съхранява текст под зададен тип, например text/plain, и връща undefined. Според стандарта HTML при повторно записване на данни от същия тип старият елемент се премахва, а новият се добавя в края на списъка. Това може да промени реда на типовете. При действително плъзгане записвайте данните в dragstart, а ги четете с getData() в drop.

DataTransfer.effectAllowed указва операциите, разрешени от източника, и трябва да се зададе в dragstart. Стойностите са none, copy, copyLink, copyMove, link, linkMove, move, all и стойността по подразбиране uninitialized, която разрешава всички операции. Целта избира съвместима операция чрез DataTransfer.dropEffect: none, copy, link или move. Невалидните стойности и на двете свойства се игнорират.

В dragover извикайте preventDefault(), за да разрешите пускането, и задавайте dropEffect при всяко събитие. То влияе на визуалната обратна връзка, обикновено курсора, но само по себе си не копира и не изтрива данни. Приложението реализира това поведение: примерът прочита текста в drop и го показва чрез textContent, без да го интерпретира като HTML. Ефектът move би изисквал също обработка на премахването на данните от източника.

Примери

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

Резултат

Copied: CKTIS

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници