# General Translation React SDKs (gt-react, gt-next, gt-react-native): Navigazione localizzata
URL: https://generaltranslation.com/it/docs/react/nextjs/link.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Passa direttamente alle route App Router localizzate con il componente Link sensibile all'impostazione regionale. Riferimento API per il componente `<Link>`.

Il componente `<Link>` di `gt-next/link` incapsula il `<Link>` di Next.js e aggiunge il prefisso del locale agli URL interni di App Router prima della navigazione. In questo modo si evita un reindirizzamento aggiuntivo del middleware quando si cambia impostazione regionale. (Consulta la [configurazione del middleware App Router](/docs/react/nextjs/app-router-middleware)).

*Nota: le app Pages Router devono usare `next/link` o `next/router` con l&#39;opzione `locale` di Next.js. (Consulta il [routing delle impostazioni regionali di Pages Router](/docs/react/nextjs/pages-router-middleware)).*

## Panoramica [#overview]

Importa il default export da `gt-next/link` e usalo come `next/link` all&#39;interno di [`<GTProvider>`](/docs/react/reference/components/gt-provider). Accetta gli stessi props e inoltra i ref.

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

export function Navigation() {
  return <Link href="/home">Home</Link>; // /fr/home per un visitatore di lingua francese
}
```

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

**Tipo** `string | false | undefined`

Seleziona il prefisso del locale. `<Link>` non inoltra `locale` a `next/link`.

* **Omessa.** Usa l&#39;impostazione regionale corrente restituita da [`useLocale`](/docs/react/reference/hooks/use-locale). All&#39;impostazione locale predefinita non viene aggiunto il prefisso, a meno che [`prefixDefaultLocale`](/docs/react/nextjs/reference/functions/create-next-middleware#prefix-default-locale) non sia `true`.
* **Stringa di impostazione regionale.** Crea un link diretto a quell&#39;impostazione regionale, ad esempio da un selettore della lingua. Un link all&#39;impostazione locale predefinita mantiene il prefisso, a meno che `prefixDefaultLocale` e [`enableSmartRouting`](/docs/react/nextjs/reference/functions/create-next-middleware#smart-routing) non siano entrambi `false`, in modo che il middleware non riporti il visitatore all&#39;impostazione regionale salvata nel suo cookie.
* **`false`.** Lascia invariato l&#39;href.

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

// Impostazione regionale corrente (predefinito): /fr/home, oppure /home per l'impostazione locale predefinita
<Link href="/home">Home</Link>;

// Impostazione regionale esplicita: /fr/home
<Link href="/home" locale="fr">French</Link>;

// Impostazione locale predefinita esplicita, con smart routing attivo: /en/home
<Link href="/home" locale="en">English</Link>;

// Nessun prefisso: /legal
<Link href="/legal" locale={false}>Legal</Link>;
```

Passa percorsi non localizzati. A un href che inizia già con un&#39;impostazione regionale configurata viene aggiunto di nuovo il prefisso, quindi `/de/about` diventa `/fr/de/about` per un visitatore francese; in fase di sviluppo, in questo caso viene registrato un avviso una sola volta. Vengono localizzati solo i percorsi che iniziano con `/`: gli URL esterni, gli URL relativi al protocollo e i percorsi che non corrispondono a [`pathRegex`](/docs/react/nextjs/config#path-regex) restano invariati. Le query string e gli hash vengono mantenuti. Per gli href di tipo oggetto, `<Link>` localizza solo un `pathname` di tipo stringa e lascia invariati gli altri campi.

`<Link>` legge `prefixDefaultLocale` e `enableSmartRouting` da [`withGTConfig`](/docs/react/nextjs/config#routing), non da [`createNextMiddleware`](/docs/react/nextjs/reference/functions/create-next-middleware). Impostali lì, altrimenti il middleware potrebbe reindirizzare il link. Per localizzare un percorso senza renderizzare un link, ad esempio con `router.push()`, usa [`useLocalizeHref`](/docs/react/nextjs/reference/hooks/use-localize-href).

## Cronologia delle versioni [#version-history]

| Versione | Modifiche                                                                                                                                                                                                                                                                                                                                                                                                                  |
| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 11.4.14  | I percorsi che non corrispondono a `pathRegex` non ricevono più il prefisso. In fase di sviluppo, se un href inizia già con un&#39;impostazione regionale configurata, viene registrato un avviso una sola volta; l&#39;output rimane invariato. Vale anche per [`useLocalizeHref`](/docs/react/nextjs/reference/hooks/use-localize-href) e [`getLocalizeHref`](/docs/react/nextjs/reference/functions/get-localize-href). |
| 11.4.13  | I link per l&#39;impostazione locale predefinita corrente non ricevono più il prefisso quando `prefixDefaultLocale` è `false`. Un link con una prop `locale` impostata esplicitamente sull&#39;impostazione locale predefinita mantiene il prefisso, a meno che anche `enableSmartRouting` non sia `false`.                                                                                                                |

## Sitemap

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