# General Translation React SDKs (gt-react, gt-next, gt-react-native): useLocales
URL: https://generaltranslation.com/ja/docs/react/reference/hooks/use-locales.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: サポートされているロケールの一覧。useLocales の API リファレンス。

`useLocales` hook は、[`<GTProvider>`](/docs/react/reference/components/gt-provider) context から読み取った、アプリがサポートするロケールコードを文字列の配列として返します。カスタムの言語切り替え機能を構築するときなどに、利用可能なロケールを表示したり列挙したりするために使用します。

*`gt-react`、`gt-next`、`gt-tanstack-start`、`gt-react-native` で利用できます。*

## 概要 [#overview]

対応しているロケールコードを取得するには、`useLocales` を呼び出します。

*例では `gt-react` からインポートしています。代わりに、ご使用のフレームワークのパッケージからインポートしてください。*

```tsx
import { useLocales } from 'gt-react';

export default function LocaleList() {
  const locales = useLocales(); // [!code highlight]
  return (
    <ul>
      {locales.map((locale) => (
        <li key={locale}>{locale}</li>
      ))}
    </ul>
  );
}
```

*注: `gt-react` では、[`<GTProvider>`](/docs/react/reference/components/gt-provider) 配下で `useLocales` を呼び出してください。`gt-next` では、サーバーコンポーネント内でも使用できます。*

## 仕組み [#how-it-works]

このリストは、設定した[`locales`](/docs/react/reference/config#locales)に基づいて生成されます。各エントリは BCP 47 のロケールコードです。

## 戻り値 [#returns]

**型** `readonly string[]`

`['en-US', 'fr', 'ja']` のような、対応しているロケールコードの配列です。

## メモ [#notes]

* `useLocales` は同期的で、サーバーコンポーネントとクライアントコンポーネントの両方で使用できます。
* アクティブなロケールを取得するには、[`useLocale`](/docs/react/reference/hooks/use-locale) を使用します。

## Sitemap

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