CKTIS / JavaScript
DataTransfer.effectAllowed — operazioni di trascinamento consentite
DataTransfer.effectAllowed specifica quali operazioni sono consentite dalla sorgente del trascinamento. Non sceglie l’operazione finale: dropEffect la descrive e deve essere compatibile con l’insieme consentito.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
dataTransfer.effectAllowed
dataTransfer.effectAllowed = "copyMove";DataTransfer.effectAllowed è una proprietà stringa di un’interfaccia del browser, non una funzionalità ECMAScript. Durante un trascinamento, la sorgente la imposta nel gestore di dragstart, quando l’archivio dei dati del trascinamento è in modalità di lettura e scrittura. Nelle altre modalità o con un valore non valido, l’assegnazione non cambia il valore precedente.
I valori consentiti sono none (nessuna operazione), copy, link, move, le coppie copyLink, copyMove, linkMove, oltre a all (tutte e tre) e uninitialized (lo stato predefinito senza una restrizione esplicita). Le maiuscole e le minuscole sono distinte. Un trascinamento reale inizia con uninitialized.
dropEffect descrive l’operazione selezionata, non l’insieme delle operazioni consentite. Di solito la destinazione annulla dragover con preventDefault() e imposta un dropEffect compatibile. Se i valori non sono compatibili, il rilascio viene impedito; effectAllowed da solo non copia né sposta i dati dell’applicazione.
Nell’esecuzione verificata in Chromium, la console mostra che per l’oggetto autonomo creato con new DataTransfer() il valore rimane none sia dopo l’assegnazione del valore valido copyMove sia dopo quella del valore non valido COPY. Questo risultato differisce da quanto previsto dallo standard HTML: l’archivio dei dati di un oggetto creato con new DataTransfer() è in modalità di lettura e scrittura, quindi l’assegnazione valida dovrebbe impostare effectAllowed su copyMove e la successiva assegnazione non valida di COPY dovrebbe lasciare il valore a copyMove. L’output della console mostra il comportamento di quella specifica esecuzione in Chromium, non la regola di assegnazione definita per tutti i browser.
Quando l’utente avvia un trascinamento, il gestore di dragstart imposta copyMove su event.dataTransfer; la successiva assegnazione di COPY non cambia quel valore. L’esempio è destinato ai browser; la presenza di Node 24 in un repository non dimostra il supporto per questa API.
Esempi
<!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>Risultato
Standalone after copyMove: none Standalone after COPY: none
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.