Sanggunian sa Vanilla JS

create18waysEngine(options)

Mag-import mula sa @18ways/core/engine.

ts
import { create18waysEngine } from '@18ways/core/engine';

Karaniwang mga opsyon:

OpsyonUriMga Tala
apiKeystringKinakailangan.
baseLocalestringPinagmulan ng lokalidad.
lokalidadstringKasalukuyang target na locale.
kontekstostring | objectDefault na susi ng konteksto.
initialTranslationsTranslationsOpsyonal na panimulang cache.
apiUrlstringOpsyonal na override ng base ng API.
fetchertypeof fetchPasadyang implementasyon ng pagkuha.
cacheTtlSecondsnumeroTTL ng request cache.
originstringNaipasa 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:

ParaanMga 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()

OpsyonUriMga Tala
lokalidadstringI-override ang target na locale para sa tawag na ito.
baseLocalestringI-override ang base locale para sa tawag na ito.
kontekstostring | objectI-override ang context para sa tawag na ito.
varsRecord<string, unknown>Variable na input para sa waysParser.

Utility exports

Ini-export din ng core package ang mga lower-level helper gaya ng:

  • fetchAcceptedLocales
  • fetchConfig
  • 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.