# General Translation React SDKs (gt-react, gt-next, gt-react-native): useLocales
URL: https://generaltranslation.com/fr/docs/react/reference/hooks/use-locales.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Liste les paramètres régionaux pris en charge. Référence de l’API pour useLocales.

Le hook `useLocales` renvoie les codes de langue pris en charge par votre application sous forme de tableau de chaînes, lus depuis le contexte [`<GTProvider>`](/docs/react/reference/components/gt-provider). Utilisez-le pour afficher ou parcourir les paramètres régionaux disponibles, par exemple lors de la création d’un sélecteur de langue personnalisé.

*Disponible dans `gt-react`, `gt-next`, `gt-tanstack-start` et `gt-react-native`.*

## Vue d’ensemble [#overview]

Appelez `useLocales` pour récupérer les codes de langue pris en charge.

*Les exemples importent depuis `gt-react` ; importez plutôt depuis le paquet de votre 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>
  );
}
```

*Remarque : dans `gt-react`, appelez `useLocales` à l’intérieur d’un [`<GTProvider>`](/docs/react/reference/components/gt-provider). Dans `gt-next`, cela fonctionne aussi dans les composants serveur.*

## Fonctionnement [#how-it-works]

La liste provient des [`locales`](/docs/react/reference/config#locales) que vous configurez. Chaque entrée correspond à un code de langue BCP 47.

## Renvoie [#returns]

**Type** `readonly string[]`

Un tableau de codes de langue pris en charge, comme `['en-US', 'fr', 'ja']`.

## Notes [#notes]

* `useLocales` est synchrone et fonctionne dans les composants serveur et client.
* Pour connaître le paramètre régional actif, utilisez [`useLocale`](/docs/react/reference/hooks/use-locale).

## Sitemap

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