Barras de la app

Las barras de la app son contenedores que proporcionan al usuario acceso a funciones clave y elementos de navegación. Existen dos tipos de barras de la app: las superiores y las inferiores. Su apariencia y propósito respectivos son los siguientes:

Tipo

Apariencia

Objetivo

Barra superior de la app

En la parte superior de la pantalla.

Proporciona acceso a tareas y datos clave. Por lo general, aloja un título, elementos de acción principales y ciertos elementos de navegación.

Barra de la app inferior

En la parte inferior de la pantalla.

Suele incluir elementos de navegación principales. También puede proporcionar acceso a otras acciones clave, como a través de un botón de acción flotante contenido.

Ejemplo de una barra de la app superior e inferior
Figura 1: Una barra de la app superior (izquierda) y una barra de la app inferior (derecha).

Para implementar una barra de la app superior y una inferior, usa los elementos componibles TopAppBar y BottomAppBar, respectivamente. Te permiten crear interfaces coherentes que encapsulan los controles de navegación y acción, y que se alinean con los principios de Material Design.

Barras superiores de la app

En la siguiente tabla, se describen los cuatro tipos de barras de la app superiores:

Tipo

Ejemplo

Pequeña: Para pantallas que no requieren mucha navegación ni acciones.

Barra superior de la app pequeña

Alineación centrada: Para pantallas que tienen una sola acción principal.

Barra superior de la app centrada

Mediano: Para pantallas que requieren una cantidad moderada de navegación y acciones.

Barra superior de la app mediana

Grande: Para pantallas que requieren mucha navegación y acciones.

Barra superior de la app grande

Superficie de la API

Los diversos elementos componibles que te permiten implementar las cuatro barras de la app superiores diferentes son bastante similares. Comparten varios parámetros clave:

  • title: Es el texto que aparece en la barra de la app.
  • navigationIcon: Es el ícono principal para la navegación. Aparece a la izquierda de la barra de la app.
  • actions: Son íconos que proporcionan al usuario acceso a acciones clave. Aparecen a la derecha de la barra de la app.
  • scrollBehavior: Determina cómo responde la barra de la app superior al desplazamiento del contenido interno del scaffold.
  • colors: Determina cómo aparece la barra de la app.

Comportamiento de desplazamiento

Puedes controlar cómo responde la barra de la app cuando el usuario se desplaza por el contenido interno del scaffold determinado. Para ello, crea una instancia de TopAppBarScrollBehavior y pásala a la barra de la app de nivel superior para el parámetro scrollBehavior.

Existen tres tipos de TopAppBarScrollBehavior. Son los siguientes:

  • enterAlwaysScrollBehavior: Cuando el usuario levanta el contenido interno del scaffold, la barra superior de la app se contrae. La barra de la app se expande cuando el usuario comienza a deslizar hacia abajo el contenido interno.
  • exitUntilCollapsedScrollBehavior: Es similar a enterAlwaysScrollBehavior, aunque la barra de la app solo se expande cuando el usuario desplaza el contenido por completo hacia abajo.
  • pinnedScrollBehaviorLa barra de la app permanece en su lugar y no reacciona al desplazamiento.

En los siguientes ejemplos, se implementan varias de estas opciones.

Ejemplos

En las siguientes secciones, se proporcionan implementaciones para los cuatro tipos diferentes de barras de la app superiores, incluidos varios ejemplos de cómo puedes controlar el comportamiento de desplazamiento.

Pequeño

Para crear una barra superior de la app pequeña, usa el elemento de componibilidad TopAppBar. En el siguiente ejemplo, se implementa una barra de la app superior básica que solo contiene un título.

En el siguiente ejemplo, no se pasa un valor para scrollBehavior a TopAppBar y, por lo tanto, no reacciona al desplazamiento del contenido interno.

@Composable
fun SmallTopAppBarExample() {
    Scaffold(
        topBar = {
            TopAppBar(
                colors = TopAppBarDefaults.topAppBarColors(
                    containerColor = MaterialTheme.colorScheme.primaryContainer,
                    titleContentColor = MaterialTheme.colorScheme.primary,
                ),
                title = {
                    Text("Small Top App Bar")
                }
            )
        },
    ) { innerPadding ->
        ScrollContent(innerPadding)
    }
}

Esta implementación se ve de la siguiente manera:

Figura 2. Barra superior de la app pequeña

Alineación centrada

La barra de la app superior alineada al centro es, en esencia, igual que la barra de la app pequeña, aunque el título está centrado dentro del componente. Para implementarlo, usa el elemento componible CenterAlignedTopAppBar dedicado.

En este ejemplo, se usa enterAlwaysScrollBehavior() para obtener el valor que pasa para scrollBehavior. Por lo tanto, la barra se contrae cuando el usuario se desplaza por el contenido interno del scaffold.

@Composable
fun CenterAlignedTopAppBarExample() {
    val scrollBehavior = TopAppBarDefaults.pinnedScrollBehavior(rememberTopAppBarState())

    Scaffold(
        modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection),

        topBar = {
            CenterAlignedTopAppBar(
                colors = TopAppBarDefaults.topAppBarColors(
                    containerColor = MaterialTheme.colorScheme.primaryContainer,
                    titleContentColor = MaterialTheme.colorScheme.primary,
                ),
                title = {
                    Text(
                        "Centered Top App Bar",
                        maxLines = 1,
                        overflow = TextOverflow.Ellipsis
                    )
                },
                navigationIcon = {
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.ArrowBack),
                            contentDescription = "Localized description"
                        )
                    }
                },
                actions = {
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.Menu),
                            contentDescription = "Localized description"
                        )
                    }
                },
                scrollBehavior = scrollBehavior,
            )
        },
    ) { innerPadding ->
        ScrollContent(innerPadding)
    }
}

Esta implementación se ve de la siguiente manera:

Figura 3. Una barra superior de la app alineada al centro

Medio

La barra superior de la app mediana coloca el título debajo de los íconos adicionales. Para crear uno, usa el elemento componible MediumTopAppBar.

Al igual que el fragmento anterior, en este ejemplo, se usa enterAlwaysScrollBehavior() para obtener el valor que se pasa para scrollBehavior.

@Composable
fun MediumTopAppBarExample() {
    val scrollBehavior = TopAppBarDefaults.enterAlwaysScrollBehavior(rememberTopAppBarState())

    Scaffold(
        modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection),
        topBar = {
            MediumTopAppBar(
                colors = TopAppBarDefaults.topAppBarColors(
                    containerColor = MaterialTheme.colorScheme.primaryContainer,
                    titleContentColor = MaterialTheme.colorScheme.primary,
                ),
                title = {
                    Text(
                        "Medium Top App Bar",
                        maxLines = 1,
                        overflow = TextOverflow.Ellipsis
                    )
                },
                navigationIcon = {
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.ArrowBack),
                            contentDescription = "Localized description"
                        )
                    }
                },
                actions = {
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.Menu),
                            contentDescription = "Localized description"
                        )
                    }
                },
                scrollBehavior = scrollBehavior
            )
        },
    ) { innerPadding ->
        ScrollContent(innerPadding)
    }
}

Esta implementación aparece de la siguiente manera, con una demostración de cómo se ve el comportamiento de desplazamiento de enterAlwaysScrollBehavior():

Figura 4. Una barra de la app superior mediana que se contrae cuando el usuario se desplaza hacia arriba y se expande cuando se desplaza hacia abajo.

Grande

Una barra de la app superior grande es similar a la mediana, aunque el padding entre el título y los íconos es mayor y ocupa más espacio en la pantalla en general. Para crear uno, usa el elemento componible LargeTopAppBar.

A diferencia de los fragmentos anteriores, en este ejemplo, se usa exitUntilCollapsedScrollBehavior() para obtener el valor que se pasa para scrollBehavior. Por lo tanto, la barra se contrae cuando el usuario se desplaza por el contenido interno del scaffold, pero se expande cuando el usuario se desplaza hasta el final del contenido interno.

@Composable
fun LargeTopAppBarExample() {
    val scrollBehavior = TopAppBarDefaults.exitUntilCollapsedScrollBehavior(rememberTopAppBarState())

    Scaffold(
        modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection),
        topBar = {
            LargeTopAppBar(
                colors = TopAppBarDefaults.topAppBarColors(
                    containerColor = MaterialTheme.colorScheme.primaryContainer,
                    titleContentColor = MaterialTheme.colorScheme.primary,
                ),
                title = {
                    Text(
                        "Large Top App Bar",
                        maxLines = 1,
                        overflow = TextOverflow.Ellipsis
                    )
                },
                navigationIcon = {
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.ArrowBack),
                            contentDescription = "Localized description"
                        )
                    }
                },
                actions = {
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.Menu),
                            contentDescription = "Localized description"
                        )
                    }
                },
                scrollBehavior = scrollBehavior
            )
        },
    ) { innerPadding ->
        ScrollContent(innerPadding)
    }
}

Esta implementación se ve de la siguiente manera:

Figura 5. Ejemplo de implementación de una barra de la app superior grande.

Actualización de M3 Expressive

Las nuevas barras de la app flexibles medianas y flexibles grandes incluyen mejoras significativas, como alturas flexibles, compatibilidad con varias líneas y texto centrado. También pueden contener una variedad más amplia de elementos, como imágenes. Se recomiendan las barras de la app flexibles medianas y grandes en lugar de las barras de la app medianas y grandes. La barra de la app pequeña se actualizó con las mismas mejoras de flexibilidad.

Barras de la app superiores con estilos expresivos
Figura 6: Variaciones de la barra superior de la app de M3 Expressive.

Para obtener más información sobre las actualizaciones de M3 Expressive para las barras de la app, consulta los lineamientos de las barras de la app de Material Design 3.

Alineación centrada y a la izquierda

Pequeño Barra superior de la app con tema claro, alineada al centro y con subtítulo
Barra superior de la app con tema oscuro
Medio Barra superior de la app mediana con alineación central, tema claro y subtítulo
Barra superior de la app mediana con tema oscuro
Grande Barra superior de la app grande, alineada al centro, con tema claro y subtítulo
Barra superior de la app grande con tema oscuro

Los encabezados pequeños, medianos flexibles y grandes flexibles se pueden alinear con el borde inicial o centrarse.

En el siguiente fragmento, se muestra cómo implementar una barra de la app superior alineada al centro con un subtítulo:

@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun SimpleCenterAlignedTopAppBarWithSubtitle() {
    val scrollBehavior = TopAppBarDefaults.pinnedScrollBehavior()
    Scaffold(
        modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection),
        topBar = {
            TopAppBar(
                title = { Text("Simple TopAppBar", maxLines = 1, overflow = TextOverflow.Ellipsis) },
                subtitle = { Text("Subtitle", maxLines = 1, overflow = TextOverflow.Ellipsis) },
                titleHorizontalAlignment = Alignment.CenterHorizontally,
                navigationIcon = {
                    IconButton(onClick = { /* onBackClick() */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.ArrowBack),
                            contentDescription = "Localized description",
                        )
                    }
                },
                actions = {
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Localized description")
                    }
                },
                scrollBehavior = scrollBehavior,
            )
        },
        content = { innerPadding ->
            // ...
        },
    )
}

Comportamiento de desplazamiento

Ingresar siempre

Cuando el usuario se desplaza hacia abajo por el contenido (lo que hace que el contenido suba), la barra de la app se contrae de inmediato. Cuando el usuario vuelve a desplazarse hacia arriba (arrastrando el contenido hacia abajo), la barra de la app se expande de inmediato, independientemente de dónde se encuentre el usuario en la lista de contenido desplazable.

En el siguiente fragmento, se muestra cómo implementar una barra de la app superior con el comportamiento de desplazamiento enter-always:

@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun EnterAlwaysTopAppBar() {
    val scrollBehavior = TopAppBarDefaults.enterAlwaysScrollBehavior()
    Scaffold(
        modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection),
        topBar = {
            TopAppBar(
                title = { Text("TopAppBar", maxLines = 1, overflow = TextOverflow.Ellipsis) },
                subtitle = { Text("Subtitle", maxLines = 1, overflow = TextOverflow.Ellipsis) },
                navigationIcon = {
                    IconButton(onClick = { /* onBackClick() */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.ArrowBack),
                            contentDescription = "Localized description",
                        )
                    }
                },
                actions = {
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Localized description")
                    }
                },
                scrollBehavior = scrollBehavior,
            )
        },
        content = { innerPadding ->
            // ...
        },
    )
}

En el siguiente video, se muestra el resultado del fragmento anterior:

Figura 7. Una barra de la app superior con un comportamiento de desplazamiento de ingreso continuo que se contrae cuando el usuario se desplaza hacia abajo y se expande cuando se desplaza hacia arriba

Salir hasta que se contraiga

Cuando el usuario se desplaza hacia abajo por el contenido (lo que hace que el contenido suba), las barras de la app flexibles medianas y grandes se contraen hasta que solo queda visible la barra de la app contraída. Cuando el usuario vuelve a desplazarse hacia arriba (arrastrando el contenido hacia abajo), la barra de la app permanece contraída hasta que el usuario llega a la parte superior del contenido, momento en el que la barra de la app se expande de nuevo a su altura completa, centrada con su subtítulo.

Medio flexible

En el siguiente fragmento, se muestra cómo implementar una barra de la app superior flexible mediana con el comportamiento de desplazamiento exit-until-collapsed:

@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun ExitUntilCollapsedCenterAlignedMediumFlexibleTopAppBar() {
    val scrollBehavior = TopAppBarDefaults.exitUntilCollapsedScrollBehavior()
    Scaffold(
        modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection),
        topBar = {
            MediumFlexibleTopAppBar(
                title = { Text("Medium TopAppBar", maxLines = 1, overflow = TextOverflow.Ellipsis) },
                subtitle = { Text("Subtitle", maxLines = 1, overflow = TextOverflow.Ellipsis) },
                titleHorizontalAlignment = Alignment.CenterHorizontally,
                navigationIcon = {
                    IconButton(onClick = { /* onBackClick() */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.ArrowBack),
                            contentDescription = "Localized description",
                        )
                    }
                },
                actions = {
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Localized description")
                    }
                },
                scrollBehavior = scrollBehavior,
            )
        },
        content = { innerPadding ->
            // ...
        },
    )
}

En el siguiente video, se muestra el resultado del fragmento anterior:

Figura 8. Una barra de la app superior de tamaño mediano y alineada al centro que se contrae a medida que el usuario se desplaza hacia abajo.

Grande y flexible

En el siguiente fragmento, se muestra cómo implementar una barra de la app superior flexible y grande con el comportamiento de desplazamiento exit-until-collapsed:

@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun ExitUntilCollapsedCenterAlignedLargeFlexibleTopAppBar() {
    val scrollBehavior = TopAppBarDefaults.exitUntilCollapsedScrollBehavior()
    Scaffold(
        modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection),
        topBar = {
            LargeFlexibleTopAppBar(
                title = { Text("Large TopAppBar", maxLines = 1, overflow = TextOverflow.Ellipsis) },
                subtitle = { Text("Subtitle", maxLines = 1, overflow = TextOverflow.Ellipsis) },
                titleHorizontalAlignment = Alignment.CenterHorizontally,
                navigationIcon = {
                    IconButton(onClick = { /* onBackClick() */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.ArrowBack),
                            contentDescription = "Localized description",
                        )
                    }
                },
                actions = {
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Localized description")
                    }
                },
                scrollBehavior = scrollBehavior,
            )
        },
        content = { innerPadding ->
            // ...
        },
    )
}

En el siguiente video, se muestra el resultado del fragmento anterior:

Figura 9: Una barra de la app superior grande y centrada que se contrae a medida que el usuario se desplaza hacia abajo.

Barra de la app inferior

Para crear una barra de la app inferior, usa el elemento de componibilidad BottomAppBar. El uso de este elemento componible es similar al de los elementos componibles de la barra superior de la app que se describen en las secciones anteriores de esta página. Pasas elementos componibles para los siguientes parámetros clave:

  • actions: Es una serie de íconos que aparecen en el lado izquierdo de la barra. Por lo general, son acciones clave para la pantalla determinada o elementos de navegación.
  • floatingActionButton: Es el botón de acción flotante que aparece en el lado derecho de la barra.

@Composable
fun BottomAppBarExample() {
    Scaffold(
        bottomBar = {
            BottomAppBar(
                actions = {
                    IconButton(onClick = { /* do something */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Check), contentDescription = "Localized description")
                    }
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.Edit),
                            contentDescription = "Localized description",
                        )
                    }
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.Mic),
                            contentDescription = "Localized description",
                        )
                    }
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.Image),
                            contentDescription = "Localized description",
                        )
                    }
                },
                floatingActionButton = {
                    FloatingActionButton(
                        onClick = { /* do something */ },
                        containerColor = BottomAppBarDefaults.bottomAppBarFabColor,
                        elevation = FloatingActionButtonDefaults.bottomAppBarFabElevation()
                    ) {
                        Icon(painter = rememberVectorPainter(AppIcons.Add), "Localized description")
                    }
                }
            )
        },
    ) { innerPadding ->
        Text(
            modifier = Modifier.padding(innerPadding),
            text = "Example of a scaffold with a bottom app bar."
        )
    }
}

Esta implementación se ve de la siguiente manera:

Figura 10. Ejemplo de implementación de una barra de la app inferior.

Actualización de M3 Expressive

En Material 3 Expressive, usa la barra de herramientas fija (FlexibleBottomAppBar) en lugar de la barra de la app inferior estándar para obtener una altura más corta y una disposición horizontal de los elementos más flexible.

En el siguiente fragmento, se implementa un FlexibleBottomAppBar con un AppBarRow que mueve los elementos de acción adicionales a un menú ampliado cuando el espacio es limitado:

@Composable
fun FlexibleBottomAppBarSample() {
    val icons =
        listOf(
            AppIcons.ArrowBack,
            AppIcons.ArrowForward,
            AppIcons.Add,
            AppIcons.Check,
            AppIcons.Edit,
            AppIcons.Favorite,
        )
    val items = listOf("Back", "Forward", "Add", "Check", "Edit", "Favorite")

    FlexibleBottomAppBar(
        contentPadding = PaddingValues(horizontal = 96.dp),
        horizontalArrangement = BottomAppBarDefaults.FlexibleFixedHorizontalArrangement,
    ) {
        AppBarRow(
            overflowIndicator = { menuState ->
                IconButton(
                    onClick = {
                        if (menuState.isShowing) {
                            menuState.dismiss()
                        } else {
                            menuState.show()
                        }
                    }
                ) {
                    Icon(
                        painter = rememberVectorPainter(AppIcons.MoreVert),
                        contentDescription = "Overflow",
                    )
                }
            }
        ) {
            items.forEachIndexed { index, item ->
                clickableItem(
                    onClick = { /* doSomething() */ },
                    icon = {
                        Icon(
                            painter = rememberVectorPainter(icons[index]),
                            contentDescription = item,
                        )
                    },
                    label = item,
                )
            }
        }
    }
}

Recursos adicionales