Helpers

useDefaultLocale

useDefaultLocale フックのAPIリファレンス

概要

useDefaultLocale フックは、<GTProvider> コンテキストからアプリケーションの既定のロケールを取得します。 このロケールはアプリのフォールバック用言語を表し、通常はユーザーの優先ロケールが利用できない場合に使用されます。

useDefaultLocale はクライアントサイドのフックで、クライアントサイドのコンポーネントでのみ使用できます。 アプリ全体が <GTProvider> でラップされていることを確認してください。

設定については withGTConfig を参照してください。 withGTConfig で既定のロケールが指定されていない場合は、既定で 'en-US' が使用されます。 サーバーサイドについては getDefaultLocale を参照してください。

リファレンス

戻り値

アプリケーションの既定のlocaleを表す文字列。例: 'en-US'


基本的な使い方

アプリケーションの既定のlocaleを取得し、コンポーネントに表示します。

DefaultLocale.jsx
"use client";
import { useDefaultLocale } from 'gt-next';

export default function DefaultLocale() {
    const defaultLocale = useDefaultLocale();

    return <p>既定のロケール: {defaultLocale}</p>; // 既定のロケールを表示
}

注意事項

  • useDefaultLocale フックは、コンテキストにアクセスするために <GTProvider> に依存します。 アプリのルートでプロバイダーにラップされていることを確認してください。
  • useDefaultLocale はクライアントサイド専用です。
  • ロケールコード文字列についてはこちらをご覧ください。

次のステップ

  • ユーザーのlocaleを取得するには、useLocalegetLocale を参照してください。
  • サーバーコンポーネントで既定のロケールを取得するには、getDefaultLocale を参照してください。

このガイドはどうでしたか?

useDefaultLocale