Ark Date Input Picker
Component kết hợp tối ưu giữa Ark Date Input (nhập liệu theo phân đoạn ngày, tháng, năm dạng segmented spinbutton, phím mũi tên) và Ark Date Picker (popover lịch chọn ngày trực quan). Bố cục gồm nút Picker (icon lịch) ở bên trái và nút Clear (X) ở bên phải (luôn xuất hiện, tự động disable khi chưa có ngày được chọn).
1. Cơ bản: Nhập Segmented + Picker bên trái + Clear bên phải
Nút Picker (lịch) nằm bên trái, nút Clear (X) nằm bên phải luôn xuất hiện (bình thường khi có ngày, disable khi chưa chọn ngày).
<ArkDateInputPicker
label="Chọn ngày hẹn"
value={selectedDate}
onValueChange={(details) => setSelectedDate(details.value)}
clearable={true}
/>2. Các trạng thái (States)
Hỗ trợ đầy đủ các trạng thái UI: Mặc định, Có sẵn giá trị, ReadOnly (chỉ đọc), Disabled (vô hiệu) và Invalid / Báo lỗi.
// Báo lỗi:
<ArkDateInputPicker label="Ngày" invalid error="Ngày không hợp lệ" />
// Vô hiệu hóa:
<ArkDateInputPicker label="Ngày" disabled />3. Bốn kích thước chuẩn ChillCMS (ControlSize)
Đồng bộ chính xác với hệ thống Input, Button và Select: xs (24px), sm (32px), md (40px) và lg (48px).
<ArkDateInputPicker size="xs" />
<ArkDateInputPicker size="sm" />
<ArkDateInputPicker size="md" /> {/* Mặc định */}
<ArkDateInputPicker size="lg" />4. Giới hạn Min / Max & Cấm chọn Cuối tuần
Hạn chế phạm vi chọn ngày: Chỉ được chọn trong tháng 10/2026 và tự động vô hiệu hóa Thứ Bảy & Chủ Nhật.
<ArkDateInputPicker
min={new Date('2026-10-01')}
max={new Date('2026-10-31')}
isDateUnavailable={(date) => date.getDay() === 0 || date.getDay() === 6}
/>5. Start Icon & Tùy biến linh hoạt
Dễ dàng thêm icon đầu ô nhập (Start Icon), định dạng tùy biến bằng dayjs format string hoặc hàm tùy chỉnh.
<ArkDateInputPicker
startIcon={<Clock className="size-4" />}
locale="en-US"
format="YYYY-MM-DD"
/>6. Interactive Playground
Thử nghiệm trực tiếp toàn bộ các tùy chọn cấu hình của ArkDateInputPicker và kiểm tra phản hồi tức thì.
6. Dạng khoảng ngày (Range Picker): ArkDateInputRangePicker
Phiên bản mở rộng hỗ trợ chọn khoảng ngày [Start → End]: Nhập phím 2 phân đoạn, lịch range trực quan, thanh Preset nhanh và nút Clear.
import { ArkDateInputRangePicker } from '~/components/ui/ark-date-input-range-picker';
<ArkDateInputRangePicker
label="Khoảng ngày áp dụng"
value={range}
onValueChange={(details) => setRange(details.value)}
helperText="DD/MM/YYYY → DD/MM/YYYY"
/>Bảng thuộc tính (Props Reference)
| Thuộc tính | Kiểu dữ liệu | Mặc định | Mô tả |
|---|---|---|---|
| value | Date | DateValue | string | null | undefined | Giá trị ngày hiện tại (chế độ controlled). |
| defaultValue | Date | DateValue | string | null | undefined | Giá trị ban đầu khi chưa kiểm soát (uncontrolled). |
| onValueChange | (details) => void | undefined | Hàm callback khi giá trị ngày thay đổi từ bàn phím hoặc lịch. |
| clearable | boolean | true | Hiển thị nút Xóa (X) ở bên phải nút Lịch; luôn xuất hiện và tự động disable khi chưa có ngày nào được chọn. |
| size | 'xs' | 'sm' | 'md' | 'lg' | 'md' | Kích thước control đồng bộ với Input và Button ChillCMS. |
| min / max | Date | DateValue | string | undefined | Giới hạn ngày nhỏ nhất và lớn nhất được phép chọn. |
| isDateUnavailable | (date: Date) => boolean | undefined | Hàm kiểm tra ngày bị vô hiệu hóa (ví dụ cuối tuần, ngày lễ). |
| shouldForceLeadingZeros | boolean | true | Tự động đệm số 0 ở đầu cho ngày và tháng (01 đến 09). |
| closeOnSelect | boolean | true | Tự động đóng popup lịch sau khi người dùng click chọn ngày. |
| startIcon | ReactNode | undefined | Icon hiển thị ở đầu ô nhập. |