# react-native: useLocaleProperties
URL: https://generaltranslation.com/fr/docs/react-native/api/helpers/use-locale-properties.mdx
---
title: useLocaleProperties
description: Référence API du hook useLocaleProperties
---

{/* GÉNÉRÉ AUTOMATIQUEMENT : ne modifiez pas directement. Modifiez plutôt le modèle dans content/docs-templates/. */}


## Vue d’ensemble

Le hook `useLocaleProperties` renvoie des métadonnées sur un paramètre régional donné, notamment son nom, son nom dans sa langue d’origine, sa langue, sa région et les informations sur son système d’écriture.

<Callout>
  `useLocaleProperties` est un hook client et *ne peut être utilisé que dans des composants client*.
  Assurez-vous que votre application est bien encapsulée dans un [`<GTProvider>`](/docs/react-native/api/components/gtprovider).
</Callout>

## Référence

### Paramètres

| Paramètre | Type     | Description                                          |
| --------- | -------- | ---------------------------------------------------- |
| `locale`  | `string` | Un code de langue BCP 47 (p. ex. `'en-US'`, `'ja'`). |

### Renvoie

Un objet `LocaleProperties` avec les champs suivants :

| Champ                      | Type     | Description                                                              |
| -------------------------- | -------- | ------------------------------------------------------------------------ |
| `code`                     | `string` | Le code de langue (par ex. `'en-US'`).                                   |
| `name`                     | `string` | Le nom anglais du paramètre régional (par ex. `'American English'`).     |
| `nativeName`               | `string` | Le nom du paramètre régional dans sa propre langue.                      |
| `languageCode`             | `string` | Le sous-tag de langue (par ex. `'en'`).                                  |
| `languageName`             | `string` | Le nom anglais de la langue.                                             |
| `nativeLanguageName`       | `string` | Le nom de la langue dans sa propre langue.                               |
| `nameWithRegionCode`       | `string` | Le nom du paramètre régional, région incluse (par ex. `'English (US)'`). |
| `nativeNameWithRegionCode` | `string` | Le nom natif du paramètre régional, région incluse.                      |
| `regionCode`               | `string` | Le sous-tag de région (par ex. `'US'`).                                  |
| `regionName`               | `string` | Le nom anglais de la région.                                             |
| `nativeRegionName`         | `string` | Le nom de la région dans la langue du paramètre régional.                |
| `scriptCode`               | `string` | Le sous-tag d’écriture (par ex. `'Latn'`).                               |
| `scriptName`               | `string` | Le nom anglais du système d’écriture.                                    |
| `nativeScriptName`         | `string` | Le nom du système d’écriture dans la langue du paramètre régional.       |
| `maximizedCode`            | `string` | Le code de langue entièrement développé (par ex. `'en-Latn-US'`).        |

***

## Exemples

### Utilisation de base

```jsx title="LocaleInfo.jsx" copy
'use client';
import { useLocaleProperties } from 'gt-react-native';
import { useLocale } from 'gt-react-native';

export default function LocaleInfo() {
  const locale = useLocale();
  const props = useLocaleProperties(locale); // [!code highlight]
  return (
    <div>
      <p>Name: {props.name}</p>
      <p>Native name: {props.nativeName}</p>
      <p>Region: {props.regionName}</p>
    </div>
  );
}
```

***


## Remarques

* Ce hook est synchrone : il renvoie directement les propriétés.
* Utile pour créer des sélecteurs de paramètres régionaux personnalisés ou afficher aux utilisateurs les métadonnées du paramètre régional.

## Prochaines étapes

* Pour en savoir plus, consultez les [codes de langue](/docs/core/locales).