# react-native: useLocales
URL: https://generaltranslation.com/ru/docs/react-native/api/helpers/use-locales.mdx
---
title: useLocales
description: Справочник по API Hook useLocales
---

{/* АВТОМАТИЧЕСКИ СГЕНЕРИРОВАНО: не редактируйте напрямую. Вместо этого редактируйте template в content/docs-templates/. */}


## Обзор

Hook `useLocales` возвращает список поддерживаемых локалей из [контекста `<GTProvider>`](/docs/react-native/api/components/gtprovider).

<Callout>
  `useLocales` — это клиентский Hook, и *его можно использовать только в клиентских компонентах*.
  Убедитесь, что ваше приложение обёрнуто в [`<GTProvider>`](/docs/react-native/api/components/gtprovider).
</Callout>

## Справочник

### Возвращает

`string[]` — Массив [кодов локалей](/docs/core/locales) в формате BCP 47, представляющих поддерживаемые локали, например `['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>
  );
}
```

***


## Примечания

* Hook `useLocales` использует [`<GTProvider>`](/docs/react-native/api/components/gtprovider) для доступа к контексту. Убедитесь, что ваше приложение обёрнуто в провайдер на корневом уровне.
* `useLocales` работает только на стороне клиента. 

## Следующие шаги

* Узнайте, как настроить поддерживаемые локали в [`gt.config.json`](/docs/react-native/api/config/gt-config-json).