Grâce aux animations de confirmation, les utilisateurs peuvent obtenir un retour visuel lorsqu'ils effectuent une action. Elles couvrent l'intégralité de l'écran afin que les utilisateurs puissent les voir d'un simple coup d'œil.
Dans la plupart des cas, vous n'avez besoin d'utiliser une autre animation de confirmation. Pour en savoir plus, consultez les principes de conception.
La bibliothèque de l'UI Jetpack Wearable fournit un élément ConfirmationActivity pour afficher une animation de confirmation dans vos applications.
Afficher les animations de confirmation
ConfirmationActivity permet d'afficher des animations de confirmation une fois que l'utilisateur a effectué une action sur l'accessoire connecté.
Il existe trois types de confirmation :
- Succès : l'action a bien été effectuée sur l'accessoire connecté.
- Échec : l'action n'a pas abouti.
- Ouvrir sur le téléphone : l'action a entraîné l'affichage d'un élément sur le téléphone. Pour terminer l'action, l'utilisateur doit accéder à son téléphone.
Si vous souhaitez afficher une animation de confirmation lorsque les utilisateurs effectuent une action dans votre application, créez un intent qui démarre ConfirmationActivity à partir de l'une de vos activités. Définissez EXTRA_ANIMATION_TYPE sur l'une des valeurs suivantes :
Pour utiliser ConfirmationActivity dans votre application, déclarez d'abord cette activité dans votre fichier manifeste, comme indiqué dans l'exemple suivant :
<manifest> <application> ... <activity android:name="androidx.wear.activity.ConfirmationActivity"> </activity> </application> </manifest>
Déterminez le résultat de l'action utilisateur, démarrez l'activité avec un intent et ajoutez un message qui apparaît sous l'icône de confirmation, comme illustré dans l'exemple suivant :
val intent = Intent(this, ConfirmationActivity::class.java).apply { putExtra(ConfirmationActivity.EXTRA_ANIMATION_TYPE, ConfirmationActivity.SUCCESS_ANIMATION) putExtra(ConfirmationActivity.EXTRA_MESSAGE, getString(R.string.msg_sent)) } startActivity(intent)
Après l'affichage de l'animation de confirmation, ConfirmationActivity se termine, et votre activité reprend.