このページとあなたの好きなAIアシスタントを使ってドキュメントを要約します
バージョン履歴
- "フレームワーク固有のフォーマッターと useRewriteURL フックの使用を伴う集中型URLリライトを実装しました。"v8.0.02026/1/25
このページのコンテンツはAIを使用して翻訳されました。
英語の元のコンテンツの最新バージョンを見るこのドキュメントを改善するアイデアがある場合は、GitHubでプルリクエストを送信することで自由に貢献してください。
ドキュメントへのGitHubリンクドキュメントのMarkdownをクリップボードにコピー
カスタムURLリライトの実装
IntlayerはカスタムURLリライトをサポートしており、標準の/locale/path構造とは異なるロケール固有のパスを定義できます。これにより、内部のアプリケーションロジックを正規のまま維持しつつ、英語では/about、フランス語では/a-proposのようなURLを実現できます。
設定
カスタムリライトは、フレームワーク固有のフォーマッターを使用して intlayer.config.ts ファイルの routing セクションで設定します。これらのフォーマッターは、お使いのルーターに適した正しい構文を提供します。
コードをクリップボードにコピー
利用可能なフォーマッタ
Intlayer は主要なフレームワーク向けのフォーマッタを提供します:
nextjsRewrite: Next.js App Router 用。[slug]、[...slug](1+)、および[[...slug]](0+) をサポートします。svelteKitRewrite: SvelteKit 用。[slug]、[...path](0+)、および[[optional]](0-1) をサポートします。reactRouterRewrite: React Router 用。:slugと*(0+) をサポートします。vueRouterRewrite: Vue Router 4 用。:slug、:slug?(0-1)、:slug*(0+)、および:slug+(1+) をサポートします。solidRouterRewrite: Solid Router 用。:slugと*slug(0+) をサポートします。tanstackRouterRewrite: TanStack Router 向け。$slugと*(0+) をサポートします。nuxtRewrite: Nuxt 3 向け。[slug]と[...slug](0+) をサポートします。viteRewrite: 任意の Vite ベースプロジェクト向けの汎用フォーマッタ。Vite プロキシ用の構文を正規化します。
高度なパターン
Intlayer はこれらのパターンを内部で統一された構文に正規化し、高度なパスのマッチングと生成を可能にします:
- オプションセグメント:
[[optional]]（SvelteKit）や:slug?（Vue/React）に対応しています。 - キャッチオール（0個以上）:
[[...slug]]（Next.js）、[...path]（SvelteKit/Nuxt）、または*（React/TanStack）は複数のセグメントにマッチできます。 - 必須キャッチオール（1個以上）:
[...slug]（Next.js）や:slug+（Vue）は少なくとも1つのセグメントが存在することを保証します。
クライアント側のURL修正: useRewriteURL
ブラウザのアドレスバーが常に「見た目の良い」ローカライズされたURLを反映するように、Intlayer は useRewriteURL フックを提供します。このフックは、ユーザーが正規のパスに到達したときに window.history.replaceState を使って URL をサイレントに更新します。
フレームワークでの使用法
コードをクリップボードにコピー
ルーター統合とプロキシ
Intlayer のサーバーサイドプロキシ（Vite と Next.js）は、SEO の一貫性を確保するためにカスタムリライトを自動的に処理します。
- 内部リライト: ユーザーが
/fr/a-proposにアクセスした場合、プロキシは内部的にそれを/fr/aboutにマッピングして、フレームワークが正しいルートに一致するようにします。 - 正規化リダイレクト: ユーザーが手動で
/fr/aboutと入力した場合、プロキシは/fr/a-proposへ 301/302 リダイレクトを発行し、検索エンジンがページの単一のバージョンのみをインデックスするようにします。
Next.js 統合
Next.js との統合は intlayerProxy ミドルウェアで完全に処理されます。
コードをクリップボードにコピー
Vite 統合
SolidJS、Vue、Svelte 向けに、開発中のリライトは intlayerProxy Vite プラグインが管理します。
コードをクリップボードにコピー
主要機能
1. マルチコンテキスト・リライト
各フォーマッタは、異なる利用先向けの特殊化されたルールを含む RewriteObject を生成します:
url: クライアント側の URL 生成に最適化（ロケールセグメントを取り除く）。nextjs: Next.js のミドルウェア向けに[locale]を保持。vite: Vite プロキシ向けに:localeを保持。
2. 自動パターン正規化
Intlayer は内部ですべてのパターン構文（例: [param] を :param に変換するなど）を正規化し、ソースフレームワークに関係なくマッチングが一貫するようにします。
3. SEO の正規 URL
正規パスから見やすいエイリアスへのリダイレクトを強制することで、Intlayer は重複コンテンツの問題を防ぎ、サイトの発見性を向上させます。
コアユーティリティ
getLocalizedUrl(url, locale): リライトルールを尊重してローカライズされた URL を生成します。getCanonicalPath(path, locale): ローカライズされた URL を内部の正規パスに解決します。getRewritePath(pathname, locale): パス名がより見やすいローカライズ済みエイリアスに修正される必要があるかどうかを検出します。