Cómo agregar un botón de acción flotante

Prueba el estilo de Compose
Jetpack Compose es el kit de herramientas de IU recomendado para Android. Aprende a agregar componentes en Compose.

Un botón de acción flotante (BAF) es un botón circular que activa la acción principal en la IU de tu app. En este documento, se muestra cómo agregar un BAF a tu diseño, personalizar parte de su apariencia y responder cuando se presionan los botones.

Si deseas obtener más información para diseñar un BAF para tu app según los lineamientos de Material Design, consulta BAF de Material Design.

Una imagen que muestra la pantalla de una app que contiene un FloatingActionButton rojo
Figura 1: Un botón de acción flotante (BAF).

Cómo agregar el botón de acción flotante a tu diseño

En el siguiente código, se muestra cómo aparece FloatingActionButton en el archivo de diseño:

<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" />

De forma predeterminada, un BAF está coloreado por el atributo colorAccent, que puedes personalizar con la paleta de colores del tema.

Puedes configurar otras propiedades del BAF usando atributos XML o métodos correspondientes, como los siguientes:

  • El tamaño del BAF mediante el atributo app:fabSize o el método setSize()
  • El color de ondas del BAF mediante el atributo app:rippleColor o el método setRippleColor()
  • El ícono del BAF con el atributo android:src o el método setImageDrawable()

Cómo responder a presiones de botones

Luego, puedes aplicar un View.OnClickListener para controlar los toques del BAF. Por ejemplo, en el siguiente código, se muestra un Snackbar cuando el usuario presiona el BAF:

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();
    }
});

Para obtener más información sobre las funciones del BAF, consulta la referencia de la API para FloatingActionButton.