InlineTranslationOptions
Référence de l’API pour le type InlineTranslationOptions
Vue d’ensemble
Le type InlineTranslationOptions permet de passer des variables aux traductions inline et d’en définir le comportement de rendu.
Vous pouvez également ajouter du contexte et un identifiant à la traduction.
Il est utilisé avec useGT et msg pour passer des variables aux traductions de chaînes inline.
Traduction à la compilation : Les traductions useGT et msg
s’effectuent à la compilation ; en revanche, les variables ne sont jamais
traduites. Elles sont insérées dans la traduction avec le formatage approprié.
Veillez à suivre le guide de déploiement.
Références
Paramètres
Prop
Type
Description
| Prop | Description |
|---|---|
variables | Un objet dont les clés indiquent où chaque valeur est injectée dans la chaîne. |
$context | Vous pouvez inclure $context comme variable dans l’objet variables pour fournir du contexte pour le contenu (utilisé pour la traduction). |
$id | Vous pouvez inclure $id comme variable dans l’objet variables pour fournir un identifiant à utiliser avec l’éditeur de traduction. |
Exemples
Contexte
Pour ajouter du contexte à la chaîne, nous utilisons la prop $context.
import { useGT } from 'gt-react';
const Component = () => {
const t = useGT();
return (
<div>{t('Bonjour, monde !', { $context: 'une salutation formelle' })}</div>
);
};Passage de variables
Pour ajouter une variable à la chaîne, nous utilisons la syntaxe {variable-name}, où des accolades entourent le nom de la variable.
import { useGT } from 'gt-react';
const Component = () => {
const t = useGT();
return (
<div>
{t('Bonjour {username} ! Comment se passe ta journée ?', {
username: 'Brian123',
})}
</div>
);
};Utiliser le format de message ICU
gt-react prend en charge le format de message ICU, ce qui vous permet aussi de formater vos variables.
import { useGT } from 'gt-react';
const Component = () => {
const t = useGT();
return (
<div>
{t('Solde de votre compte : {dollars, number, ::currency/USD} !', {
dollars: 1000000,
})}
</div>
);
};Voir la documentation du format de message ICU pour en savoir plus sur le format de message ICU.
Notes
InlineTranslationOptionsest utilisé pour les traductions de chaînes inline.- L’objet
variablestransmet des valeurs au texte. - L’objet
variablesOptionsdéfinit le comportement des variables.
Prochaines étapes
- Consultez
useGTpour en savoir plus sur les traductions de chaînes en ligne. - Consultez le
format de message ICUpour en savoir plus sur les options de formatage.
Comment trouvez-vous ce guide ?