Ark Date Input Range Picker
Component khoảng ngày kết hợp giữa Ark Date Input Range (2 phân đoạn nhập liệu bắt đầu & kết thúc bằng bàn phím) và Ark Date Picker Range (popover lịch chọn khoảng ngày, thanh preset nhanh: 7 ngày trước, 14 ngày trước, tháng này...). Nút Picker (icon lịch) ở bên trái và nút Clear (X) ở bên phải (tự động disabled khi chưa có khoảng ngày).
1. Cơ bản: Nhập 2 đoạn [Start → End] + Lịch Range + Preset
Cho phép gõ phím trực tiếp vào ngày bắt đầu hoặc kết thúc, hoặc mở lịch chọn khoảng ngày với preset nhanh.
<ArkDateInputRangePicker
label="Khoảng thời gian hiệu lực"
value={range}
onValueChange={(details) => setRange(details.value)}
helperText="Định dạng mặc định vi-VN"
/>2. Kích thước (ControlSize: xs, sm, md, lg)
Tương thích hoàn toàn với hệ thống ControlSize của ChillCMS (h-8, h-9, h-10, h-12).
<ArkDateInputRangePicker size="xs" value={range} />
<ArkDateInputRangePicker size="sm" value={range} />
<ArkDateInputRangePicker size="md" value={range} />
<ArkDateInputRangePicker size="lg" value={range} />3. Trạng thái & Tùy biến dấu phân cách (rangeSeparator)
Hỗ trợ disabled, readOnly, invalid/error, cùng khả năng đổi dấu nối giữa ngày bắt đầu và kết thúc.
// Tùy biến ký tự phân cách
<ArkDateInputRangePicker
rangeSeparator={<span className="text-primary text-xs">đến</span>}
value={range}
/>
// Báo lỗi
<ArkDateInputRangePicker
error="Khoảng ngày không hợp lệ"
value={range}
/>4. Giới hạn ngày (min, max & vô hiệu hóa cuối tuần)
Chỉ cho phép chọn trong khoảng min/max định sẵn, và vô hiệu hóa các ngày nghỉ cuối tuần.
<ArkDateInputRangePicker
min="2026-10-01"
max="2026-10-31"
isDateUnavailable={(date) => {
const day = date.getDay();
return day === 0 || day === 6;
}}
value={range}
/>5. Sân chơi tương tác (Interactive Playground)
Thử nghiệm đầy đủ các props để kiểm tra hành vi trực quan của component ArkDateInputRangePicker.
Bảng thuộc tính (ArkDateInputRangePicker Props)
| Thuộc tính | Kiểu dữ liệu | Mặc định | Mô tả |
|---|---|---|---|
| value | [Date | string | null, Date | string | null] | Date[] | null | undefined | Giá trị khoảng ngày hiện tại (chế độ controlled). |
| defaultValue | [Date | string | null, Date | string | null] | Date[] | null | undefined | Giá trị ban đầu khi chưa kiểm soát (uncontrolled). |
| onValueChange | (details) => void | undefined | Callback khi khoảng ngày thay đổi từ bàn phím hoặc popover lịch. |
| rangeSeparator | ReactNode | '→' | Ký tự hoặc phần tử ngăn cách giữa 2 ô nhập bắt đầu và kết thúc. |
| presets | ArkDateInputRangePickerPresetOption[] | Mặc định 8+ preset | Danh sách nút chọn nhanh. Preset chỉ có một ngày được chuyển thành khoảng cùng ngày; preset vi phạm min/max hoặc có đầu mút bị khóa sẽ bị vô hiệu hóa. |
| clearable | boolean | true | Hiển thị nút Xóa (X) bên cạnh nút Lịch; tự động disabled khi chưa chọn khoảng ngày. |
| size | 'xs' | 'sm' | 'md' | 'lg' | 'md' | Kích thước control đồng bộ với ControlSize ChillCMS. |
| min / max | Date | 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 | Khóa ngày bắt đầu/kết thúc trên lịch, bàn phím và preset; ngày nghỉ ở bên trong khoảng vẫn được phép. |