CKTIS / JavaScript
DataTransfer.effectAllowed — erlaubte Drag-and-drop-Operationen
DataTransfer.effectAllowed legt fest, welche Operationen die Drag-Quelle zulässt. Die Eigenschaft wählt nicht die endgültige Operation aus: Diese beschreibt dropEffect, dessen Wert mit der erlaubten Auswahl übereinstimmen muss.
Version: 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 ist eine String-Eigenschaft einer Browser-Schnittstelle, kein ECMAScript-Feature. Bei einem Ziehvorgang setzt die Quelle die Eigenschaft im dragstart-Handler, wenn sich der Speicher für die Drag-Daten im Lese-/Schreibmodus befindet. In anderen Modi oder bei einem ungültigen Wert ändert die Zuweisung den bisherigen Wert nicht.
Erlaubte Werte sind none (keine Operation), copy, link, move, die Paare copyLink, copyMove, linkMove sowie all (alle drei) und uninitialized (Standardzustand ohne ausdrückliche Einschränkung). Bei den Werten wird zwischen Groß- und Kleinschreibung unterschieden. Bei einem tatsächlichen Ziehvorgang ist uninitialized der Anfangswert.
dropEffect beschreibt die ausgewählte Operation, nicht die Menge der erlaubten Operationen. Das Ziel bricht dragover normalerweise mit preventDefault() ab und setzt einen passenden Wert für dropEffect. Bei einer Abweichung kann nicht abgelegt werden; effectAllowed allein kopiert oder verschiebt keine Anwendungsdaten.
Beim überprüften Lauf in Chromium zeigt die Konsole, dass der Wert beim eigenständigen, mit new DataTransfer() erstellten Objekt sowohl nach der gültigen Zuweisung von copyMove als auch nach der ungültigen Zuweisung von COPY auf none bleibt. Das weicht vom HTML-Standard ab: Der Speicher für die Drag-Daten eines mit new DataTransfer() erstellten Objekts befindet sich im Lese-/Schreibmodus. Daher sollte die gültige Zuweisung effectAllowed auf copyMove setzen und die anschließende ungültige Zuweisung von COPY den Wert copyMove unverändert lassen. Die Konsolenausgabe zeigt das Verhalten bei diesem Lauf in Chromium und nicht das browserübergreifend spezifizierte Verhalten bei der Zuweisung.
Beginnt der Nutzer einen Ziehvorgang, setzt der dragstart-Handler auf event.dataTransfer den Wert copyMove; die anschließende Zuweisung von COPY ändert diesen Wert nicht. Das Beispiel ist für Browser gedacht; die Verwendung von Node 24 in einem Repository belegt nicht, dass diese API unterstützt wird.
Beispiele
<!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>Ergebnis
Standalone after copyMove: none Standalone after COPY: none
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.