MonthYearPicker
MonthYearPicker 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 MonthYearPicker 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 { MonthYearPicker } from '@underverse-ui/underverse';Ví dụ tương tác
Dùng thử MonthYearPicker 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.
MonthYearPicker
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
value | Current value as Date or {month, year} | Date | { month: number; year: number } | — |
defaultValue | Default value | Date | { month: number; year: number } | — |
onChange | Change handler | (value: { month: number; year: number; date: Date } | undefined) => void | — |
placeholder | Placeholder text | string | "Select month/year" |
disabled | Disabled state | boolean | false |
size | Size variant | FormControlSize | "md" |
label | Label text | string | — |
labelClassName | Custom class for label | string | — |
required | Required field | boolean | — |
clearable | Show clear button | boolean | true |
variant | Visual variant | MonthYearPickerVariant | "default" |
matchTriggerWidth | Match dropdown width to trigger | boolean | false |
monthNames | Custom month names | string[] | DEFAULT_MONTH_NAMES |
shortMonthNames | Custom short month names for display | string[] | DEFAULT_SHORT_MONTH_NAMES |
minYear | Minimum year in range | number | — |
maxYear | Maximum year in range | number | — |
minDate | Minimum selectable date | Date | — |
maxDate | Maximum selectable date | Date | — |
error | Show validation error | string | — |
success | Success state | boolean | — |
helperText | Helper text | string | — |
animate | Enable smooth animations | boolean | true |
onOpen | Callback when popover opens | () => void | — |
onClose | Callback when popover closes | () => void | — |
showThisMonth | Show "This Month" button | boolean | true |
columnLabels | Column labels | { month?: string; year?: string } | { month: "Month", year: "Year" } |
borderMode | Mã nguồn chưa cung cấp mô tả bổ sung. | BorderMode | — |
getPortalContainer | Resolve the document element that should receive the picker portal. | () => HTMLElement | null | — |
MonthYearPickerBase
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
value | Current value as Date or {month, year} | Date | { month: number; year: number } | — |
defaultValue | Default value | Date | { month: number; year: number } | — |
onChange | Change handler | (value: { month: number; year: number; date: Date } | undefined) => void | — |
placeholder | Placeholder text | string | "Select month/year" |
disabled | Disabled state | boolean | false |
size | Size variant | FormControlSize | "md" |
label | Label text | string | — |
labelClassName | Custom class for label | string | — |
required | Required field | boolean | — |
clearable | Show clear button | boolean | true |
variant | Visual variant | MonthYearPickerVariant | "default" |
matchTriggerWidth | Match dropdown width to trigger | boolean | false |
monthNames | Custom month names | string[] | DEFAULT_MONTH_NAMES |
shortMonthNames | Custom short month names for display | string[] | DEFAULT_SHORT_MONTH_NAMES |
minYear | Minimum year in range | number | — |
maxYear | Maximum year in range | number | — |
minDate | Minimum selectable date | Date | — |
maxDate | Maximum selectable date | Date | — |
error | Show validation error | string | — |
success | Success state | boolean | — |
helperText | Helper text | string | — |
animate | Enable smooth animations | boolean | true |
onOpen | Callback when popover opens | () => void | — |
onClose | Callback when popover closes | () => void | — |
showThisMonth | Show "This Month" button | boolean | true |
columnLabels | Column labels | { month?: string; year?: string } | { month: "Month", year: "Year" } |
borderMode | Mã nguồn chưa cung cấp mô tả bổ sung. | BorderMode | — |
getPortalContainer | Resolve the document element that should receive the picker portal. | () => HTMLElement | null | — |
Hướng dẫn sử dụng
Dùng MonthYearPicker 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 MonthYearPicker, 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ế.