Types

Opzioni di traduzione in runtime

Riferimento API per il tipo RuntimeTranslationOptions

Panoramica

Il tipo RuntimeTranslationOptions viene utilizzato per passare variabili alle traduzioni inline e definirne il comportamento di rendering. Puoi anche aggiungere una locale per specificare una lingua diversa per la traduzione. Questo si usa con la funzione tx.

Traduzione a runtime: Per tradurre una variabile su richiesta, includila direttamente nella stringa passata a tx. Le variabili passate a tx tramite l'oggetto options non vengono tradotte.

Riferimenti

Parametri

Prop

Type

Descrizione

PropDescrizione
variablesUn oggetto in cui le chiavi indicano a quale punto della stringa viene assegnato ciascun valore.
$localePuoi includere $locale come variabile nell'oggetto variables per specificare la lingua/locale della traduzione. In mancanza, verrà utilizzata la lingua/locale preferita del browser tra quelle supportate dalla tua app.

Esempi

Passaggio di variabili

Per aggiungere una variabile alla stringa, utilizziamo la sintassi {variable-name}, in cui le parentesi graffe racchiudono il nome della variabile.

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

const Component = () => {
  return <div>
    {tx(`Ciao, {username}!`,{ username: 'Brian123' })}
  </div>;
};

Uso del formato di messaggi ICU

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

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

const Component = () => {
  return <div>
    { tx(
      'Saldo del conto: {dollars, number, ::currency/USD}!',
      {
        "dollars" : 1000000,
      }
    ) }
  </div>;
};

Traduzione delle variabili

Per tradurre una variabile, includila direttamente nella stringa passata a tx.

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

const Component = ({ hairColor }: { hairColor: string }) => {
  return <div>{tx(
    `Ciao, {username}! Il colore dei tuoi capelli è ${hairColor}`,
    { username: 'Brian123' }
  )}</div>;
};

Nota che la variabile hairColor viene tradotta, mentre username no.

Specificare una lingua/locale

Puoi specificare la lingua/locale da usare per la traduzione.

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

const Component = () => {
  return <div>{tx('Ciao, mondo!', { $locale: 'fr' })}</div>;
};

Questo verrà sempre tradotto in francese.


Note

  • RuntimeTranslationOptions viene utilizzato per le traduzioni di stringhe a runtime.
  • L'oggetto variables passa i valori al testo.
  • L'oggetto variablesOptions definisce il comportamento delle variabili.

Prossimi passaggi

  • Vedi tx per ulteriori informazioni sulle traduzioni di stringhe inline.
  • Vedi il formato dei messaggi ICU per ulteriori informazioni sulle opzioni di formattazione.

Come valuti questa guida?

Opzioni di traduzione in runtime