# General Translation React SDKs (gt-react, gt-next, gt-react-native): useSetLocale
URL: https://generaltranslation.com/fr/docs/react/reference/hooks/use-set-locale.mdx
---
title: useSetLocale
description: Modifiez le paramètre régional actif. Référence de l’API pour useSetLocale.

---

Le hook `useSetLocale` renvoie une fonction qui modifie le paramètre régional actif. Il est uniquement disponible côté client.

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

## Vue d’ensemble [#overview]

Appelez `useSetLocale` pour obtenir la fonction de mise à jour, puis appelez-la avec un code de langue.

*Les exemples importent depuis `gt-react` ; importez plutôt depuis le paquet de votre framework.*

```tsx
import { useSetLocale } from 'gt-react';

export default function LocaleButton() {
  const setLocale = useSetLocale();
  return <button onClick={() => setLocale('en')}>Set locale</button>;
}
```

*Remarque : `useSetLocale` est disponible uniquement côté client.*

## Fonctionnement [#how-it-works]

L’appel de la fonction renvoyée enregistre et applique le paramètre régional via le framework actif :

* React l’enregistre dans un cookie et recharge la page par défaut.
* Next.js App Router l’enregistre dans un cookie et actualise l’arborescence des composants serveur. Pages Router peut remplacer le rechargement par défaut par la navigation Next.js.
* TanStack Start l’enregistre dans un cookie et recharge la page, ou accède au pathname correspondant lorsque [`localeRouting`](/docs/react/reference/config#locale-routing) est activé.
* React Native l’enregistre dans le stockage natif, met à jour l’état du provider, charge les traductions et réaffiche l’interface.

## Retourne [#returns]

**Type** `(locale: string) => void`

Une fonction qui définit le paramètre régional actif à partir du code fourni.

## Remarques [#notes]

* `useSetLocale` est disponible uniquement côté client.
* Pour connaître le paramètre régional actif, utilisez [`useLocale`](/docs/react/reference/hooks/use-locale). Pour un sélecteur prêt à l’emploi, utilisez [`<LocaleSelector>`](/docs/react/reference/components/locale-selector).