Przeciągnij i upuść

  
Przyjmuj dane typu „przeciągnij i upuść” z innej aplikacji lub z poziomu aplikacji i pokaż stałą aporcję docelową.
Najnowsza aktualizacja Wersja stabilna Kandydat 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 Google Maven. Więcej informacji znajdziesz w repozytorium Google Maven.

W pliku build.gradle aplikacji lub modułu dodaj zależności artefaktów, których potrzebujesz:

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ć Jetpack. Daj nam znać, jeśli znajdziesz nowe wydania lub masz pomysły na ulepszenie tej biblioteki. Zanim utworzysz nową bibliotekę, przejrzyj problemy z tą biblioteką. Możesz oddać głos w ramach istniejącego problemu, klikając przycisk gwiazdki.

Utwórz nowy numer

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

Wersja 1.0

Wersja 1.0.0

11 maja 2022 roku

Aplikacja androidx.draganddrop:draganddrop:1.0.0 została zwolniona. 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 wdrażanie funkcji przeciągania i upuszczania. Za pomocą funkcji DropHelper możesz określić wartości docelowe, dostosować wyróżnianie tych wartości i określić sposób postępowania z utraconymi danymi.

  • DropHelper korzysta z narzędzia OnReceiveContentListener Jetpack, aby umożliwiać konkretny proces przetwarzania przeciągania i upuszczania ClipData w zależności od celu. DropHelper zwiększa komfort korzystania z aplikacji, konfigurując elementy docelowe, które wyświetlają podświetlenie, gdy użytkownicy przeciągają treści nad obszarami docelowymi. Zagnieżdżona klasa DropHelper.Options pozwala dostosować wygląd domyślnego zaznaczenia.
  • DropHelper dołącza element OnReceiveContentListener do pomijania celów i konfiguruje elementy docelowe wykrywające zdarzenia „przeciągnij i upuść”. Jeśli używasz metody DropHelper, nie dołączaj elementu OnDragListener ani dodatkowego elementu OnReceiveContentListener, aby pomijać cele.
  • Funkcja DropHelper.Options umożliwia wyświetlenie wszystkich elementów EditText zawartych w hierarchii widoków złożonych miejsc docelowych. Jeśli są obecne, muszą być określone w ten sposób. Funkcja DropHelper zapobiega kradzieżom elementu EditText elementu docelowego, gdy użytkownik przeciągnie dane nad obszarem docelowym. Jeśli element ClipData typu „przeciągnij i upuść” obejmuje dane tekstowe i identyfikator URI, DropHelper wybiera jeden z elementów EditText w obszarze roboczym do obsługi danych tekstowych, gdy element ClipData zostanie utracony.

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

Wersja 1.0.0-rc01

20 kwietnia 2022 r.

Aplikacja androidx.draganddrop:draganddrop:1.0.0-rc01 została zwolniona. Wersja 1.0.0-rc01 zawiera te zatwierdzenia.

  • Brak zmian od ostatniej wersji beta.

Wersja 1.0.0-beta01

23 marca 2022 r.

Aplikacja androidx.draganddrop:draganddrop:1.0.0-beta01 została zwolniona. Wersja 1.0.0-beta01 zawiera te zatwierdzenia.

  • Brak zmian od ostatniej wersji alfa.

Wersja 1.0.0-alfa04

23 lutego 2022 r.

Aplikacja androidx.draganddrop:draganddrop:1.0.0-alpha04 została zwolniona. Wersja 1.0.0-alpha04 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Funkcja DragEvents z wartością argumentu localState nie ma wartości null nie będzie domyślnie wywoływać podświetlania. Dostępna jest opcja konfiguracji, która pozwala zmienić to działanie. (I55792)

Wersja 1.0.0-alfa03

26 stycznia 2022 r.

Aplikacja androidx.draganddrop:draganddrop:1.0.0-alpha03 została zwolniona. Wersja 1.0.0-alpha03 zawiera te zatwierdzenia.

Nowe funkcje

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

Wersja 1.0.0-alfa02

15 grudnia 2021 roku

Aplikacja androidx.draganddrop:draganddrop:1.0.0-alpha02 została zwolniona. Wersja 1.0.0-alpha02 zawiera te zatwierdzenia.

Funkcje w pierwszej wersji

DropHelper, pierwszy element biblioteki draganddrop, to klasa narzędziowa, która upraszcza wdrażanie funkcji przeciągania i upuszczania. Za pomocą funkcji DropHelper możesz określić wartości docelowe, dostosować wyróżnianie tych wartości i określić sposób postępowania z utraconymi danymi.

DropHelper korzysta z narzędzia OnReceiveContentListener Jetpack, aby umożliwiać konkretny proces przetwarzania przeciągania i upuszczania ClipData w zależności od celu. DropHelper zwiększa komfort korzystania z aplikacji, konfigurując elementy docelowe, które wyświetlają podświetlenie, gdy użytkownicy przeciągają treści nad obszarami docelowymi. Zagnieżdżona klasa DropHelper.Options pozwala dostosować kolor i promień narożnika domyślnego zaznaczenia.

DropHelper.Options umożliwia też wyświetlenie wszystkich elementów EditText zawartych w hierarchii widoków złożonych celów. Funkcja DropHelper zapobiega kradzieżom elementu EditText elementu docelowego, gdy użytkownik przeciągnie dane nad obszarem docelowym. Jeśli element ClipData typu „przeciągnij i upuść” obejmuje dane tekstowe i identyfikator URI, DropHelper wybiera jeden z elementów EditText w obszarze roboczym do obsługi danych tekstowych, gdy element ClipData zostanie utracony.

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