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'.

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ù locali preferite nelle impostazioni del browser e (2) una di queste locali è supportata dalla tua applicazione, allora la locale eseguirà il fallback verso la lingua più adatta.

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

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

Vedi <GTProvider> per informazioni sulla configurazione delle locali supportate.

Esempi

Utilizzo di base

Recupera la lingua/locale corrente e mostrala nel tuo componente.

import { useLocale } from 'gt-react';

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 in un provider al livello root.
• Scopri di più sulle stringhe locali qui.

Prossimi passaggi

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