Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

DataTransfer.effectAllowed — povolené operace přetažení

DataTransfer.effectAllowed určuje, které operace zdroj přetažení povoluje. Nevybírá konečnou operaci: tu popisuje dropEffect a jeho hodnota musí odpovídat povolené množině.

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

Syntaxe

dataTransfer.effectAllowed
 dataTransfer.effectAllowed = "copyMove";

DataTransfer.effectAllowed je řetězcová vlastnost rozhraní prohlížeče, nikoli funkce ECMAScriptu. Při přetahování ji zdroj nastavuje v obsluze události dragstart, kdy je úložiště dat přetažení v režimu čtení a zápisu. V ostatních režimech nebo při neplatné hodnotě přiřazení předchozí hodnotu nezmění.

Povolené hodnoty jsou none (žádná operace), copy, link, move, dvojice copyLink, copyMove, linkMove a také all (všechny tři) a uninitialized (výchozí stav bez výslovného omezení). Rozlišují se velká a malá písmena. Skutečné přetažení začíná s hodnotou uninitialized.

dropEffect popisuje vybranou operaci, nikoli množinu povolených operací. Cíl obvykle zruší dragover pomocí preventDefault() a nastaví kompatibilní dropEffect. Při nesouladu nelze přetahovaný obsah upustit; samotné effectAllowed data aplikace nekopíruje ani nepřesouvá.

Při ověřeném spuštění v Chromiu konzole ukazuje, že u samostatného objektu vytvořeného pomocí new DataTransfer() zůstává hodnota none jak po přiřazení platného copyMove, tak po přiřazení neplatného COPY. To se liší od standardu HTML: úložiště dat objektu vytvořeného pomocí new DataTransfer() je v režimu čtení a zápisu, takže platné přiřazení by mělo nastavit effectAllowed na copyMove a následné neplatné přiřazení COPY by mělo hodnotu copyMove ponechat beze změny. Výstup konzole ukazuje chování při tomto spuštění v Chromiu, nikoli pravidlo přiřazování stanovené pro všechny prohlížeče.

Když uživatel začne přetahovat, obsluha události dragstart nastaví na event.dataTransfer hodnotu copyMove; následné přiřazení COPY tuto hodnotu nezmění. Příklad je určen pro prohlížeče; přítomnost Node 24 v repozitáři nedokazuje podporu tohoto API.

Pří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ýsledek

Standalone after copyMove: none
Standalone after COPY: none

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje