Vous pouvez utiliser un Snackbar
pour afficher un bref message à l'attention de l'utilisateur. Contrairement aux Notifications, le message disparaît automatiquement après une courte période. Un Snackbar
est idéal pour les messages brefs sur lesquels l'utilisateur n'a pas besoin d'agir. Par exemple, une application de messagerie peut utiliser un Snackbar
pour indiquer à l'utilisateur que l'application a envoyé un e-mail.
Utiliser un CoordinatorLayout
Un Snackbar
est associé à une vue. Snackbar
fournit des fonctionnalités de base s'il est associé à un objet dérivé de la classe View
, comme l'un des objets de mise en page courants. Toutefois, si le Snackbar
est associé à un CoordinatorLayout
, le Snackbar
obtient des fonctionnalités supplémentaires:
- L'utilisateur peut ignorer
Snackbar
en balayant l'écran. - La mise en page déplace les autres éléments de l'interface utilisateur lorsque
Snackbar
apparaît. Par exemple, si la mise en page comporte un élémentFloatingActionButton
, elle déplace le bouton vers le haut lorsqu'elle affiche uneSnackbar
, au lieu de dessiner l'élémentSnackbar
au-dessus du bouton. Vous pouvez voir à quoi cela ressemble dans la figure 1.
La classe CoordinatorLayout
fournit un sur-ensemble des fonctionnalités de FrameLayout
.
Si votre application utilise déjà un FrameLayout
, vous pouvez remplacer cette mise en page par un CoordinatorLayout
pour activer l'intégralité de la fonctionnalité Snackbar
. Si votre application utilise d'autres objets de mise en page, encapsulez vos éléments de mise en page existants dans un CoordinatorLayout
, comme illustré dans l'exemple suivant:
<android.support.design.widget.CoordinatorLayout android:id="@+id/myCoordinatorLayout" xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" android:layout_width="match_parent" android:layout_height="match_parent"> <!-- Here are the existing layout elements, now wrapped in a CoordinatorLayout. --> <LinearLayout android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="vertical"> <!-- ...Toolbar, other layouts, other elements... --> </LinearLayout> </android.support.design.widget.CoordinatorLayout>
Définissez une balise android:id
pour votre CoordinatorLayout
.
Vous avez besoin de l'ID de la mise en page lorsque vous affichez le message.
Afficher un message
L'affichage d'un message s'effectue en deux étapes. Commencez par créer un objet Snackbar
avec le texte du message. Vous appelez ensuite la méthode show()
de cet objet pour afficher le message auprès de l'utilisateur.
Créer un objet Snackbar
Créez un objet Snackbar
en appelant la méthode statique Snackbar.make()
. Lorsque vous créez le Snackbar
, spécifiez le message qu'il affiche et la durée d'affichage:
Kotlin
val mySnackbar = Snackbar.make(view, stringId, duration)
Java
Snackbar mySnackbar = Snackbar.make(view, stringId, duration);
- vue
-
Vue à laquelle associer le
Snackbar
. La méthode recherche dans la hiérarchie des vues depuis la vue transmise jusqu'à atteindre unCoordinatorLayout
ou la vue de contenu du décor de fenêtre. Habituellement, il est plus simple de transmettre leCoordinatorLayout
contenant votre contenu. - chaîneId
- ID de ressource du message que vous souhaitez afficher. Il peut s'agir de texte formaté ou non.
- de visionnage
-
Durée d'affichage du message. Il peut s'agir de
LENGTH_SHORT
ouLENGTH_LONG
.
Présenter le message à l'utilisateur
Après avoir créé l'Snackbar
, appelez sa méthode show()
pour présenter l'Snackbar
à l'utilisateur:
Kotlin
mySnackbar.show()
Java
mySnackbar.show();
Le système n'affiche pas plusieurs objets Snackbar
en même temps. Par conséquent, si la vue affiche actuellement une autre Snackbar
, le système met votre Snackbar
en file d'attente et l'affiche une fois la Snackbar
actuelle expirée ou ignorée.
Si vous souhaitez afficher un message pour l'utilisateur et que vous n'avez pas besoin d'appeler l'une des méthodes utilitaires de l'objet Snackbar
, vous n'avez pas besoin de conserver la référence à Snackbar
après avoir appelé show()
. Pour cette raison, il est courant d'utiliser un chaînage de méthodes pour créer et afficher un Snackbar
dans une seule instruction:
Kotlin
Snackbar.make( findViewById(R.id.myCoordinatorLayout), R.string.email_sent, Snackbar.LENGTH_SHORT ).show()
Java
Snackbar.make(findViewById(R.id.myCoordinatorLayout), R.string.email_sent, Snackbar.LENGTH_SHORT) .show();