Panoramica

La funzione getLocale recupera il locale corrente dell’utente durante il rendering sul server. Il locale restituito è formattato come stringa, ad esempio 'en-US'.

Per l’uso lato client, vedi useLocale.

Riferimenti

Restituisce

Una promessa che risolve in 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/locale preferite nelle impostazioni del browser e (2) una di queste è supportata dalla tua applicazione, allora si eseguirà il fallback alla lingua/locale 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 si eseguirà il fallback alla locale supportata che condivide la stessa lingua.

Se nessuna delle due 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 dell’utente durante il rendering lato server.

import { getLocale } from 'gt-next/server';

export default async function GetUserLocale() {
    const locale = await getLocale(); 
    return <p>Locale utente: {locale}</p>;
}

Note

• La funzione getLocale è asincrona e deve essere utilizzata con await per ottenere la locale.
• È progettata specificamente per l’uso lato server. Vedi useLocale per i componenti lato client.
• La locale restituita segue il formato delle stringhe della locale.

Prossimi passaggi

• Scopri come configurare i locale supportati con withGTConfig().