DragAndDrop

  
Akzeptieren Sie Drag-and-drop-Daten aus einer anderen App oder innerhalb einer App und zeigen Sie ein einheitliches Drop-Ziel-Affordance an.
Letzte Aktualisierung Stabile Version Releasekandidat Beta-Ausgabe Alphaversion
11. Mai 2022 1.0.0 - – -

Abhängigkeiten deklarieren

Wenn Sie eine Abhängigkeit von DragAndDrop hinzufügen möchten, 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 App oder Ihr Modul die Abhängigkeiten für die erforderlichen 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

Ihr Feedback hilft uns, Jetpack zu verbessern. Bitte teilen Sie uns mit, wenn Sie neue Probleme feststellen oder Ideen zur Verbesserung dieser Bibliothek haben. Sehen Sie sich die vorhandenen Probleme in dieser Bibliothek an, bevor Sie ein neues erstellen. Sie können einem vorhandenen Problem Ihre Stimme geben, indem Sie auf die Schaltfläche mit dem Stern klicken.

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 veröffentlicht. Version 1.0.0 enthält diese Commits.

Wichtige Funktionen von 1.0.0

DropHelper, das erste Mitglied der draganddrop-Bibliothek, ist eine Dienstprogrammklasse, die die Implementierung von Drag-and-drop-Funktionen vereinfacht. Mit DropHelper können Sie Drop-Ziele angeben, die Hervorhebung von Drop-Zielen anpassen und festlegen, wie Drop-Daten verarbeitet werden.

  • DropHelper nutzt die OnReceiveContentListener von Jetpack, um eine zielspezifische Verarbeitung von Drag-and-drop-ClipData zu ermöglichen. DropHelper verbessert die Nutzerfreundlichkeit, indem Drop-Ziele so konfiguriert werden, dass ein Highlight angezeigt wird, wenn Nutzer Inhalte auf die Ziele ziehen. Mit der verschachtelten Klasse DropHelper.Options können Sie das Aussehen der Standard-Hervorhebung anpassen.
  • DropHelper fügt Drop-Zielen ein OnReceiveContentListener hinzu und konfiguriert Drop-Ziele so, dass sie auf Drag-and-drop-Ereignisse achten. Fügen Sie bei Verwendung von DropHelper kein OnDragListener oder zusätzliches OnReceiveContentListener an, um Ziele zu setzen.
  • Mit DropHelper.Options können Sie alle EditText-Elemente auflisten, die in der Ansichtshierarchie komplexer Drop-Ziele enthalten sind. Falls vorhanden, müssen sie so angegeben werden. DropHelper verhindert, dass die EditText-Elemente den Fokus vom Drop-Ziel stehlen, wenn Nutzer Daten über das Ziel ziehen. Wenn das Drag-and-drop-Element ClipData Text- und URI-Daten enthält, wählt DropHelper eines der EditText-Elemente im Drop-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 veröffentlicht. 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 veröffentlicht. Version 1.0.0-beta01 enthält diese Commits.

  • Keine Änderungen seit der letzten Alphaversion.

Version 1.0.0-alpha04

23. Februar 2022

androidx.draganddrop:draganddrop:1.0.0-alpha04 wird veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.

API-Änderungen

  • DragEvents mit einem nicht nullwertigen localState lösen standardmäßig keine Hervorhebung aus. Es gibt eine Konfigurationsoption, mit der sich dieses Verhalten ändern lässt. (I55792)

Version 1.0.0-alpha03

26. Januar 2022

androidx.draganddrop:draganddrop:1.0.0-alpha03 wird veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.

Neue Funktionen

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

Version 1.0.0-alpha02

15. Dezember 2021

androidx.draganddrop:draganddrop:1.0.0-alpha02 wird veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.

Funktionen der ersten Version

DropHelper, das erste Mitglied der draganddrop-Bibliothek, ist eine Dienstprogrammklasse, die die Implementierung von Drag-and-drop-Funktionen vereinfacht. Mit DropHelper können Sie Drop-Ziele angeben, die Hervorhebung von Drop-Zielen anpassen und festlegen, wie Drop-Daten verarbeitet werden.

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

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

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