API JavaScript

Você também pode usar o cliente Magic Translate diretamente em seus scripts para traduzir textos e alterar o idioma.

Obtendo a instância

Com a tag de script, a instância é criada quando a página é carregada e está disponível como window.magicTranslate. Para usá-lo assim que estiver pronto, ouça o evento magictranslate:ready:

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

Com o npm, createMagicTranslate retorna a instância.

Traduzindo em código

Para traduzir uma string, chame translate. Ele retorna uma promessa.

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

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

Sem a opção lang, o texto é traduzido para o idioma atual. Com um id, você pode editar esse uso do texto sozinho.

Os valores que não devem ser traduzidos estão em v, referenciados como $name. O texto é traduzido uma vez como modelo e armazenado em cache, quaisquer que sejam os valores:

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

O idioma atual

Leia o idioma atual com magicTranslate.language. Use setLanguage para alterá-la e traduzir a página novamente ou onLanguageChange para executar um retorno de chamada sempre que o idioma mudar:

magicTranslate.setLanguage('fr');

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

Parando

destroy interrompe a tradução da página. O conteúdo que já está traduzido permanece traduzido.

magicTranslate.destroy();