# gt-react: General Translation React SDK: LocaleSelector
URL: https://generaltranslation.com/it/docs/react/api/components/locale-selector.mdx
---
title: LocaleSelector
description: Riferimento API del componente LocaleSelector
---

{/* GENERATO AUTOMATICAMENTE: non modificare direttamente. Modifica il modello in content/docs-templates/. */}


## Panoramica

Il componente `<LocaleSelector>` viene utilizzato per selezionare l&#39;impostazione regionale dell&#39;utente.
È un componente lato client che fornisce un menu a discesa per selezionare l&#39;impostazione regionale.

## Riferimento

### Restituisce

Un componente che consente all&#39;utente di selezionare la propria impostazione regionale.

### Proprietà

* **`locales`** (facoltativo): `string[]`
  * Un elenco facoltativo di impostazioni regionali (ad esempio `['en', 'es-MX', 'fr']`) con cui popolare il menu a discesa. Se non viene fornito, viene usato l&#39;elenco di impostazioni regionali del contesto `<GTProvider>`.
* **`customNames`** (facoltativo): `{[locale: string]: string}`
  * Un oggetto facoltativo per associare i codici locale a nomi di visualizzazione personalizzati.
  * Esempio: `{{ 'en-US': 'English (United States)', 'es': 'Español' }}`

## Esempi

### Uso di base

```jsx
import { LocaleSelector } from 'gt-react';

export default function MyComponent() {
  return <LocaleSelector />;
}
```


### Utilizzo di `customNames`

```jsx
import { LocaleSelector } from 'gt-react';

export default function MyComponent() {
  const myCustomNames = {
    en: 'English',
    es: 'Español',
    'fr-CA': 'Français (Canada)',
  };
  return <LocaleSelector customNames={myCustomNames} />;
}
```

***


## Note

* Il componente `<LocaleSelector>` ti consente di selezionare un&#39;impostazione regionale diversa per la tua app.
* Il componente `<LocaleSelector>` non è disponibile in un componente server.

## Passaggi successivi

* Scopri di più sull&#39;hook [`useLocale`](/docs/react/api/helpers/use-locale).
* Scopri l&#39;hook [`useLocaleSelector`](/docs/react/api/helpers/use-locale-selector) per definire un selettore personalizzato dell&#39;impostazione regionale.
* Scopri di più sulle [stringhe relative alle impostazioni regionali](/docs/core/locales).