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

title: useRegion
description: Lire la région active avec General Translation gt-react. Référence de l’API pour useRegion.

---

Le hook `useRegion` renvoie la région actuellement sélectionnée par l’utilisateur à partir du contexte [`<GTProvider>`](/docs/react/reference/components/gt-provider), ou `undefined` si aucune n’est définie.

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

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

## Vue d’ensemble [#overview]

Appelez `useRegion` pour obtenir le code de la région active.

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

export default function RegionDisplay() {
  const region = useRegion(); // [!code highlight]
  return <p>Current region: {region ?? 'Not set'}</p>;
}
```

*Remarque : dans `gt-react`, appelez `useRegion` au sein d’un [`<GTProvider>`](/docs/react/reference/components/gt-provider). Dans `gt-next`, cela fonctionne également dans les composants serveur synchrones.*

## Comment ça fonctionne [#how-it-works]

La région est définie à l’aide du composant [`<RegionSelector>`](/docs/react/reference/components/region-selector) ou du hook [`useRegionSelector`](/docs/react/reference/hooks/use-region-selector). Si l’utilisateur n’a pas sélectionné de région, le hook renvoie `undefined`.

## Renvoie [#returns]

**Type** `string | undefined`

Le code de région actif, par exemple `US` ou `CA`, ou `undefined` si aucune région n’est définie.

## Notes [#notes]

* Dans un composant App Router asynchrone, utilisez plutôt [`getRegion`](/docs/react/nextjs/reference/functions/get-region).
* Pour changer de région, utilisez [`useSetRegion`](/docs/react/reference/hooks/use-set-region) ou [`<RegionSelector>`](/docs/react/reference/components/region-selector).