Das globalearia-dropeffect-Attribut zeigt an, welche Funktionen ausgeführt werden können, wenn ein gezogenes Objekt auf dem Ziel abgelegt wird.Veraltet

Beschreibung

In ARIA 1.1 als veraltet eingestuft, zeigt diearia-dropeffect-Eigenschaft an, welche Funktionen ausgeführt werden können, wenn ein gezogenes Objekt auf dem Ziel abgelegt wird. Das globalearia-dropeffect-Attribut bietet Benutzern assistierender Technologien die gleichen Informationen, die über dasDataTransfer.dropEffect den sehenden Benutzern über das Dropeffekt-Symbol bereitgestellt werden.

Texte, Bilder und Links können standardmäßig gezogen werden. Durch Setzen des globalendraggable="true"-Attributs, Teil der HTML5-Drag-and-Drop-API, mit einemdragstart-Ereignishandler, kann auch jeder DOM-Knoten ziehbar gemacht werden.

Bei einem Ziehereignis wird ein durchscheinendes Bild des gezogenen Elements erzeugt, das dem Zeiger des Benutzers während des Ziehvorgangs folgt. Das Standardbild kann mitsetDragImage durch jedes andere Bild ersetzt werden. Zusammen mit dem Standardbild, das das gezogene Element identifiziert, gibt es einedataTransfer.dropEffect-Eigenschaft, die verwendet werden kann, um das visuelle Feedback zu steuern, das der Benutzer während eines Drag-and-Drop-Vorgangs erhält. Diearia-dropeffect-Eigenschaft sollte verwendet werden, um Benutzern assistierender Technologien das gleiche Feedback bereitzustellen, das sehende Benutzer über diedataTransfer.dropEffect-Eigenschaft erhalten.

dropeffect definiert, welchen Cursor der Browser beim Ziehen anzeigt und wird auf dem Element gesetzt, auf das das Element abgelegt werden kann. Während des Ziehvorgangs, wenn das ziehbare Element über verschiedene Ablegebereiche gezogen wird, sollten sowohl diedataTransfer.dropeffect als auch diearia-dropeffect angepasst werden, um die Art der Operation anzuzeigen, die ausgeführt wird, wenn das gezogene Element freigegeben wird.

Für ein bestimmtes Element können mehrere Ablegeeffekte unterstützt werden. Daher ist der Wert desaria-dropeffect-Attributs eine durch Leerzeichen getrennte Liste von Funktionen. Zu den Funktionen gehörencopy,execute,link undmove. Die Standardeinstellung istnone, was bedeutet, dass keine Funktionalität in der Anwendung unterstützt wird. Die Einstellungaria-dropeffect="popup" informiert Benutzer assistierender Technologien darüber, dass es ein Popup-Menü oder einen Dialog mit Ziehoperationen gibt, aus denen der Benutzer wählen kann.

Das Einfügen des Attributs ermöglicht es assistierenden Technologien, die möglichen Ziehoptionen an den Benutzer der assistierenden Technologie zu übermitteln, fügt jedoch keine tatsächliche Funktionalität hinzu.

Es wird erwartet, dass diearia-dropeffect-Eigenschaft in einer zukünftigen Version von WAI-ARIA durch eine neue Funktion ersetzt wird und gilt als veraltet.

Typischerweise können Ablegeeffekt-Funktionen erst bereitgestellt werden, nachdem ein Objekt für einen Ziehvorgang ergriffen wurde, da die verfügbaren Ablegeeffekt-Funktionen vom gezogenen Objekt abhängen. Daher fügen Siearia-dropeffect in der Regel allen potenziellen Ablegezielen hinzu, wenn dasdragstart-Ereignis ausgelöst wird.

Werte

Der Wert ist eine durch Leerzeichen getrennte Liste möglicher Aktionen. Die folgenden sind die gültigen Tokens:

copy

Eine Kopie des Quellobjekts wird in das Ziel abgelegt.

execute

Eine Funktion, die vom Ziel unterstützt wird, wird ausgeführt, wobei die Ziehquelle als Eingabe verwendet wird.

link

Eine Referenz oder Verknüpfung zum gezogenen Objekt wird im Zielobjekt erstellt.

move

Das Quellobjekt wird von seinem aktuellen Standort entfernt und in das Ziel abgelegt.

none (Standard)

Es kann keine Operation ausgeführt werden; bricht den Ziehvorgang effektiv ab, wenn versucht wird, auf dieses Objekt abzulegen. Wird ignoriert, wenn es mit einem anderen Tokenwert kombiniert wird; beispielsweise ist 'none copy' gleichbedeutend mit einem 'copy'-Wert.

popup

Es gibt ein Popup-Menü oder einen Dialog, der dem Benutzer erlaubt, eine der Ziehoperationen (copy, move, link, execute) und jede andere Ziehfunktionalität wie Abbrechen auszuwählen.

Zugeordnete Rollen

Wird inALLEN Rollen verwendet.

Spezifikationen

Siehe auch

• aria-grabbed
• HTML Globalesdraggable-Attribut
• HTMLDrag-and-Drop-API
• dataTransfer
• DataTransfer.dropEffect
• dragstart