Types

OptionsDeTraductionÀL’Exécution

Référence de l’API pour le type RuntimeTranslationOptions

Présentation

Le type RuntimeTranslationOptions sert à transmettre des variables aux traductions inline et à définir leur mode de rendu. Vous pouvez également ajouter une locale pour imposer une autre langue pour la traduction. Cela s’utilise avec la fonction tx.

Traduction à l’exécution : Pour traduire une variable à la demande, incluez-la directement dans la chaîne transmise à tx. Les variables passées à tx via l’objet options ne sont pas traduites.

Références

Paramètres

Prop

Type

Description

PropDescription
variablesUn objet dont les clés indiquent où chaque valeur est insérée dans la chaîne.
$localeVous pouvez inclure $locale comme variable dans l’objet variables pour spécifier une locale pour la traduction. Par défaut, la locale la plus préférée du navigateur prise en charge par votre application sera utilisée.

Exemples

Transmission de variables

Pour ajouter une variable à la chaîne, utilisez la syntaxe {variable-name}, où des accolades entourent le nom de la variable.

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

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

Utilisation du format de message ICU

gt-next prend en charge le format de message ICU, ce qui vous permet également de formater vos variables.

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

const Component = () => {
  return <div>
    { tx(
      'Solde de votre compte : {dollars, number, ::currency/USD} !',
      {
        "dollars" : 1000000,
      }
    ) }
  </div>;
};

Traduction des variables

Pour traduire une variable, insérez-la directement dans la chaîne passée à tx.

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

const Component = ({ hairColor }: { hairColor: string }) => {
  return <div>{tx(
    `Bonjour {username} ! Votre couleur de cheveux est ${hairColor}`,
    { username: 'Brian123' }
  )}</div>;
};

Notez que la variable hairColor est traduite, mais pas username.

Définir une locale

Vous pouvez définir une locale à utiliser pour la traduction.

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

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

Ce sera toujours traduit en français.


Notes

  • RuntimeTranslationOptions est utilisé pour traduire des chaînes au moment de l’exécution.
  • L’objet variables transmet des valeurs au texte.
  • L’objet variablesOptions définit le comportement des variables.

Prochaines étapes

  • Consultez tx pour en savoir plus sur les traductions de chaînes en ligne.
  • Consultez le format de message ICU pour en savoir plus sur les options de formatage.

Que pensez-vous de ce guide ?

OptionsDeTraductionÀL’Exécution