Utilisation de Vanilla JS
Le moteur central vous fournit le comportement d'exécution. Votre application décide comment le présenter.
Contexte par zone
Définissez un contexte par défaut sur le moteur, puis remplacez-le pour des appels spécifiques si nécessaire.
const moteur = create18waysEngine({
apiKey: 'VOTRE_CLE_API_PUBLIQUE_18WAYS',
baseLocale: 'en-GB',
locale: 'fr-FR',
context: 'app',
});
const payNow = await engine.t('Pay now', {
context: 'checkout.button',
});Les variables fonctionnent de la même manière
const ligne = await moteur.t('Bonjour {name}', {
vars: { name:'Ada' },
});Le même waysParser la syntaxe utilisée dans React fonctionne ici aussi.
Comportement du cache
Le moteur garde un magasin de traductions en mémoire.
Cela signifie :
- la première demande pour une nouvelle chaîne ou un nouveau paramètre régional peut atteindre l'API
- les demandes ultérieures peuvent être servies depuis le magasin
- revenir à une locale précédente est peu coûteux si les traductions sont déjà mises en cache
Apportez vos propres contrôles de localisation
Dans Vanilla JS, le changement de locale est explicite.
async fonction setLocale(locale) {
moteur.setLocale(locale);
await render();
}C'est un meilleur ajustement que de prétendre que le package principal gère le routage ou l'état de React.
Quand rester dans le package principal
Restez ici si vous voulez un contrôle maximal.
Passez aux packages React ou Next quand vous le souhaitez :
- Primitives de traduction JSX
- hooks de locale intégrés
- routage et métadonnées gérés par l'adaptateur