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

CKTIS / JavaScript

DataTransfer.effectAllowed — разрешени операции при влачене

DataTransfer.effectAllowed задава кои операции разрешава източникът на влаченето. Не избира крайната операция: нея описва dropEffect и стойността му трябва да съответства на разрешения набор.

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

Синтаксис

dataTransfer.effectAllowed
 dataTransfer.effectAllowed = "copyMove";

DataTransfer.effectAllowed е свойство със стойност от тип низ на интерфейс в браузъра, а не функция на ECMAScript. При влачене източникът го задава в обработчика на събитието dragstart, когато хранилището за данните на влаченето е в режим на четене и запис. В други режими или при невалидна стойност присвояването не променя предишната стойност.

Разрешените стойности са none (без операция), copy, link, move, двойките copyLink, copyMove, linkMove, както и all (и трите) и uninitialized (състоянието по подразбиране без изрично ограничение). Различават се главни и малки букви. Реалното влачене започва със стойност uninitialized.

dropEffect описва избраната операция, а не набора от разрешени операции. Целта обикновено отменя dragover чрез preventDefault() и задава съвместим dropEffect. При несъвпадение пускането е възпрепятствано; само по себе си effectAllowed не копира и не премества данни на приложението.

При провереното изпълнение в Chromium конзолата показва, че за самостоятелния обект, създаден с new DataTransfer(), стойността остава none както след присвояването на валидната стойност copyMove, така и след присвояването на невалидната стойност COPY. Този резултат се различава от предвиденото в стандарта HTML: хранилището за данни на обект, създаден с new DataTransfer(), е в режим на четене и запис, затова валидното присвояване трябва да зададе effectAllowed на copyMove, а последващото невалидно присвояване на COPY трябва да остави стойността copyMove непроменена. Изходът от конзолата показва поведението при това изпълнение в Chromium, а не правилото за присвояване, определено за всички браузъри.

Когато потребителят започне да влачи, обработчикът на dragstart задава copyMove в event.dataTransfer; последващото присвояване на COPY не променя тази стойност. Примерът е предназначен за браузъри; наличието на Node 24 в хранилище не доказва поддръжка на този API.

Примери

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>DataTransfer.effectAllowed</title>
</head>
<body>
  <h1>Allowed drag operations</h1>
  <p id="source" draggable="true">Drag this text, then press Escape to cancel.</p>
  <p id="status" role="status">Start a drag to see which operations the source allows.</p>
  <script>
    const standalone = new DataTransfer();
    standalone.effectAllowed = 'copyMove';
    console.log('Standalone after copyMove: ' + standalone.effectAllowed);
    standalone.effectAllowed = 'COPY';
    console.log('Standalone after COPY: ' + standalone.effectAllowed);

    document.getElementById('source').addEventListener('dragstart', (event) => {
      const transfer = event.dataTransfer;
      transfer.setData('text/plain', 'Example drag');
      transfer.effectAllowed = 'copyMove';
      const accepted = transfer.effectAllowed;
      transfer.effectAllowed = 'COPY';
      document.getElementById('status').textContent =
        'Drag source after copyMove: ' + accepted +
        '. After invalid COPY: ' + transfer.effectAllowed + '.';
    });
  </script>
</body>
</html>

Резултат

Standalone after copyMove: none
Standalone after COPY: none

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

Източници