# General Translation React SDKs (gt-react, gt-next, gt-react-native): ローカライズされたナビゲーション
URL: https://generaltranslation.com/ja/docs/react/nextjs/link.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: ロケール対応の `Link` コンポーネントを使って、ローカライズ済みの App Router ルートに直接移動できます。`<Link>` コンポーネントの API リファレンス。

`gt-next/link` の `<Link>` コンポーネントは Next.js の `<Link>` をラップし、遷移前に内部 App Router URL にロケールプレフィックスを追加します。これにより、ロケールを切り替える際の余分なミドルウェア リダイレクトを回避できます。 ([App Router ミドルウェアのセットアップ](/docs/react/nextjs/app-router-middleware)を参照してください) 。

*注: Pages Router アプリでは、Next.js の `locale` オプションとともに `next/link` または `next/router` を使用してください。 ([Pages Router のロケールルーティング](/docs/react/nextjs/pages-router-middleware)を参照してください) 。*

## 概要 [#overview]

`gt-next/link` からデフォルトエクスポートをインポートし、[`<GTProvider>`](/docs/react/reference/components/gt-provider) 内で `next/link` と同様に使用します。同じpropsを受け取り、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` でない限り、デフォルトロケールへのリンクにもプレフィックスが付いたままになります。これにより、ミドルウェアが訪問者をクッキーに保存されたロケールへ戻してしまうのを防ぎます。
* **`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>;

// デフォルトロケールを明示的に指定（スマートルーティング有効時）: /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、および [`pathRegex`](/docs/react/nextjs/config#path-regex) に一致しないパスはそのまま維持されます。クエリ文字列とハッシュは保持されます。オブジェクト形式の href の場合、`<Link>` は文字列の `pathname` のみをローカライズし、その他のフィールドはそのまま保持します。

`<Link>` は `prefixDefaultLocale` と `enableSmartRouting` を、[`createNextMiddleware`](/docs/react/nextjs/reference/functions/create-next-middleware) ではなく [`withGTConfig`](/docs/react/nextjs/config#routing) から読み取ります。これらは `withGTConfig` 側で設定してください。そうしないと、ミドルウェアによってリンクがリダイレクトされる場合があります。`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.
