DragAndDrop

Принимайте данные, перетаскиваемые из другого приложения или внутри него, и демонстрируйте единообразную область для перетаскивания.
Последнее обновление Стабильный релиз Предварительная версия релиза Бета-версия Альфа-версия
11 мая 2022 г. 1.0.0 - - -

Объявление зависимостей

Чтобы добавить зависимость от DragAndDrop, необходимо добавить репозиторий Google Maven в ваш проект. Для получения дополнительной информации ознакомьтесь с информацией в репозитории Google Maven .

Добавьте зависимости для необходимых артефактов в файл build.gradle вашего приложения или модуля:

классный 

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

Котлин 

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

Для получения дополнительной информации о зависимостях см. раздел «Добавление зависимостей сборки» .

Обратная связь

Ваши отзывы помогают улучшить Jetpack. Сообщите нам, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете проголосовать за существующую проблему, нажав кнопку со звездочкой.

Создать новую задачу

Для получения более подробной информации см. документацию по системе отслеживания ошибок .

Версия 1.0

Версия 1.0.0

11 мая 2022 г.

Выпущена версия androidx.draganddrop:draganddrop:1.0.0 . Версия 1.0.0 содержит следующие коммиты.

Основные особенности версии 1.0.0

DropHelper , первый компонент библиотеки draganddrop , — это вспомогательный класс, упрощающий реализацию функций перетаскивания. Используйте DropHelper для указания целевых областей для перетаскивания, настройки подсветки этих областей и определения способа обработки перетаскиваемых данных.

  • DropHelper использует OnReceiveContentListener из Jetpack для обработки перетаскиваемых ClipData с учетом их местоположения. DropHelper улучшает пользовательский опыт, настраивая области перетаскивания таким образом, чтобы при перетаскивании контента на них отображалась подсветка. Вложенный класс DropHelper.Options позволяет настраивать внешний вид подсветки по умолчанию.
  • DropHelper добавляет OnReceiveContentListener к целевым областям для перетаскивания и настраивает их на прослушивание событий перетаскивания. Не добавляйте OnDragListener или дополнительные OnReceiveContentListener к целевым областям для перетаскивания при использовании DropHelper .
  • DropHelper.Options позволяет перечислить все элементы EditText , содержащиеся в иерархии представлений сложных целевых областей для перетаскивания. Если какие-либо из них присутствуют, их необходимо указать таким образом. DropHelper предотвращает перехват фокуса элементами EditText у целевой области для перетаскивания, когда пользователи перетаскивают данные на эту область. Если перетаскиваемый объект ClipData содержит текст и данные URI, DropHelper выбирает один из элементов EditText в целевой области для обработки текстовых данных при перетаскивании ClipData .

Для получения более подробной информации см. руководство разработчика по функции перетаскивания .

Версия 1.0.0-rc01

20 апреля 2022 г.

Выпущена версия androidx.draganddrop:draganddrop:1.0.0-rc01 . Версия 1.0.0-rc01 содержит следующие коммиты.

  • С момента последнего бета-релиза изменений не наблюдалось.

Версия 1.0.0-beta01

23 марта 2022 г.

Выпущена версия androidx.draganddrop:draganddrop:1.0.0-beta01 . Версия 1.0.0-beta01 содержит следующие коммиты.

  • С момента последнего альфа-релиза изменений не наблюдалось.

Версия 1.0.0-alpha04

23 февраля 2022 г.

Выпущена версия androidx.draganddrop:draganddrop:1.0.0-alpha04 . Версия 1.0.0-alpha04 содержит следующие коммиты.

Изменения в API

  • События перетаскивания с ненулевым значением localState по умолчанию не будут запускать подсветку. Существует параметр конфигурации для изменения этого поведения. ( I55792 )

Версия 1.0.0-alpha03

26 января 2022 г.

Выпущена версия androidx.draganddrop:draganddrop:1.0.0-alpha03 . Версия 1.0.0-alpha03 содержит следующие коммиты.

Новые функции

  • На устройствах под управлением Android S или более поздних версий DropHelper теперь делегирует обработку события системной реализации OnReceiveContentListener , автоматически обеспечивая поддержку методов ввода, отличных от перетаскивания.

Версия 1.0.0-alpha02

15 декабря 2021 г.

Выпущена версия androidx.draganddrop:draganddrop:1.0.0-alpha02 . Версия 1.0.0-alpha02 содержит следующие коммиты.

Функции в первоначальном выпуске

DropHelper , первый компонент библиотеки draganddrop , — это вспомогательный класс, упрощающий реализацию функций перетаскивания. Используйте DropHelper для указания целевых областей для перетаскивания, настройки подсветки этих областей и определения способа обработки перетаскиваемых данных.

DropHelper использует OnReceiveContentListener из Jetpack для обработки перетаскиваемых ClipData с учетом специфики целевой области. DropHelper улучшает пользовательский опыт, настраивая целевые области таким образом, чтобы при перетаскивании контента на них отображалась подсветка. Вложенный класс DropHelper.Options позволяет настраивать цвет и радиус скругления углов подсветки по умолчанию.

DropHelper.Options также позволяет перечислить все элементы EditText , содержащиеся в иерархии представлений сложных целевых областей для перетаскивания. DropHelper предотвращает перехват фокуса элементами EditText у целевой области при перетаскивании данных. Если перетаскиваемые данные ClipData содержат текст и URI, DropHelper выбирает один из элементов EditText в целевой области для обработки текстовых данных при перетаскивании ClipData .

Для получения более подробной информации см. руководство разработчика по функции перетаскивания .