Tham khảo React
Ways
Root props
Các thuộc tính gốc chung:
| Trụ | Kiểu | Ghi chú |
|---|---|---|
apiKey | chuỗi | Bắt buộc. |
ngôn ngữ | chuỗi | Ngôn ngữ mục tiêu hiện tại. |
baseLocale | chuỗi | Ngôn ngữ nguồn. |
persistLocaleCookie | boolean | Chính sách cookie ngôn ngữ mặc định cho runtime gốc. |
bối cảnh | chuỗi | đối tượng | Ngữ cảnh gốc tùy chọn. |
thời gian sống của bộ nhớ đệm | số | TTL bộ nhớ đệm cho các yêu cầu dịch thuật. |
messageFormatter | 'waysParser' | 'none' | fn | Ghi đè trình phân tích cú pháp hoặc trình định dạng. |
suspenseTimeoutMs | số | Thời gian tối đa cho phép render bị chặn trước khi việc render fallback tiếp tục. |
fetcher | kiểu của fetch | Triển khai fetch tùy chỉnh. |
acceptedLocales | chuỗ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ểu | Ghi chú |
|---|---|---|
bối cảnh | chuỗi | đối tượng | Bắt buộc. |
ngôn ngữ | chuỗi | Có sẵn, nhưng hãy dùng một root lồng nhau cho một phiên locale biệt lập. |
baseLocale | chuỗi | Ghi đè locale nguồn tuỳ chọn cho cây con. |
thành phần | Ghi<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ểu | Ghi chú |
|---|---|---|
trẻ em | ReactNode | Bắt buộc. |
biến | Bản ghi<string, unknown> | Dữ liệu đầu vào nội suy. |
bối cảnh | chuỗi | đối tượng | Ghi đè ngữ cảnh lá tùy chọn. |
thành phần | Ghi<string, component> | Ánh xạ thành phần cho nội dung phong phú. |
cố định | boolean | Bỏ 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.
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ểu | Ghi chú |
|---|---|---|
currentLocale | chuỗi | Ngôn ngữ vùng được kiểm soát. |
onLocaleChange | (locale) => void | Bộ xử lý thay đổi. |
hướng | 'lên' | 'xuống' | Hướng dẫn menu. |
styles / classNames | đối tượng | Ghi đè kiểu dáng. |
không định kiểu | boolean | Tắt các kiểu tích hợp sẵn. |
Utility exports
@18ways/react cũng xuất lại:
fetchAcceptedLocalesfetchConfigresolveOrigin