# gt-react: General Translation React SDK: useLocaleProperties
URL: https://generaltranslation.com/it/docs/react/api/helpers/use-locale-properties.mdx
---
title: useLocaleProperties
description: Riferimento API dell'Hook useLocaleProperties
---

{/* GENERATO AUTOMATICAMENTE: Non modificare direttamente. Modifica invece il template in content/docs-templates/. */}


## Panoramica

L'hook `useLocaleProperties` restituisce i metadati di una determinata impostazione regionale, inclusi nome, nome nativo, lingua, regione e informazioni sul sistema di scrittura.

<Callout>
  `useLocaleProperties` è un hook lato client e *può essere utilizzato solo nei componenti lato client*.
  Assicurati che la tua app sia avvolta in [`<GTProvider>`](/docs/react/api/components/gtprovider).
</Callout>

## Riferimento

### Parametri

| Parametro | Tipo     | Descrizione                                             |
| --------- | -------- | ------------------------------------------------------- |
| `locale`  | `string` | Un codice locale BCP 47 (ad esempio `'en-US'`, `'ja'`). |

### Restituisce

Un oggetto `LocaleProperties` con i seguenti campi:

| Campo                      | Tipo     | Descrizione                                                                                  |
| -------------------------- | -------- | -------------------------------------------------------------------------------------------- |
| `code`                     | `string` | Il codice locale (ad es. `'en-US'`).                                                         |
| `name`                     | `string` | Il nome in inglese dell&#39;impostazione regionale (ad es. `'American English'`).            |
| `nativeName`               | `string` | Il nome dell&#39;impostazione regionale nella propria lingua.                                |
| `languageCode`             | `string` | Il sottotag della lingua (ad es. `'en'`).                                                    |
| `languageName`             | `string` | Il nome in inglese della lingua.                                                             |
| `nativeLanguageName`       | `string` | Il nome della lingua nella propria lingua.                                                   |
| `nameWithRegionCode`       | `string` | Il nome dell&#39;impostazione regionale comprensivo della regione (ad es. `'English (US)'`). |
| `nativeNameWithRegionCode` | `string` | Il nome nativo dell&#39;impostazione regionale comprensivo della regione.                    |
| `regionCode`               | `string` | Il sottotag della regione (ad es. `'US'`).                                                   |
| `regionName`               | `string` | Il nome in inglese della regione.                                                            |
| `nativeRegionName`         | `string` | Il nome della regione nella lingua dell&#39;impostazione regionale.                          |
| `scriptCode`               | `string` | Il sottotag del sistema di scrittura (ad es. `'Latn'`).                                      |
| `scriptName`               | `string` | Il nome in inglese del sistema di scrittura.                                                 |
| `nativeScriptName`         | `string` | Il nome del sistema di scrittura nella lingua dell&#39;impostazione regionale.               |
| `maximizedCode`            | `string` | Il codice locale completamente espanso (ad es. `'en-Latn-US'`).                              |

***

## Esempi

### Utilizzo di base

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

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>
  );
}
```

***


## Note

* Questo Hook è sincrono: restituisce direttamente le proprietà.
* Utile per creare selettori personalizzati dell&#39;impostazione regionale o per mostrare agli utenti i metadati dell&#39;impostazione regionale.

## Passaggi successivi

* Scopri di più sui [codici locale](/docs/core/locales).