Accéder manuellement à la progression

Le composable PredictiveBackHandler dans Jetpack Compose vous permet d'intercepter le geste Retour et d'accéder à sa progression. Vous pouvez réagir au geste de 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 :

  • progress : valeur float comprise entre 0 et 1 indiquant la progression du geste Retour (0 = geste commencé, 1 = geste terminé).
  • touchX et touchY : coordonnées X et Y de l'événement tactile.

L'extrait suivant montre l'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 intégrée personnalisée à l'aide de PredictiveBackHandler pour créer une interaction fluide avec un tiroir de navigation en réponse aux gestes Retour dans JetLagged :

Figure 5 : Panneau de navigation avec prise en charge de la prévisualisation du Retour.

Dans cet exemple, PredictiveBackHandler est utilisé pour :

  • Suivez la progression du geste Retour.
  • Mettez à jour le translationX du tiroir en fonction de la progression du geste.
  • Utilisez un velocityTracker pour ouvrir ou fermer le tiroir en douceur en fonction de la vitesse du geste lorsque le geste est terminé ou annulé.