# gt-react: General Translation React SDK: LocaleSelector
URL: https://generaltranslation.com/ru/docs/react/api/components/locale-selector.mdx
---
title: LocaleSelector
description: Справка по API компонента LocaleSelector
---

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


## Обзор

Компонент `<LocaleSelector>` используется для выбора локали пользователя.
Это клиентский компонент с выпадающим списком для выбора локали.

## Справка

### Возвращаемое значение

Компонент, позволяющий пользователю выбрать локаль.

### Свойства

* **`locales`** (необязательно): `string[]`
  * Необязательный список локалей (например, `['en', 'es-MX', 'fr']`) для заполнения выпадающего списка. Если он не указан, используется список локалей из контекста `<GTProvider>`.
* **`customNames`** (необязательно): `{[locale: string]: string}`
  * Необязательный объект, сопоставляющий кодам локалей пользовательские отображаемые названия.
  * Пример: `{{ 'en-US': 'English (United States)', 'es': 'Español' }}`

## Примеры

### Основное использование

```jsx
import { LocaleSelector } from 'gt-react';

export default function MyComponent() {
  return <LocaleSelector />;
}
```


### Использование параметра `customNames`

```jsx
import { LocaleSelector } from 'gt-react';

export default function MyComponent() {
  const myCustomNames = {
    en: 'English',
    es: 'Español',
    'fr-CA': 'Français (Canada)',
  };
  return <LocaleSelector customNames={myCustomNames} />;
}
```

***


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

* Компонент `<LocaleSelector>` позволяет выбрать для вашего приложения другую локаль.
* Компонент `<LocaleSelector>` недоступен в серверном компоненте.

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

* Узнайте больше о хуке [`useLocale`](/docs/react/api/helpers/use-locale).
* Ознакомьтесь с хуком [`useLocaleSelector`](/docs/react/api/helpers/use-locale-selector), чтобы задать собственный селектор локали.
* Узнайте больше о [строковых представлениях локалей](/docs/core/locales).