LunarDatePicker
Đã cập nhậtLunarDatePicker thuộc nhóm Picker & Select. 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 LunarDatePicker từ entry của gói Free. 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 { LunarDatePicker } from '@underverse-ui/underverse';Ví dụ tương tác
Dùng thử LunarDatePicker 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.
LunarDatePicker
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
id | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
value | Mã nguồn chưa cung cấp mô tả bổ sung. | LunarPickerValue | — |
onChangeBắt buộc | Mã nguồn chưa cung cấp mô tả bổ sung. | (date: LunarPickerValue | undefined) => void | Bắt buộc |
formatDate | Custom date display formatter function | (date: LunarPickerValue) => string | — |
placeholder | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
className | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
disabled | Mã nguồn chưa cung cấp mô tả bổ sung. | boolean | false |
size | Mã nguồn chưa cung cấp mô tả bổ sung. | FormControlSize | "md" |
label | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
labelClassName | Custom class for label | string | — |
required | Mã nguồn chưa cung cấp mô tả bổ sung. | boolean | — |
todayLabel | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
clearLabel | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
weekdayLabels | Mã nguồn chưa cung cấp mô tả bổ sung. | string[] | — |
disablePastDates | Disable selecting past dates (before today) | boolean | false |
minDate | Minimum selectable date (inclusive). Compared by day in local timezone. | LunarPickerValue | — |
maxDate | Maximum selectable date (inclusive). Compared by day in local timezone. | LunarPickerValue | — |
borderMode | Mã nguồn chưa cung cấp mô tả bổ sung. | BorderMode | — |
getPortalContainer | Resolve the document element that should receive the calendar portal. | () => HTMLElement | null | — |
LunarDateRangePicker
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
id | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
startDate | Mã nguồn chưa cung cấp mô tả bổ sung. | LunarPickerValue | — |
endDate | Mã nguồn chưa cung cấp mô tả bổ sung. | LunarPickerValue | null | — |
onChangeBắt buộc | Mã nguồn chưa cung cấp mô tả bổ sung. | (start: LunarPickerValue | undefined, end: LunarPickerValue | null | undefined) => void | Bắt buộc |
formatDate | Custom date display formatter function applied to both start and end date | (date: LunarPickerValue) => string | — |
placeholder | Mã nguồn chưa cung cấp mô tả bổ sung. | string | "Select lunar date range..." |
className | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
label | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
labelClassName | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
required | Mã nguồn chưa cung cấp mô tả bổ sung. | boolean | false |
disablePastDates | Mã nguồn chưa cung cấp mô tả bổ sung. | boolean | false |
minDate | Mã nguồn chưa cung cấp mô tả bổ sung. | LunarPickerValue | — |
maxDate | Mã nguồn chưa cung cấp mô tả bổ sung. | LunarPickerValue | — |
size | Mã nguồn chưa cung cấp mô tả bổ sung. | FormControlSize | "md" |
disabled | Mã nguồn chưa cung cấp mô tả bổ sung. | boolean | false |
borderMode | Mã nguồn chưa cung cấp mô tả bổ sung. | BorderMode | — |
getPortalContainer | Resolve the document element that should receive the calendar portal. | () => HTMLElement | null | — |
Hướng dẫn sử dụng
Dùng LunarDatePicker khi lựa chọn có giới hạn nhanh và an toàn hơn nhập tự do. Cần cấu hình rõ locale, giới hạn, giá trị bị vô hiệu hóa và trạng thái xóa.
Trợ năng
Khi dùng LunarDatePicker, 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ế.