# General Translation React SDKs (gt-react, gt-next): useLocaleProperties
URL: https://generaltranslation.com/it/docs/react/reference/hooks/use-locale-properties.mdx
---

title: useLocaleProperties
description: Legge i metadati di visualizzazione di un'impostazione regionale con General Translation gt-react. Riferimento API per useLocaleProperties.

---

L'hook `useLocaleProperties` restituisce i metadati di visualizzazione di un'impostazione regionale: nome, nome nativo, lingua, regione e sistema di scrittura.

*Disponibile in `gt-react`, `gt-next` e `gt-react-native`. Gli esempi importano da `gt-react`; importa invece dal pacchetto del framework che usi.*

*Nota: non esportato da `gt-tanstack-start`.*

## Panoramica [#overview]

Passa un codice locale a `useLocaleProperties` per ottenerne le proprietà.

```tsx
import { useLocale, useLocaleProperties } 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>
  );
}
```

*Nota: In `gt-react`, chiama `useLocaleProperties` all&#39;interno di un [`<GTProvider>`](/docs/react/reference/components/gt-provider). In `gt-next`, funziona anche nei componenti server.*

## Come funziona [#how-it-works]

L&#39;hook converte il codice locale specificato in un oggetto [`LocaleProperties`](/docs/platform/core/reference/types/locale-properties), utile per creare selettori di impostazione regionale personalizzati o per mostrare agli utenti i metadati dell&#39;impostazione regionale.

## Parametri [#parameters]

| Parametro           | Descrizione                                 | Tipo     | Facoltativo | Predefinito |
| ------------------- | ------------------------------------------- | -------- | ----------- | ----------- |
| [`locale`](#locale) | L&#39;impostazione regionale da descrivere. | `string` | No          | —           |

### `locale` [#locale]

**Tipo** `string` · **Obbligatorio**

Un codice locale BCP 47, come `en-US` o `ja`.

## Restituisce [#returns]

**Tipo** [`LocaleProperties`](/docs/platform/core/reference/types/locale-properties)

Un oggetto che descrive l&#39;impostazione regionale. I campi principali includono:

| Campo                      | Descrizione                                                                             | Tipo     |
| -------------------------- | --------------------------------------------------------------------------------------- | -------- |
| `code`                     | Il codice locale, ad esempio `en-US`.                                                   | `string` |
| `name`                     | Nome inglese dell&#39;impostazione regionale, ad esempio `American English`.            | `string` |
| `nativeName`               | Nome dell&#39;impostazione regionale nella propria lingua.                              | `string` |
| `languageCode`             | Il sottotag della lingua, ad esempio `en`.                                              | `string` |
| `languageName`             | Nome inglese della lingua.                                                              | `string` |
| `nativeLanguageName`       | Nome della lingua nella lingua stessa.                                                  | `string` |
| `nameWithRegionCode`       | Nome dell&#39;impostazione regionale con la regione inclusa, ad esempio `English (US)`. | `string` |
| `nativeNameWithRegionCode` | Nome nativo dell&#39;impostazione regionale con la regione inclusa.                     | `string` |
| `regionCode`               | Il sottotag della regione, ad esempio `US`.                                             | `string` |
| `regionName`               | Nome inglese della regione.                                                             | `string` |
| `nativeRegionName`         | Nome della regione nella lingua dell&#39;impostazione regionale.                        | `string` |
| `scriptCode`               | Il sottotag del sistema di scrittura, ad esempio `Latn`.                                | `string` |
| `scriptName`               | Nome inglese del sistema di scrittura.                                                  | `string` |
| `nativeScriptName`         | Nome del sistema di scrittura nella lingua dell&#39;impostazione regionale.             | `string` |
| `maximizedCode`            | Il codice locale completamente esteso, ad esempio `en-Latn-US`.                         | `string` |
| `emoji`                    | Emoji associata alla regione dell&#39;impostazione regionale.                           | `string` |

Vedi [`LocaleProperties`](/docs/platform/core/reference/types/locale-properties) per l&#39;elenco completo dei campi.

## Note [#notes]

* `useLocaleProperties` è sincrono e funziona sia nei componenti server sia in quelli client.
* Per leggere l&#39;impostazione regionale attiva, usa [`useLocale`](/docs/react/reference/hooks/use-locale).