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

重要 ExperimentalStack 是一个在 Expo SDK 56 及更高版本中可用的 alpha API。仅用于测试——在准备好用于生产之前，API 和功能集可能会发生变化。

ExperimentalStack 是 Stack 的兄弟组件，基于新的 react-native-screens/experimental 技术栈。它是按导航器可选的：在你想迁移的特定布局中将 <Stack /> 替换为 <ExperimentalStack />，在其他地方保持 <Stack /> 不变。

我们提前分享它，这样你可以在你的应用中尝试，并告诉我们缺少什么。支持的选项范围是故意有限的，会随着时间的推移而增加。

🌐 We are sharing it early so you can try it in your app and tell us what is missing. The supported option surface is intentionally narrow and will grow over time.

有关本地和 Web 应用的基于文件的路由库的更多信息，请参阅 Expo Router 参考资料。

支持的功能

🌐 Supported features

支持的屏幕选项：

🌐 Supported screen options:

• title
• headerShown
• headerTransparent
• headerBackVisible

在 Android 上，ExperimentalStack 提供了 预测返回手势 支持。你仍然需要通过在你的 应用配置 中将 android.predictiveBackGestureEnabled 设置为 true 来为你的应用启用它。

🌐 On Android, ExperimentalStack ships with predictive back gesture support. You still need to enable it for your app by setting android.predictiveBackGestureEnabled to true in your app config.

平台支持

🌐 Platform support

ExperimentalStack 仅限本地使用。在网页上，它会回退到标准的 Stack，因此相同的布局可以在各个平台上使用，而无需条件代码。

基本用法

🌐 Basic usage

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。

🌐 You can compose ExperimentalStack.Screen and ExperimentalStack.Protected the same way you would with Stack.

已知的限制

🌐 Known limitations

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

安装

🌐 Installation

ExperimentalStack 作为 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