Bắt đầu nhanh
Import LanguageSwitcher (headless) 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ợ.
import { LanguageSwitcherHeadless } from '@underverse-ui/underverse';Ví dụ tương tác
Dùng thử LanguageSwitcher (headless) thật, xem mã ví dụ và tra cứu các prop đã được mô tả.
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.
LanguageSwitcherHeadless
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
localesBắt buộc | Mã nguồn chưa cung cấp mô tả bổ sung. | LanguageOption[] | Bắt buộc |
currentLocaleBắt buộc | Mã nguồn chưa cung cấp mô tả bổ sung. | string | Bắt buộc |
onSwitchBắt buộc | Mã nguồn chưa cung cấp mô tả bổ sung. | (code: string) => void | Bắt buộc |
labels | Mã nguồn chưa cung cấp mô tả bổ sung. | { heading?: string } | — |
className | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
LanguageSwitcher
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
localesBắt buộc | Danh sách ngôn ngữ (code, name, flag?). | LanguageOption[] | Bắt buộc |
currentLocaleBắt buộc | Mã ngôn ngữ hiện tại. | string | Bắt buộc |
onSwitchBắt buộc | Callback nhận mã ngôn ngữ được chọn. | (code: string) => void | Bắt buộc |
labels | Mã nguồn chưa cung cấp mô tả bổ sung. | { heading?: string } | — |
className | Class tuỳ chỉnh cho wrapper. | string | — |
Hướng dẫn sử dụng
Đặt LanguageSwitcher (headless) gần gốc ứng dụng và dùng design token làm nguồn dữ liệu duy nhất. Kiểm tra chế độ sáng, tối và hệ thống mà không gây chớp giao diện khi hydrate.
Trợ năng
Khi dùng LanguageSwitcher (headless), 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ế.