クッキー / ヘッダーからロケールを取得する方法

フックの使用（推奨）

ほとんどのユースケースでは、useLocale フックを使用して現在のロケールを取得することを推奨します。これは自動的に解決されます。Vue.js の useLocale コンポーザブルと同様に動作します。

import { useLocale } from "next-intlayer";// or import { useLocale } from "react-intlayer";// or import { useLocale } from "vue-intlayer";ts;// クライアントサイドでの使用例const { locale } = useLocale();

import { useLocale } from "next-intlayer";// or import { useLocale } from "react-intlayer";// or import { useLocale } from "vue-intlayer";ts;// クライアントサイドでの使用例const { locale } = useLocale();

サーバーコンポーネントの場合は、以下からインポートできます:

import { useLocale } from "next-intlayer/server";const Test = () => {  const { locale } = useLocale();  return <>{locale}</>;};const Page = async ({ params }) => {  const { locale } = await params;  return (    <IntlayerServerProvider locale={locale}>      <Test />    </IntlayerServerProvider>  );};

import { useLocale } from "next-intlayer/server";const Test = () => {  const { locale } = useLocale();  return <>{locale}</>;};const Page = async ({ params }) => {  const { locale } = await params;  return (    <IntlayerServerProvider locale={locale}>      <Test />    </IntlayerServerProvider>  );};

クッキーの値のみを解決する useLocaleCookie フックもあります。

手動でのクッキー設定

カスタムクッキー名を次のように宣言できます。

import { type IntlayerConfig } from "intlayer";const config: IntlayerConfig = {  middleware: {    cookieName: "myCustomLocaleCookie", // デフォルトは 'intlayer-locale'  },};export default config;

import { type IntlayerConfig } from "intlayer";const config: IntlayerConfig = {  middleware: {    cookieName: "myCustomLocaleCookie", // デフォルトは 'intlayer-locale'  },};export default config;

それを取得する方法は以下の通りです。

クライアントサイド

// デフォルトのクッキー名を使用する場合const locale = document.cookie  .split("; ")  .find((row) => row.startsWith("intlayer-locale="))  ?.split("=")[1];// カスタムクッキー名を使用する場合const locale = document.cookie  .split("; ")  .find((row) => row.startsWith("myCustomLocaleCookie="))  ?.split("=")[1];

// デフォルトのクッキー名を使用する場合const locale = document.cookie  .split("; ")  .find((row) => row.startsWith("intlayer-locale="))  ?.split("=")[1];// カスタムクッキー名を使用する場合const locale = document.cookie  .split("; ")  .find((row) => row.startsWith("myCustomLocaleCookie="))  ?.split("=")[1];

サーバーサイド（Next.js）

import { cookies } from "next/headers";// デフォルトのクッキー名を使用する場合const locale = cookies().get("intlayer-locale")?.value;// カスタムクッキー名を使用する場合const locale = cookies().get("myCustomLocaleCookie")?.value;

import { cookies } from "next/headers";// デフォルトのクッキー名を使用する場合const locale = cookies().get("intlayer-locale")?.value;// カスタムクッキー名を使用する場合const locale = cookies().get("myCustomLocaleCookie")?.value;

localeがまだ設定されていない場合

localeはユーザーが明示的にlocaleを選択したときにのみクッキーとして設定されます。デフォルトでは、新しい訪問者に対しては、localeはヘッダーのフィールドから解釈されます。

ユーザーの優先するロケールはリクエストヘッダーから検出できます。以下はその処理例です：

/** * リクエストヘッダーからロケールを検出する * * accept-language ヘッダーはロケール検出において最も重要です。 * これは言語コードと品質値（q値）のリストを含み、 * ユーザーの優先言語を優先順位順に示します。 * * 例: "en-US,en;q=0.9,fr;q=0.8,es;q=0.7" * - en-US は第一優先言語（q=1.0が暗黙的に設定されている） * - en は第二選択肢（q=0.9） * - fr は第三選択肢（q=0.8） * - es は第四選択肢（q=0.7） */import { localeDetector } from "@intlayer/core";/** * ブラウザが通常送信するネゴシエーターヘッダーの例 * これらのヘッダーはユーザーの優先言語を判定するのに役立ちます */const exampleNegotiatorHeaders: Record<string, string> = {  "accept-language": "en-US,en;q=0.9,fr;q=0.8,es;q=0.7",  "accept":    "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8",  "user-agent":    "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36",};// 使用例:const detectedLocale = localeDetector(exampleNegotiatorHeaders);

/** * リクエストヘッダーからロケールを検出する * * accept-language ヘッダーはロケール検出において最も重要です。 * これは言語コードと品質値（q値）のリストを含み、 * ユーザーの優先言語を優先順位順に示します。 * * 例: "en-US,en;q=0.9,fr;q=0.8,es;q=0.7" * - en-US は第一優先言語（q=1.0が暗黙的に設定されている） * - en は第二選択肢（q=0.9） * - fr は第三選択肢（q=0.8） * - es は第四選択肢（q=0.7） */import { localeDetector } from "@intlayer/core";/** * ブラウザが通常送信するネゴシエーターヘッダーの例 * これらのヘッダーはユーザーの優先言語を判定するのに役立ちます */const exampleNegotiatorHeaders: Record<string, string> = {  "accept-language": "en-US,en;q=0.9,fr;q=0.8,es;q=0.7",  "accept":    "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8",  "user-agent":    "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36",};// 使用例:const detectedLocale = localeDetector(exampleNegotiatorHeaders);