JavaScript API

Anda juga dapat menggunakan klien Magic Translate langsung di skrip Anda untuk menerjemahkan string dan mengubah bahasa.

Mendapatkan contoh

Dengan tag skrip, instance dibuat setelah halaman dimuat dan tersedia sebagai window.magicTranslate. Untuk menggunakannya segera setelah siap, dengarkan acara magictranslate:ready:

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

Dengan npm, createMagicTranslate mengembalikan instance.

Menerjemahkan dalam kode

Untuk menerjemahkan string, panggil translate. Ia mengembalikan sebuah janji.

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

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

Tanpa opsi lang, teks diterjemahkan ke dalam bahasa saat ini. Dengan id, Anda dapat mengedit penggunaan teks ini sendiri.

Nilai yang tidak boleh diterjemahkan masuk ke v, dirujuk sebagai $name. Teks diterjemahkan sekali sebagai template dan di-cache, apa pun nilainya:

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

Bahasa saat ini

Baca bahasa saat ini dengan magicTranslate.language. Gunakan setLanguage untuk mengubahnya dan menerjemahkan halaman lagi, atau onLanguageChange untuk menjalankan panggilan balik setiap kali bahasa berubah:

magicTranslate.setLanguage('fr');

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

Berhenti

destroy berhenti menerjemahkan halaman. Konten yang sudah diterjemahkan tetap diterjemahkan.

magicTranslate.destroy();