# gt-react: General Translation React SDK: useLocale
URL: https://generaltranslation.com/fr/docs/react/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 depuis le [contexte `<GTProvider>`](/docs/react/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 enveloppée dans un [`<GTProvider>`](/docs/react/api/components/gtprovider).
</Callout>

## Référence

### Valeur renvoyée

Une chaîne correspondant au paramètre régional actuel de l’utilisateur, par exemple `'en-US'`.

***

## Comportement de repli

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

Par exemple, si un paramètre régional non pris en charge est demandé,
et si (1) l’utilisateur a configuré plusieurs paramètres régionaux préférés dans les réglages 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 repli sera la langue la plus appropriée.

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

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

Consultez la documentation de [`gt.config.json`](/docs/react/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 courant et affichez-le dans votre composant.

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

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

***


## Remarques

* Le hook `useLocale` s’appuie sur le [`<GTProvider>`](/docs/react/api/components/gtprovider) pour accéder au contexte. Assurez-vous que votre application est entourée d’un provider à la racine.
* `useLocale` est disponible 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 avec le fichier [`gt.config.json`](/docs/react/api/config/gt-config-json).