DataTransfer: addElement()-Methode
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.
Die addElement()-Methode des DataTransfer-Interfaces setzt die Zugriffsquelle auf das angegebene Element. Dieses Element wird das Element sein, auf das drag- und dragend-Ereignisse ausgelöst werden, und nicht der Standardzielknoten (der Knoten, der gezogen wurde).
Während einer Ziehoperation kann diese Methode nur im Handler für das dragstart-Ereignis verwendet werden, da dies der einzige Zeitpunkt ist, an dem der Datenspeicher der Ziehoperation beschreibbar ist. Ein Aufruf in einem anderen Ziehereignis löst einen NoModificationAllowedError DOMException aus. Siehe Ändern des Drag-Datenspeichers für Details.
Syntax
addElement(element)
Parameter
Rückgabewert
Keiner (undefined).
Ausnahmen
NoModificationAllowedErrorDOMException-
Wird ausgelöst, wenn der Drag-Datenspeicher nicht im Lese-/Schreibmodus ist.
Beispiele
Dieses Beispiel zeigt die Verwendung der addElement()-Methode
function changeDragNode(event, node) {
const dt = event.dataTransfer;
dt.addElement(node);
}
Spezifikationen
Diese Methode ist in keinem Web-Standard definiert.