# General Translation React SDKs (gt-react, gt-next): useLocales
URL: https://generaltranslation.com/ja/docs/react/reference/hooks/use-locales.mdx
---

title: useLocales
description: General Translation gt-react でサポートされているロケールの一覧を取得します。useLocales の API リファレンス。

---

`useLocales` hook は、[`<GTProvider>`](/docs/react/reference/components/gt-provider) context からサポートされているロケールの一覧を返します。

*`gt-react`、`gt-next`、`gt-tanstack-start`、`gt-react-native` で利用できます。例では `gt-react` から import していますが、実際には使用しているフレームワークのパッケージから import してください。*

## 概要 [#overview]

サポートされているロケールコードを取得するには、`useLocales` を呼び出します。

```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) を使用します。