Panoramica

L'hook useLocale recupera la lingua/locale corrente dell'utente dal contesto di <GTProvider>. Il valore restituito è formattato come stringa, ad esempio 'en-US'.

Per la gestione della locale lato server, consulta getLocale.

Riferimenti

Restituisce

Una stringa che rappresenta la lingua/locale corrente dell’utente, ad esempio 'en-US'.

Comportamento di fallback

Quando viene richiesta una locale non supportata, verrà selezionata una locale di fallback.

Ad esempio, nel caso di una locale non supportata, se (1) l’utente ha configurato più lingue preferite nelle impostazioni del browser, e (2) una di queste è supportata dalla tua applicazione, allora la locale effettuerà il fallback alla lingua migliore.

Inoltre, se non sono disponibili possibili locale di fallback, ma due locale condividono la stessa lingua (ad es. en-US e en-GB), allora la locale effettuerà il fallback alla locale supportata che condivide la stessa lingua.

Se nessuna delle condizioni può essere soddisfatta, verrà utilizzata la locale predefinita.

Consulta la documentazione di gt.config.json per informazioni sulla configurazione delle locale supportate.

Esempi

Utilizzo di base

Recupera la lingua/locale corrente e mostrala nel componente.

"use client";
import { useLocale } from 'gt-next';

export default function CurrentLocale() {
    const locale = useLocale(); 
    return <p>Locale corrente: {locale}</p>;
}

Note

• L’hook useLocale si basa su <GTProvider> per accedere al contesto. Assicurati che la tua app sia racchiusa da un provider a livello di root.
• useLocale è solo lato client.
• Scopri di più sulle stringhe di localizzazione qui.

Prossimi passi

• Scopri come gestire e definire le lingue/locali supportate nella tua applicazione con il file gt.config.json.