Chuyển tới nội dung chính

DatePicker

import { DatePicker } from "zmp-ui";

Dùng để cho phép người dùng lựa chọn ngày tháng.

Ví dụ

Bảng thuộc tính

DatePickerProps

PropertyTypeRequiredDescription
labelstringNoNhãn của input date picker. Sẽ được hiển thị phía trên input.
helperTextstringNoHelper text là phần văn bản ngắn nằm dưới các ô nhập liệu. Nội dung của các văn bản này thường chứa thông tin hướng dẫn giúp người dùng hiểu rõ hơn về tác dụng hoặc mô tả định dạng của dữ liệu được khuyến khích nhập vào.
errorTextstringNoError text là phần văn bản ngắn nằm dưới các ô nhập liệu. Nội dung của các văn bản này thường chứa thông tin cảnh báo về lỗi của dữ liệu được nhập vào, cũng như hướng dẫn cách khắc phục. `errorText` sẽ được hiển thị thay cho `helperText` khi `status` có giá trị là `error`.
status'' | 'error' | 'success'NoTrạng thái hiện tại của input date picker. Nếu là `error`, input sẽ có màu cảnh báo kèm theo `errorText`, ngược lại input sẽ có màu trung hoà kèm theo `helperText`. (default: '')
placeholderstringNoPlaceholder của input date picker. Được hiển thị khi chưa có giá trị.
titlestringNoTiêu đề của hộp thoại date picker.
disabledbooleanNoVô hiệu hóa input date picker. (default: false)
startDateDateNoNgày bắt đầu của date picker. Người dùng sẽ không thể chọn ngày trước ngày này.
endDateDateNoNgày kết thúc của date picker. Người dùng sẽ không thể chọn ngày sau ngày này.
startYearnumberNoNăm bắt đầu của date picker. Người dùng sẽ không thể chọn năm trước năm này.
endYearnumberNoNăm kết thúc của date picker. Người dùng sẽ không thể chọn năm sau năm này.
formatPickedValueDisplay(date: Date) => stringNoHàm dùng để định dạng nội dung hiển thị của input date picker dựa trên giá trị ngày đang chọn. Khác với `dateFormat` là một chuỗi định dạng ngày tháng năm, `formatPickedValueDisplay` là một hàm nhận vào giá trị ngày đang chọn và trả về chuỗi hiển thị, và chuối hiển thị này có thể không phải là ngày tháng năm.
dateFormatstringNoĐịnh dạng ngày tháng năm của date picker input. - Ngày: `dd` - Tháng: `mm`, `m`, `MM` (kiểu chữ), `M` (kiểu chữ tắt) - Năm: `yyyy`, `yy`
columnsFormat'MM-DD-YYYY' | 'DD-MM-YYYY' | 'YYYY-MM-DD'NoSắp xếp vị trí xuất hiện tương ứng của các cột ngày, tháng, năm trong date picker. `DD` tương ứng với cột ngày, `MM` tương ứng với cột tháng, `YYYY` tương ứng với cột năm.
defaultOpenbooleanNoMặc định mở hộp thoại date picker khi khởi tạo. (default: false)
defaultValueDateNoNgày mặc định được chọn sẵn khi khởi tạo date picker. _Lưu ý: thay đổi giá trị của `defaultValue` sau khi khởi tạo date picker sẽ không có tác dụng._
valueDateNoNgày được chọn. Cần được sử dụng cùng với `onChange` để cập nhật lại giá trị cho date picker sau khi người dùng thay đổi.
onChange(value: Date, pickedValue: { { [name: string]: OptionValueType } }) => voidNoCallback được gọi khi người dùng thay đổi giá trị của date picker. Tham số truyền vào là giá trị mới của date picker.
onVisibilityChange(visibilityState: boolean) => voidNoCallback được gọi khi người dùng mở / đóng hộp thoại date picker.
maskbooleanNoMask là một lớp overlay màu xám được phủ lên các thành phần bên dưới hộp thoại date picker, ngăn không cho người dùng tương tác với các nội dung đó và tập trung vào hộp thoại được mở. (default: true)
maskClosablebooleanNoTự động đóng hộp thoại date picker khi người dùng nhấn vào mask. Cần phải bật thuộc tính `mask` để sử dụng tính năng này. (default: true)
actionDatePickerActionTypeNoThêm action button cho hộp thoại date picker.
inputClassstringNoThêm CSS class cho input của date picker.
prefixReactNodeNoThêm nội dung vào đầu input của date picker. Thường được sử dụng để hiển thị icon.
suffixReactNodeNoThêm nội dung vào cuối input của date picker. Thường được sử dụng để hiển thị icon.
localestringNoNgôn ngữ hiển thị của date picker, được truyền vào dưới dạng mã ngôn ngữ BCP 47, ví dụ: `vi-VN`, `en-US`.

DatePickerActionType

PropertyTypeRequiredDescription
textstringNoChữ trên nút.
closebooleanNoNhấn vào nút sẽ đóng hộp thoại date picker. (default: false)
onClick(event: React.MouseEvent) => voidNoCallback được gọi khi nhấn vào nút.