# react-native: useLocales
URL: https://generaltranslation.com/zh/docs/react-native/api/helpers/use-locales.mdx
---
title: useLocales
description: useLocales 钩子的 API 参考
---

{/* 自动生成：请勿直接编辑。请改为在 content/docs-templates/ 中编辑 template。 */}


## 概述

`useLocales` 钩子会从 [`<GTProvider>` 上下文](/docs/react-native/api/components/gtprovider) 中获取受支持的区域设置列表。

<Callout>
  `useLocales` 是一个客户端钩子，*只能在客户端组件中使用*。
  请确保你的应用已包装在 [`<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` 钩子 依赖 [`<GTProvider>`](/docs/react-native/api/components/gtprovider) 来访问上下文。请确保在应用根级使用 provider 进行包裹。
* `useLocales` 仅支持客户端。 

## 后续步骤

* 了解如何在 [`gt.config.json`](/docs/react-native/api/config/gt-config-json) 中配置受支持的区域设置。