Panoramica

La funzione getGT è una funzione asincrona che traduce le stringhe durante la build.

const t = await getGT();

<p>{  t('Questo testo verrà tradotto')  }</p>;

Riferimenti

Parametri

Nessuno

Restituisce

Una Promise di una funzione di callback, t, che traduce il contenuto fornito.

Promise<(content: string, options?: InlineTranslationOptions) => string>

Comportamento

Produzione

Durante il processo di CD, qualsiasi contenuto all'interno di una funzione t viene tradotto prima che la tua applicazione venga distribuita. Questo garantisce tempi di caricamento rapidi per tutte le lingue/località, ma può tradurre solo i contenuti noti al momento della build.

Una volta generate, le traduzioni vengono (1) archiviate nella CDN oppure (2) incluse nell'output di build della tua app, in base alla configurazione. Da lì, il contenuto tradotto viene erogato ai tuoi utenti. Se una traduzione non è disponibile, viene utilizzato il contenuto originale come fallback.

Assicurati di seguire la guida al deployment qui.

Sviluppo

Durante lo sviluppo, la funzione t traduce i contenuti on‑demand. È utile per prototipare l’aspetto della tua app in lingue diverse. Ricorda di aggiungere una chiave API Dev al tuo ambiente per abilitare questo comportamento.

In sviluppo potresti notare un ritardo durante le traduzioni on‑demand. Questo non accadrà nelle build di produzione, a meno che i contenuti non vengano esplicitamente tradotti on‑demand, ad esempio utilizzando tx o <Tx>.

Esempio

Uso di base

Puoi usare getGT per tradurre stringhe.

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

export default async function TranslateGreeting() {
  const t = await getGT();

  return (
    <p>
      {t('Ciao, Alice!')}
    </p>
  );
}

Nota: "Alice" verrà tradotta nella lingua preferita dell'utente.

Utilizzo delle variabili

Puoi passare variabili alle traduzioni del dizionario.

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

export default async function TranslateGreeting() {
  const t = await getGT();

  return (
    <p>
      {t('Ciao, {name}!', { name: 'Alice' })}
    </p>
  );
}

Nota: "Alice" non verrà tradotta nella lingua preferita dell'utente perché è una variabile.

Uso del formato di messaggi ICU

gt-next supporta il formato di messaggi ICU, che consente anche di formattare le variabili.

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

export default async function TranslateGreeting() {
  const t = await getGT();
  return (
    <p>
      {t('Ci sono {count, plural, =0 {nessun articolo} =1 {un articolo} other {{count} articoli}} nel carrello', { count: 10 })}
    </p>
  );
}

Note

• La funzione getGT è una funzione server-side che traduce stringhe.
• Le traduzioni con getGT avvengono prima dell’esecuzione, durante il processo di build (tranne che in ambiente di sviluppo).

Prossimi passaggi

• Consulta useGT per tradurre le stringhe lato client in fase di build.
• Per le traduzioni a runtime, consulta tx e <Tx>.