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

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


## Vue d’ensemble

Le hook `useLocale` récupère le paramètre régional actuel de l’utilisateur à partir du [contexte `<GTProvider>`](/docs/next/api/components/gtprovider).
Le paramètre régional est renvoyé sous la forme d’un [code de langue](/docs/core/locales) BCP 47, par exemple `'en-US'`.

<Callout>
  `useLocale` 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 encapsulée dans un [`<GTProvider>`](/docs/next/api/components/gtprovider).
</Callout>

## Référence

### Renvoie

Une chaîne indiquant le paramètre régional actuel de l’utilisateur, par ex. `'en-US'`.

***

## Comportement de secours

Lorsqu’un paramètre régional non pris en charge est demandé, un paramètre régional de secours est sélectionné.

Par exemple, dans le cas d’un paramètre régional non pris en charge,
si (1) l’utilisateur a configuré plusieurs paramètres régionaux préférés dans les paramètres de son navigateur,
et (2) que l’un de ces paramètres régionaux est pris en charge par votre application,
alors le paramètre régional de secours sera la langue la plus appropriée.

De plus, si aucun paramètre régional de secours n’est disponible,
mais que deux paramètres régionaux partagent la même langue (par exemple, `en-US` et `en-GB`),
alors le paramètre régional de secours sera le paramètre régional pris en charge qui partage cette même langue.

Si aucune de ces conditions n’est remplie, le paramètre régional par défaut sera utilisé.

Consultez la documentation de [`gt.config.json`](/docs/next/api/config/gt-config-json) pour savoir comment configurer les paramètres régionaux pris en charge.

***

## Exemples

### Utilisation de base

Récupérez le paramètre régional actuel et affichez-le dans votre composant.

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

export default function CurrentLocale() {
  const locale = useLocale(); // [!code highlight]
  return <p>Current locale: {locale}</p>;
}
```

***


## Remarques

* Le hook `useLocale` s’appuie sur [`<GTProvider>`](/docs/next/api/components/gtprovider) pour accéder au contexte. Assurez-vous que votre application est enveloppée dans un provider à la racine.
* `useLocale` fonctionne uniquement côté client.
* Pour en savoir plus sur les codes de langue, cliquez [ici](/docs/core/locales).

## Étapes suivantes

* Découvrez comment gérer et définir les paramètres régionaux pris en charge dans votre application à l’aide du fichier [`gt.config.json`](/docs/next/api/config/gt-config-json).