# gt-next: General Translation Next.js SDK: useLocaleSelector
URL: https://generaltranslation.com/it/docs/next/api/helpers/use-locale-selector.mdx
---
title: useLocaleSelector
description: Riferimento dell'API per l'hook useLocaleSelector
---

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


## Panoramica

Questo hook restituisce l'impostazione regionale corrente, l'elenco delle impostazioni regionali, l'hook [`useSetLocale`](/docs/next/api/helpers/use-set-locale) e una funzione per ottenere le proprietà dell'impostazione regionale.
È pensato per essere usato facilmente quando crei un tuo componente selettore di impostazione regionale.

Se non vuoi implementarne uno tuo, puoi usare invece il componente [`<LocaleSelector>`](/docs/next/api/components/locale-selector).

## Riferimento

### Restituisce

Un oggetto contenente l&#39;impostazione regionale corrente, l&#39;elenco delle impostazioni regionali, l&#39;hook [`useSetLocale`](/docs/next/api/helpers/use-set-locale) e una funzione per ottenere le proprietà dell&#39;impostazione regionale.

***

## Esempi

### `<LocaleSelector>`

Questa è un&#39;implementazione di esempio del componente [`<LocaleSelector>`](/docs/next/api/components/locale-selector).

```jsx
export default function LocaleSelector({
  locales: _locales,
  ...props
}: {
  locales?: string[];
  [key: string]: any;
}): React.JSX.Element | null {
  // Ottieni le proprietà del selettore di impostazione regionale
  const { locale, locales, setLocale, getLocaleProperties } = useLocaleSelector(
    _locales ? _locales : undefined
  );

  // Ottieni il nome visualizzato
  const getDisplayName = (locale: string) => {
    return capitalizeLanguageName(
      getLocaleProperties(locale).nativeNameWithRegionCode
    );
  };

  // Se non vengono restituite impostazioni regionali, non renderizzare nulla o gestisci correttamente
  if (!locales || locales.length === 0 || !setLocale) {
    return null;
  }

  return (
    <select
      {...props}
      // Fallback a una stringa vuota se currentLocale è undefined
      value={locale || ''}
      onChange={(e) => setLocale(e.target.value)}
    >
      {/* Fallback opzionale per quando non è impostata alcuna impostazione regionale */}
      {!locale && <option value='' />}

      {locales.map((locale) => (
        <option key={locale} value={locale} suppressHydrationWarning>
          {getDisplayName(locale)}
        </option>
      ))}
    </select>
  );
}
```

***


## Note

* Questo hook è utilizzabile solo lato client.
* Scopri di più sui codici locale [qui](/docs/core/locales).

## Passaggi successivi

* Scopri di più sul componente [`<LocaleSelector>`](/docs/next/api/components/locale-selector).
* Scopri di più sull&#39;hook [`useLocale`](/docs/next/api/helpers/use-locale).