# General Translation React SDKs (gt-react, gt-next, gt-react-native): useLocaleSelector
URL: https://generaltranslation.com/it/docs/react/reference/hooks/use-locale-selector.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Crea un selettore di impostazione regionale personalizzato. Riferimento API di useLocaleSelector.

L'hook `useLocaleSelector` espone gli elementi per 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 per cambiare l'impostazione regionale.

*Disponibile in `gt-react`, `gt-next`, `gt-tanstack-start` e `gt-react-native`.*

## Panoramica [#overview]

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

*Gli esempi importano da `gt-react`; importa invece dal package del tuo framework.*

```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 e `getLocaleProperties` per visualizzare i nomi visualizzati. Passa un sottoinsieme di impostazioni regionali per limitare le opzioni. Il comportamento al cambio dell&#39;impostazione regionale dipende dal framework; consulta [Gestione delle impostazioni regionali](/docs/react/guides/managing-locales#persistence).

## 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. L&#39;hook mantiene l&#39;ordine di un array fornito esplicitamente. Se omesso, ordina le impostazioni regionali del contesto di [`<GTProvider>`](/docs/react/reference/components/gt-provider) in base al nome visualizzato nella lingua nativa.

## 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 utilizzando il mapping personalizzato configurato. | `(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).

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.