CKTIS / JavaScript
DataTransfer.effectAllowed — dovoljene operacije vlečenja
DataTransfer.effectAllowed določa, katere operacije vir vlečenja dovoljuje. Ne izbere končne operacije: to opisuje dropEffect, katerega vrednost se mora ujemati z dovoljenim naborom.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
dataTransfer.effectAllowed
dataTransfer.effectAllowed = "copyMove";DataTransfer.effectAllowed je lastnost z besedilno vrednostjo v vmesniku brskalnika, ne funkcija ECMAScript. Med vlečenjem jo vir nastavi v obravnavalniku dogodka dragstart, ko je shramba podatkov vlečenja v načinu branja in pisanja. V drugih načinih ali pri neveljavni vrednosti dodelitev prejšnje vrednosti ne spremeni.
Dovoljene vrednosti so none (brez operacije), copy, link, move, pari copyLink, copyMove, linkMove ter all (vse tri) in uninitialized (privzeto stanje brez izrecne omejitve). Pri vrednostih so pomembne velike in male črke. Dejansko vlečenje se začne z vrednostjo uninitialized.
dropEffect opisuje izbrano operacijo, ne nabora dovoljenih operacij. Cilj običajno prekliče dragover z preventDefault() in nastavi združljiv dropEffect. Ob neujemanju spuščanje ni mogoče; effectAllowed sam ne kopira ali premika podatkov aplikacije.
Pri preverjenem zagonu v Chromiumu konzola pokaže, da pri samostojnem objektu, ustvarjenem z new DataTransfer(), vrednost ostane none tako po dodelitvi veljavne vrednosti copyMove kot po dodelitvi neveljavne vrednosti COPY. Ta rezultat odstopa od standarda HTML: shramba podatkov objekta, ustvarjenega z new DataTransfer(), je v načinu branja in pisanja, zato bi morala veljavna dodelitev nastaviti effectAllowed na copyMove, poznejša neveljavna dodelitev COPY pa bi morala vrednost copyMove pustiti nespremenjeno. Izpis v konzoli prikazuje vedenje pri tem zagonu v Chromiumu in ne pravila dodeljevanja, določenega za vse brskalnike.
Ko uporabnik začne vleči, obravnavalnik dogodka dragstart na event.dataTransfer nastavi vrednost copyMove; poznejša dodelitev COPY je ne spremeni. Primer je namenjen brskalnikom; prisotnost Node 24 v repozitoriju ne dokazuje podpore za ta API.
Primeri
<!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>Rezultat
Standalone after copyMove: none Standalone after COPY: none
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.