# gt-next: General Translation Next.js SDK: LocaleSelector
URL: https://generaltranslation.com/es/docs/next/api/components/locale-selector.mdx
---
title: LocaleSelector
description: Referencia de la API del componente LocaleSelector
---

{/* GENERADO AUTOMÁTICAMENTE: No edites 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.

### Props

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

## Ejemplos

### Uso básico

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

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


### Uso de `customNames`

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

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 diferente para tu aplicación.
* El componente `<LocaleSelector>` no está disponible en componentes de servidor.

## Próximos pasos

* Obtén más información sobre el hook [`useLocale`](/docs/next/api/helpers/use-locale).
* Consulta el hook [`useLocaleSelector`](/docs/next/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).