Types

Opzioni di traduzione inline

Riferimento API per il tipo InlineTranslationOptions

Panoramica

Il tipo InlineTranslationOptions viene usato per passare variabili alle traduzioni inline e per definirne il comportamento di rendering. Puoi anche aggiungere un contesto e un identificatore alla traduzione. Si usa con useGT, getGT e msg per passare variabili alle traduzioni inline delle stringhe.

Traduzione in fase di build: Con useGT, getGT e msg vengono tradotte solo le stringhe originali, non le variabili. Vedi tx per tradurre stringhe con contenuto dinamico.

Riferimenti

Parametri

Prop

Type

Descrizione

PropDescrizione
variablesUn oggetto in cui le chiavi indicano a cosa viene associato ciascun valore nella stringa.
$contextFacoltativamente, includi $context come variabile nell'oggetto variables per fornire contesto al contenuto (usato per la traduzione).
$idFacoltativamente, includi $id come variabile nell'oggetto variables per fornire un identificatore da usare con l'editor di traduzione.

Esempi

Contesto

Per aggiungere contesto alla stringa, utilizziamo la prop $context.

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

const Component = () => {
  const t = useGT();
  return <div>{t('Hello, world!', { $context: 'saluto formale' })}</div>;
};

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 { useGT } from 'gt-next';

const Component = () => {
  const t = useGT();
  return <div>{t('Ciao, {username}! Com’è la tua giornata?', { username: 'Brian123' })}</div>;
};

Utilizzo del formato di messaggio ICU

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

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

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

Consulta la documentazione del formato di messaggistica ICU per ulteriori informazioni sul formato di messaggistica ICU.


Note

  • InlineTranslationOptions viene usato per le traduzioni di stringhe inline.
  • L'oggetto variables passa i valori al testo.
  • L'oggetto variablesOptions definisce il comportamento delle variabili.

Prossimi passaggi

  • Consulta useGT e getGT per ulteriori informazioni sulle traduzioni di stringhe inline.
  • Consulta il formato dei messaggi ICU per ulteriori informazioni sulle opzioni di formattazione.

Come valuti questa guida?

Opzioni di traduzione inline