# General Translation React SDKs (gt-react, gt-next, gt-react-native): useLocales
URL: https://generaltranslation.com/ru/docs/react/reference/hooks/use-locales.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Список поддерживаемых локалей. Справочник API по useLocales.

Хук `useLocales` возвращает коды локалей, которые поддерживает ваше приложение, в виде массива строк из контекста [`<GTProvider>`](/docs/react/reference/components/gt-provider). Используйте его, чтобы отображать или перебирать доступные локали, например при создании пользовательского переключателя языка.

*Доступно в `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` вызывайте `useLocales` внутри [`<GTProvider>`](/docs/react/reference/components/gt-provider). В `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.