# General Translation React SDKs (gt-react, gt-next, gt-react-native): useLocales
URL: https://generaltranslation.com/es/docs/react/reference/hooks/use-locales.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Lista de configuraciones regionales compatibles. Referencia de API para useLocales.

El hook `useLocales` devuelve los códigos de configuración regional que admite tu aplicación como una lista de cadenas, leídos del contexto de [`<GTProvider>`](/docs/react/reference/components/gt-provider). Úsalo para renderizar o iterar las configuraciones regionales disponibles, por ejemplo al crear un selector de idioma personalizado.

*Disponible en `gt-react`, `gt-next`, `gt-tanstack-start` y `gt-react-native`.*

## Descripción general [#overview]

Llama a `useLocales` para leer los códigos de configuración regional admitidos.

*Los ejemplos importan desde `gt-react`; en su lugar, importa desde el paquete de tu framework.*

```tsx
import { useLocales } from 'gt-react';

export default function LocaleList() {
  const locales = useLocales(); // [!code highlight]
  return (
    <ul>
      {locales.map((locale) => (
        <li key={locale}>{locale}</li>
      ))}
    </ul>
  );
}
```

*Nota: En `gt-react`, usa `useLocales` dentro de un [`<GTProvider>`](/docs/react/reference/components/gt-provider). En `gt-next`, también funciona en componentes del servidor.*

## Cómo funciona [#how-it-works]

La lista proviene de los [`locales`](/docs/react/reference/config#locales) que configuras. Cada entrada es un código de configuración regional BCP 47.

## Devuelve [#returns]

**Tipo** `readonly string[]`

Una lista de códigos de configuración regional compatibles, como `['en-US', 'fr', 'ja']`.

## Notas [#notes]

* `useLocales` es síncrono y funciona en componentes de servidor y de cliente.
* Para leer la configuración regional activa, usa [`useLocale`](/docs/react/reference/hooks/use-locale).

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.