NavigationBar

适用于 Material 3 底部导航的 Jetpack Compose NavigationBar 组件。

Android

Included in Expo Go

Recommended version:

~57.0.22

Expo UI 导航栏与官方 Jetpack Compose NavigationBar API 相匹配。它显示一行目的地，用于在应用的顶层部分之间切换。

🌐 Expo UI NavigationBar matches the official Jetpack Compose NavigationBar API. It displays a row of destinations for switching between top-level app sections.

Material 3 navigation bar with selectable destinations

安装

🌐 Installation

Terminal

- npx expo install @expo/ui

- yarn expo install @expo/ui

- pnpm expo install @expo/ui

- bun expo install @expo/ui

If you are installing this in an existing React Native app, make sure to install expo in your project.

用法

🌐 Usage

基础导航栏

🌐 Basic navigation bar

在 React 状态中管理所选项目，并将 selected 传递给每个 NavigationBarItem。

🌐 Manage the selected item in React state and pass selected to each NavigationBarItem.

BasicNavigationBar.tsx

import { useState } from 'react';
import {
  Host,
  Icon,
  NavigationBar,
  NavigationBarItem,
  Text,
} from '@expo/ui/jetpack-compose';

const HOME_ICON = require('./assets/home.xml');
const SEARCH_ICON = require('./assets/search.xml');
const SETTINGS_ICON = require('./assets/settings.xml');

export default function BasicNavigationBar() {
  const [selectedTab, setSelectedTab] = useState('home');

  return (
    <Host
      matchContents={{ vertical: true }}
      style={{ width: '100%' }}>
      <NavigationBar>
        <NavigationBarItem
          selected={selectedTab === 'home'}
          onClick={() => setSelectedTab('home')}>
          <NavigationBarItem.Icon>
            <Icon source={HOME_ICON} />
          </NavigationBarItem.Icon>
          <NavigationBarItem.Label>
            <Text>Home</Text>
          </NavigationBarItem.Label>
        </NavigationBarItem>

        <NavigationBarItem
          selected={selectedTab === 'search'}
          onClick={() => setSelectedTab('search')}>
          <NavigationBarItem.Icon>
            <Icon source={SEARCH_ICON} />
          </NavigationBarItem.Icon>
          <NavigationBarItem.Label>
            <Text>Search</Text>
          </NavigationBarItem.Label>
        </NavigationBarItem>

        <NavigationBarItem
          selected={selectedTab === 'settings'}
          onClick={() => setSelectedTab('settings')}>
          <NavigationBarItem.Icon>
            <Icon source={SETTINGS_ICON} />
          </NavigationBarItem.Icon>
          <NavigationBarItem.Label>
            <Text>Settings</Text>
          </NavigationBarItem.Label>
        </NavigationBarItem>
      </NavigationBar>
    </Host>
  );
}

应用接口

🌐 API

import {
  NavigationBar,
  NavigationBarItem,
} from '@expo/ui/jetpack-compose';

Components

`NavigationBar`

Android

Type: React.Element<NavigationBarProps>

A Material Design 3 navigation bar.

NavigationBarProps

`children`

Android

Optional • Type: ReactNode

Navigation bar items.

`containerColor`

Android

Optional • Type: ColorValue • Default: NavigationBarDefaults.containerColor

Background color of the navigation bar.

`contentColor`

Android

Optional • Type: ColorValue • Default: contentColorFor(containerColor)

Preferred content color inside the navigation bar.

`modifiers`

Android

Optional • Type: ModifierConfig[]

Modifiers for the component.

`tonalElevation`

Android

Optional • Type: number • Default: NavigationBarDefaults.Elevation

Tonal elevation in dp.

`NavigationBarItem`

Android

Type: React.Element<NavigationBarItemProps>

A Material Design 3 navigation bar item. Must be used inside NavigationBar.

NavigationBarItemProps

`alwaysShowLabel`

Android

Optional • Type: boolean • Default: true

Whether to always show the label.

`children`

Android

Optional • Type: ReactNode

Children containing Icon, SelectedIcon, and Label slots.

`colors`

Android

Optional • Type: NavigationBarItemColors

Colors for the item in different states.

`enabled`

Android

Optional • Type: boolean • Default: true

Whether the item is enabled.

`modifiers`

Android

Optional • Type: ModifierConfig[]

Modifiers for the component.

`onClick`

Android

Optional • Type: () => void

Callback that is called when the item is clicked.

`selected`

Android

Type: boolean

Whether this item is currently selected.

Types

`NavigationBarItemColors`

Android

Colors for navigation bar items in different states.

Property	Type	Description
disabledIconColor(optional)	`ColorValue`	-
disabledTextColor(optional)	`ColorValue`	-
selectedIconColor(optional)	`ColorValue`	-
selectedIndicatorColor(optional)	`ColorValue`	-
selectedTextColor(optional)	`ColorValue`	-
unselectedIconColor(optional)	`ColorValue`	-
unselectedTextColor(optional)	`ColorValue`	-

Components

`NavigationBar`

Android

Type: React.Element<NavigationBarProps>

A Material Design 3 navigation bar.

NavigationBarProps

`children`

Android

Optional • Type: ReactNode

Navigation bar items.

`containerColor`

Android

Optional • Type: ColorValue • Default: NavigationBarDefaults.containerColor

Background color of the navigation bar.

`contentColor`

Android

Optional • Type: ColorValue • Default: contentColorFor(containerColor)

Preferred content color inside the navigation bar.

`modifiers`

Android

Optional • Type: ModifierConfig[]

Modifiers for the component.

`tonalElevation`

Android

Optional • Type: number • Default: NavigationBarDefaults.Elevation

Tonal elevation in dp.

`NavigationBarItem`

Android

Type: React.Element<NavigationBarItemProps>

A Material Design 3 navigation bar item. Must be used inside NavigationBar.

NavigationBarItemProps

`alwaysShowLabel`

Android

Optional • Type: boolean • Default: true

Whether to always show the label.

`children`

Android

Optional • Type: ReactNode

Children containing Icon, SelectedIcon, and Label slots.

`colors`

Android

Optional • Type: NavigationBarItemColors

Colors for the item in different states.

`enabled`

Android

Optional • Type: boolean • Default: true

Whether the item is enabled.

`modifiers`

Android

Optional • Type: ModifierConfig[]

Modifiers for the component.

`onClick`

Android

Optional • Type: () => void

Callback that is called when the item is clicked.

`selected`

Android

Type: boolean

Whether this item is currently selected.

Types

`NavigationBarItemColors`

Android

Colors for navigation bar items in different states.

Property	Type	Description
disabledIconColor(optional)	`ColorValue`	-
disabledTextColor(optional)	`ColorValue`	-
selectedIconColor(optional)	`ColorValue`	-
selectedIndicatorColor(optional)	`ColorValue`	-
selectedTextColor(optional)	`ColorValue`	-
unselectedIconColor(optional)	`ColorValue`	-
unselectedTextColor(optional)	`ColorValue`	-