香草 JS 參考

create18waysEngine(options)

從 @18ways/core/engine 匯入。

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

常見選項：

選項類型備註
apiKey字串必填。
baseLocale字串來源語言。
區域設定字串當前目標語言環境。
上下文字串 | 物件預設上下文鍵。
初始翻譯翻譯可選的起始快取。
apiUrl字串可選的 API 基本覆蓋。
fetchertypeof fetch自訂的擷取實作。
cacheTtlSeconds數字請求快取的 TTL。
來源字串來源已在伺服器端請求中轉發。

引擎方法

t(text, options?)

翻譯一個字串並返回解析後的值。

setLocale(locale)

更改目標語言環境。

getLocale()

閱讀當前目標語言環境。

getStore()

訪問底層翻譯存儲。

t() options

選項類型備註
區域設定字串覆蓋此呼叫的目標區域設定。
baseLocale字串覆蓋此呼叫的基本區域設置。
上下文字串 | 物件覆蓋此呼叫的上下文。
變數Record<string, unknown>waysParser 的變數輸入。

Utility exports

核心套件還匯出較低層級的輔助工具，例如：

  • fetchAcceptedLocales
  • fetchConfig
  • 區域設置工具
  • 翻譯商店工具

在需要時使用它們，但引擎應該是默認的起始點。