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

title: useLocaleSelector
description: Crea un selettore di impostazione regionale personalizzato con General Translation gt-react. Riferimento API di useLocaleSelector.

---

L'hook `useLocaleSelector` restituisce lo stato necessario per creare un selettore di impostazione regionale personalizzato: l'impostazione regionale attiva, le impostazioni regionali disponibili, un helper per le proprietà dell'impostazione regionale e un setter.

*Disponibile in `gt-react`, `gt-next`, `gt-tanstack-start` e `gt-react-native`. Negli esempi l'importazione avviene da `gt-react`; importa invece dal pacchetto del tuo framework.*

## Panoramica [#overview]

Chiama `useLocaleSelector` e usa i valori restituiti nel tuo `<select>` o in un&#39;interfaccia personalizzata.

```tsx
'use client';
import { useLocaleSelector } from 'gt-react';

export default function MySelector() {
  const { locale, locales, setLocale, getLocaleProperties } = useLocaleSelector();

  return (
    <select value={locale} onChange={(e) => setLocale(e.target.value)}>
      {locales.map((l) => (
        <option key={l} value={l}>
          {getLocaleProperties(l).nativeNameWithRegionCode}
        </option>
      ))}
    </select>
  );
}
```

*Nota: `useLocaleSelector` è solo lato client. Se non hai bisogno di un&#39;interfaccia utente personalizzata, usa invece il componente [`<LocaleSelector>`](/docs/react/reference/components/locale-selector).*

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

L&#39;hook espone tutto ciò di cui un selettore ha bisogno: l&#39;`impostazione regionale` attiva, l&#39;elenco di `locales`, `setLocale` per cambiarla (salvando la scelta e ricaricando la pagina) e `getLocaleProperties` per visualizzare i nomi visualizzati. Passa un sottoinsieme di impostazioni regionali per limitare le opzioni.

## Parametri [#parameters]

| Parametro             | Descrizione                                        | Tipo       | Facoltativo | Predefinito             |
| --------------------- | -------------------------------------------------- | ---------- | ----------- | ----------------------- |
| [`locales`](#locales) | Sottoinsieme di impostazioni regionali da offrire. | `string[]` | Sì          | Tutte quelle supportate |

### `locales` [#locales]

**Tipo** `string[]` · **Facoltativo** · **Predefinito** Tutte le supportate

Un sottoinsieme delle impostazioni regionali supportate da rendere disponibili. Se omesso, vengono utilizzate le impostazioni regionali del contesto di `<GTProvider>`.

## Restituisce [#returns]

**Tipo** `object`

| Campo                 | Descrizione                                                              | Tipo                                   |
| --------------------- | ------------------------------------------------------------------------ | -------------------------------------- |
| `locale`              | L&#39;impostazione regionale attualmente selezionata.                    | `string`                               |
| `locales`             | Le impostazioni regionali disponibili.                                   | `string[]`                             |
| `setLocale`           | Modifica l&#39;impostazione regionale attiva.                            | `(locale: string) => void`             |
| `getLocaleProperties` | Recupera i metadati di visualizzazione di un&#39;impostazione regionale. | `(locale: string) => LocaleProperties` |

## Note [#notes]

* `useLocaleSelector` è disponibile solo lato client.
* Per un menu a discesa già pronto, usa [`<LocaleSelector>`](/docs/react/reference/components/locale-selector).