Paggamit ng Vanilla JS

Ang core engine ang nagbibigay sa inyo ng runtime na pag-uugali. Ang iyong app ang magpapasya kung paano ito ipapakita.

Konteksto bawat area

Magtakda ng default na context sa engine, pagkatapos ay i-override ito para sa mga partikular na tawag kapag kinakailangan.

ts
const engine = create18waysEngine({
  apiKey: 'pk_dummy_demo_token',
  baseLocale: 'en-GB',
  locale: 'fr-FR',
  context: 'app',
});
 
const payNow = await engine.t('Pay now', {
  context: 'checkout.button',
});

Gumagana ang mga variable sa parehong paraan

ts
const line = await engine.t('Hello {name}', {
  vars: { name: 'Ada' },
});

Gumagana rin dito ang kaparehong syntax ng waysParser na ginagamit sa React.

Pag-uugali ng cache

Pinananatili ng engine ang isang translation store sa memorya.

Ibig sabihin:

  • ang unang request para sa isang bagong string o locale ay maaaring mag-hit sa API
  • maihahatid mula sa imbakan ang mga susunod na kahilingan
  • mura ang paglipat pabalik sa dating locale kung naka-cache na ang mga salin

Magdala ng sarili mong mga kontrol sa lokalisasyon

Sa Vanilla JS, tahasang ginagawa ang pagpapalit ng locale.

ts
async function setLocale(locale) {
  engine.setLocale(locale);
  await render();
}

Mas akma iyon kaysa magkunwaring ang core package ang may-ari ng routing o React state.

Kailan dapat manatili sa pangunahing pakete

Manatili ka rito kung gusto mo ng pinakamataas na kontrol.

Lumipat sa React o Next packages kapag gusto mo:

  • Mga pangunahing elemento ng pagsasalin ng JSX
  • mga built-in na hook ng locale
  • routing at metadata na pinamamahalaan ng adapter
Changing language
Vanilla JS Usage