# General Translation React SDKs (gt-react, gt-next, gt-react-native): Navegación localizada
URL: https://generaltranslation.com/es/docs/react/nextjs/link.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Navega directamente a rutas localizadas de App Router con el componente Link adaptado a la configuración regional. Referencia de la API del componente `<Link>`.

El componente `<Link>` de `gt-next/link` envuelve el `<Link>` de Next.js y añade el prefijo de configuración regional a las URL internas de App Router antes de navegar. Esto evita una redirección adicional del middleware al cambiar de configuración regional. (Consulta la [configuración del middleware de App Router](/docs/react/nextjs/app-router-middleware)).

*Nota: Las aplicaciones de Pages Router deben usar `next/link` o `next/router` con la opción `locale` de Next.js. (Consulta el [enrutamiento de configuración regional de Pages Router](/docs/react/nextjs/pages-router-middleware)).*

## Descripción general [#overview]

Importa la exportación por defecto de `gt-next/link` y úsala igual que `next/link` dentro de [`<GTProvider>`](/docs/react/reference/components/gt-provider). Acepta las mismas props y reenvía las refs.

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

export function Navigation() {
  return <Link href="/home">Home</Link>; // /fr/home para un visitante en francés
}
```

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

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

Selecciona el prefijo de configuración regional. `<Link>` no reenvía `locale` a `next/link`.

* **Omitida.** Se usa la configuración regional actual que devuelve [`useLocale`](/docs/react/reference/hooks/use-locale). La configuración regional predeterminada no lleva prefijo a menos que [`prefixDefaultLocale`](/docs/react/nextjs/reference/functions/create-next-middleware#prefix-default-locale) sea `true`.
* **Cadena de configuración regional.** Enlaza directamente a esa configuración regional, por ejemplo, desde un selector de idioma. Un enlace a la configuración regional predeterminada conserva su prefijo, salvo que tanto `prefixDefaultLocale` como [`enableSmartRouting`](/docs/react/nextjs/reference/functions/create-next-middleware#smart-routing) sean `false`, para que el middleware no redirija al visitante a la configuración regional guardada en su cookie.
* **`false`.** Deja el href sin cambios.

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

// Configuración regional actual (opción predeterminada): /fr/home, o /home para la configuración regional predeterminada
<Link href="/home">Home</Link>;

// Configuración regional explícita: /fr/home
<Link href="/home" locale="fr">French</Link>;

// Configuración regional predeterminada explícita, con el enrutamiento inteligente activado: /en/home
<Link href="/home" locale="en">English</Link>;

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

Pasa rutas sin localizar. Si un href ya comienza con una configuración regional configurada, se le vuelve a añadir el prefijo, de modo que `/de/about` se convierte en `/fr/de/about` para un visitante francés; en desarrollo, esto registra una advertencia una sola vez. Solo se localizan las rutas que comienzan con `/`: las URL externas, las URL relativas al protocolo y las rutas que no coinciden con [`pathRegex`](/docs/react/nextjs/config#path-regex) se mantienen sin cambios. Las cadenas de consulta y los hashes se conservan. Con hrefs de tipo objeto, `<Link>` solo localiza el `pathname` si es una cadena y conserva los demás campos.

`<Link>` lee `prefixDefaultLocale` y `enableSmartRouting` de [`withGTConfig`](/docs/react/nextjs/config#routing), no de [`createNextMiddleware`](/docs/react/nextjs/reference/functions/create-next-middleware). Configúralos allí; de lo contrario, el middleware podría redirigir el enlace. Para localizar una ruta sin renderizar un enlace, por ejemplo con `router.push()`, usa [`useLocalizeHref`](/docs/react/nextjs/reference/hooks/use-localize-href).

## Historial de versiones [#version-history]

| Versión | Cambios                                                                                                                                                                                                                                                                                                                                                                                         |
| ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 11.4.14 | Las rutas que no coinciden con `pathRegex` ya no llevan prefijo. En desarrollo, si un href ya empieza por una configuración regional configurada, se registra una advertencia una sola vez; la salida no cambia. También se aplica a [`useLocalizeHref`](/docs/react/nextjs/reference/hooks/use-localize-href) y [`getLocalizeHref`](/docs/react/nextjs/reference/functions/get-localize-href). |
| 11.4.13 | Los enlaces de la configuración regional predeterminada actual ya no llevan prefijo cuando `prefixDefaultLocale` es `false`. Un enlace cuya prop `locale` indica explícitamente la configuración regional predeterminada conserva el prefijo, salvo que `enableSmartRouting` también sea `false`.                                                                                               |

## Sitemap

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