Interfejs API JavaScript

Możesz także użyć klienta Magic Translate bezpośrednio w skryptach do tłumaczenia ciągów i zmiany języka.

Uzyskanie instancji

Za pomocą znacznika skryptu instancja jest tworzona po załadowaniu strony i jest dostępna jako window.magicTranslate. Aby go użyć, gdy tylko będzie gotowy, posłuchaj wydarzenia magictranslate:ready:

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

W przypadku npm createMagicTranslate zwraca instancję.

Tłumaczenie w kodzie

Aby przetłumaczyć ciąg znaków, zadzwoń translate. Zwraca obietnicę.

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

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

Bez opcji lang tekst jest tłumaczony na bieżący język. Za pomocą id możesz samodzielnie edytować to użycie tekstu.

Wartości, których nie należy tłumaczyć, wchodzą w v, określane jako $name. Tekst jest tłumaczony raz jako szablon i buforowany, niezależnie od wartości:

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

Obecny język

Przeczytaj bieżący język za pomocą magicTranslate.language. Użyj setLanguage, aby zmienić stronę i ponownie przetłumaczyć stronę, lub onLanguageChange, aby uruchomić wywołanie zwrotne za każdym razem, gdy zmienia się język:

magicTranslate.setLanguage('fr');

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

Zatrzymanie

destroy przestaje tłumaczyć stronę. Treści, które są już przetłumaczone, pozostają przetłumaczone.

magicTranslate.destroy();