Tham khảo React

Ways

Root props

Các thuộc tính gốc chung:

TrụKiểuGhi chú
apiKeychuỗiBắt buộc.
ngôn ngữchuỗiNgôn ngữ mục tiêu hiện tại.
baseLocalechuỗiNgôn ngữ nguồn.
persistLocaleCookiebooleanChính sách cookie ngôn ngữ mặc định cho runtime gốc.
bối cảnhchuỗi | đối tượngNgữ cảnh gốc tùy chọn.
thời gian sống của bộ nhớ đệmsốTTL bộ nhớ đệm cho các yêu cầu dịch thuật.
messageFormatter'waysParser' | 'none' | fnGhi đè trình phân tích cú pháp hoặc trình định dạng.
suspenseTimeoutMssốThời gian tối đa cho phép render bị chặn trước khi việc render fallback tiếp tục.
fetcherkiểu của fetchTriển khai fetch tùy chỉnh.
acceptedLocaleschuỗi[]Danh sách ngôn ngữ vùng rõ ràng tùy chọn.

Scoped props

Phạm vi lồng nhau chấp nhận:

TrụKiểuGhi chú
bối cảnhchuỗi | đối tượngBắt buộc.
ngôn ngữchuỗiCó sẵn, nhưng hãy dùng một root lồng nhau cho một phiên locale biệt lập.
baseLocalechuỗiGhi đè locale nguồn tuỳ chọn cho cây con.
thành phầnGhi<string, component>Các thành phần được sử dụng bên trong nội dung có thể dịch.

T

T là primitive dịch theo JSX-first.

TrụKiểuGhi chú
trẻ emReactNodeBắt buộc.
biếnBản ghi<string, unknown>Dữ liệu đầu vào nội suy.
bối cảnhchuỗi | đối tượngGhi đè ngữ cảnh lá tùy chọn.
thành phầnGhi<string, component>Ánh xạ thành phần cho nội dung phong phú.
cố địnhbooleanBỏ qua dịch đối với nội dung cố định mang tính thương hiệu.

useT()

useT() trả về một hàm dịch cho chuỗi, thuộc tính và logic.

tsx
const t = useT();
const label = t('Save changes');

Các hook lúc chạy

useTranslatedMemo()

Một giá trị được ghi nhớ, tự tính lại khi bản dịch thay đổi.

useTranslationLoading()

Trả về true trong khi ngữ cảnh hiện tại vẫn đang tải.

useCurrentLocale()

Đọc locale đã chọn cho runtime gốc hiện tại.

useTargetLocale()

Đọc locale đích đang hoạt động cho phạm vi hiện tại.

useBaseLocale()

Đọc locale nguồn cho runtime gốc hiện tại.

useSetCurrentLocale()

Trả về bộ thiết lập cho locale runtime gốc.

useAcceptedLocales()

Đọc danh sách locale đã chấp nhận đã được phân giải từ runtime gốc.

LanguageSwitcher

Các đạo cụ thường dùng:

TrụKiểuGhi chú
currentLocalechuỗiNgôn ngữ vùng được kiểm soát.
onLocaleChange(locale) => voidBộ xử lý thay đổi.
hướng'lên' | 'xuống'Hướng dẫn menu.
styles / classNamesđối tượngGhi đè kiểu dáng.
không định kiểubooleanTắt các kiểu tích hợp sẵn.

Utility exports

@18ways/react cũng xuất lại:

  • fetchAcceptedLocales
  • fetchConfig
  • resolveOrigin
Đang đổi ngôn ngữ
Tài liệu tham chiếu React