JavaScript-API

Du kannst den Magic Translate-Client auch direkt in deinen Skripten verwenden, um Zeichenketten zu übersetzen und die Sprache zu ändern.

Die Instanz abrufen

Mit dem Script-Tag wird die Instanz erstellt, sobald die Seite geladen wurde, und ist als window.magicTranslate verfügbar. Um es zu verwenden, sobald es fertig ist, hör dir das magictranslate:ready-Event an:

document.addEventListener('magictranslate:ready', (event) => {
  const magicTranslate = event.detail;
});

Mit npm gibt createMagicTranslate die Instanz zurück.

Im Code übersetzen

Um eine Zeichenfolge zu übersetzen, rufe translate an. Es gibt ein Versprechen zurück.

const message = await magicTranslate.translate('Your order has been placed');

// with options
const formal = await magicTranslate.translate('How are you?', {
  lang: 'fr',
  formality: 'formal'
});

Ohne die Option lang wird der Text in die aktuelle Sprache übersetzt. Mit einem id kannst du diese Verwendung des Textes eigenständig bearbeiten.

Werte, die nicht übersetzt werden sollten, gehen in v, referenziert als $name. Der Text wird einmal als Vorlage übersetzt und zwischengespeichert, unabhängig von den Werten:

const message = await magicTranslate.translate('Your order $id has shipped', {
  v: { id: order.id }
});

Die aktuelle Sprache

Lies die aktuelle Sprache mit magicTranslate.language. Benutze setLanguage, um es zu ändern und die Seite erneut zu übersetzen, oder onLanguageChange, um einen Rückruf zu starten, wenn sich die Sprache ändert:

magicTranslate.setLanguage('fr');

const unsubscribe = magicTranslate.onLanguageChange((language) => {
  document.documentElement.lang = language;
});

Stoppen

destroy beendet die Übersetzung der Seite. Inhalte, die bereits übersetzt wurden, bleiben übersetzt.

magicTranslate.destroy();