# General Translation React SDKs (gt-react, gt-next, gt-react-native): 本地化导航
URL: https://generaltranslation.com/zh/docs/react/nextjs/link.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 使用符合区域设置的 Link 组件，直接跳转到本地化 App Router 路由。`<Link>` 组件的 API 参考。

`gt-next/link` 提供的 `<Link>` 组件封装了 Next.js 的 `<Link>`，并会在导航前为内部 App Router URL 添加区域设置前缀。这样在切换区域设置时可避免额外的中间件重定向。 (请参阅 [App Router 中间件设置](/docs/react/nextjs/app-router-middleware)。) 

*注意：Pages Router 应用应使用 `next/link` 或带有 Next.js `locale` 选项的 `next/router`。 (请参阅 [Pages Router 区域设置路由](/docs/react/nextjs/pages-router-middleware)。)&#x20;*

## 概览 [#overview]

从 `gt-next/link` 导入默认导出，并在 [`<GTProvider>`](/docs/react/reference/components/gt-provider) 内像使用 `next/link` 一样使用它。它接受相同的属性，并支持转发 ref。

```tsx title="app/nav.tsx"
import Link from 'gt-next/link';

export function Navigation() {
  return <Link href="/home">Home</Link>; // 法语访客对应 /fr/home
}
```

## `locale` 属性 [#locale-prop]

**类型** `string | false | undefined`

用于选择区域设置前缀。`<Link>` 不会将 `locale` 传递给 `next/link`。

* **省略时。** 使用 [`useLocale`](/docs/react/reference/hooks/use-locale) 返回的当前区域设置。除非 [`prefixDefaultLocale`](/docs/react/nextjs/reference/functions/create-next-middleware#prefix-default-locale) 为 `true`，否则默认区域设置不添加前缀。
* **区域设置字符串。** 直接链接到该区域设置，适用于语言切换器等场景。指向默认区域设置的链接会保留前缀 (除非 `prefixDefaultLocale` 和 [`enableSmartRouting`](/docs/react/nextjs/reference/functions/create-next-middleware#smart-routing) 均为 `false`) ，以免中间件将访问者重定向回其 cookie 中保存的区域设置。
* **`false`。** 保持 href 不变。

```tsx
import Link from 'gt-next/link';

// 当前区域设置（默认）：/fr/home；若为默认区域设置，则为 /home
<Link href="/home">Home</Link>;

// 显式指定区域设置：/fr/home
<Link href="/home" locale="fr">French</Link>;

// 显式指定默认区域设置，并启用智能路由：/en/home
<Link href="/home" locale="en">English</Link>;

// 无前缀：/legal
<Link href="/legal" locale={false}>Legal</Link>;
```

请传入未本地化的路径。如果 href 已经以某个已配置的区域设置开头，仍会再次添加前缀，因此对于法语访问者，`/de/about` 会变成 `/fr/de/about`；在开发环境中，这种情况会记录一次警告。只有以 `/` 开头的路径才会被本地化：外部 URL、协议相对 URL 以及不匹配 [`pathRegex`](/docs/react/nextjs/config#path-regex) 的路径均保持不变。查询字符串和哈希值会被保留。对于对象形式的 href，`<Link>` 仅本地化字符串类型的 `pathname`，其他字段保持不变。

`<Link>` 从 [`withGTConfig`](/docs/react/nextjs/config#routing) 而非 [`createNextMiddleware`](/docs/react/nextjs/reference/functions/create-next-middleware) 读取 `prefixDefaultLocale` 和 `enableSmartRouting`。请在 `withGTConfig` 中设置这两项，否则中间件可能会重定向该链接。如需在不渲染链接的情况下本地化路径 (例如配合 `router.push()` 使用) ，请使用 [`useLocalizeHref`](/docs/react/nextjs/reference/hooks/use-localize-href)。

## 版本历史 [#version-history]

| 版本      | 变更                                                                                                                                                                                                                                        |
| ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 11.4.14 | 与 `pathRegex` 不匹配的路径不再添加前缀。在开发环境中，若 href 已以某个已配置的区域设置开头，将记录一次警告，但输出不变。此变更同样适用于 [`useLocalizeHref`](/docs/react/nextjs/reference/hooks/use-localize-href) 和 [`getLocalizeHref`](/docs/react/nextjs/reference/functions/get-localize-href)。 |
| 11.4.13 | 当 `prefixDefaultLocale` 为 `false` 时，指向当前默认区域设置的链接不再添加前缀。若链接通过 `locale` 属性显式指定为默认区域设置，则仍会保留前缀，除非 `enableSmartRouting` 也为 `false`。                                                                                                          |

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.
