# 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
Docs index: https://generaltranslation.com/llms.txt
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 généralement l’arborescence des composants serveur de React. Lorsque le routage par paramètre régional est activé, le passage au paramètre régional par défaut depuis une URL qui correspond à un paramètre régional autre que celui par défaut recharge le document afin que le middleware puisse supprimer le préfixe du paramètre régional. Une URL qui correspond déjà au paramètre régional par défaut est seulement actualisée. 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).

## Historique des versions [#version-history]

| Version | Modifications                                                                                                                                                                             |
| ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 11.1.16 | La sélection du paramètre régional par défaut sur une URL App Router sans préfixe ou utilisant la résolution par défaut actualise les composants serveur de React au lieu de recharger le document. |

## Sitemap

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