Đi tới nội dung tài liệu
Underverse UI Logo
ComponentĐa ngôn ngữ

TranslationProvider

TranslationProvider thuộc nhóm Đa ngôn ngữ. Xem demo trực tiếp, cách tích hợp và các lưu ý triển khai.

Bắt đầu nhanh

Import TranslationProvider từ entry công khai. Các ví dụ bên dưới thể hiện những kiểu tương tác và cấu hình được hỗ trợ.

component.tsxtsx
import { TranslationProvider } from '@underverse-ui/underverse';

Ví dụ tương tác

Dùng thử TranslationProvider thật, xem mã ví dụ và tra cứu các prop đã được mô tả.

Đang tải ví dụ tương tác…
Tham chiếu

Tham chiếu API

Tra cứu các thuộc tính, kiểu dữ liệu được chấp nhận, giá trị mặc định và lưu ý về hành vi.

Dữ liệu được sinh từ API TypeScript công khai của thư viện. Kiểu dữ liệu, thuộc tính bắt buộc và giá trị mặc định luôn đồng bộ với mã nguồn.

TranslationProvider

Component
Thuộc tínhMô tảKiểuMặc định
childrenBắt buộcMã nguồn chưa cung cấp mô tả bổ sung.React.ReactNodeBắt buộc
localeCurrent locale. Defaults to "en"Locale"en"
translationsCustom translations to merge with defaultsPartial<Record<Locale, Translations>>
i18nGlobal flat label overrides — lets callers skip per-component prop drilling for common strings.GlobalI18nConfig

useUnderverseLocale

Hàm
APIKiểuMô tả
useUnderverseLocale() => LocaleHook to get the current locale. Falls back to "en" when TranslationProvider is not available.

useUnderverseTranslations

Hàm
APIKiểuMô tả
useUnderverseTranslations(namespace: string) => (key: string) => stringHook to get translations for a specific namespace. Falls back to the key itself when TranslationProvider is not available.

Hướng dẫn sử dụng

Cấu hình TranslationProvider tại biên ứng dụng. Giữ nguyên placeholder cùng quy tắc ngày, số và số nhiều cho mọi locale được hỗ trợ.

Trợ năng

Khi dùng TranslationProvider, hãy giữ trạng thái focus dễ nhận biết, cung cấp tên truy cập khi cần và kiểm tra bàn phím cùng trình đọc màn hình trong ngữ cảnh thực tế.