# react-native: useLocales
URL: https://generaltranslation.com/ja/docs/react-native/api/helpers/use-locales.mdx
---
title: useLocales
description: useLocales Hook の API リファレンス
---

{/* 自動生成: 直接編集せず、代わりに content/docs-templates/ 内の template を編集してください。 */}


## 概要

`useLocales` Hook は、[`<GTProvider>` コンテキスト](/docs/react-native/api/components/gtprovider) から対応ロケールの一覧を取得します。

<Callout>
  `useLocales` はクライアント側の Hook であり、*クライアント側コンポーネントでのみ使用できます*。
  アプリが [`<GTProvider>`](/docs/react-native/api/components/gtprovider) でラップされていることを確認してください。
</Callout>

## リファレンス

### 戻り値

`string[]` — サポートされているロケールを表す、BCP 47 準拠の[ロケールコード](/docs/core/locales)の配列 (例: `['en-US', 'fr', 'ja']`) 。

***

## 例

### 基本的な使い方

```jsx title="LocaleList.jsx" copy
'use client';
import { useLocales } from 'gt-react-native';

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

***


## 注意事項

* `useLocales` Hook は、コンテキストにアクセスするために [`<GTProvider>`](/docs/react-native/api/components/gtprovider) を必要とします。アプリがルートでプロバイダーにラップされていることを確認してください。
* `useLocales` はクライアント側でのみ使用できます。 

## 次のステップ

* [`gt.config.json`](/docs/react-native/api/config/gt-config-json) で対応ロケールを設定する方法を確認してください。