# 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` de General Translation adaptado a la configuración regional. Referencia de la API de 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`

Controla el prefijo de configuración regional:

* **Omitida**: usa la configuración regional actual de [`useLocale`](/docs/react/reference/hooks/use-locale). La configuración regional predeterminada no lleva prefijo a menos que `prefixDefaultLocale` sea `true`.
* **Cadena de configuración regional**: enlaza directamente a esa configuración regional, por ejemplo, desde un selector de idioma. La configuración regional predeterminada conserva su prefijo a menos que `enableSmartRouting` sea `false`.
* **`false`**: deja el href sin cambios.

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

// Configuración regional actual (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>;

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

Pasa rutas sin localizar; si un `href` ya contiene una configuración regional, se le vuelve a añadir el prefijo. Las URL externas y las rutas que no coinciden con [`pathRegex`](/docs/react/nextjs/config#path-regex) no se modifican. Cuando `href` es un objeto, `<Link>` localiza solo el `pathname` y conserva los demás campos.

`<Link>` lee `prefixDefaultLocale` y `enableSmartRouting` de [`withGTConfig`](/docs/react/nextjs/config#routing). Para localizar una ruta sin renderizar un enlace, por ejemplo con `router.push()`, usa [`useLocalizeHref`](/docs/react/nextjs/reference/hooks/use-localize-href).

## Sitemap

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