Créer une notification avec une barre de notification

Le composant snackbar sert de notification brève qui s'affiche en bas de l'écran. Il fournit des commentaires sur une opération ou une action sans interrompre l'expérience utilisateur. Les barres de notification disparaissent au bout de quelques secondes. L'utilisateur peut également les ignorer en effectuant une action, comme appuyer sur un bouton.

Voici trois cas d'utilisation dans lesquels vous pouvez utiliser une barre de notification:

  • Confirmation d'action:lorsqu'un utilisateur supprime un e-mail ou un message, une barre de notification s'affiche pour confirmer l'action et proposer une option "Annuler".
  • État du réseau:lorsque l'application perd sa connexion Internet, une barre de notification s'affiche pour indiquer qu'elle est désormais hors connexion.
  • Envoi de données:lorsqu'un formulaire est envoyé ou que des paramètres sont mis à jour, une barre de notification indique que le changement a bien été enregistré.

Compatibilité des versions

Cette implémentation nécessite que la version minimale du SDK de votre projet soit définie sur le niveau d'API 21 ou version ultérieure.

Dépendances

Créer une barre de notification de base

Pour implémenter une barre de notification, vous devez d'abord créer SnackbarHost, qui inclut une propriété SnackbarHostState. SnackbarHostState fournit un accès à la fonction showSnackbar() que vous pouvez utiliser pour afficher votre barre de notification.

Cette fonction de suspension nécessite de définir sa CoroutineScope (par exemple, via rememberCoroutineScope) et peut être appelée en réponse à des événements d'interface utilisateur pour afficher une Snackbar dans le Scaffold.

Créer une barre d'action

Vous pouvez ajouter une action facultative et ajuster la durée de Snackbar. La fonction snackbarHostState.showSnackbar() accepte des paramètres actionLabel et duration supplémentaires et renvoie un SnackbarResult.

Vous pouvez fournir une Snackbar personnalisée avec le paramètre snackbarHost. Pour en savoir plus, consultez la documentation de référence de l'API SnackbarHost.

Résultats

Figure 1 Notifications Snackbar avec action.

Collections contenant ce guide

Ce guide fait partie de ces collections de guides rapides sélectionnées qui couvrent des objectifs de développement Android plus larges:

Découvrez comment les fonctions composables peuvent vous permettre de créer facilement de beaux composants d'interface utilisateur basés sur le système de conception Material Design.

Vous avez des questions ou des commentaires ?

Consultez notre page des questions fréquentes et découvrez les guides rapides, ou contactez-nous pour nous faire part de vos commentaires.