Ark UI (@ark-ui/react) + Tailwind CSS v4
Đã có phiên bản Range Picker: ArkDateInputRangePicker

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).

15102026

Định dạng mặc định vi-VN (Ngày / Tháng / Năm)

Giá trị Date: 2026-10-15
ISO String: null
Chuỗi hiển thị (valueAsString): Chưa đổi
<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.

15102026
15102026

Không thể sửa ô nhập hay mở popup lịch

15102026

Toàn bộ tương tác bị vô hiệu

ddmmyyyy

Vui lòng nhập ngày hợp lệ để tiếp tục!

// 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).

Size: xs
15102026
Size: sm
15102026
Size: md
15102026
Size: lg
15102026
<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.

20102026

Thứ 7 và Chủ Nhật bị vô hiệu hóa trên lịch

Lưu ý: Khi mở lịch, các ngày nằm ngoài khoảng Min/Max hoặc ngày cuối tuần sẽ bị làm mờ và không thể click chọn.
<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.

20112026

Định dạng lưu trữ format: YYYY-MM-DD

10152026

Thứ tự hiển thị: Month / Day / Year

<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ì.

Size:
15102026

Gõ từng phân đoạn hoặc click icon lịch bên phải

Live State Output:
Date: 2026-10-15
ISO: null
valueAsString: Chưa đổi
arkValue: null

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.

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

Hỗ trợ gõ phím trực tiếp hoặc click icon lịch để chọn range kèm preset

Giá trị Range hiện tại: 2026-10-10 → 2026-10-25
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ínhKiểu dữ liệuMặc địnhMô tả
valueDate | DateValue | string | nullundefinedGiá trị ngày hiện tại (chế độ controlled).
defaultValueDate | DateValue | string | nullundefinedGiá trị ban đầu khi chưa kiểm soát (uncontrolled).
onValueChange(details) => voidundefinedHàm callback khi giá trị ngày thay đổi từ bàn phím hoặc lịch.
clearablebooleantrueHiể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 / maxDate | DateValue | stringundefinedGiới hạn ngày nhỏ nhất và lớn nhất được phép chọn.
isDateUnavailable(date: Date) => booleanundefinedHàm kiểm tra ngày bị vô hiệu hóa (ví dụ cuối tuần, ngày lễ).
shouldForceLeadingZerosbooleantrueTự động đệm số 0 ở đầu cho ngày và tháng (01 đến 09).
closeOnSelectbooleantrueTự động đóng popup lịch sau khi người dùng click chọn ngày.
startIconReactNodeundefinedIcon hiển thị ở đầu ô nhập.
© 2026. FlatVn All rights reserved. Version 4.4.2