Ajouter un bouton d'action flottant

Essayer Compose
Jetpack Compose est le kit d'outils d'UI recommandé pour Android. Découvrez comment ajouter des composants dans Compose.

Un bouton d'action flottant (FAB) est un bouton circulaire qui déclenche l'action principale dans l'UI de votre application. Ce document explique comment ajouter un FAB à votre mise en page, personnaliser son apparence et répondre aux appuis sur le bouton.

Pour savoir comment concevoir un bouton d'action flottant pour votre application en suivant les consignes Material Design, consultez Bouton d'action flottant Material Design.

Image montrant un écran d'application contenant un FloatingActionButton rouge
Image 1. Bouton d'action flottant (FAB).

Ajouter le bouton d'action flottant à votre mise en page

Le code suivant montre comment FloatingActionButton apparaît dans votre fichier de mise en page :

<com.google.android.material.floatingactionbutton.FloatingActionButton
        android:id="@+id/fab"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="end|bottom"
        android:src="@drawable/ic_my_icon"
        android:contentDescription="@string/submit"
        android:layout_margin="16dp" />

Par défaut, un FAB est coloré par l'attribut colorAccent, que vous pouvez personnaliser avec la palette de couleurs du thème.

Vous pouvez configurer d'autres propriétés du bouton d'action flottant à l'aide d'attributs XML ou de méthodes correspondantes, comme les suivantes :

  • Taille du bouton d'action flottant, à l'aide de l'attribut app:fabSize ou de la méthode setSize()
  • Couleur de l'onde du FAB, à l'aide de l'attribut app:rippleColor ou de la méthode setRippleColor()
  • L'icône du bouton d'action flottant, à l'aide de l'attribut android:src ou de la méthode setImageDrawable()

Répondre aux commandes tactiles

Vous pouvez ensuite appliquer un View.OnClickListener pour gérer les appuis sur le bouton d'action flottant. Par exemple, le code suivant affiche un Snackbar lorsque l'utilisateur appuie sur le FAB :

Kotlin

val fab: View = findViewById(R.id.fab)
fab.setOnClickListener { view ->
    Snackbar.make(view, "Here's a Snackbar", Snackbar.LENGTH_LONG)
            .setAction("Action", null)
            .show()
}

Java

FloatingActionButton fab = findViewById(R.id.fab);
fab.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View view) {
        Snackbar.make(view, "Here's a Snackbar", Snackbar.LENGTH_LONG)
                .setAction("Action", null).show();
    }
});

Pour en savoir plus sur les fonctionnalités du FAB, consultez la documentation de référence de l'API pour FloatingActionButton.