Paggamit ng Vanilla JS

Ang core engine ang nagbibigay sa iyo ng runtime na pag-uugali. Ang app mo ang nagdedesisyon kung paano ito ipapakita.

Kontexto bawat lugar

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 parehong syntax ng waysParser na ginagamit sa React.

Pag-uugali ng cache

Ang engine ay nag-iingat ng translation store sa memorya.

Ibig sabihin:

  • ang unang kahilingan para sa isang bagong string o locale ay maaaring tumama sa API
  • ang mga susunod na kahilingan ay maaaring ihain mula sa imbakan
  • mura ang pagbabalik sa nakaraang locale kung naka-cache na ang mga salin

Dalhin ang sarili mong mga kontrol sa locale

Sa Vanilla JS, tahasan 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 core package

Manatili ka rito kung gusto mo ng maximum na kontrol.

Lumipat na sa mga React o Next package kapag gusto mo na:

  • Mga pangunahing primitive ng pagsasalin ng JSX
  • mga built-in na locale hook
  • ruting at metadata na pinamamahalaan ng adapter