DragAndDrop

  
Aceite dados arrastados de outro app ou dentro do mesmo para mostrar uma ação de soltar consistente.
Atualização mais recente Versão estável Versão candidata a lançamento Versão Beta Versão Alfa
11 de maio de 2022 1.0.0 - - -

Declarar dependências

Para adicionar uma dependência a DragAndDrop, é preciso adicionar o repositório Maven do Google ao seu projeto. Veja mais informações em Repositório Maven do Google.

Adicione as dependências dos artefatos necessários ao arquivo build.gradle do seu app ou módulo:

Groovy

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

Kotlin

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

Para mais informações sobre dependências, consulte Adicionar dependências de build.

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas conhecidos nesta biblioteca antes de criar um novo. Adicione seu voto a um problema clicando no botão de estrela.

Criar novo problema

Consulte a documentação do Issue Tracker para saber mais.

Versão 1.0

Versão 1.0.0

11 de maio de 2022

Lançamento de androidx.draganddrop:draganddrop:1.0.0. A versão 1.0.0 contém estas confirmações.

Principais recursos da versão 1.0.0

A DropHelper, o primeiro membro da biblioteca draganddrop, é uma classe de utilitário que simplifica a implementação de recursos de arrastar e soltar. Use a DropHelper para especificar destinos em que itens serão soltos, personalizar o destaque do destino e definir como os dados soltos são processados.

  • A DropHelper usa a interface OnReceiveContentListener do Jetpack para oferecer processamento específico do destino da classe ClipData de arrastar e soltar. O uso de DropHelper melhora a experiência do usuário ao configurar destinos de soltar para mostrar um destaque conforme os usuários arrastam conteúdo sobre eles. A classe aninhada DropHelper.Options permite personalizar a aparência do destaque padrão.
  • A DropHelper anexa uma interface OnReceiveContentListener aos destinos de soltar e os configura para detectar eventos de arrastar e soltar. Não anexe um OnDragListener ou outra interface OnReceiveContentListener a destinos de soltar ao usar a DropHelper.
  • Com a DropHelper.Options, você pode listar todos os elementos EditText contidos na hierarquia de visualização em destinos de soltar complexos. Se houver algum, eles precisam ser especificados dessa forma. A DropHelper impede que os elementos EditText roubem o foco do destino quando os usuários arrastam dados sobre ele. Se a ClipData de arrastar e soltar incluir dados de texto e URI, a DropHelper vai selecionar um dos elementos EditText no destino para processar os dados de texto quando a ClipData for solta.

Se quiser mais informações, consulte o guia para desenvolvedores sobre Arrastar e soltar.

Versão 1.0.0-rc01

20 de abril de 2022

Lançamento de androidx.draganddrop:draganddrop:1.0.0-rc01. A versão 1.0.0-rc01 contém estas confirmações.

  • Nenhuma mudança desde a última versão Beta.

Versão 1.0.0-beta01

23 de março de 2022

Lançamento de androidx.draganddrop:draganddrop:1.0.0-beta01. A versão 1.0.0-beta01 contém estas confirmações:

  • Nenhuma mudança desde a última versão Alfa.

Versão 1.0.0-alpha04

23 de fevereiro de 2022

Lançamento de androidx.draganddrop:draganddrop:1.0.0-alpha04. A versão 1.0.0-alpha04 contém estas confirmações.

Mudanças na API

  • DragEvents com um localState não nulo não acionam o destaque por padrão. Há uma opção de configuração para mudar esse comportamento (I55792).

Versão 1.0.0-alpha03

26 de janeiro de 2022

Lançamento de androidx.draganddrop:draganddrop:1.0.0-alpha03. A versão 1.0.0-alpha03 contém estas confirmações.

Novos recursos

  • Em dispositivos com Android S ou versões mais recentes, o DropHelper agora delega a implementação do sistema do OnReceiveContentListener, oferecendo suporte automaticamente a métodos de entrada que não sejam arrastar e soltar.

Versão 1.0.0-alpha02

15 de dezembro de 2021

Lançamento de androidx.draganddrop:draganddrop:1.0.0-alpha02. A versão 1.0.0-alpha02 contém estas confirmações.

Recursos na versão inicial

A DropHelper, o primeiro membro da biblioteca draganddrop, é uma classe de utilitário que simplifica a implementação de recursos de arrastar e soltar. Use a DropHelper para especificar destinos em que itens serão soltos, personalizar o destaque do destino e definir como os dados soltos são processados.

A DropHelper usa a interface OnReceiveContentListener do Jetpack para oferecer processamento específico do destino da classe ClipData de arrastar e soltar. O uso de DropHelper melhora a experiência do usuário ao configurar destinos de soltar para mostrar um destaque conforme os usuários arrastam conteúdo sobre eles. A classe aninhada DropHelper.Options permite personalizar o raio da cor e do canto do destaque padrão.

A DropHelper.Options também permite listar todos os elementos EditText na hierarquia de visualização de destinos de soltar complexos. A DropHelper impede que os elementos EditText roubem o foco do destino quando os usuários arrastam dados sobre ele. Se a ClipData de arrastar e soltar incluir dados de texto e URI, a DropHelper vai selecionar um dos elementos EditText no destino para processar os dados de texto quando a ClipData for solta.

Para mais informações, consulte o guia do desenvolvedor sobre Arrastar e soltar.