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.