# General Translation React SDKs (gt-react, gt-next): useSetRegion
URL: https://generaltranslation.com/fr/docs/react/reference/hooks/use-set-region.mdx
---

title: useSetRegion
description: Modifier la région active avec General Translation gt-react. Référence API de useSetRegion.

---

Le hook `useSetRegion` renvoie une fonction qui modifie la région active. Il est uniquement disponible côté client.

*Disponible dans `gt-react` et `gt-react-native`. Les exemples importent depuis `gt-react` ; importez plutôt depuis le package de votre framework.*

*Remarque : non exporté par `gt-next` ou `gt-tanstack-start`.*

## Vue d’ensemble [#overview]

Appelez `useSetRegion` pour récupérer le setter, puis appelez-le avec un code de région.

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

export default function RegionButton() {
  const setRegion = useSetRegion();
  return <button onClick={() => setRegion('CA')}>Switch to Canada</button>;
}
```

*Remarque : `useSetRegion` est disponible uniquement côté client et doit être utilisé sous un [`<GTProvider>`](/docs/react/reference/components/gt-provider).*

## Fonctionnement [#how-it-works]

L’appel de la fonction renvoyée enregistre la région choisie dans un cookie et recharge la page afin d’appliquer le formatage propre à la région. Passer `undefined` réinitialise la région.

## Retourne [#returns]

**Type** `(region: string | undefined) => void`

Une fonction qui définit la région active à partir du code fourni, ou l’efface si `undefined` est passé.

## Notes [#notes]

* `useSetRegion` est disponible uniquement côté client.
* Pour lire la région active, utilisez [`useRegion`](/docs/react/reference/hooks/use-region). Pour un sélecteur prêt à l’emploi, utilisez [`<RegionSelector>`](/docs/react/reference/components/region-selector).