자바스크립트 API

스크립트에서 Magic Translate 클라이언트를 직접 사용하여 문자열을 번역하고 언어를 변경할 수도 있어.

인스턴스 가져오는 중

스크립트 태그를 사용하면 페이지가 로드되면 인스턴스가 생성되고 window.magicTranslate 형식으로 사용 가능해.준비되자마자 사용하려면 magictranslate:ready 이벤트를 들어봐.

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

npm이면 createMagicTranslate 인스턴스를 반환해.

코드로 번역하기

문자열 번역하려면 translate 전화해.약속을 돌려줘.

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 옵션 없으면 텍스트가 현재 언어로 번역돼.id 사용하면 이 텍스트 사용을 자체적으로 편집할 수 있어.

번역하면 안 되는 값은 v, 참조는 $name.값이 무엇이든 텍스트는 템플릿으로 한 번 번역되고 캐시돼.

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

현재 언어.

magicTranslate.language 으로 현재 언어를 읽어.변경하고 페이지를 다시 번역하려면 setLanguage, 언어가 바뀔 때마다 콜백을 실행하려면 onLanguageChange 써.

magicTranslate.setLanguage('fr');

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

멈추는 중야

destroy 페이지 번역 멈춰.이미 번역된 콘텐츠는 계속 번역되어 있어.

magicTranslate.destroy();