# gt-next: General Translation Next.js SDK: useLocales
URL: https://generaltranslation.com/fr/docs/next/api/helpers/use-locales.mdx
---
title: useLocales
description: Référence de l’API du Hook useLocales
---

{/* GÉNÉRÉ AUTOMATIQUEMENT : ne modifiez pas ce fichier directement. Modifiez plutôt le template dans content/docs-templates/. */}


## Vue d’ensemble

Le hook `useLocales` récupère la liste des paramètres régionaux pris en charge à partir du [contexte `<GTProvider>`](/docs/next/api/components/gtprovider).

<Callout>
  `useLocales` est un hook côté client et *ne peut être utilisé que dans des composants côté client*.
  Assurez-vous que votre application est bien entourée par un [`<GTProvider>`](/docs/next/api/components/gtprovider).
</Callout>

## Référence

### Renvoie

`string[]` — Un tableau de [codes de langue](/docs/core/locales) BCP 47 représentant les paramètres régionaux pris en charge, par ex. `['en-US', 'fr', 'ja']`.

***

## Exemples

### Utilisation de base

```jsx title="LocaleList.jsx" copy
'use client';
import { useLocales } from 'gt-next';

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

***


## Remarques

* Le Hook `useLocales` s&#39;appuie sur le [`<GTProvider>`](/docs/next/api/components/gtprovider) pour accéder au contexte. Assurez-vous que votre application est enveloppée par ce provider à la racine.
* `useLocales` fonctionne uniquement côté client. 

## Étapes suivantes

* Apprenez à configurer les paramètres régionaux pris en charge dans [`gt.config.json`](/docs/next/api/config/gt-config-json).