# react-native: useRegion
URL: https://generaltranslation.com/fr/docs/react-native/api/helpers/use-region.mdx
---
title: useRegion
description: Référence d’API du hook useRegion
---

{/* 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 `useRegion` récupère la région actuellement sélectionnée par l’utilisateur à partir du [contexte `<GTProvider>`](/docs/react-native/api/components/gtprovider).

<Callout>
  `useRegion` est un hook côté client et *ne peut être utilisé que dans des composants côté client*.
  Assurez-vous d’envelopper votre application dans un [`<GTProvider>`](/docs/react-native/api/components/gtprovider).
</Callout>

## Référence

### Renvoie

`string | undefined` — Le code régional actuellement actif (par ex. `"US"`, `"CA"`), ou `undefined` si aucune région n’est définie.

***

## Exemples

### Utilisation de base

```jsx title="RegionDisplay.jsx" copy
'use client';
import { useRegion } from 'gt-react-native';

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

***


## Remarques

* Renvoie `undefined` si l’utilisateur n’a pas sélectionné de région.
* Vous pouvez définir la région à l’aide du composant [`<RegionSelector>`](/docs/react-native/api/components/region-selector) ou du hook [`useRegionSelector`](/docs/react-native/api/helpers/use-region-selector).

## Étapes suivantes

* Utilisez [`<RegionSelector>`](/docs/react-native/api/components/region-selector) pour permettre aux utilisateurs de choisir leur région.
* Utilisez [`useRegionSelector`](/docs/react-native/api/helpers/use-region-selector) pour créer un sélecteur de région personnalisé.