Verwendung von Vanilla JS

Der Kern-Engine gibt Ihnen das Laufzeitverhalten. Ihre App entscheidet, wie es präsentiert wird.

Kontext pro Bereich

Setzen Sie einen Standardkontext für die Engine und überschreiben Sie ihn bei Bedarf für spezifische Aufrufe.

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',
});

Variablen funktionieren auf die gleiche Weise

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

Die gleiche waysParser Syntax, die in React verwendet wird, funktioniert auch hier.

Cache-Verhalten

Die Engine hält einen Übersetzungsspeicher im Arbeitsspeicher.

Das bedeutet:

  • Die erste Anfrage nach einem neuen String oder einer neuen Locale kann die API erreichen.
  • spätere Anfragen können aus dem Speicher bedient werden
  • Das Zurückwechseln zu einer vorherigen Spracheinstellung ist kostengünstig, wenn die Übersetzungen bereits im Cache gespeichert sind.

Bringen Sie Ihre eigenen Standortsteuerungen mit

In Vanilla JS ist das Wechseln der Locale explizit.

ts
async function setLocale(locale) {
  engine.setLocale(locale);
  await render();
}

Das ist eine bessere Lösung, als vorzugeben, dass das Kernpaket das Routing oder den React-Zustand verwaltet.

Wann man im Kernpaket bleiben sollte

Bleiben Sie hier, wenn Sie maximale Kontrolle wünschen.

Wechseln Sie zu den React- oder Next-Paketen, wenn Sie möchten:

  • JSX-Übersetzungsprimitive
  • eingebaute Locale-Hooks
  • adaptergesteuertes Routing und Metadaten