Types

Opzioni di traduzione del dizionario

Riferimento API per il tipo DictionaryTranslationOptions

Panoramica

Il tipo DictionaryTranslationOptions viene utilizzato per passare variabili alle voci del dizionario e definirne il comportamento di rendering. Si usa con useTranslations e getTranslations per passare variabili alle voci del dizionario.

Traduzione in fase di build: Le variabili non vengono tradotte con useTranslations e getTranslations, ma solo la stringa originale. Consulta tx per tradurre stringhe con contenuto dinamico.

Riferimenti

Parametri

Prop

Type

Descrizione

PropDescrizione
variablesUn oggetto in cui le chiavi indicano a quale posizione viene assegnato ciascun valore nella voce del dizionario.

Esempi

Passaggio di variabili

Per passare una variabile a una voce del dizionario, dobbiamo fare due cose: (1) aggiungere una variabile alla voce e (2) fare riferimento a tale variabile nell’invocazione di d.

Per prima cosa, aggiungiamo una variabile alla voce del dizionario con la seguente sintassi: {username}. username è il nome della variabile.

dictionary.ts
const dictionary = {
  greeting: {
    hello: 'Ciao, {username}!',
  },
};

export default dictionary;

Successivamente, facciamo riferimento alla variabile:

Component.tsx
import { useTranslations } from 'gt-next';

const Component = () => {
  const d = useTranslations();
  return <div>{d('greeting.hello', { username : 'Brian123' })}</div>;
};

Uso del formato di messaggi ICU

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

dictionary.ts
const dictionary = {
  account: {
    balance: 'Saldo del tuo account: {dollars, number, ::currency/USD}!',
  },
};

export default dictionary;

Successivamente, facciamo riferimento alla variabile:

Component.tsx
import { useTranslations } from 'gt-next';

const Component = () => {
  const d = useTranslations();
  return <div>
    { d(
      'account.balance',
      {
        "dollars" : 1000000,
      }
    ) }
  </div>;
};

Note

  • L’oggetto variables passa valori a una voce del dizionario.
  • L’oggetto variablesOptions definisce il comportamento delle variabili.

Prossimi passi

Come valuti questa guida?

Opzioni di traduzione del dizionario