DragAndDrop

  
Acceptez les données par glisser-déposer au sein d'une application ou à partir d'une autre application, et affichez une affordance de cible de glisser-déposer cohérente.
Dernière mise à jour Version stable Version finale Version bêta Version alpha
11 mai 2022 1.0.0 - - -

Déclarer des dépendances

Pour ajouter une dépendance à DragAndDrop, vous devez ajouter le dépôt Maven de Google à votre projet. Consultez la section Dépôt Maven de Google pour en savoir plus.

Ajoutez les dépendances correspondant aux artefacts dont vous avez besoin dans le fichier build.gradle de votre application ou de votre module :

Groovy

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

Kotlin

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

Pour en savoir plus sur les dépendances, consultez Ajouter des dépendances de compilation.

Commentaires

Vos commentaires nous aident à améliorer Jetpack. N'hésitez pas à nous contacter si vous découvrez de nouveaux problèmes ou si vous avez des idées pour améliorer cette bibliothèque. Veuillez consulter les problèmes existants de cette bibliothèque avant d'en signaler un nouveau. Vous pouvez ajouter votre vote à un problème existant en cliquant sur le bouton en forme d'étoile.

Signaler un nouveau problème

Pour en savoir plus, consultez la documentation sur l'outil Issue Tracker.

Version 1.0

Version 1.0.0

11 mai 2022

Publication d'androidx.draganddrop:draganddrop:1.0.0. Liste des commits de la version 1.0.0

Principales fonctionnalités de la version 1.0.0

DropHelper, le premier membre de la bibliothèque draganddrop, est une classe utilitaire qui simplifie l'implémentation des fonctionnalités de glisser-déposer. Utilisez DropHelper pour spécifier des cibles de dépôt, personnaliser leur mise en surbrillance et définir la façon dont les données déposées sont traitées.

  • DropHelper s'appuie sur OnReceiveContentListener de Jetpack pour traiter les glisser-déposer ClipData propres à une cible. DropHelper améliore l'expérience utilisateur en configurant des cibles de dépôt de manière à afficher un effet de surbrillance lorsque les utilisateurs font glisser du contenu. La classe imbriquée DropHelper.Options vous permet de personnaliser l'apparence de la mise en surbrillance par défaut.
  • DropHelper associe un OnReceiveContentListener aux cibles de dépôt et les configure pour surveiller les événements de glisser-déposer. N'associez pas d'autres OnDragListener ni de OnReceiveContentListener aux cibles de dépôt lorsque DropHelper est utilisé.
  • DropHelper.Options vous permet de recenser tous les éléments EditText contenus dans la hiérarchie des vues de cibles de dépôt complexes. Le cas échéant, vous devez les spécifier de cette manière. DropHelper empêche les éléments EditText de prendre le pas sur la cible de dépôt lorsque des utilisateurs font glisser des données sur la cible. Si le glisser-déposer ClipData inclut des données de texte et d'URI, DropHelper sélectionne l'un des éléments EditText de la cible de dépôt pour traiter les données textuelles lorsque ClipData est déposé.

Pour en savoir plus, consultez la section Glisser-déposer du guide du développeur.

Version 1.0.0-rc01

20 avril 2022

Publication d'androidx.draganddrop:draganddrop:1.0.0-rc01. Liste des commits de la version 1.0.0-rc01.

  • Aucune modification depuis la dernière version bêta.

Version 1.0.0-beta01

23 mars 2022

Publication d'androidx.draganddrop:draganddrop:1.0.0-beta01. Liste des commits de la version 1.0.0-beta01.

  • Aucune modification depuis la dernière version alpha.

Version 1.0.0-alpha04

23 février 2022

Publication d'androidx.draganddrop:draganddrop:1.0.0-alpha04. Liste des commits de la version 1.0.0-alpha04

Modifications apportées à l'API

  • Les DragEvents dont la valeur localState n'est pas nulle ne déclenchent pas de mise en surbrillance par défaut. Une option de configuration permet de modifier ce comportement. (I55792)

Version 1.0.0-alpha03

26 janvier 2022

Publication d'androidx.draganddrop:draganddrop:1.0.0-alpha03. Liste des commits de la version 1.0.0-alpha03

Nouvelles fonctionnalités

  • Sur les appareils équipés d'Android S ou version ultérieure, DropHelper délègue désormais l'implémentation de OnReceiveContentListener au système, ce qui lui permet de prendre en charge automatiquement les modes d'entrée autres que le glisser-déposer.

Version 1.0.0-alpha02

15 décembre 2021

Publication d'androidx.draganddrop:draganddrop:1.0.0-alpha02. Liste des commits de la version 1.0.0-alpha02.

Fonctionnalités de la version initiale

DropHelper, le premier membre de la bibliothèque draganddrop, est une classe utilitaire qui simplifie l'implémentation des fonctionnalités de glisser-déposer. Utilisez DropHelper pour spécifier des cibles de dépôt, personnaliser leur mise en surbrillance et définir la façon dont les données déposées sont traitées.

DropHelper s'appuie sur OnReceiveContentListener de Jetpack pour traiter les glisser-déposer ClipData propres à une cible. DropHelper améliore l'expérience utilisateur en configurant des cibles de dépôt de manière à afficher un effet de surbrillance lorsque les utilisateurs font glisser du contenu. La classe imbriquée DropHelper.Options vous permet de personnaliser la couleur et l'arrondi d'angle de la mise en surbrillance par défaut.

DropHelper.Options vous permet également de recenser tous les éléments EditText contenus dans la hiérarchie des vues de cibles de dépôt complexes. DropHelper empêche les éléments EditText de prendre le pas sur la cible de dépôt lorsque des utilisateurs font glisser des données sur la cible. Si le glisser-déposer ClipData inclut des données de texte et d'URI, DropHelper sélectionne l'un des éléments EditText de la cible de dépôt pour traiter les données textuelles lorsque ClipData est déposé.

Pour en savoir plus, consultez la section Glisser-déposer du guide du développeur.