Panoramica

La funzione tx è una funzione lato server per la traduzione delle stringhe.

await tx('Hello, world!'); // restituisce 'Hola, mundo!'

Riferimenti

Parametri

Restituisce

Una promise che viene risolta con una stringa contenente il contenuto tradotto, oppure con il contenuto originale se non è necessaria alcuna traduzione.

Comportamento

La funzione tx traduce le stringhe a runtime. Ciò significa che le traduzioni avvengono in tempo reale, permettendoti di tradurre contenuti disponibili solo a runtime. Lo svantaggio è un ritardo, perché il caricamento di una traduzione on‑demand è sensibilmente più lento.

Il nostro consiglio è di tradurre il più possibile in fase di build utilizzando getGT, useGT o <T>, e ricorrere alle traduzioni on‑demand, come tx e <Tx>, solo quando necessario.

Assicurati di seguire la guida al deployment.

Esempio

Utilizzo di base

Puoi usare tx per tradurre le stringhe.

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

export default async function translateGreeting() {
    return await tx("Ciao, mondo!"); 
}

Aggiunta del contesto

Puoi personalizzare la traduzione fornendo un contesto da tenere in considerazione durante la traduzione.

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

export default async function TranslateWithOptions() {
    return await tx("Ciao mondo!", {
      $context: 'Traduci in modo informale'
    });
}

Uso delle variabili

Per passare valori alla stringa, devi (1) assegnare un identificatore e (2) fare riferimento a tale identificatore nell’oggetto passato.

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

export default async function translateWithVariables() {
  return await tx("Il costo è {price, number, ::currency/USD}", {
    price: 29.99,
  });
}

Specificare una locale

Puoi specificare una locale da utilizzare per la traduzione. Per impostazione predefinita, la locale corrisponde alla lingua preferita dell’utente.

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

export default async function translateWithLocale() {
    return await tx("Bonjour, le monde !", { $locale: 'fr' }); 
}

Note

• tx è esclusivamente per l’uso lato server e non può essere utilizzato nei componenti lato client.
• Le traduzioni con tx avvengono a runtime, quindi sono eseguite in tempo reale. Questo è sensibilmente più lento rispetto alle traduzioni effettuate in fase di build.

Prossimi passi

• Consulta useGT e getGT per tradurre le stringhe prima della distribuzione.
• Per tradurre JSX, vedi <T> e <Tx>.
• Vedi RuntimeTranslationOptions per maggiori dettagli sulla personalizzazione delle traduzioni.