Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

DataTransfer.effectAllowed — dopuštene operacije povlačenja

DataTransfer.effectAllowed određuje koje operacije izvor povlačenja dopušta. Ne odabire završnu operaciju: nju opisuje dropEffect i njegova vrijednost mora odgovarati dopuštenom skupu.

Verzija: 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 svojstvo je tekstualnog tipa na sučelju preglednika, a ne značajka ECMAScripta. Pri povlačenju izvor ga postavlja u funkciji za obradu događaja dragstart, kada je spremište podataka povlačenja u načinu čitanja i pisanja. U drugim načinima ili uz nevaljanu vrijednost dodjela ne mijenja prethodnu vrijednost.

Dopuštene su vrijednosti none (nijedna operacija), copy, link, move, parovi copyLink, copyMove, linkMove, kao i all (sve tri) i uninitialized (zadano stanje bez izričitog ograničenja). Razlikuju se velika i mala slova. Stvarno povlačenje počinje s vrijednošću uninitialized.

dropEffect opisuje odabranu operaciju, a ne skup dopuštenih operacija. Cilj obično otkazuje dragover pomoću preventDefault() i postavlja kompatibilan dropEffect. U slučaju neusklađenosti nije moguće ispustiti sadržaj; sam effectAllowed ne kopira niti premješta podatke aplikacije.

Pri provjerenom izvođenju u Chromiumu konzola pokazuje da na samostalnom objektu stvorenom pomoću new DataTransfer() vrijednost ostaje none i nakon dodjele valjane vrijednosti copyMove i nakon dodjele nevaljane vrijednosti COPY. Taj se rezultat razlikuje od onoga što propisuje standard HTML-a: spremište podataka objekta stvorenog pomoću new DataTransfer() u načinu je čitanja i pisanja, pa bi valjana dodjela trebala postaviti effectAllowed na copyMove, a naknadna nevaljana dodjela COPY trebala bi ostaviti vrijednost copyMove nepromijenjenom. Ispis u konzoli prikazuje ponašanje pri tom izvođenju u Chromiumu, a ne pravilo dodjele propisano za sve preglednike.

Kada korisnik započne povlačenje, funkcija za obradu događaja dragstart postavlja copyMove na event.dataTransfer; naknadna dodjela COPY ne mijenja tu vrijednost. Primjer je namijenjen preglednicima; prisutnost Node 24 u repozitoriju ne dokazuje podršku za ovaj API.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori