# General Translation React SDKs (gt-react, gt-next, gt-react-native): Navigation localisée
URL: https://generaltranslation.com/fr/docs/react/nextjs/link.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Accédez directement aux routes App Router localisées avec le composant Link adapté au paramètre régional. Référence de l’API du composant `<Link>`.

Le composant `<Link>` de `gt-next/link` encapsule le `<Link>` de Next.js et ajoute le préfixe du paramètre régional aux URL internes d’App Router avant d’effectuer la navigation. Cela évite une redirection `middleware` supplémentaire lors d’un changement de paramètre régional. (Consultez la [configuration du middleware App Router](/docs/react/nextjs/app-router-middleware)).

*Remarque : les applications Pages Router doivent utiliser `next/link` ou `next/router` avec l’option `locale` de Next.js. (Consultez le [routage par paramètre régional de Pages Router](/docs/react/nextjs/pages-router-middleware)).*

## Vue d’ensemble [#overview]

Importez l’export par défaut de `gt-next/link` et utilisez-le comme `next/link` à l’intérieur de [`<GTProvider>`](/docs/react/reference/components/gt-provider). Il accepte les mêmes props et transmet les refs.

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

export function Navigation() {
  return <Link href="/home">Home</Link>; // /fr/home pour un visiteur francophone
}
```

## La prop `locale` [#locale-prop]

**Type** `string | false | undefined`

Sélectionne le préfixe du paramètre régional. `<Link>` ne transmet pas `locale` à `next/link`.

* **Omise.** Utilise le paramètre régional actuel renvoyé par [`useLocale`](/docs/react/reference/hooks/use-locale). Les paramètres régionaux par défaut ne sont pas préfixés, sauf si [`prefixDefaultLocale`](/docs/react/nextjs/reference/functions/create-next-middleware#prefix-default-locale) vaut `true`.
* **Chaîne de paramètres régionaux.** Crée un lien direct vers ce paramètre régional, par exemple depuis un sélecteur de langue. Un lien vers les paramètres régionaux par défaut conserve son préfixe, sauf si `prefixDefaultLocale` et [`enableSmartRouting`](/docs/react/nextjs/reference/functions/create-next-middleware#smart-routing) valent tous deux `false`. Ainsi, le middleware ne redirige pas le visiteur vers le paramètre régional enregistré dans son cookie.
* **`false`.** Laisse le href tel quel.

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

// Paramètre régional actuel (par défaut) : /fr/home, ou /home pour les paramètres régionaux par défaut
<Link href="/home">Home</Link>;

// Paramètre régional explicite : /fr/home
<Link href="/home" locale="fr">French</Link>;

// Paramètres régionaux par défaut explicites, avec routage intelligent activé : /en/home
<Link href="/home" locale="en">English</Link>;

// Sans préfixe : /legal
<Link href="/legal" locale={false}>Legal</Link>;
```

Transmettez des chemins non localisés. Un href qui commence déjà par un paramètre régional configuré reçoit un préfixe supplémentaire : ainsi, `/de/about` devient `/fr/de/about` pour un visiteur francophone ; en développement, un avertissement est alors consigné une seule fois. Seuls les chemins commençant par `/` sont localisés : les URL externes, les URL relatives au protocole et les chemins qui ne correspondent pas à [`pathRegex`](/docs/react/nextjs/config#path-regex) restent inchangés. Les chaînes de requête et les fragments (hash) sont conservés. Pour les href de type objet, `<Link>` localise uniquement un `pathname` de type chaîne de caractères et conserve les autres champs tels quels.

`<Link>` lit `prefixDefaultLocale` et `enableSmartRouting` depuis [`withGTConfig`](/docs/react/nextjs/config#routing), et non depuis [`createNextMiddleware`](/docs/react/nextjs/reference/functions/create-next-middleware). Définissez-les à cet endroit ; sinon, le middleware risque de rediriger le lien. Pour localiser un chemin sans afficher de lien, par exemple pour `router.push()`, utilisez [`useLocalizeHref`](/docs/react/nextjs/reference/hooks/use-localize-href).

## Historique des versions [#version-history]

| Version | Modifications                                                                                                                                                                                                                                                                                                                                                                                                          |
| ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 11.4.14 | Les chemins qui ne correspondent pas à `pathRegex` ne sont plus préfixés. En développement, un href qui commence déjà par un paramètre régional configuré consigne un avertissement une seule fois ; la sortie reste inchangée. S&#39;applique également à [`useLocalizeHref`](/docs/react/nextjs/reference/hooks/use-localize-href) et [`getLocalizeHref`](/docs/react/nextjs/reference/functions/get-localize-href). |
| 11.4.13 | Les liens vers les paramètres régionaux par défaut actuels ne sont plus préfixés lorsque `prefixDefaultLocale` vaut `false`. Un lien dont la prop `locale` désigne explicitement les paramètres régionaux par défaut reste préfixé, sauf si `enableSmartRouting` vaut également `false`.                                                                                                                               |

## Sitemap

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