This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.
NavigationBar 适用于 Material 3 底部导航的 Jetpack Compose NavigationBar 组件。
Recommended version:
~58.0.15
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.
安装
🌐 Installation
- 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.
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' ;
No API data file found, sorry!
No API data file found, sorry!