Sanggunian sa Vanilla JS
create18waysEngine(options)
Mag-import mula sa @18ways/core/engine.
import { create18waysEngine } from '@18ways/core/engine';Karaniwang mga opsyon:
| Opsyon | Uri | Mga Tala |
|---|---|---|
apiKey | string | Kinakailangan. |
baseLocale | string | Pinagmulan ng lokalidad. |
lokalidad | string | Kasalukuyang target na locale. |
konteksto | string | object | Default na susi ng konteksto. |
initialTranslations | Translations | Opsyonal na panimulang cache. |
apiUrl | string | Opsyonal na override ng base ng API. |
fetcher | typeof fetch | Pasadyang implementasyon ng pagkuha. |
cacheTtlSeconds | numero | TTL ng request cache. |
origin | string | Naipasa ang pinagmulan sa mga kahilingang ipinasa sa server side. |
Mga pamamaraan ng makina
t(text, options?)
Isalin ang isang string at ibalik ang nalutas na halaga.
setLocale(locale)
Palitan ang target na locale.
getLocale()
Basahin ang kasalukuyang target na locale.
getStore()
I-access ang pinagbabatayang imbakan ng pagsasalin.
TranslationStore
Ibinubunyag ng engine.getStore() ang mas mababang-level na runtime state machine. Ang store ang may-ari ng locale state,
config, hydrated translations, naaalalang source strings, at blocking loading state.
Mga karaniwang paraan:
| Paraan | Mga Tala |
|---|---|
getState() | Basahin ang kasalukuyang napiling locale, settled locale, config, at naka-cache na translations. |
hydrate(input) | Pagsamahin ang mga translation at config sa store. Kapaki-pakinabang para sa SSR o custom bootstrapping. |
dehydrate() | I-snapshot ang store bilang hydration payload na madaling i-merge. |
loadConfig() | Kunín ang tinatanggap na mga locale at fallback config nang minsanan, saka i-cache ang resulta. |
setLocale(locale) | Simulan ang paglipat ng locale sa loob ng store. |
getTranslationSync(input) | Sabay na pag-read na nagbabalik ng handa nang value o isang nakabinbing read na may fallback value. |
getTranslation(input) | Async na pag-read ng translation na nagre-resolve sa panghuling naisaling string. |
isLoading(input?) | Nagbabalik ng true kapag may nakabinbing blocking translation work pa, sa buong app o para sa isang context. |
waitForIdle(input?) | Nagre-resolve kapag naayos na ang blocking translation work. Mag-pass ng timeoutMs para tumigil sa paghihintay pagkalipas ng takdang oras habang ang paglo-load ay nagpapatuloy sa background. |
getIdleState(input?) | Nagbabalik ng timed wait state na pag-aari ng store at ginagamit ng mga renderer: {timedOut, promise}. |
mount(entry) / unmount(entry) | Opsyonal na pagsubaybay sa mount para sa mga integrasyon na nagpapagana ng garbage collection na aware sa mount. |
Kung direktang gumagamit ka ng @18ways/core, karaniwan ay mananatili ka sa antas ng engine.t(...). Lumapit sa
store kapag gumagawa ka ng sarili mong rendering runtime o hydration layer.
mga option ng t()
| Opsyon | Uri | Mga Tala |
|---|---|---|
lokalidad | string | I-override ang target na locale para sa tawag na ito. |
baseLocale | string | I-override ang base locale para sa tawag na ito. |
konteksto | string | object | I-override ang context para sa tawag na ito. |
vars | Record<string, unknown> | Variable na input para sa waysParser. |
Utility exports
Ini-export din ng core package ang mga lower-level helper gaya ng:
fetchAcceptedLocalesfetchConfig- mga utility para sa locale
Gamitin mo ang mga iyon kapag kailangan mo ang mga ito, pero ang engine ang dapat na default na panimulang punto.