Le PredictiveBackHandler composable dans Jetpack Compose vous permet d'intercepter le geste Retour et d'accéder à sa progression. Vous pouvez réagir au geste Retour de l'utilisateur en temps réel, en créant des animations ou des comportements personnalisés en fonction de la distance parcourue par l'utilisateur.
Pour utiliser PredictiveBackHandler, assurez-vous d'utiliser androidx.activity:activity:1.6.0 ou une version ultérieure.
PredictiveBackHandler fournit un Flow<BackEventCompat> qui émet des événements
représentant la progression du geste Retour. Chaque événement contient des informations telles que les suivantes :
progress: valeur flottante comprise entre 0 et 1 indiquant la progression du geste Retour (0 = geste commencé, 1 = geste terminé).touchXettouchY: coordonnées X et Y de l'événement tactile.
L'extrait de code suivant montre une utilisation de base de PredictiveBackHandler :
PredictiveBackHandler(true) { progress: Flow<BackEventCompat> -> // code for gesture back started try { progress.collect { backEvent -> // code for progress boxScale = 1F - (1F * backEvent.progress) } // code for completion boxScale = 0F } catch (e: CancellationException) { // code for cancellation boxScale = 1F throw e } }
Exemple : Intégrer un panneau de navigation
Cet exemple montre comment implémenter une animation personnalisée dans l’application à l’aide de
PredictiveBackHandler pour créer une interaction fluide avec un tiroir de navigation
en réponse aux gestes Retour dans JetLagged :
Dans cet exemple, PredictiveBackHandler est utilisé pour :
- suivre la progression du geste Retour ;
- mettre à jour le
translationXdu tiroir en fonction de la progression du geste ; - utiliser un
velocityTrackerpour ouvrir ou fermer le tiroir en douceur en fonction de la vitesse du geste lorsque celui-ci est terminé ou annulé.