JavaScript API'si

Dizeleri çevirmek ve dili değiştirmek için Magic Translate istemcisini doğrudan komut dosyalarınızda da kullanabilirsiniz.

Örneği alma

Komut dosyası etiket i ile, sayfa yüklendikten sonra örnek oluşturulur ve window.magicTranslate olarak kullanılabilir. Hazır olur olmaz kullanmak için magictranslate:ready etkinliğini dinleyin:

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

npm ile createMagicTranslate örneği döndürür.

Kodda çeviri

Bir dizeyi çevirmek için translate öğesini arayın. Bir söz verir.

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

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

lang seçeneği olmadan metin geçerli dile çevrilir. id ile metnin bu kullanımını kendi başınıza düzenleyebilirsiniz.

Çevrilmemesi gereken değerler v olarak belirtilir ve $name olarak atıfta bulunulur. Metin bir kez şablon olarak çevrilir ve değerler ne olursa olsun önbelleğe alınır:

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

Mevcut dil

Mevcut dili magicTranslate.language ile okuyun. Değiştirmek ve sayfayı tekrar çevirmek için setLanguage öğesini veya dil değiştiğinde geri arama yapmak için onLanguageChange öğesini kullanın:

magicTranslate.setLanguage('fr');

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

Durdurmak

destroy sayfayı çevirmeyi durdurur. Halihazırda çevrilmiş olan içerik çevrilmiş kalır.

magicTranslate.destroy();