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

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


## Panoramica

L&#39;hook `useLocales` recupera l&#39;elenco delle impostazioni regionali supportate dal [contesto `<GTProvider>`](/docs/next/api/components/gtprovider).

<Callout>
  `useLocales` è un hook lato client e *può essere utilizzato solo nei componenti lato client*.
  Assicurati che la tua app sia avvolta in un [`<GTProvider>`](/docs/next/api/components/gtprovider).
</Callout>

## Guida di riferimento

### Restituisce

`string[]` — Un array di [codici locale](/docs/core/locales) BCP 47 che rappresentano le impostazioni regionali supportate, ad esempio `['en-US', 'fr', 'ja']`.

***

## Esempi

### Utilizzo di base

```jsx title="LocaleList.jsx" copy
'use client';
import { useLocales } from 'gt-next';

export default function LocaleList() {
  const locales = useLocales(); // [!code highlight]
  return (
    <ul>
      {locales.map((locale) => (
        <li key={locale}>{locale}</li>
      ))}
    </ul>
  );
}
```

***


## Note

* L&#39;hook `useLocales` si basa su [`<GTProvider>`](/docs/next/api/components/gtprovider) per accedere al contesto. Assicurati che l&#39;app sia racchiusa in un provider a livello della radice.
* `useLocales` è disponibile solo lato client. 

## Passaggi successivi

* Scopri come configurare le impostazioni regionali supportate in [`gt.config.json`](/docs/next/api/config/gt-config-json).