# General Translation React SDKs (gt-react, gt-next): useLocaleSelector
URL: https://generaltranslation.com/ru/docs/react/reference/hooks/use-locale-selector.mdx
---

title: useLocaleSelector
description: Создайте собственный переключатель локали с General Translation gt-react. Справочник API по useLocaleSelector.

---

Хук `useLocaleSelector` возвращает состояние, необходимое для создания собственного переключателя локали: активную локаль, доступные локали, вспомогательный объект со свойствами локали и setter.

*Доступно в `gt-react`, `gt-next`, `gt-tanstack-start` и `gt-react-native`. В примерах используется импорт из `gt-react`; вместо этого импортируйте из пакета вашего фреймворка.*

## Обзор [#overview]

Вызовите `useLocaleSelector` и используйте возвращаемые значения в собственном элементе `<select>` или другом пользовательском интерфейсе.

```tsx
'use client';
import { useLocaleSelector } from 'gt-react';

export default function MySelector() {
  const { locale, locales, setLocale, getLocaleProperties } = useLocaleSelector();

  return (
    <select value={locale} onChange={(e) => setLocale(e.target.value)}>
      {locales.map((l) => (
        <option key={l} value={l}>
          {getLocaleProperties(l).nativeNameWithRegionCode}
        </option>
      ))}
    </select>
  );
}
```

*Примечание: `useLocaleSelector` доступен только на клиенте. Если вам не нужен собственный интерфейс, используйте компонент [`<LocaleSelector>`](/docs/react/reference/components/locale-selector).*

## Как это работает [#how-it-works]

Этот хук предоставляет всё, что нужно селектору: активную `locale`, список `locales`, `setLocale` для её изменения (это сохраняет выбор и перезагружает страницу) и `getLocaleProperties` для отображения названий. Передайте подмножество локалей, чтобы ограничить доступные варианты.

## Параметры [#parameters]

| Параметр              | Описание                           | Тип        | Необязательный | По умолчанию              |
| --------------------- | ---------------------------------- | ---------- | -------------- | ------------------------- |
| [`locales`](#locales) | Подмножество предлагаемых локалей. | `string[]` | Да             | Все поддерживаемые локали |

### `locales` [#locales]

**Тип** `string[]` · **Необязательно** · **По умолчанию** Все поддерживаемые

Подмножество поддерживаемых локалей, которое будет доступно. Если параметр не указан, используются локали из контекста `<GTProvider>`.

## Возвращает [#returns]

**Тип** `object`

| Поле                  | Описание                                    | Тип                                    |
| --------------------- | ------------------------------------------- | -------------------------------------- |
| `locale`              | Текущая локаль.                             | `string`                               |
| `locales`             | Доступные локали.                           | `string[]`                             |
| `setLocale`           | Изменить активную локаль.                   | `(locale: string) => void`             |
| `getLocaleProperties` | Получить метаданные локали для отображения. | `(locale: string) => LocaleProperties` |

## Заметки [#notes]

* `useLocaleSelector` работает только на клиенте.
* Чтобы использовать готовый выпадающий список, воспользуйтесь [`<LocaleSelector>`](/docs/react/reference/components/locale-selector).