Paggamit ng React

@18ways/react ang nagbibigay sa iyo ng runtime primitives. Ang pangunahing gawain ay i-scope ang mga ito nang maayos.

Root mode laban sa scope mode

Sa pinakapundasyon, pagmamay-ari ng Ways ang API key, locale, tinatanggap na mga locale, at shared translation store.

Kailangan lang ng konteksto ang mga nested na saklaw ng Ways:

tsx
<Ways apiKey="pk_dummy_demo_token" locale="es-ES" baseLocale="en-GB" context="checkout">
  <Ways context="payment-form">
    <PaymentForm />
  </Ways>
</Ways>

Kung kailangan ng subtree ang sarili nitong locale session, bigyan ito ng sarili nitong root sa halip na umasa sa isang scoped locale override:

tsx
<Ways apiKey="pk_dummy_demo_token" locale="en-GB" baseLocale="en-GB" context="app">
  <MarketingSite />
 
  <Ways apiKey="pk_dummy_demo_token" locale="ja-JP" baseLocale="en-GB" context="hero-demo">
    <EmbeddedLocaleDemo />
  </Ways>
</Ways>

Ang nested root na iyon ay magkakaroon ng sarili nitong napiling locale, loading state, at hydrated store.

Estado ng paglo-load

Kung gusto mong ipakita ang gawaing pagsasalin sa UI, gamitin ang useTranslationLoading().

tsx
import { useTranslationLoading } from '@18ways/react';
 
function SavePanel() {
  const isTranslationLoading = useTranslationLoading();
 
  return <span>{isTranslationLoading ? 'Loading translations...' : 'Ready'}</span>;
}

useTranslationLoading() ay sumusubaybay lang sa blocking work para sa kasalukuyang context. Ang mga kontrol sa root-level tulad ng LanguageSwitcher ay binabasa na ang root runtime loading state para sa iyo.

Suspense

<T> at useT() ay nagti-throw papunta sa pinakamalapit na hangganan ng React o framework kapag may hindi pa tapos na read na hindi transition. Sa panahon ng totoong paglipat ng locale, patuloy nilang nirirender ang nakaraang naayos na locale sa pamamagitan ng store fallback sa halip na mag-suspend. Ang blocking work ay nililimitahan ng suspenseTimeoutMs, at pagkatapos noon ay magpapatuloy ang rendering gamit ang pinakamahusay na available na fallback habang ang paglo-load ng translation ay nagpapatuloy sa background.

Mga hook ng locale

Ang root runtime ay naglalantad ng dalawang low-level na hook:

tsx
import { useCurrentLocale, useSetCurrentLocale } from '@18ways/react';

Gamitin ang mga ito kapag gusto mong bumuo ng sarili mong mga control para sa locale sa halip na LanguageSwitcher.

LanguageSwitcher

Ang built-in na switcher ay kontrolado at composable.

tsx
<LanguageSwitcher currentLocale={locale} onLocaleChange={setLocale} direction="down" />

Binabasa nito ang tinatanggap na listahan ng locale mula sa root runtime at hinahawakan ang mga state ng paglo-load habang nire-resolve ang susunod na locale. Sa panahon ng paglipat ng locale, patuloy na ginagamit ng isinaling UI ang huling naayos na locale bilang fallback nito hanggang maging handa ang susunod na locale.

Komposisyon ng bahagi

Panatilihing magkakaugnay ang pangungusap at hayaang <T> mapanatili ang anyo ng UI.

tsx
<T>
  <a href="/pricing">Click here</a> to see more
</T>

Mga escape hatch ng pag-format ng mensahe

Ang default na formatter ay waysParser. Lumipat lamang mula rito kung mayroon kang konkretong dahilan.

  • messageFormatter="none" ay hinahayaang hindi nababago ang mga string.
  • pinapayagan ka ng isang custom na function ng formatter na ganap mong kontrolin ang interpolation.

Bihira dapat iyon.