在页面之间导航

创建链接以在页面之间移动。

Expo Router 使用 "links" 在应用的页面之间移动。 这在概念上类似于网络如何使用 <a> 标签和 href 属性。

在以下示例中，有两个导航到不同路由的 <Link /> 组件。

import { View } from 'react-native';
import { Link } from 'expo-router';

export default function Page() {
  return (
    <View>
      <Link href="/about">About</Link>

      <Link href="/user/bacon">View user</Link>
    </View>
  );
}

按钮

默认情况下，Link 组件将子组件封装在 <Text> 组件中，这对于可访问性很有用，但并不总是需要的。 你可以通过传递 asChild 属性来自定义组件，这会将所有属性转发到 Link 组件的第一个子组件。 子组件必须支持 onPress 和 onClick 属性，href 和 role 也会被传递下去。

import { Pressable, Text } from "react-native";
import { Link } from "expo-router";

export default function Page() {
  return (
    <Link href="/other" asChild>
      <Pressable>
        <Text>Home</Text>
      </Pressable>
    </Link>
  );
}

命令式导航

当用户登录或注销时，你可能希望从全局商店进行导航。 你可以使用 router 对象或 useRouter 钩子进行命令式导航（在 React 之外）。

import { router } from 'expo-router';

export function logout() {
  router.replace('/login');
}

router 对象是不可变的，包含以下函数：

• push： (href: Href) => void 导航至路由。 你可以提供完整路径（如 /profile/settings）或相对路径（如 ../settings）。 通过传递 { pathname: 'profile', params: { id: '123' } } 等对象导航到动态路由。
• replace： (href: Href) => void 与推送相同的 API，但替换历史记录中的当前路由，而不是推送新路由。 这对于重定向很有用。
• back： () => void 导航回之前的路由。
• canGoBack： () => boolean 如果存在有效的历史堆栈并且 back() 函数可以弹出，则返回 true。
• setParams： (params: Record<string, string>) => void 更新当前所选路由的查询参数。

链接到动态路由

动态路由和查询参数可以静态提供或使用方便的 参考文献 对象提供。

import { Link } from 'expo-router';

export default function Page() {
  return (
    <View>
      <Link
        href={{
          pathname: "/user/[id]",
          params: { id: 'bacon' }
        }}>
          View user
        </Link>
    </View>
  );
}

更换屏幕

默认情况下，将 "push" 路由链接到导航堆栈。 它遵循与 navigation.navigate() 相同的规则。 这意味着当用户返回时，上一个屏幕将可用。 你可以使用 replace 属性替换当前屏幕，而不是推送新屏幕。

import { Link } from 'expo-router';

export default function Page() {
  return (
    <View>
      <Link
        replace
        href="/feed">
        Login
      </Link>
    </View>
  );
}

使用 router.replace() 强制替换当前屏幕。

原生导航并不总是支持 replace。 例如，在 Twitter 上，你无法直接从个人资料 "replace" 到推文，这是因为 UI 需要后退按钮才能返回提要或其他顶层选项卡屏幕。 在这种情况下，替换将切换到提要选项卡，并将推文路由推到其顶部，或者如果你在提要选项卡内的其他推文上，它将用新推文替换当前推文。 通过使用 unstable_settings，可以在 Expo Router 中获得这种确切的行为。

自动补齐

Expo Router 可以自动为应用中的所有路由生成静态 TypeScript 类型。 这允许你对 href 使用自动补齐功能，并在使用无效链接时收到警告。 了解更多： 静态类型路由。

Web 行为

Expo Router 在网络上运行时支持标准 <a> 元素，但这将执行全页服务器导航。 这比较慢并且没有充分利用 React。 相反，Expo Router <Link> 组件将执行客户端导航，这将保留网站的状态并更快地导航。

还支持仅 Web 属性 target、rel 和 download。 当在网络上运行时，这些将被传递到 <a> 元素。

客户端导航适用于单页应用和 静态渲染。

在模拟器中的使用

请参阅 测试网址 指南，了解如何在模拟器和模拟器中模拟深层链接。