# General Translation React SDKs (gt-react, gt-next): useLocales
URL: https://generaltranslation.com/es/docs/react/reference/hooks/use-locales.mdx
---

title: useLocales
description: Lista de configuraciones regionales compatibles con General Translation gt-react. Referencia de API para useLocales.

---

El hook `useLocales` devuelve la lista de configuraciones regionales compatibles del contexto de [`<GTProvider>`](/docs/react/reference/components/gt-provider).

*Disponible en `gt-react`, `gt-next`, `gt-tanstack-start` y `gt-react-native`. Los ejemplos importan desde `gt-react`; en su lugar, importa desde el paquete de tu framework.*

## Descripción general [#overview]

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

```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).