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:
<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:
<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().
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:
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.
<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.
<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.