# General Translation React SDKs (gt-react, gt-next, gt-react-native): Локализованная навигация
URL: https://generaltranslation.com/ru/docs/react/nextjs/link.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Переходите напрямую к локализованным маршрутам App Router с помощью компонента Link с поддержкой локалей. Справочник API для компонента `<Link>`.

Компонент `<Link>` из `gt-next/link` оборачивает `<Link>` из Next.js и перед переходом добавляет к внутренним URL App Router префикс локали. Это позволяет избежать лишнего перенаправления через промежуточное ПО при смене локали. (См. [настройку промежуточного ПО App Router](/docs/react/nextjs/app-router-middleware)).

*Примечание: приложения Pages Router должны использовать `next/link` или `next/router` с параметром `locale` Next.js. (См. [маршрутизацию по локалям Pages Router](/docs/react/nextjs/pages-router-middleware)).*

## Обзор [#overview]

Импортируйте экспорт по умолчанию из `gt-next/link` и используйте его так же, как `next/link`, внутри [`<GTProvider>`](/docs/react/reference/components/gt-provider). Он принимает те же пропсы и пробрасывает 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>;

// Явно заданная локаль по умолчанию при включённой умной маршрутизации (smart routing): /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 без протокола (protocol-relative) и пути, не соответствующие [`pathRegex`](/docs/react/nextjs/config#path-regex), остаются без изменений. Строки запроса и хеши сохраняются. Если href передан объектом, `<Link>` локализует только строковый `pathname`, а остальные поля оставляет как есть.

`<Link>` берёт `prefixDefaultLocale` и `enableSmartRouting` из [`withGTConfig`](/docs/react/nextjs/config#routing), а не из [`createNextMiddleware`](/docs/react/nextjs/reference/functions/create-next-middleware). Задавайте их именно там, иначе промежуточное ПО может перенаправить ссылку. Чтобы локализовать путь без рендеринга ссылки, например для `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.
