CKTIS / JavaScript
DataTransfer.effectAllowed — toegestane sleepbewerkingen
DataTransfer.effectAllowed geeft aan welke bewerkingen de sleepbron toestaat. De eigenschap kiest niet de uiteindelijke bewerking: dropEffect beschrijft die bewerking en moet overeenkomen met de toegestane set.
Versie: 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 is een tekenreekseigenschap van een browserinterface, geen ECMAScript-functie. Tijdens het slepen stelt de bron deze eigenschap in de dragstart-handler in, wanneer de opslag voor sleepgegevens in de lees-schrijfmodus staat. In andere modi of bij een ongeldige waarde verandert de toewijzing de vorige waarde niet.
Toegestane waarden zijn none (geen bewerking), copy, link, move, de paren copyLink, copyMove, linkMove, en ook all (alle drie) en uninitialized (de standaardtoestand zonder expliciete beperking). De waarden zijn hoofdlettergevoelig. Een echte sleepbewerking begint met uninitialized.
dropEffect beschrijft de geselecteerde bewerking, niet de set toegestane bewerkingen. Het doel annuleert dragover doorgaans met preventDefault() en stelt een compatibele dropEffect in. Bij een mismatch kan er niet worden neergezet; effectAllowed kopieert of verplaatst op zichzelf geen applicatiegegevens.
In de gecontroleerde uitvoering in Chromium laat de console zien dat de waarde op het zelfstandige object dat met new DataTransfer() is gemaakt, none blijft na zowel de toewijzing van het geldige copyMove als die van het ongeldige COPY. Dit wijkt af van de HTML-standaard: bij een object dat met new DataTransfer() is gemaakt, staat de opslag voor sleepgegevens in de lees-schrijfmodus. De geldige toewijzing zou effectAllowed dus op copyMove moeten zetten, waarna de ongeldige toewijzing van COPY die waarde ongewijzigd zou moeten laten. De console-uitvoer toont het gedrag bij deze uitvoering in Chromium, niet de toewijzingsregel die voor alle browsers is gespecificeerd.
Wanneer de gebruiker begint te slepen, stelt de dragstart-handler copyMove in op event.dataTransfer; de daaropvolgende toewijzing van COPY verandert die waarde niet. Het voorbeeld is bedoeld voor browsers; de aanwezigheid van Node 24 in een repository bewijst niet dat deze API wordt ondersteund.
Voorbeelden
<!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>Resultaat
Standalone after copyMove: none Standalone after COPY: none
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.