Types

OpzioniTraduzioneInLinea

Riferimento API per il tipo InlineTranslationOptions

Panoramica

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

Traduzione in fase di build: Le traduzioni con useGT e msg avvengono in fase di build; tuttavia, le variabili non vengono mai tradotte. Vengono invece inserite nella traduzione con la relativa formattazione. Assicurati di seguire la guida al deployment.

Riferimenti

Parametri

Prop

Type

Descrizione

PropDescrizione
variablesUn oggetto in cui le chiavi indicano a quale punto della stringa viene assegnato ciascun valore.
$contextIncludi facoltativamente $context come variabile nell'oggetto variables per fornire contesto al contenuto (usato per la traduzione).
$idIncludi facoltativamente $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-react';

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

Passaggio di variabili

Per aggiungere una variabile alla stringa, utilizziamo la sintassi {variable-name}, dove il nome della variabile è racchiuso tra parentesi graffe.

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

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

Uso del formato di messaggi ICU

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

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

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

Consulta la documentazione sul formato dei messaggi ICU per ulteriori informazioni sul formato dei messaggi ICU.


Note

  • InlineTranslationOptions viene usato per tradurre stringhe inline.
  • L’oggetto variables passa i valori al testo.
  • L’oggetto variablesOptions definisce il comportamento delle variabili.

Prossimi passi

  • Consulta useGT per ulteriori informazioni sulle traduzioni in linea delle stringhe.
  • Consulta il formato dei messaggi ICU per ulteriori informazioni sulle opzioni di formattazione.

Come valuti questa guida?

OpzioniTraduzioneInLinea