Cómo navegar desde la barra superior de la app

En esta guía, se muestra cómo puedes hacer que el ícono de navegación en una barra superior de la app realice acciones de navegación.

Ejemplo

El siguiente fragmento es un ejemplo mínimo de cómo puedes implementar una barra superior de la app con un ícono de navegación funcional. En este caso, el ícono lleva al usuario a su destino anterior en la app:

@Composable
fun TopBarNavigationExample(
    navigateBack: () -> Unit,
) {
    Scaffold(
        topBar = {
            CenterAlignedTopAppBar(
                title = {
                    Text(
                        "Navigation example",
                    )
                },
                navigationIcon = {
                    IconButton(onClick = navigateBack) {
                        Icon(
                            imageVector = Icons.AutoMirrored.Filled.ArrowBack,
                            contentDescription = "Localized description"
                        )
                    }
                },
            )
        },
    ) { innerPadding ->
        Text(
            "Click the back button to pop from the back stack.",
            modifier = Modifier.padding(innerPadding),
        )
    }
}
AppBar.kt

Puntos clave sobre el código

Ten en cuenta lo siguiente en este ejemplo:

  • El elemento componible TopBarNavigationExample define un parámetro navigateBack de tipo () -> Unit.
  • Pasa navigateBack para el parámetro navigationIcon de CenterAlignedTopAppBar.

Por lo tanto, cada vez que el usuario hace clic en el ícono de navegación en la parte superior de la app, llama a navigateBack().

Pasa una función

En este ejemplo, se usa una flecha hacia atrás para el ícono. Por lo tanto, el argumento de navigateBack() debería llevar al usuario al destino anterior.

Para ello, pasa TopBarNavigationExample una llamada a NavController.popBackStack(). Para ello, debes compilar tu gráfico de navegación. Por ejemplo:

NavHost(navController, startDestination = "home") {
    composable("topBarNavigationExample") {
        TopBarNavigationExample{ navController.popBackStack() }
    }
    // Other destinations...

Recursos adicionales

Para obtener más información sobre cómo implementar la navegación en tu app, consulta la siguiente serie de guías: