This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

重要 ExperimentalStack 是一个 alpha API，适用于 Expo SDK 56 及更高版本。该 API 仅供测试使用——在可用于生产环境之前，API 和功能集可能会发生变化。

ExperimentalStack 是 Stack 的同类组件，由新的 react-native-screens/experimental 堆栈驱动。它需要按导航器选择启用：在要迁移的特定布局中，将 <Stack /> 替换为 <ExperimentalStack />，其他地方继续使用 <Stack />。

我们提前分享它，以便你可以在应用中试用并告诉我们还缺少什么。当前支持的选项范围有意保持精简，今后会逐步扩展。

有关适用于原生和 Web 应用的基于文件路由库的更多信息，请参阅 Expo Router 参考文档。

支持的功能

支持的屏幕选项：

• title
• headerShown
• headerTransparent
• headerBackVisible

在 Android 上，ExperimentalStack 内置了对预测性返回手势的支持。你仍需在应用配置中将 android.predictiveBackGestureEnabled 设置为 true，以便为应用启用此功能。

平台支持

ExperimentalStack 仅适用于原生平台。在 Web 上，它会回退到标准的 Stack，因此相同的布局可以在各个平台上运行，无需条件代码。

基本用法

import { ExperimentalStack as Stack } from 'expo-router';

export default function Layout() {
  return (
    <Stack screenOptions={{ headerShown: true }}>
      <Stack.Screen name="index" options={{ title: 'Home' }} />
      <Stack.Screen name="details" options={{ title: 'Details' }} />
    </Stack>
  );
}

你可以像使用 Stack 一样组合使用 ExperimentalStack.Screen 和 ExperimentalStack.Protected。

已知限制

信息 我们正在积极开发 ExperimentalStack，并期待收到反馈。你可以在 Discord 上分享想法、在 GitHub 上提交问题，或使用本页底部的 反馈 按钮。

安装

ExperimentalStack 是 expo-router 的一部分。如果你的项目中尚未安装 Expo Router，请按照 Expo Router 安装指南进行操作：

API

import { ExperimentalStack } from 'expo-router';

Components

import { Stack } from 'expo-router';

export default function Layout() {
  return (
    <Stack>
      <Stack.Screen name="detail">
        <Stack.Screen.BackButton displayMode="minimal">Back</Stack.Screen.BackButton>
      </Stack.Screen>
    </Stack>
  );
}

import { Stack } from 'expo-router';

export default function Page() {
  return (
    <>
      <Stack.Screen.BackButton hidden />
      <ScreenContent />
    </>
  );
}

Props

Types