Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

DataTransfer.effectAllowed — povolené operácie ťahania

DataTransfer.effectAllowed určuje, ktoré operácie zdroj ťahania povoľuje. Nevyberá konečnú operáciu: tú opisuje dropEffect a jeho hodnota musí zodpovedať povolenej množine.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

dataTransfer.effectAllowed
 dataTransfer.effectAllowed = "copyMove";

DataTransfer.effectAllowed je reťazcová vlastnosť rozhrania prehliadača, nie funkcia ECMAScriptu. Pri ťahaní ju zdroj nastavuje v obsluhe udalosti dragstart, keď je úložisko údajov ťahania v režime čítania a zápisu. V ostatných režimoch alebo pri neplatnej hodnote priradenie predchádzajúcu hodnotu nezmení.

Povolené hodnoty sú none (žiadna operácia), copy, link, move, dvojice copyLink, copyMove, linkMove a tiež all (všetky tri) a uninitialized (predvolený stav bez výslovného obmedzenia). Rozlišujú sa veľké a malé písmená. Skutočné ťahanie sa začína s hodnotou uninitialized.

dropEffect opisuje vybranú operáciu, nie množinu povolených operácií. Cieľ zvyčajne zruší dragover pomocou preventDefault() a nastaví kompatibilný dropEffect. Pri nesúlade nemožno obsah položiť; samotné effectAllowed údaje aplikácie nekopíruje ani nepresúva.

Pri overenom spustení v prehliadači Chromium konzola ukazuje, že v samostatnom objekte vytvorenom pomocou new DataTransfer() zostáva hodnota none po priradení platnej hodnoty copyMove aj po priradení neplatnej hodnoty COPY. Tento výsledok sa líši od toho, čo stanovuje štandard HTML: úložisko údajov objektu vytvoreného pomocou new DataTransfer() je v režime čítania a zápisu, takže platné priradenie by malo nastaviť effectAllowed na copyMove a následné neplatné priradenie COPY by malo hodnotu copyMove ponechať bez zmeny. Výstup konzoly ukazuje správanie pri tomto spustení v prehliadači Chromium, nie pravidlo priraďovania stanovené pre všetky prehliadače.

Keď používateľ začne ťahať, obsluha udalosti dragstart nastaví na event.dataTransfer hodnotu copyMove; následné priradenie COPY ju nezmení. Príklad je určený pre prehliadače; prítomnosť Node 24 v repozitári nedokazuje podporu tohto API.

Príklady

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

Výsledok

Standalone after copyMove: none
Standalone after COPY: none

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje