Trascina

  
Accetta i dati di trascinamento da un'altra app o all'interno di un'app e mostra un'affinità del target di rilascio coerente.
Aggiornamento più recente Release stabile Candidato per la release Versione beta Release alpha
11 maggio 2022 1.0.0 - - -

Dichiarazione delle dipendenze

Per aggiungere una dipendenza su DragAndDrop, devi aggiungere il Repository Maven di Google al tuo progetto. Per ulteriori informazioni, consulta il Repository Maven di Google.

Aggiungi le dipendenze per gli artefatti necessari nel file build.gradle per l'app o il modulo:

trendy

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

Kotlin

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

Per saperne di più sulle dipendenze, vedi Aggiungere dipendenze di build.

Feedback

Il tuo feedback ci aiuterà a migliorare Jetpack. Facci sapere se scopri nuovi problemi o se hai idee per migliorare questa libreria. Dai un'occhiata ai problemi esistenti in questa libreria prima di crearne uno nuovo. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.

Crea un nuovo problema

Per ulteriori informazioni, consulta la documentazione relativa al monitoraggio dei problemi.

Versione 1.0

Versione 1.0.0

11 maggio 2022

androidx.draganddrop:draganddrop:1.0.0 viene rilasciato. La versione 1.0.0 contiene questi commit.

Funzionalità principali della versione 1.0.0

DropHelper, il primo membro della libreria draganddrop, è una classe di utilità che semplifica l'implementazione delle funzionalità di trascinamento. Usa DropHelper per specificare i target di rilascio, personalizzare l'evidenziazione dei target di rilascio e definire la modalità di gestione dei dati eliminati.

  • DropHelper utilizza OnReceiveContentListener di Jetpack per fornire l'elaborazione del trascinamento ClipData specifica per un target. DropHelper migliora l'esperienza utente configurando i target di rilascio per mostrare un'evidenziazione mentre gli utenti trascinano i contenuti sui target. La classe nidificata DropHelper.Options consente di personalizzare l'aspetto dell'evidenziazione predefinita.
  • DropHelper collega un elemento OnReceiveContentListener per rilasciare i target e configura i target di rilascio per rilevare gli eventi di trascinamento. Non collegare un elemento OnDragListener o un elemento OnReceiveContentListener aggiuntivo per rilasciare target quando utilizzi DropHelper.
  • DropHelper.Options ti offre la possibilità di elencare tutti gli elementi EditText contenuti nella gerarchia di visualizzazione di target di rilascio complessi. Se sono presenti, devono essere specificati in questo modo. DropHelper impedisce agli elementi EditText di sottrarre lo stato attivo alla destinazione quando gli utenti trascinano i dati sopra la destinazione. Se l'elemento ClipData di trascinamento include dati di testo e URI, DropHelper seleziona uno degli elementi EditText nella destinazione del rilascio per gestire i dati di testo quando l'elemento ClipData viene rilasciato.

Per ulteriori informazioni, consulta la guida per gli sviluppatori relativa al trascinamento.

Versione 1.0.0-rc01

20 aprile 2022

androidx.draganddrop:draganddrop:1.0.0-rc01 viene rilasciato. La versione 1.0.0-rc01 contiene questi commit.

  • Nessuna modifica dall'ultima release beta.

Versione 1.0.0-beta01

23 marzo 2022

androidx.draganddrop:draganddrop:1.0.0-beta01 viene rilasciato. La versione 1.0.0-beta01 contiene questi commit.

  • Nessuna modifica dall'ultima release alpha.

Versione 1.0.0-alpha04

23 febbraio 2022

androidx.draganddrop:draganddrop:1.0.0-alpha04 viene rilasciato. La versione 1.0.0-alpha04 contiene questi commit.

Modifiche alle API

  • DragEvents con un localState non null non attiverà l'evidenziazione per impostazione predefinita. Esiste un'opzione di configurazione per modificare questo comportamento. (I55792)

Versione 1.0.0-alpha03

26 gennaio 2022

androidx.draganddrop:draganddrop:1.0.0-alpha03 viene rilasciato. La versione 1.0.0-alpha03 contiene questi commit.

Nuove funzionalità

  • Sui dispositivi con Android S o versioni successive, DropHelper ora delega all'implementazione di sistema di OnReceiveContentListener, fornendo automaticamente supporto per metodi di immissione diversi dal trascinamento.

Versione 1.0.0-alpha02

15 dicembre 2021

androidx.draganddrop:draganddrop:1.0.0-alpha02 viene rilasciato. La versione 1.0.0-alpha02 contiene questi commit.

Funzionalità nella release iniziale

DropHelper, il primo membro della libreria draganddrop, è una classe di utilità che semplifica l'implementazione delle funzionalità di trascinamento. Usa DropHelper per specificare i target di rilascio, personalizzare l'evidenziazione dei target di rilascio e definire la modalità di gestione dei dati eliminati.

DropHelper utilizza OnReceiveContentListener di Jetpack per fornire l'elaborazione del trascinamento ClipData specifica per un target. DropHelper migliora l'esperienza utente configurando i target di rilascio per mostrare un'evidenziazione mentre gli utenti trascinano i contenuti sui target. La classe nidificata DropHelper.Options consente di personalizzare il colore e il raggio d'angolo dell'evidenziazione predefinita.

DropHelper.Options ti offre anche la possibilità di elencare tutti gli elementi EditText contenuti nella gerarchia di visualizzazione di target di rilascio complessi. DropHelper impedisce agli elementi EditText di sottrarre lo stato attivo alla destinazione quando gli utenti trascinano i dati sopra la destinazione. Se l'elemento ClipData di trascinamento include dati di testo e URI, DropHelper seleziona uno degli elementi EditText nella destinazione del rilascio per gestire i dati di testo quando l'elemento ClipData viene rilasciato.

Per ulteriori informazioni, consulta la guida per gli sviluppatori relativa al trascinamento.