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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.