# react-native: LocaleSelector
URL: https://generaltranslation.com/es/docs/react-native/api/components/locale-selector.mdx
---
title: LocaleSelector
description: Referencia de la API del componente LocaleSelector
---

{/* GENERADO AUTOMÁTICAMENTE: No edites esto directamente. En su lugar, edita la plantilla en content/docs-templates/. */}


## Resumen

El componente `<LocaleSelector>` se usa para seleccionar la configuración regional del usuario.
Es un componente del lado del cliente que ofrece un menú desplegable para seleccionar la configuración regional.

## Referencia

### Devuelve

Un componente que permite al usuario seleccionar su configuración regional.

### Propiedades

* **`locales`** (opcional): `string[]`
  * Una lista opcional de configuraciones regionales (p. ej., `['en', 'es-MX', 'fr']`) para completar el menú desplegable. Si no se proporciona, se usa la lista de configuraciones regionales del contexto de `<GTProvider>`.
* **`customNames`** (opcional): `{[locale: string]: string}`
  * Un objeto opcional que asigna códigos de configuración regional a nombres de visualización personalizados.
  * Ejemplo: `{{ 'en-US': 'inglés (Estados Unidos)', 'es': 'Español' }}`

## Ejemplos

### Uso básico

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

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


### Uso de `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} />;
}
```

***


## Notas

* El componente `<LocaleSelector>` te permite seleccionar una configuración regional distinta para tu aplicación.
* El componente `<LocaleSelector>` no está disponible en el componente de servidor.

## Próximos pasos

* Obtén más información sobre el hook [`useLocale`](/docs/react-native/api/helpers/use-locale).
* Consulta el hook [`useLocaleSelector`](/docs/react-native/api/helpers/use-locale-selector) para definir un selector de configuración regional personalizado.
* Obtén más información sobre las [cadenas de configuración regional](/docs/core/locales).