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.

ts
const engine = create18waysEngine({
  apiKey: 'YOUR_18WAYS_PUBLIC_API_KEY',
  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

ts
const line = await engine.t('Hello {name}', {
  vars: { name: 'Ada' },
});

La même syntaxe waysParser 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.

ts
async function setLocale(locale) {
  engine.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