DragAndDrop

  
Akceptowanie danych przeciąganych z innej aplikacji lub z aplikacji oraz wyświetlanie spójnego miejsca docelowo.
Ostatnia 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ć repozytorium Google Maven do projektu. Więcej informacji znajdziesz w repozytorium Maven firmy Google.

Dodaj zależności dla artefaktów, których potrzebujesz, 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.

Opinia

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

Tworzenie nowego zgłoszenia

Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.

Wersja 1.0

Wersja 1.0.0

11 maja 2022 roku

Element androidx.draganddrop:draganddrop:1.0.0 został zwolniony. Wersja 1.0.0 zawiera te zatwierdzenia.

Główne funkcje wersji 1.0.0

DropHelper, pierwszy element biblioteki draganddrop, to klasa pomocnicza, która upraszcza implementację funkcji przeciągania i upuszczania. Użyj opcji DropHelper, aby określić cele odrzucenia, dostosować wyróżnianie celu odrzucenia i określić sposób obsługi odrzuconych danych.

  • DropHelper korzysta z funkcji OnReceiveContentListener Jetpacka, aby przetwarzać elementy przeciągane i upuszczane ClipData w sposób dostosowany do konkretnego celu. DropHelper zwiększa wygodę użytkowników, ponieważ pozwala skonfigurować miejsca docelowe, aby wyświetlały podświetlenie podczas przeciągania treści na te miejsca. Za pomocą klasy zagnieżdżonej DropHelper.Options możesz dostosować wygląd domyślnego wyróżnienia.
  • DropHelper dołącza OnReceiveContentListener do celów przeciągania i skonfigurowuje je tak, aby słuchały zdarzeń przeciągania i upuszczania. Korzystając z elementu DropHelper, nie dołączaj elementu OnDragListener ani dodatkowego elementu OnReceiveContentListener, aby wykluczyć cele.
  • DropHelper.Options umożliwia wyświetlenie listy wszystkich elementów EditText zawartych w hierarchii widoku złożonych docelów przenoszenia. Jeśli są obecne, muszą być określone w ten sposób. DropHelper uniemożliwia elementom EditText przechwycenie fokusu od miejsca docelowo docelowego, gdy użytkownicy przeciągają dane do tego miejsca. Jeśli przeciąganie i upuszczanie ClipData obejmuje dane tekstowe i URI, DropHelper wybiera jeden z elementów EditText w miejscu docelowym, aby obsłużyć dane tekstowe po upuszczeniu elementu ClipData.

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

Wersja 1.0.0-rc01

20 kwietnia 2022 r.

Element androidx.draganddrop:draganddrop:1.0.0-rc01 został zwolniony. Wersja 1.0.0-rc01 zawiera te zatwierdzenia.

  • Brak zmian od ostatniej wersji beta.

Wersja 1.0.0-beta01

23 marca 2022 r.

Element androidx.draganddrop:draganddrop:1.0.0-beta01 został zwolniony. Wersja 1.0.0-beta01 zawiera te commity.

  • Brak zmian od ostatniej wersji alfa.

Wersja 1.0.0-alpha04

23 lutego 2022 r.

Element androidx.draganddrop:draganddrop:1.0.0-alpha04 został zwolniony. Wersja 1.0.0-alpha04 zawiera te commity.

Zmiany w interfejsie API

  • Zdarzenia DragEvents o wartości niezerowej w localState nie będą domyślnie uruchamiać wyróżniania. Aby zmienić to zachowanie, możesz użyć opcji konfiguracji. (I55792)

Wersja 1.0.0-alpha03

26 stycznia 2022 r.

Element androidx.draganddrop:draganddrop:1.0.0-alpha03 został zwolniony. Wersja 1.0.0-alpha03 zawiera te commity.

Nowe funkcje

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

Wersja 1.0.0-alpha02

15 grudnia 2021 roku

Element androidx.draganddrop:draganddrop:1.0.0-alpha02 został zwolniony. Wersja 1.0.0-alpha02 zawiera te commity.

Funkcje dostępne w pierwszej wersji

DropHelper, pierwszy element biblioteki draganddrop, to klasa pomocnicza, która upraszcza implementację funkcji przeciągania i upuszczania. Użyj opcji DropHelper, aby określić cele odrzucenia, dostosować wyróżnianie celu odrzucenia i określić sposób obsługi odrzuconych danych.

DropHelper korzysta z funkcji OnReceiveContentListener Jetpacka, aby przetwarzać elementy przeciągane i upuszczane ClipData w sposób dostosowany do konkretnego celu. DropHelper zwiększa wygodę użytkowników, ponieważ pozwala skonfigurować miejsca docelowe, aby wyświetlały podświetlenie podczas przeciągania treści na te miejsca. Klasa zagnieżdżona DropHelper.Options umożliwia dostosowanie koloru i promienia zaokrąglenia narożników domyślnego wyróżnienia.

DropHelper.Options umożliwia też wyświetlenie wszystkich elementów EditText zawartych w hierarchii widoku złożonych celów przenoszenia. DropHelper uniemożliwia elementom EditText przechwycenie fokusu od miejsca docelowo docelowego, gdy użytkownicy przeciągają dane do tego miejsca. Jeśli przeciąganie i upuszczanie ClipData obejmuje dane tekstowe i URI, DropHelper wybiera jeden z elementów EditText w miejscu docelowym, aby obsłużyć dane tekstowe po upuszczeniu elementu ClipData.

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