DatePicker
Быстрый старт
- Uncontrolled
- Controlled
Сигнатура вызова onCommitDate c 6 аргументами - deprecated
export type OnCommitDateCallback = (
value: Date | string,
error?: boolean,
success?: boolean,
dateInfo?: DateInfo,
originalDate?: Date,
isoDate?: string,
) => void;
Используйте обновленную сигнатуру с 2мя аргументами
export type FormattedDateValues = {
/**
* Статус ошибки валидации
*/
error?: boolean;
/**
* Статус успешной валидации
*/
success?: boolean;
/**
* Информация о дате (для кварталов и т.д.)
*/
dateInfo?: DateInfo;
/**
* Дата как экземпляр Date
*/
originalDate?: Date;
/**
* Дата в формате ISO
*/
isoDate?: string;
};
export type OnCommitDateCallback = (value: Date | string, formattedValues: FormattedDateValues) => void;
Управление внешним видом
Внешний вид компонента зависит от свойств appearance, size:
- Appearance
- Size
Для appearance="clear" есть возможность отобразить разделитель с помощью hasClearDivider
Размер DatePicker задаётся с помощью свойства size.
Формат даты
Формат даты задается с помощью свойства format.
| Обозначение | Отображение | Описание |
|---|---|---|
| DD | 01-31 | Дни месяца, 2 цифры |
| D | 1-31 | Дни месяца |
| MMMM | January...December / январь...декабрь | Месяц года, полное название |
| MMM | Jan...Dec / янв.-дек. | Месяц года, сокращенное название |
| MM | 01-12 | Месяц года, 2 цифры |
| M | 1-12 | Месяц года |
| YYYY | 2024 | Год из 4 цифр |
| YY | 24 | Год из 2 цифр |
| Q | 1-4 | Квартал |
При выборе даты в календаре или вводе даты через поле ввода, дата будет приводиться к заданному формату.
Свойство maskWithFormat позволяет маскировать ввод, кроме случаев когда месяц имеет формат полной записи MMMM:
Язык даты
Язык даты задается с помощью свойства lang.
| Обозначение | Отображение | Описание |
|---|---|---|
| ru | June | Английский Язык |
| en | июнь | Русский язык |
По умолчанию используется ru
Валидация и индикация успешного ввода даты
За индикацию ошибки или успешного ввода отвечают valueError, valueSuccess.
В данном примере валидация происходит при нажатии клавиши Enter после ввода значений:
Обязательность поля
Наличие индикатора регулируется свойством hasRequiredIndicator.
Обязательность поля задаётся с помощью свойства required.
Если поле является обязательным, то у компонента появляется специальный индикатор.
Изменить расположение индикатора можно с помощью свойства requiredPlacement, которое принимает значения left и right.
Всплывающая подсказка для событий календаря
С помощью eventList, eventMonthList, eventQuarterList и eventYearList
можно задать список событий для определенной даты
Элемент списка имеет следующую структуру:
type EventDay {
date: Date;
color?: string;
eventInfo?: ReactNode;
}
Типизация свойств всплывающего окна:
type EventTooltipOptions = {
/**
* Обертка для всплывающей подсказки для событий.
*/
bodyWrapper?: FC<PropsWithChildren>;
/**
* Размер всплывающей подсказки для событий.
*/
size?: string;
/**
* Направление раскрытия тултипа.
*/
placement?: PopoverPlacement | Array<PopoverPlacementBasic>;
/**
* Отступ окна относительно элемента, у которого оно вызвано.
* @default
* [0, 8]
*/
offset?: [number, number];
/**
* Видимость стрелки (хвоста).
*/
hasArrow?: boolean;
/**
* Анимированное появление/сокрытие.
*/
animated?: boolean;
/**
* Минимальная ширина окна (в rem).
*/
minWidth?: number | string;
/**
* Максимальная ширина окна (в rem).
*/
maxWidth?: number | string;
};
DatePickerRange
Быстрый старт
Компонент DatePickerRange представляет собой Range с выпадающим календарем.
Календарь может быть одиночным или двойным. За это отвечает свойство isDoubleCalendar.
- Uncontrolled
- Controlled
Управление внешним видом
Внешний вид компонента зависит от свойств appearance, size, isDoubleCalendar:
- Appearance
- Size
- isDoubleCalendar
Для appearance="clear" есть возможность отобразить разделитель с помощью hasClearDivider
Размер DatePickerRange задаётся с помощью свойства size.
Возможные значения свойства: "l", "m", "s", "xs".
Календарь может быть одиночным или двойным. За это отвечает свойство isDoubleCalendar.