API JavaScript

Puoi anche usare il client Magic Translate direttamente nei tuoi script per tradurre stringhe e cambiare la lingua.

Ottenere l'istanza

Con il tag script, l'istanza viene creata una volta caricata la pagina ed è disponibile come window.magicTranslate. Per usarlo non appena è pronto, ascolta l'evento magictranslate:ready:

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

Con npm, createMagicTranslate restituisce l'istanza.

Tradurre in codice

Per tradurre una stringa, chiama translate. Restituisce una 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'
});

Senza l'opzione lang, il testo viene tradotto nella lingua corrente. Con un id, puoi modificare questo uso del testo da solo.

I valori che non devono essere tradotti vanno in v, indicato come $name. Il testo viene tradotto una volta come modello e memorizzato nella cache, indipendentemente dai valori:

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

La lingua attuale

Leggi la lingua corrente con magicTranslate.language. Usa setLanguage per cambiarlo e tradurre nuovamente la pagina, o onLanguageChange per eseguire una richiamata ogni volta che la lingua cambia:

magicTranslate.setLanguage('fr');

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

Fermarsi

destroy smette di tradurre la pagina. I contenuti già tradotti rimangono tradotti.

magicTranslate.destroy();