Cette page a été traduite par l'API Cloud Translation.

Ajouter un bouton d'action flottant

Un bouton d'action flottant (FAB) est un bouton circulaire qui déclenche l'action principale dans l'interface utilisateur de votre application. Cette page vous explique comment ajouter le bouton d'action flottant à votre mise en page, personnaliser une partie de son apparence et répondre aux pressions sur les boutons.

Pour savoir comment concevoir un bouton d'action flottant dans votre application conformément aux consignes Material Design, consultez également Boutons: bouton d'action flottant.

Figure 1 : Un bouton d'action flottant

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

Le code suivant montre comment FloatingActionButton doit apparaître 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, le bouton d'action flottant 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 de 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'ondulation du bouton d'action flottant, à 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 pressions sur les boutons

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

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 bouton d'action flottant, consultez la documentation de référence de l'API pour FloatingActionButton.