# react-native: LocaleSelector
URL: https://generaltranslation.com/ru/docs/react-native/api/components/locale-selector.mdx
---
title: LocaleSelector
description: Справочная документация по API компонента LocaleSelector
---

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


## Обзор

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

## Справка

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

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

### Свойства

* **`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-native';

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


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

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

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