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 per passare variabili alle voci del dizionario.

Traduzione in fase di build: Le traduzioni di useTranslations avvengono in fase di build; tuttavia, le variabili non vengono mai tradotte. Vengono invece inserite nella traduzione con relativa formattazione. Assicurati di seguire la guida alla distribuzione.

Riferimenti

Parametri

Prop

Type

Descrizione

PropDescrizione
variablesOggetto in cui le chiavi indicano a quale posizione viene associato ciascun valore nella voce di dizionario.

Esempi

Passare 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-react';

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

Uso del formato di messaggi ICU

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

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

export default dictionary;

Successivamente, richiamiamo la variabile:

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

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

Note

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

Prossimi passi

  • Consulta dictionaries per ulteriori informazioni sui dizionari e sulle pratiche comuni.
  • Consulta useTranslations per ulteriori informazioni sull'interfaccia dei dizionari.
  • Consulta il formato dei messaggi ICU per ulteriori informazioni sulle opzioni di formattazione.

Come valuti questa guida?

Opzioni di traduzione del dizionario