Drag-and-drop

  
Akzeptieren Sie Drag-and-drop-Daten aus einer anderen App oder innerhalb einer App und zeigen Sie einheitliche Zielangebote an.
Letzte Aktualisierung Stabile Version Releasekandidat Beta-Ausgabe Alpharelease
11. Mai 2022 1.0.0 - - -

Abhängigkeiten deklarieren

Zum Hinzufügen einer Abhängigkeit von DragAndDrop müssen Sie Ihrem Projekt das Google Maven-Repository hinzufügen. Weitere Informationen finden Sie im Maven-Repository von Google.

Fügen Sie der Datei build.gradle für Ihre Anwendung oder Ihr Modul die Abhängigkeiten für die benötigten Artefakte hinzu:

Cool

dependencies {
    implementation "androidx.draganddrop:draganddrop:1.0.0"
}

Kotlin

dependencies {
    implementation("androidx.draganddrop:draganddrop:1.0.0")
}

Weitere Informationen zu Abhängigkeiten finden Sie unter Build-Abhängigkeiten hinzufügen.

Feedback

Dein Feedback hilft uns, Jetpack zu verbessern. Lassen Sie uns wissen, wenn Sie neue Probleme entdecken oder Ideen zur Verbesserung dieser Bibliothek haben. Sehen Sie sich die vorhandenen Probleme in dieser Bibliothek an, bevor Sie eine neue erstellen. Durch Klicken auf die Stern-Schaltfläche können Sie zu einem vorhandenen Problem abstimmen.

Neues Problem erstellen

Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.

Version 1.0

Version 1.0.0

11. Mai 2022

androidx.draganddrop:draganddrop:1.0.0 wird freigegeben. Version 1.0.0 enthält diese Commits.

Hauptfunktionen von Version 1.0.0

DropHelper, das erste Mitglied der draganddrop-Bibliothek, ist eine Dienstprogrammklasse, die die Implementierung von Drag-and-drop-Funktionen vereinfacht. Verwende DropHelper, um Drop-Ziele anzugeben, die Hervorhebung von Drop-Zielen anzupassen und zu definieren, wie mit verworfenen Daten verfahren wird.

  • DropHelper nutzt OnReceiveContentListener von Jetpack, um eine zielspezifische Verarbeitung von Drag-and-drop ClipData zu ermöglichen. DropHelper optimiert die Nutzerfreundlichkeit, indem es Drop-Ziele so konfiguriert, dass ein Highlight angezeigt wird, wenn Nutzer Inhalte über die Ziele ziehen. Mit der verschachtelten Klasse DropHelper.Options kannst du das Erscheinungsbild der Standardhervorhebung anpassen.
  • DropHelper hängt zum Ablegen von Zielen ein OnReceiveContentListener an und konfiguriert Drop-Ziele so, dass Drag-and-drop-Ereignisse überwacht werden. Fügen Sie beim Ablegen von Zielen kein OnDragListener oder zusätzliche OnReceiveContentListener hinzu, wenn Sie DropHelper verwenden.
  • Mit DropHelper.Options können Sie alle EditText-Elemente auflisten, die in der Ansichtshierarchie komplexer Drop-Ziele enthalten sind. Falls welche vorhanden sind, müssen sie auf diese Weise angegeben werden. DropHelper verhindert, dass der Fokus des Drop-Ziels durch EditText-Elemente vom Ablegen-Ziel abgelenkt wird, wenn Nutzer Daten über das Ziel ziehen. Wenn das Drag-and-drop ClipData Text- und URI-Daten enthält, wählt DropHelper eines der EditText-Elemente im Drop-down-Ziel aus, um die Textdaten zu verarbeiten, wenn ClipData abgelegt wird.

Weitere Informationen finden Sie im Entwicklerhandbuch für Drag-and-drop.

Version 1.0.0-rc01

20. April 2022

androidx.draganddrop:draganddrop:1.0.0-rc01 wird freigegeben. Version 1.0.0-rc01 enthält diese Commits.

  • Keine Änderungen seit der letzten Betaversion.

Version 1.0.0-beta01

23. März 2022

androidx.draganddrop:draganddrop:1.0.0-beta01 wird freigegeben. Version 1.0.0-beta01 enthält diese Commits.

  • Keine Änderungen seit dem letzten Alpharelease.

Version 1.0.0-alpha04

23. Februar 2022

androidx.draganddrop:draganddrop:1.0.0-alpha04 wird freigegeben. Version 1.0.0-alpha04 enthält diese Commits.

API-Änderungen

  • DragEvents mit einem localState-Wert ungleich null löst standardmäßig keine Hervorhebung aus. Es gibt eine Konfigurationsoption, um dieses Verhalten zu ändern. (I55792)

Version 1.0.0-alpha03

26. Januar 2022

androidx.draganddrop:draganddrop:1.0.0-alpha03 wird freigegeben. Version 1.0.0-alpha03 enthält diese Commits.

Neue Funktionen

  • Auf Geräten mit Android S oder höher delegiert DropHelper jetzt an die Systemimplementierung von OnReceiveContentListener und unterstützt automatisch andere Eingabemethoden als Drag-and-drop.

Version 1.0.0-alpha02

15. Dezember 2021

androidx.draganddrop:draganddrop:1.0.0-alpha02 wird freigegeben. Version 1.0.0-alpha02 enthält diese Commits.

Funktionen in der ersten Version

DropHelper, das erste Mitglied der draganddrop-Bibliothek, ist eine Dienstprogrammklasse, die die Implementierung von Drag-and-drop-Funktionen vereinfacht. Verwende DropHelper, um Drop-Ziele anzugeben, die Hervorhebung von Drop-Zielen anzupassen und zu definieren, wie mit verworfenen Daten verfahren wird.

DropHelper nutzt OnReceiveContentListener von Jetpack, um eine zielspezifische Verarbeitung von Drag-and-drop ClipData zu ermöglichen. DropHelper optimiert die Nutzerfreundlichkeit, indem es Drop-Ziele so konfiguriert, dass ein Highlight angezeigt wird, wenn Nutzer Inhalte über die Ziele ziehen. Mit der verschachtelten Klasse DropHelper.Options können Sie die Farbe und den Eckenradius der Standardhervorhebung anpassen.

Mit DropHelper.Options können Sie außerdem alle EditText-Elemente auflisten, die in der Ansichtshierarchie komplexer Drop-Ziele enthalten sind. DropHelper verhindert, dass der Fokus des Drop-Ziels durch EditText-Elemente vom Ablegen-Ziel abgelenkt wird, wenn Nutzer Daten über das Ziel ziehen. Wenn das Drag-and-drop ClipData Text- und URI-Daten enthält, wählt DropHelper eines der EditText-Elemente im Drop-down-Ziel aus, um die Textdaten zu verarbeiten, wenn ClipData abgelegt wird.

Weitere Informationen finden Sie im Entwicklerhandbuch für Drag-and-drop.