DragAndDrop

  
Akceptuj dane przeciągane z innej aplikacji lub w aplikacji i wyświetlaj spójny element docelowy.
Najnowsza aktualizacja Wersja stabilna Wersja kandydująca do publikacji Wersja beta Wersja alfa
11 maja 2022 roku 1.0.0 - - -

Deklarowanie zależności

Aby dodać zależność od DragAndDrop, musisz dodać do projektu repozytorium Maven Google. Więcej informacji znajdziesz w artykule Repozytorium Maven Google.

Dodaj zależności od potrzebnych artefaktów w pliku build.gradle aplikacji lub modułu:

Odlotowe

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

Kotlin

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

Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.

Prześlij opinię

Twoja opinia pomoże nam ulepszyć Jetpack. Jeśli znajdziesz nowe problemy lub masz pomysły na ulepszenie tej biblioteki, daj nam znać. Zanim utworzysz nowy problem, zapoznaj się z istniejącymi problemami w tej bibliotece. Możesz dodać swój głos do istniejącego problemu, klikając przycisk gwiazdki.

Utwórz nowy problem

Więcej informacji znajdziesz w dokumentacji narzędzia do śledzenia problemów Issue Tracker documentation.

Wersja 1.0

Wersja 1.0.0

11 maja 2022 roku

Publikacja androidx.draganddrop:draganddrop:1.0.0 Wersja 1.0.0 zawiera te zatwierdzenia.

Główne funkcje wersji 1.0.0

DropHelper, pierwszy element biblioteki draganddrop, to klasa narzędziowa, która upraszcza implementację funkcji przeciągania i upuszczania. Użyj DropHelper, aby określić elementy docelowe, dostosować wyróżnienie elementu docelowego i zdefiniować sposób obsługi upuszczonych danych.

  • DropHelper wykorzystuje OnReceiveContentListener z Jetpack, aby zapewnić przetwarzanie przeciągania i upuszczania ClipData specyficzne dla elementu docelowego. DropHelper zwiększa wygodę użytkowników, konfigurując elementy docelowe tak, aby wyświetlały wyróżnienie, gdy użytkownicy przeciągają treści nad elementami docelowymi. Zagnieżdżona klasa DropHelper.Options umożliwia dostosowanie wyglądu domyślnego wyróżnienia.
  • DropHelper dołącza OnReceiveContentListener do elementów docelowych i konfiguruje je tak, aby nasłuchiwały zdarzeń przeciągania i upuszczania. Gdy używas4/, nie dołączaj do elementów docelowych OnDragListener ani dodatkowego OnReceiveContentListener.DropHelper
  • DropHelper.Options umożliwia wyświetlenie listy wszystkich elementów EditText zawartych w hierarchii widoków złożonych elementów docelowych. Jeśli są obecne, muszą być określone w ten sposób. DropHelper uniemożliwia elementom EditText przejęcie fokusu z elementu docelowego, gdy użytkownicy przeciągają dane nad elementem docelowym. Jeśli przeciąganie i upuszczanie ClipData zawiera tekst i dane URI, DropHelper wybiera jeden z elementów EditText w elemencie docelowym, aby obsługiwać dane tekstowe, gdy ClipData zostanie upuszczony.

Więcej informacji znajdziesz w przewodniku dla programistów dotyczącym przeciągania i upuszczania.

Wersja 1.0.0-rc01

20 kwietnia 2022 roku

Publikacja androidx.draganddrop:draganddrop:1.0.0-rc01 Wersja 1.0.0-rc01 zawiera te zatwierdzenia.

  • Brak zmian od ostatniej wersji beta.

Wersja 1.0.0-beta01

23 marca 2022 roku

Publikacja androidx.draganddrop:draganddrop:1.0.0-beta01 Wersja 1.0.0-beta01 zawiera te zatwierdzenia.

  • Brak zmian od ostatniej wersji alfa.

Wersja 1.0.0-alpha04

23 lutego 2022 roku

Publikacja androidx.draganddrop:draganddrop:1.0.0-alpha04 Wersja 1.0.0-alpha04 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Domyślnie DragEvents z niepustym localState nie będą wywoływać wyróżnienia. Istnieje opcja konfiguracji, która umożliwia zmianę tego zachowania. (I55792)

Wersja 1.0.0-alpha03

26 stycznia 2022 roku

Publikacja androidx.draganddrop:draganddrop:1.0.0-alpha03 Wersja 1.0.0-alpha03 zawiera te zatwierdzenia.

Nowe funkcje

  • Na urządzeniach z Androidem S lub nowszym DropHelper deleguje teraz do implementacji systemowej OnReceiveContentListener, automatycznie zapewniając obsługę metod wprowadzania innych niż przeciąganie i upuszczanie.

Wersja 1.0.0-alpha02

15 grudnia 2021 roku

Publikacja androidx.draganddrop:draganddrop:1.0.0-alpha02 Wersja 1.0.0-alpha02 zawiera te zatwierdzenia.

Funkcje w wersji początkowej

DropHelper, pierwszy element biblioteki draganddrop, to klasa narzędziowa, która upraszcza implementację funkcji przeciągania i upuszczania. Użyj DropHelper, aby określić elementy docelowe, dostosować wyróżnienie elementu docelowego i zdefiniować sposób obsługi upuszczonych danych.

DropHelper wykorzystuje OnReceiveContentListener z Jetpack, aby zapewnić przetwarzanie przeciągania i upuszczania ClipData specyficzne dla elementu docelowego. DropHelper zwiększa wygodę użytkowników, konfigurując elementy docelowe tak, aby wyświetlały wyróżnienie, gdy użytkownicy przeciągają treści nad elementami docelowymi. Zagnieżdżona klasa DropHelper.Options umożliwia dostosowanie koloru i promienia narożników domyślnego wyróżnienia.

DropHelper.Options umożliwia też wyświetlenie listy wszystkich elementów EditText zawartych w hierarchii widoków złożonych elementów docelowych. DropHelper uniemożliwia elementom EditText przejęcie fokusu z elementu docelowego, gdy użytkownicy przeciągają dane nad elementem docelowym. Jeśli przeciąganie i upuszczanie ClipData zawiera tekst i dane URI, DropHelper wybiera jeden z elementów EditText w elemencie docelowym, aby obsługiwać dane tekstowe, gdy ClipData zostanie upuszczony.

Więcej informacji znajdziesz w przewodniku dla programistów dotyczącym przeciągania i upuszczania.