Ark UI (@ark-ui/react) + Tailwind CSS v4
Xem phiên bản ngày đơn (ArkDateInputPicker)

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.

Ngày bắt đầuNgày kết thúc
10102026
25102026

Định dạng mặc định vi-VN: DD/MM/YYYY → DD/MM/YYYY

Giá trị Range: 10/10/2026 → 25/10/2026
Số ngày đã chọn: 2 / 2
Chuỗi hiển thị (valueAsString): Chưa đổi
<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).

Size: xs
Ngày bắt đầuNgày kết thúc
10102026
20102026
Size: sm
Ngày bắt đầuNgày kết thúc
10102026
20102026
Size: md
Ngày bắt đầuNgày kết thúc
10102026
20102026
Size: lg
Ngày bắt đầuNgày kết thúc
10102026
20102026
<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.

Ngày bắt đầuNgày kết thúc
10102026
20102026
Ngày bắt đầuNgày kết thúc
10102026
20102026

Khoảng ngày bắt buộc không quá 30 ngày!

Ngày bắt đầuNgày kết thúc
10102026
20102026

Chế độ chỉ xem, không thể nhập liệu hay mở popover

Ngày bắt đầuNgày kết thúc
10102026
20102026
// 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.

Ngày bắt đầuNgày kết thúc
15102026
22102026

Giới hạn: 01/10/2026 → 31/10/2026 (ngày cuối tuần bị khóa)

Khoảng đã chọn: 15/10/2026 → 22/10/2026
<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.

Nút Clear
Đệm số 0
Start Icon
Báo lỗi (Invalid)
Read Only
Disabled
Ngày bắt đầuNgày kết thúc
10102026
25102026

Thử thay đổi cấu hình ở trên để kiểm tra giao diện động

Giá trị hiện tại: 10/10/2026 → 25/10/2026
Details valueAsString: Chưa đổi

Bảng thuộc tính (ArkDateInputRangePicker Props)

Thuộc tínhKiểu dữ liệuMặc địnhMô tả
value[Date | string | null, Date | string | null] | Date[] | nullundefinedGiá trị khoảng ngày hiện tại (chế độ controlled).
defaultValue[Date | string | null, Date | string | null] | Date[] | nullundefinedGiá trị ban đầu khi chưa kiểm soát (uncontrolled).
onValueChange(details) => voidundefinedCallback khi khoảng ngày thay đổi từ bàn phím hoặc popover lịch.
rangeSeparatorReactNode'→'Ký tự hoặc phần tử ngăn cách giữa 2 ô nhập bắt đầu và kết thúc.
presetsArkDateInputRangePickerPresetOption[]Mặc định 8+ presetDanh 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.
clearablebooleantrueHiể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 / maxDate | stringundefinedGiới hạn ngày nhỏ nhất và lớn nhất được phép chọn.
isDateUnavailable(date: Date) => booleanundefinedKhó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.
© 2026. FlatVn All rights reserved. Version 4.4.2