Tài liệu: Hàm getIntlayerAsync trong intlayer

Mô tả

Hàm getIntlayerAsync chọn một từ điển theo khóa của nó và giải quyết nội dung của nó cho một locale nhất định, chỉ tải locale đó.

Nó là phiên bản không đồng bộ của getIntlayer, được sử dụng cho các trường hợp từ điển được đọc bên ngoài quá trình render — route head / metadata builders, loaders, server functions.

Nếu như getIntlayer kéo trong từ điển đã hợp nhất chứa mọi locale, các build plugins (@intlayer/babel, @intlayer/swc) sẽ viết lại cuộc gọi này thành getDictionaryAsync(loaderMap, key, locale), chỉ vào các chunks theo locale trong .intlayer/dynamic_dictionaries/. Bundle do đó chỉ bao giờ cũng mang lại locale thực sự được yêu cầu.

Nếu không có các plugins này — một build chưa được tối ưu hóa — cuộc gọi sẽ được giải quyết thông qua registry từ điển đồng bộ thay thế: cùng nội dung, nhưng không có sự phân chia theo locale.

Các tính năng chính:

• Các khóa, selector và nội dung được trả về giống như getIntlayer
• Chỉ tải chunk locale được yêu cầu trong các build được tối ưu hóa
• Các cuộc gọi đồng thời cho cùng một chunk chia sẻ một lần tải
• An toàn để sử dụng trong async metadata builders, loaders và server functions

Function Signature

getIntlayerAsync(
  key: DictionaryKeys,                        // Bắt buộc
  localeOrSelector?: LocalesValues | DictionarySelector, // Tùy chọn
  plugins?: Plugins[]                         // Tùy chọn
): Promise<DeepTransformContent<...>>

Tham số

• key: DictionaryKeys

  • Description: Khóa của từ điển cần đọc, như được khai báo trong các tệp nội dung của bạn.
  • Type: DictionaryKeys — một union của mọi khóa từ điển được khai báo.
  • Required: Yes

• localeOrSelector: LocalesValues | DictionarySelector

  • Description: Locale để giải thích nội dung với, hoặc một đối tượng selector cho dynamic dictionaries.
    • 'fr' — một locale
    • { item: 2 } — một mục collection (bỏ qua item để lấy mọi mục dưới dạng mảng)
    • { variant: 'black-friday' } — một variant có tên (bỏ qua để lấy default)
    • { variant: { id: 'prod_abc', userId: '123' } } — một variant có cấu trúc
    • Bất kỳ selector nào cũng có thể mang theo một locale: { item: 2, locale: 'fr' }
  • Type: LocalesValues | DictionarySelector
  • Required: No (Optional) — mặc định là defaultLocale được cấu hình.

• plugins: Plugins[]

  • Description: Các node transformers tùy chỉnh thay thế các plugin interpreter cơ bản. Chỉ sử dụng nâng cao.
  • Type: Plugins[]
  • Required: No (Optional)

Returns

• Type: Promise<Content> — a promise resolving to the interpreted content of the dictionary, typed from your declaration.

Ví dụ Sử dụng

Cách sử dụng cơ bản

import { getIntlayerAsync } from "intlayer";

const { title } = await getIntlayerAsync("app", "fr"); // "Bonjour"

getIntlayer vs getIntlayerAsync

Cả hai chấp nhận các đối số giống nhau và trả về nội dung giống nhau: chuyển đổi từ cái này sang cái khác chỉ thay đổi khi và bao nhiêu được tải.

Các Hàm Liên Quan

• getIntlayer: Tương đương đồng bộ đọc từ điển đã hợp nhất.
• getDictionaryAsync: Hàm cấp thấp hơn mà các build plugins viết lại cuộc gọi này thành.
• getLocale: Phát hiện locale của một yêu cầu đến.

TypeScript

function getIntlayerAsync<
  const T extends DictionaryKeys,
  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
>(
  key: T,
  localeOrSelector?: A,
  plugins?: Plugins[]
): Promise<
  DeepTransformContent<
    DictionaryRegistryResult<T, A>,
    IInterpreterPluginState,
    ExtractSelectorLocale<A>
  >
>;