Pasek nawigacyjny

Pasek nawigacyjny umożliwia użytkownikom przełączanie się między miejscami docelowymi w aplikacji. Paski nawigacyjne powinny być używane w przypadku:

  • Od 3 do 5 miejsc docelowych o jednakowym znaczeniu
  • Kompaktowe rozmiary okien
  • Spójne miejsca docelowe na ekranach aplikacji
Pasek nawigacyjny z 4 miejscami docelowymi. Każde miejsce docelowe ma nazwę zastępczą „Etykieta”. Wybrane miejsce docelowe jest oznaczone ikoną koła, a pozostałe miejsca docelowe – trójkątami.
Rysunek 1. Pasek nawigacyjny z 4 miejscami docelowymi.

Na tej stronie dowiesz się, jak wyświetlić w aplikacji pasek nawigacyjny z powiązanymi ekranami i podstawową nawigacją.

Interfejs API

Użyj komponentów NavigationBar i NavigationBarItem, aby zaimplementować logikę przełączania miejsc docelowych. Każdy element NavigationBarItem reprezentuje pojedyncze miejsce docelowe.

NavigationBarItem zawiera te kluczowe parametry:

  • selected: określa, czy bieżący element jest wizualnie wyróżniony.
  • onClick(): określa działanie, które ma zostać wykonane, gdy użytkownik kliknie element. Tutaj powinna znajdować się logika obsługi zdarzeń nawigacji, aktualizowania stanu wybranego elementu lub wczytywania odpowiednich treści.
  • label: wyświetla tekst w elemencie. Opcjonalnie:
  • icon: wyświetla ikonę w elemencie. Opcjonalnie:

Przykład: dolny pasek nawigacyjny

Ten fragment kodu implementuje dolny pasek nawigacyjny z elementami, dzięki którym użytkownicy mogą przechodzić między różnymi ekranami w aplikacji:

@Composable
fun NavigationBarExample(modifier: Modifier = Modifier) {
    val navController = rememberNavController()
    val startDestination = Destination.SONGS
    var selectedDestination by rememberSaveable { mutableIntStateOf(startDestination.ordinal) }

    Scaffold(
        modifier = modifier,
        bottomBar = {
            NavigationBar(windowInsets = NavigationBarDefaults.windowInsets) {
                Destination.entries.forEachIndexed { index, destination ->
                    NavigationBarItem(
                        selected = selectedDestination == index,
                        onClick = {
                            navController.navigate(route = destination.route)
                            selectedDestination = index
                        },
                        icon = {
                            Icon(
                                destination.icon,
                                contentDescription = destination.contentDescription
                            )
                        },
                        label = { Text(destination.label) }
                    )
                }
            }
        }
    ) { contentPadding ->
        AppNavHost(navController, startDestination, modifier = Modifier.padding(contentPadding))
    }
}

Najważniejsze punkty

  • NavigationBar wyświetla kolekcję elementów, z których każdy odpowiada Destination.
  • val navController = rememberNavController() tworzy i zapamiętuje instancję NavHostController, która zarządza nawigacją w NavHost.
  • var selectedDestination by rememberSaveable { mutableIntStateOf(startDestination.ordinal) } zarządza stanem wybranego elementu.
    • startDestination.ordinal pobiera indeks liczbowy (pozycję) wpisu typu wyliczeniowego Destination.SONGS.
  • Gdy element zostanie kliknięty, wywoływana jest funkcja navController.navigate(route = destination.route), która umożliwia przejście do odpowiedniego ekranu.
  • Funkcja lambda onClick elementu NavigationBarItem aktualizuje stan selectedDestination, aby wizualnie wyróżnić kliknięty element.
  • Logika nawigacji wywołuje funkcję kompozycyjną AppNavHost, przekazując navController i startDestination, aby wyświetlić rzeczywistą zawartość wybranego ekranu.

Wynik

Poniższy obraz przedstawia pasek nawigacyjny utworzony za pomocą poprzedniego fragmentu kodu:

Rysunek 2. Pasek nawigacyjny zawierający 3 miejsca docelowe z powiązanymi ikonami: Utwory, Album i Playlista.

Aktualizacja M3 Expressive

Material 3 Expressive wprowadza ShortNavigationBar i ShortNavigationBarItem jako dodatkowe, elastyczne opcje obok standardowego NavigationBar.

Przykład elastycznego paska nawigacyjnego Material 3 o mniejszej wysokości i z ikonami z etykietami.
Rysunek 3. elastyczny pasek nawigacyjny.

Więcej informacji o aktualizacjach Material 3 Expressive dotyczących pasków nawigacyjnych znajdziesz we wskazówkach dotyczących paska nawigacyjnego w Material Design 3.

Elementy nawigacyjne w komponencie ShortNavigationBar można ułożyć pionowo lub poziomo.

Pasek nawigacyjny z elementami pionowymi

Używaj elementów pionowych w kompaktowych oknach, np. na urządzeniach mobilnych. Poniższy fragment kodu pokazuje, jak wdrożyć ShortNavigationBar z elementami pionowymi:

@Composable
fun ShortNavigationBarSample() {
    var selectedItem by remember { mutableIntStateOf(0) }
    val items = listOf("Songs", "Artists", "Playlists")

    ShortNavigationBar {
        items.forEachIndexed { index, item ->
            ShortNavigationBarItem(
                icon = {
                    Icon(
                        painter = rememberVectorPainter(if (selectedItem == index) AppIcons.FavoriteFilled else AppIcons.Favorite),
                        contentDescription = null,
                    )
                },
                label = { Text(item) },
                selected = selectedItem == index,
                onClick = { selectedItem = index },
            )
        }
    }
}

Pasek nawigacyjny z elementami poziomymi

Używaj elementów poziomych w średnich oknach, np. na tabletach. Poniższy fragment kodu pokazuje, jak wdrożyć komponent ShortNavigationBar z elementami poziomymi wyśrodkowanymi na pasku:

@Composable
fun ShortNavigationBarWithHorizontalItemsSample() {
    var selectedItem by remember { mutableIntStateOf(0) }
    val items = listOf("Songs", "Artists", "Playlists")

    Column {
        Text(
            "Note: this configuration is better displayed in medium screen sizes.",
            Modifier.padding(16.dp),
        )

        Spacer(Modifier.height(32.dp))

        ShortNavigationBar(arrangement = ShortNavigationBarArrangement.Centered) {
            items.forEachIndexed { index, item ->
                ShortNavigationBarItem(
                    iconPosition = NavigationItemIconPosition.Start,
                    icon = {
                        Icon(
                            painter = rememberVectorPainter(if (selectedItem == index) AppIcons.FavoriteFilled else AppIcons.Favorite),
                            contentDescription = null,
                        )
                    },
                    label = { Text(item) },
                    selected = selectedItem == index,
                    onClick = { selectedItem = index },
                )
            }
        }
    }
}

Dodatkowe materiały