# General Translation React SDKs (gt-react, gt-next, gt-react-native): useSetLocale
URL: https://generaltranslation.com/it/docs/react/reference/hooks/use-set-locale.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Cambia l'impostazione regionale attiva. Riferimento API per useSetLocale.

L'hook `useSetLocale` restituisce una funzione che cambia l'impostazione regionale attiva. È disponibile solo lato client.

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

## Panoramica [#overview]

Chiama `useSetLocale` per ottenere la funzione setter, quindi chiamala con un codice locale.

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

```tsx
import { useSetLocale } from 'gt-react';

export default function LocaleButton() {
  const setLocale = useSetLocale();
  return <button onClick={() => setLocale('en')}>Set locale</button>;
}
```

*Nota: `useSetLocale` è disponibile solo lato client.*

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

La chiamata alla funzione restituita salva e applica l&#39;impostazione regionale tramite il framework attivo:

* React la salva in un cookie e, per impostazione predefinita, ricarica la pagina.
* Next.js App Router la salva in un cookie e di solito aggiorna l&#39;albero dei server component. Con il routing delle impostazioni regionali abilitato, il passaggio all&#39;impostazione regionale predefinita da un URL che corrisponde a un&#39;impostazione regionale non predefinita ricarica il documento affinché il middleware possa rimuovere il prefisso dell&#39;impostazione regionale. Un URL che corrisponde già all&#39;impostazione regionale predefinita viene solo aggiornato. Pages Router può sostituire il ricaricamento predefinito con la navigazione di Next.js.
* TanStack Start la salva in un cookie e ricarica la pagina oppure passa al pathname corrispondente quando [`localeRouting`](/docs/react/reference/config#locale-routing) è abilitato.
* React Native la salva nello storage nativo, aggiorna lo stato del provider, carica le traduzioni e renderizza nuovamente.

## Restituisce [#returns]

**Tipo** `(locale: stringa) => void`

Una funzione che imposta l&#39;impostazione regionale attiva sul codice fornito.

## Note [#notes]

* `useSetLocale` è disponibile solo lato client.
* Per leggere l&#39;impostazione regionale attiva, usa [`useLocale`](/docs/react/reference/hooks/use-locale). Per un selettore già pronto, usa [`<LocaleSelector>`](/docs/react/reference/components/locale-selector).

## Cronologia versioni [#version-history]

| Versione | Modifiche                                                                                                                                                                                           |
| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 11.1.16  | La selezione dell&#39;impostazione regionale predefinita su un URL dell&#39;App Router senza prefisso o risolto al valore predefinito aggiorna i Server Components anziché ricaricare il documento. |

## Sitemap

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