This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.
NavigationStack
包含链接和目标视图、可将视图推入导航栈的 SwiftUI NavigationStack 组件。
Expo UI NavigationStack 与官方 SwiftUI NavigationStack API 一致,并显示一个可以将其他视图推入其上的根视图。
点击 NavigationLink 会推入具有相同 value 的 NavigationDestination。
安装
If you are installing this in an existing React Native app, make sure to install expo in your project.
用法
基本导航
将根视图和目标视图放入导航栈中。为链接及其目标视图设置相同的 value。使用 navigationTitle 修饰符设置每个屏幕的标题。
在 List 中,链接会渲染为带箭头的一行。无论推入该目标视图的链接嵌套多深,目标视图都必须是导航栈的直接子项。
信息 将链接保留在
NavigationStack内部。从导航栈呈现的内容(例如BottomSheet或Popover)需要拥有自己的NavigationStack和目标视图。
将任意视图作为链接
链接可以包装任意视图。
读取和设置路径
导航栈默认维护自己的路径。传入 path 和 onPathChange,即可通过状态驱动导航栈。路径按推入顺序保存每个视图的 value。将其设为空数组即可返回根视图。
向导航栏添加按钮
使用 Toolbar 包装内容,并将按钮放入 Toolbar.Content。
API
import { NavigationDestination, NavigationLink, NavigationStack, } from '@expo/ui/swift-ui';
Component
Type: React.Element<NavigationStackProps>
A view that displays a root view and enables you to present additional views over the root view.
Example
const [path, setPath] = useState<string[]>([]); <NavigationStack path={path} onPathChange={setPath}> <List> <NavigationLink value="settings"> <Text>Settings</Text> </NavigationLink> </List> <NavigationDestination value="settings"> <SettingsScreen /> </NavigationDestination> </NavigationStack>
ReactNodeThe root view of the stack, and the NavigationDestination views the stack can push. It is
displayed inside a navigation bar.
(path: string[]) => voidCallback function that is called when the stack pushes or pops a view, for example when a
NavigationLink is tapped or the user swipes back. Gets called with the new path.
When path is set, the stack is controlled: a push takes effect once the new path comes back
through this prop.
string[]The values of the views pushed on top of the root view, in the order they were pushed. Leave it undefined to let the stack manage its own path.
Component
Type: React.Element<NavigationLinkProps>
A view that controls a navigation presentation. In a List it renders as a row with a
disclosure chevron, and tapping it pushes the matching NavigationDestination.
The link has to be inside the NavigationStack itself. Content presented from the stack, such
as a BottomSheet or a Popover, is its own presentation context and does not reach the
stack's destinations, so give that content its own NavigationStack.
Example
<NavigationLink value="settings"> <Text>Settings</Text> </NavigationLink>
Component
Type: React.Element<NavigationDestinationProps>
Associates a destination view with a NavigationLink value, matching SwiftUI's
navigationDestination(for:destination:). It must be a direct child of the NavigationStack,
however deeply the link that pushes it is nested inside that stack.
Keep it mounted so the pushed screen already carries its navigationTitle when the slide
starts, or render one for each value on the stack's path to build screens on demand.
Example
<NavigationDestination value="settings"> <SettingsScreen /> </NavigationDestination>