API JavaScript

Bạn cũng có thể sử dụng ứng dụng Magic Translate trực tiếp trong tập lệnh của mình để dịch chuỗi và thay đổi ngôn ngữ.

Lấy phiên bản

Với thẻ script, phiên bản được tạo khi trang đã tải và có sẵn dưới dạng window.magicTranslate. Để sử dụng nó ngay khi nó đã sẵn sàng, hãy lắng nghe sự kiện magictranslate:ready:

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

Với npm, createMagicTranslate trả về phiên bản.

Dịch bằng mã

Để dịch một chuỗi, hãy gọi translate. Nó trả lại một lời hứa.

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

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

Nếu không có tùy chọn lang, văn bản được dịch sang ngôn ngữ hiện tại. Với id, bạn có thể tự chỉnh sửa cách sử dụng văn bản này.

Các giá trị không nên dịch sẽ nằm trong v, được tham chiếu là $name. Văn bản được dịch một lần dưới dạng mẫu và được lưu trong bộ nhớ cache, bất kể giá trị là gì:

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

Ngôn ngữ hiện tại

Đọc ngôn ngữ hiện tại với magicTranslate.language. Sử dụng setLanguage để thay đổi và dịch lại trang hoặc onLanguageChange để chạy callback bất cứ khi nào ngôn ngữ thay đổi:

magicTranslate.setLanguage('fr');

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

Dừng lại

destroy ngừng dịch trang. Nội dung đã được dịch vẫn được dịch.

magicTranslate.destroy();