diff --git a/.storybook/preview.ts b/.storybook/preview.ts index bd5a1c5f..78c56666 100644 --- a/.storybook/preview.ts +++ b/.storybook/preview.ts @@ -68,6 +68,9 @@ const preview: Preview = { globals: { theme: 'light' }, }, controls: { + // Полная таблица в панели Controls: имя, описание, тип, дефолт и группы категорий. + // В компактном режиме Storybook 10 описание пропса не отображается. + expanded: true, matchers: { color: /(background|color)$/i, date: /Date$/i diff --git a/docs/components-api/datepicker.md b/docs/components-api/datepicker.md index 6980268a..7cc73ff8 100644 --- a/docs/components-api/datepicker.md +++ b/docs/components-api/datepicker.md @@ -1,35 +1,52 @@ -[Открыть в Figma →](https://www.figma.com/design/Q1BWgZ7zoV5UzlBOnjW0cM/UI-Kit--DS--v2.1?node-id=484-5983&m=dev) +[Открыть в Figma →](https://www.figma.com/design/Q1BWgZ7zoV5UzlBOnjW0cM/UI-Kit--DS--v3.0?node-id=25178-78127&m=dev) # ExtraDatePicker -| Свойство | Описание | Типизация | По умолчанию | -| ---------------- | ----------------------------------------------------------------------------- | ---------------------------------- | ------------ | -| `placeholder` | текст подсказки внутри поля | `string` | — | -| `label` | текст названия поля | `string` | `''` | -| `labelPosition` | положение лейбла | `top \| left` | `top` | -| `floatLabel` | плавающий лейбл внутри поля (перекрывает `labelPosition`) | `boolean` | `false` | -| `view` | режим отображения календаря | `day \| month \| year \| time` | `day` | -| `selectionMode` | режим выбора даты | `single \| multiple \| range` | `single` | -| `showTime` | включить выбор времени (значение времени в поле + timepicker в календаре) | `boolean` | `false` | -| `inline` | отображать календарь встроенно, без поля ввода | `boolean` | `false` | -| `showButtonBar` | отображать блок с кнопками (Сегодня / Очистить) | `boolean` | `false` | -| `clearable` | отображение иконки для очистки поля | `boolean` | `false` | -| `dateFormat` | формат отображения даты | `string` | `'dd.mm.yy'` | -| `minDate` | минимальная выбираемая дата | `Date` | — | -| `maxDate` | максимальная выбираемая дата | `Date` | — | -| `caption` | текст пояснения под полем | `string` | `''` | -| `info` | текст с доп. информацией (показывается в тултипе иконки ti-info-circle) | `string` | `''` | -| `size` | размер поля | `small \| base \| large \| xlarge` | `base` | -| `hourLabel` | подпись поля часов в блоке времени (по умолчанию «Часы») | `string` | `'Часы'` | -| `minuteLabel` | подпись поля минут в блоке времени (по умолчанию «Минуты») | `string` | `'Минуты'` | -| `readonly` | только для чтения | `boolean` | `false` | -| `required` | поле обязательно для заполнения | `boolean` | `false` | -| `name` | имя поля (нативный атрибут `name`); используется браузером для автозаполнения | `string` | — | -| `autocomplete` | значение нативного атрибута `autocomplete` | `string` | — | -| `ariaLabel` | метка для программ экранного доступа | `string` | — | -| `ariaLabelledBy` | `id` внешнего элемента-метки для доступности | `string` | — | -| `autofocus` | автофокус при монтировании компонента | `boolean` | `false` | -| `tabindex` | порядок перехода по Tab | `number` | — | +| Свойство | Описание | Типизация | По умолчанию | +| ----------------- | ----------------------------------------------------------------------------- | -------------------------------------- | ------------ | +| `placeholder` | текст подсказки внутри поля | `string` | — | +| `label` | текст названия поля | `string` | `''` | +| `labelPosition` | положение лейбла | `top \| left` | `top` | +| `floatLabel` | плавающий лейбл внутри поля (перекрывает `labelPosition`) | `boolean` | `false` | +| `view` | режим отображения календаря | `day \| month \| year \| time \| date` | `day` | +| `selectionMode` | режим выбора даты | `single \| multiple \| range` | `single` | +| `showTime` | включить выбор времени (значение времени в поле + timepicker в календаре) | `boolean` | `false` | +| `inline` | отображать календарь встроенно, без поля ввода | `boolean` | `false` | +| `showButtonBar` | отображать блок с кнопками (Сегодня / Очистить) | `boolean` | `false` | +| `clearable` | отображение иконки для очистки поля | `boolean` | `false` | +| `dateFormat` | формат отображения даты | `string` | `'dd.mm.yy'` | +| `minDate` | минимальная выбираемая дата | `Date` | — | +| `maxDate` | максимальная выбираемая дата | `Date` | — | +| `caption` | текст пояснения под полем | `string` | `''` | +| `captionSeverity` | вариант подписи: base, success, warning, danger, info | `ExtraCaptionSeverity` | `'base'` | +| `info` | текст с доп. информацией (показывается в тултипе иконки ti-info-circle) | `string` | `''` | +| `size` | размер поля | `small \| base \| large \| xlarge` | `base` | +| `hourLabel` | подпись поля часов в блоке времени (по умолчанию «Часы») | `string` | `'Часы'` | +| `minuteLabel` | подпись поля минут в блоке времени (по умолчанию «Минуты») | `string` | `'Минуты'` | +| `readonly` | только для чтения | `boolean` | `false` | +| `required` | поле обязательно для заполнения | `boolean` | `false` | +| `name` | имя поля (нативный атрибут `name`); используется браузером для автозаполнения | `string` | — | +| `autocomplete` | значение нативного атрибута `autocomplete` | `string` | — | +| `ariaLabel` | метка для программ экранного доступа | `string` | — | +| `ariaLabelledBy` | `id` внешнего элемента-метки для доступности | `string` | — | +| `autofocus` | автофокус при монтировании компонента | `boolean` | `false` | +| `tabindex` | порядок перехода по Tab | `number` | — | + +| `fluid` | растягивает поле до ширины контейнера | `boolean` | `false` | +| `showIcon` | показывает иконку календаря | `boolean` | `true` | +| `iconDisplay` | иконка внутри поля либо отдельная кнопка | `input \| button` | `input` | +| `hourFormat` | формат времени; в 12-часовом режиме доступен переключатель AM/PM | `'24' \| '12'` | `'24'` | +| `showOtherMonths` | показывает дни соседних месяцев | `boolean` | `true` | +| `selectOtherMonths` | разрешает выбирать дни соседних месяцев | `boolean` | `false` | +| `inputId` | id поля, связанный с label | `string` | уникальный id | +| `invalid` | явная невалидность; также учитывается touched/dirty связанного NgControl | `boolean` | `false` | + +`view="date"` сохраняется для существующих шаблонов; каноническое имя режима дней — `day`. +`view="time"` показывает только панель времени. При `inline=true` label/caption и поле ввода не рендерятся. +`floatLabel=true` перекрывает `labelPosition` и подавляет placeholder; метка поднимается при фокусе или значении. +`required` подключён как NG_VALIDATORS-валидатор. `disabled` задаётся через FormControl, не через Input. + +Миграция: **BREAKING** `size="medium"` → `size="base"`; `[showClear]` → `[clearable]`. Названия месяцев и дней недели, а также подписи кнопок навигации для скринридера берутся из перевода PrimeNG (`providePrimeNG({ translation })`, `PrimeNG.setTranslation`); по умолчанию `provideExtraThemes()` задаёт русский. @@ -41,21 +58,24 @@ # События -| Событие | Описание | Типизация | -| ------------- | -------------------------------------------- | ------------------------------------------------- | -| `input` | срабатывает при ручном вводе значения в поле | `(event: Event) => void` | -| `select` | срабатывает при выборе даты в календаре | `(value: Date) => void` | -| `clear` | срабатывает при очистке значения | `() => void` | -| `show` | срабатывает при открытии календаря | `() => void` | -| `hide` | срабатывает при закрытии календаря | `() => void` | -| `monthChange` | срабатывает при смене месяца | `(event: ExtraDatePickerViewChangeEvent) => void` | -| `yearChange` | срабатывает при смене года | `(event: ExtraDatePickerViewChangeEvent) => void` | -| `todayClick` | срабатывает при клике по кнопке «Сегодня» | `(value: Date) => void` | -| `clearClick` | срабатывает при клике по кнопке «Очистить» | `() => void` | +| Событие | Описание | Типизация | +| --------------- | -------------------------------------------- | ------------------------------------------------- | +| `onInput` | срабатывает при ручном вводе значения в поле | `(event: Event) => void` | +| `onSelect` | срабатывает при выборе даты в календаре | `(value: Date) => void` | +| `onClear` | срабатывает при очистке значения | `() => void` | +| `onShow` | срабатывает при открытии календаря | `() => void` | +| `onHide` | срабатывает при закрытии календаря | `() => void` | +| `onMonthChange` | срабатывает при смене месяца | `(event: ExtraDatePickerViewChangeEvent) => void` | +| `onYearChange` | срабатывает при смене года | `(event: ExtraDatePickerViewChangeEvent) => void` | +| `onTodayClick` | срабатывает при клике по кнопке «Сегодня» | `(value: Date) => void` | +| `onClearClick` | срабатывает при клике по кнопке «Очистить» | `() => void` | + +| `onFocus` | получение фокуса полем | `(event: Event) => void` | +| `onBlur` | потеря фокуса полем, помечает FormControl touched | `(event: Event) => void` | # ExtraDatePickerViewChangeEvent -Событие смены месяца/года, передаётся в `monthChange` и `yearChange`. +Событие смены месяца/года, передаётся в `onMonthChange` и `onYearChange`. | Свойство | Описание | Типизация | | -------- | --------------- | --------- | diff --git a/src/lib/components/date-picker/date-picker.component.ts b/src/lib/components/date-picker/date-picker.component.ts index c0f49b0d..c69f646a 100644 --- a/src/lib/components/date-picker/date-picker.component.ts +++ b/src/lib/components/date-picker/date-picker.component.ts @@ -1,5 +1,10 @@ import { AfterViewInit, + afterEveryRender, + booleanAttribute, + Injector, + OnChanges, + SimpleChanges, ChangeDetectionStrategy, ChangeDetectorRef, Component, @@ -12,15 +17,30 @@ import { ViewChild } from '@angular/core'; import { takeUntilDestroyed } from '@angular/core/rxjs-interop'; -import { FormsModule, ControlValueAccessor, NG_VALUE_ACCESSOR } from '@angular/forms'; +import { + FormsModule, + ControlValueAccessor, + NG_VALUE_ACCESSOR, + NG_VALIDATORS, + NgControl, + AbstractControl, + ValidationErrors, + Validator, + Validators +} from '@angular/forms'; +import { NgTemplateOutlet } from '@angular/common'; +import { FloatLabel } from 'primeng/floatlabel'; +import { ExtraCaptionComponent, ExtraCaptionSeverity } from '@cdek-it/angular-ui-kit/components/caption'; +import { ExtraTooltipDirective } from '@cdek-it/angular-ui-kit/components/tooltip'; +import { ExtraSelectComponent } from '@cdek-it/angular-ui-kit/components/select'; import { DatePicker, DatePickerMonthChangeEvent } from 'primeng/datepicker'; import { InputText } from 'primeng/inputtext'; import { PrimeTemplate, Translation, TranslationKeys } from 'primeng/api'; import { PrimeNG } from 'primeng/config'; -import { Select } from 'primeng/select'; import { Button } from 'primeng/button'; -export type ExtraDatePickerMonthChangeEvent = DatePickerMonthChangeEvent; +export type ExtraDatePickerViewChangeEvent = DatePickerMonthChangeEvent; +export type ExtraDatePickerMonthChangeEvent = ExtraDatePickerViewChangeEvent; const YEARS = (() => { const result = []; @@ -40,13 +60,14 @@ const NAV_LABEL_KEYS = { year: { prev: 'prevDecade', next: 'nextDecade' } } satisfies Record<'date' | 'month' | 'year', Record<'prev' | 'next', keyof Translation>>; -export type ExtraDatePickerSize = 'small' | 'medium' | 'large' | 'xlarge'; +export type ExtraDatePickerSize = 'small' | 'base' | 'large' | 'xlarge'; +export type ExtraDatePickerView = 'day' | 'date' | 'month' | 'year' | 'time'; export type ExtraDatePickerSelectionMode = 'single' | 'multiple' | 'range'; export type ExtraDatePickerIconDisplay = 'input' | 'button'; @Component({ selector: 'extra-date-picker', - host: { style: 'display: inline-flex' }, + host: { style: 'display: contents' }, standalone: true, changeDetection: ChangeDetectionStrategy.OnPush, providers: [ @@ -54,147 +75,237 @@ export type ExtraDatePickerIconDisplay = 'input' | 'button'; provide: NG_VALUE_ACCESSOR, useExisting: forwardRef(() => ExtraDatePickerComponent), multi: true - } + }, + { provide: NG_VALIDATORS, useExisting: forwardRef(() => ExtraDatePickerComponent), multi: true } + ], + imports: [ + DatePicker, + InputText, + PrimeTemplate, + FormsModule, + ExtraSelectComponent, + Button, + NgTemplateOutlet, + FloatLabel, + ExtraCaptionComponent, + ExtraTooltipDirective ], - imports: [DatePicker, InputText, PrimeTemplate, FormsModule, Select, Button], template: ` - - -
- - - - - -
- - -
- - - - - + @if (!inline && (label || caption)) { +
+ @if (label && labelPosition === 'left' && !floatLabel) { + + } +
+ @if (label && labelPosition === 'top' && !floatLabel) { + + } + @if (floatLabel) { + + } @else { + + } + @if (caption) { + {{ caption }} + }
- - - - - - - - - @if (showClear) { - - - - } - @if (showTime) { - -
-
- - -
-
- : -
-
- - +
+ } @else { + + } + + + + + + +
+ + + + + +
+ +
+ + + + +
- } -
+ + + + + + + + @if (clearable) { + + + + } + @if (showTime || view === 'time') { + +
+
+ + +
+
+ : +
+
+ + +
+ @if (hourFormat === '12') { + + } +
+
+ } + +
` }) -export class ExtraDatePickerComponent implements ControlValueAccessor, AfterViewInit, OnDestroy { +export class ExtraDatePickerComponent implements ControlValueAccessor, AfterViewInit, OnDestroy, OnChanges, Validator { private readonly cdr = inject(ChangeDetectorRef); private readonly primeng = inject(PrimeNG); + private readonly injector = inject(Injector); + private onValidatorChange: () => void = () => {}; + private explicitInvalid = false; @ViewChild('dpRef') dpRef!: DatePicker; @@ -216,22 +327,43 @@ export class ExtraDatePickerComponent implements ControlValueAccessor, AfterView @Input() dateFormat = 'dd.mm.yy'; @Input() selectionMode: ExtraDatePickerSelectionMode = 'single'; - @Input() size: ExtraDatePickerSize = 'medium'; - @Input() showIcon = true; + @Input() size: ExtraDatePickerSize = 'base'; + @Input({ transform: booleanAttribute }) showIcon = true; @Input() iconDisplay: ExtraDatePickerIconDisplay = 'input'; - @Input() inline = false; - @Input() showButtonBar = false; - @Input() showTime = false; - @Input() hourFormat = '24'; - @Input() showClear = false; + @Input({ transform: booleanAttribute }) inline = false; + @Input({ transform: booleanAttribute }) showButtonBar = false; + @Input({ transform: booleanAttribute }) showTime = false; + @Input({ transform: (value: string | number) => String(value) }) hourFormat = '24'; + @Input({ transform: booleanAttribute }) clearable = false; @Input() placeholder: string | undefined = undefined; - @Input() readonly = false; - @Input() invalid = false; + @Input({ transform: booleanAttribute }) readonly = false; + @Input({ transform: booleanAttribute }) set invalid(value: boolean) { + this.explicitInvalid = value; + } + get invalid(): boolean { + const control = this.injector.get(NgControl, null, { self: true, optional: true }); + return this.explicitInvalid || !!(control?.invalid && (control.touched || control.dirty)); + } + @Input() label = ''; + @Input() labelPosition: 'top' | 'left' = 'top'; + @Input({ transform: booleanAttribute }) floatLabel = false; + @Input() caption = ''; + @Input() captionSeverity: ExtraCaptionSeverity = 'base'; + @Input() info = ''; + @Input({ transform: booleanAttribute }) required = false; + @Input({ transform: booleanAttribute }) fluid = false; + @Input() inputId = `extra-date-picker-${this.instanceId}`; + @Input() name: string | undefined = undefined; + @Input() autocomplete = 'off'; + @Input() ariaLabel: string | undefined = undefined; + @Input() ariaLabelledBy: string | undefined = undefined; + @Input({ transform: booleanAttribute }) autofocus = false; + @Input() tabindex: number | undefined = undefined; @Input() minDate: Date | undefined = undefined; @Input() maxDate: Date | undefined = undefined; - @Input() view: 'date' | 'month' | 'year' = 'date'; - @Input() showOtherMonths = true; - @Input() selectOtherMonths = false; + @Input() view: ExtraDatePickerView = 'day'; + @Input({ transform: booleanAttribute }) showOtherMonths = true; + @Input({ transform: booleanAttribute }) selectOtherMonths = false; @Input() hourLabel = 'Часы'; @Input() minuteLabel = 'Минуты'; @@ -240,7 +372,58 @@ export class ExtraDatePickerComponent implements ControlValueAccessor, AfterView @Output() onYearChange = new EventEmitter(); @Output() onClear = new EventEmitter(); + @Output() onInput = new EventEmitter(); + @Output() onFocus = new EventEmitter(); + @Output() onBlur = new EventEmitter(); + @Output() onShow = new EventEmitter(); + @Output() onHide = new EventEmitter(); + @Output() onTodayClick = new EventEmitter(); + @Output() onClearClick = new EventEmitter(); + + get primeView(): 'date' | 'month' | 'year' { + return this.view === 'month' || this.view === 'year' ? this.view : 'date'; + } + + get pickerClass(): string { + return [ + 'extra-date-picker-field', + `extra-date-picker-field--${this.size}`, + this.inline ? 'extra-date-picker-field--inline' : '', + this.fluid ? 'extra-date-picker-field--fluid' : '', + this.readonly ? 'extra-date-picker-field--readonly' : '', + this.floatLabel ? 'extra-date-picker-field--float' : '' + ] + .filter(Boolean) + .join(' '); + } + + validate(control: AbstractControl): ValidationErrors | null { + return this.required ? Validators.required(control) : null; + } + registerOnValidatorChange(fn: () => void): void { + this.onValidatorChange = fn; + } + ngOnChanges(changes: SimpleChanges): void { + if (changes['required']) this.onValidatorChange(); + this.syncInputAttributes(); + if (this.dpRef && this.inline) this.syncTimeInputs(); + } + private syncInputAttributes(): void { + const input = this.dpRef?.inputfieldViewChild?.nativeElement; + if (!input) return; + input.setAttribute('autocomplete', this.autocomplete); + input.setAttribute('aria-required', String(this.required)); + if (this.name) input.setAttribute('name', this.name); + else input.removeAttribute('name'); + } + + onInputBlur(event: Event): void { + this._onTouched(); + this.onBlur.emit(event); + } + constructor() { + afterEveryRender(() => this.syncInputAttributes()); // Month names come from the PrimeNG translation; rebuild them when it changes at runtime. // markForCheck also refreshes the nav button labels, which read the translation in the template this.primeng.translationObserver.pipe(takeUntilDestroyed()).subscribe(() => { @@ -256,9 +439,13 @@ export class ExtraDatePickerComponent implements ControlValueAccessor, AfterView } ngAfterViewInit(): void { + this.syncInputAttributes(); // Sync initial month/year for inline mode (panel renders immediately) if (this.inline) { - this.syncCurrentDate(); + queueMicrotask(() => { + this.syncCurrentDate(); + this.syncTimeInputs(); + }); } } @@ -268,8 +455,8 @@ export class ExtraDatePickerComponent implements ControlValueAccessor, AfterView } navAriaLabel(direction: 'prev' | 'next'): string { - const view = (this.dpRef?.currentView ?? this.view) as keyof typeof NAV_LABEL_KEYS; - return this.primeng.getTranslation(NAV_LABEL_KEYS[view][direction]); + const view = (this.dpRef?.currentView ?? this.primeView) as keyof typeof NAV_LABEL_KEYS; + return this.primeng.getTranslation((NAV_LABEL_KEYS[view] ?? NAV_LABEL_KEYS.date)[direction]); } syncCurrentDate(): void { @@ -294,19 +481,32 @@ export class ExtraDatePickerComponent implements ControlValueAccessor, AfterView onMonthSelect(month: number): void { this.dpCurrentMonth = month; this.dpRef?.createMonths(month, this.dpCurrentYear); + if (this.dpRef) this.dpRef.currentMonth = month; + this.onMonthChange.emit({ month: month + 1, year: this.dpCurrentYear }); } onYearSelect(year: number): void { this.dpCurrentYear = year; this.dpRef?.createMonths(this.dpCurrentMonth, year); + if (this.dpRef) this.dpRef.currentYear = year; + this.onYearChange.emit({ month: this.dpCurrentMonth + 1, year }); } navPrev(event: MouseEvent): void { this.dpRef?.navBackward(event); + this.syncYearNavigation(); } navNext(event: MouseEvent): void { this.dpRef?.navForward(event); + this.syncYearNavigation(); + } + + private syncYearNavigation(): void { + if (this.dpRef && this.dpRef.currentView !== 'date' && !this.disabled) { + this.syncCurrentDate(); + this.onYearChange.emit({ month: this.dpCurrentMonth + 1, year: this.dpCurrentYear }); + } } onValueChange(val: Date | Date[] | null): void { @@ -337,17 +537,21 @@ export class ExtraDatePickerComponent implements ControlValueAccessor, AfterView if (cleaned.length === 2) { const parsed = parseInt(cleaned, 10); if (!isNaN(parsed)) { - this.dpRef.currentHour = Math.min(23, Math.max(0, parsed)); + this.dpRef.currentHour = Math.min( + this.hourFormat === '12' ? 12 : 23, + Math.max(this.hourFormat === '12' ? 1 : 0, parsed) + ); } } } onHourFieldBlur(): void { const parsed = parseInt(this.hourInput, 10); - const clamped = isNaN(parsed) ? 0 : Math.min(23, Math.max(0, parsed)); + const min = this.hourFormat === '12' ? 1 : 0; + const clamped = isNaN(parsed) ? min : Math.min(this.hourFormat === '12' ? 12 : 23, Math.max(min, parsed)); this.dpRef.currentHour = clamped; this.hourInput = String(clamped).padStart(2, '0'); - (this.dpRef as any).updateTime(); + this.commitTime(); this.cdr.markForCheck(); } @@ -371,10 +575,23 @@ export class ExtraDatePickerComponent implements ControlValueAccessor, AfterView const clamped = isNaN(parsed) ? 0 : Math.min(59, Math.max(0, parsed)); this.dpRef.currentMinute = clamped; this.minuteInput = String(clamped).padStart(2, '0'); - (this.dpRef as any).updateTime(); + this.commitTime(); this.cdr.markForCheck(); } + private commitTime(): void { + if (this.selectionMode !== 'single' && (!Array.isArray(this.dpRef.value) || !this.dpRef.value.length)) return; + this.dpRef.updateTime(); + } + + toggleMeridiem(event: Event): void { + if (this.selectionMode !== 'single' && (!Array.isArray(this.dpRef.value) || !this.dpRef.value.length)) { + this.dpRef.pm = !this.dpRef.pm; + event.preventDefault(); + } else this.dpRef.toggleAMPM(event); + this.syncTimeInputs(); + } + private syncTimeInputs(): void { if (!this.dpRef) return; const h = this.dpRef.currentHour ?? 0; @@ -413,12 +630,14 @@ export class ExtraDatePickerComponent implements ControlValueAccessor, AfterView this.syncCurrentDate(); this.syncTimeInputs(); this.attachSelectOverlayGuard(); + this.onShow.emit(); if (this.selectionMode === 'range') { this.attachRangePreview(); } } onPanelClose(): void { + this.onHide.emit(); this.detachSelectOverlayGuard(); this.detachRangePreview(); this._onTouched(); @@ -435,6 +654,7 @@ export class ExtraDatePickerComponent implements ControlValueAccessor, AfterView writeValue(value: Date | Date[] | null): void { this.modelValue = value ?? null; + if (this.inline) queueMicrotask(() => this.syncTimeInputs()); this.cdr.markForCheck(); } diff --git a/src/lib/components/date-picker/date-picker.figma.md b/src/lib/components/date-picker/date-picker.figma.md index 653460f7..14a22fea 100644 --- a/src/lib/components/date-picker/date-picker.figma.md +++ b/src/lib/components/date-picker/date-picker.figma.md @@ -5,48 +5,55 @@ import: symbol: ExtraDatePickerComponent from: '@cdek-it/angular-ui-kit' figma: - fileKey: 'Khh7arsuXss3ncqy1Dz3OZ' - nodeId: '431:3069' - componentKey: '186776f4f5b0f28244809844575073296ec8c383' + fileKey: 'Q1BWgZ7zoV5UzlBOnjW0cM' + nodeId: '25178:78127' name: '' status: stable -updated: '2026-10-06' +updated: '2026-11-17' --- ## Overview `ExtraDatePickerComponent` — поле выбора даты с раскрывающимся календарём: выбор одной даты, диапазона или нескольких значений, ввод даты со временем и inline-режим. Оборачивает PrimeNG `p-datepicker`, добавляя кастомную шапку с выпадающими списками месяца и года, предпросмотр диапазона при наведении и поля ручного ввода времени. Реализует `ControlValueAccessor` и работает с `[(ngModel)]` и `[formControl]` «из коробки». -Компонент соответствует Figma-компоненту `` (component set, nodeId `431:3069`, fileKey `Khh7arsuXss3ncqy1Dz3OZ`, библиотека «UI Kit (DS) v2.0»). Варианты поля задаются Figma-свойствами `state` (`default | hover | focus | danger | disabled | readonly`), `has-placeholder` и `has-floatlabel`. Раскрывающаяся панель календаря описана отдельным Figma-узлом `` / `` и в коде рендерится PrimeNG автоматически. +Компонент соответствует Figma-компоненту `` (component set, nodeId `25178:78127`, fileKey `Q1BWgZ7zoV5UzlBOnjW0cM`, библиотека «UI Kit (DS) v3.0»). Варианты поля задаются Figma-свойствами `state` (`default | hover | focus | danger | disabled | readonly`), `has-placeholder` и `has-float-label`. Раскрывающаяся панель календаря описана отдельным Figma-узлом `` / `` и в коде рендерится PrimeNG автоматически. ## Props mapping -| Свойство | Тип | По умолчанию | Описание | -|----------|-----|--------------|---------| -| `selectionMode` | `'single' \| 'multiple' \| 'range'` | `'single'` | Режим выбора: одна дата, несколько дат или диапазон | -| `dateFormat` | `string` | `'dd.mm.yy'` | Маска формата отображаемой даты | -| `size` | `'small' \| 'medium' \| 'large' \| 'xlarge'` | `'medium'` | Размер поля; `large` и `xlarge` маппируются на PrimeNG `size="large"` | -| `showIcon` | `boolean` | `true` | Показывать иконку календаря в поле | -| `iconDisplay` | `'input' \| 'button'` | `'input'` | Расположение иконки: внутри поля или отдельной кнопкой | -| `inline` | `boolean` | `false` | Встроенный календарь без раскрывающейся панели | -| `showButtonBar` | `boolean` | `false` | Показывать панель кнопок «Сегодня» / «Очистить» | -| `showTime` | `boolean` | `false` | Включает выбор времени (часы и минуты) | -| `hourFormat` | `string` | `'24'` | Формат часов при `showTime=true` (`'24'` или `'12'`) | -| `showClear` | `boolean` | `false` | Показывает иконку очистки (×) — соответствует Figma-свойству `show-clear` | -| `placeholder` | `string \| undefined` | `undefined` | Подсказка при пустом поле — соответствует Figma-свойству `text-placeholder` / `has-placeholder` | -| `readonly` | `boolean` | `false` | Только для чтения — соответствует Figma-состоянию `state=readonly` | -| `minDate` | `Date \| undefined` | `undefined` | Минимальная доступная для выбора дата | -| `maxDate` | `Date \| undefined` | `undefined` | Максимальная доступная для выбора дата | -| `view` | `'date' \| 'month' \| 'year'` | `'date'` | Начальный режим панели: дни, месяцы или годы | -| `showOtherMonths` | `boolean` | `true` | Показывать даты соседних месяцев в сетке | -| `selectOtherMonths` | `boolean` | `false` | Разрешить выбор дат соседних месяцев | -| `hourLabel` | `string` | `'Часы'` | Подпись поля часов в блоке времени (при `showTime=true`) | -| `minuteLabel` | `string` | `'Минуты'` | Подпись поля минут в блоке времени (при `showTime=true`) | -| `(onSelect)` | `EventEmitter` | — | Событие выбора даты в сетке | -| `(onMonthChange)` | `EventEmitter` | — | Событие смены отображаемого месяца | -| `(onYearChange)` | `EventEmitter` | — | Событие смены отображаемого года | -| `(onClear)` | `EventEmitter` | — | Событие очистки значения (при `showClear=true`) | -| `[(ngModel)]` / `[formControl]` | `Date \| Date[] \| null` | `null` | Выбранное значение через ControlValueAccessor | +| Свойство | Тип | По умолчанию | Описание | +| ------------------------------- | ------------------------------------------------ | ------------ | ----------------------------------------------------------------------------------------------- | +| `label` | `string` | `''` | Текст метки | +| `labelPosition` | `'top' \| 'left'` | `'top'` | Положение метки | +| `floatLabel` | `boolean` | `false` | Плавающая метка, перекрывает labelPosition | +| `caption` | `string` | `''` | Подпись через общий ExtraCaptionComponent | +| `captionSeverity` | `ExtraCaptionSeverity` | `'base'` | Цвет и иконка подписи | +| `info` | `string` | `''` | Подсказка у метки | +| `required` | `boolean` | `false` | Обязательность через NG_VALIDATORS | +| `fluid` | `boolean` | `false` | Растяжение до ширины контейнера | +| `selectionMode` | `'single' \| 'multiple' \| 'range'` | `'single'` | Режим выбора: одна дата, несколько дат или диапазон | +| `dateFormat` | `string` | `'dd.mm.yy'` | Маска формата отображаемой даты | +| `size` | `'small' \| 'base' \| 'large' \| 'xlarge'` | `'base'` | Размер поля; `large` и `xlarge` маппируются на PrimeNG `size="large"` | +| `showIcon` | `boolean` | `true` | Показывать иконку календаря в поле | +| `iconDisplay` | `'input' \| 'button'` | `'input'` | Расположение иконки: внутри поля или отдельной кнопкой | +| `inline` | `boolean` | `false` | Встроенный календарь без раскрывающейся панели | +| `showButtonBar` | `boolean` | `false` | Показывать панель кнопок «Сегодня» / «Очистить» | +| `showTime` | `boolean` | `false` | Включает выбор времени (часы и минуты) | +| `hourFormat` | `string` | `'24'` | Формат часов при `showTime=true` (`'24'` или `'12'`) | +| `clearable` | `boolean` | `false` | Показывает иконку очистки (×) — соответствует Figma-свойству `show-clear` | +| `placeholder` | `string \| undefined` | `undefined` | Подсказка при пустом поле — соответствует Figma-свойству `text-placeholder` / `has-placeholder` | +| `readonly` | `boolean` | `false` | Только для чтения — соответствует Figma-состоянию `state=readonly` | +| `minDate` | `Date \| undefined` | `undefined` | Минимальная доступная для выбора дата | +| `maxDate` | `Date \| undefined` | `undefined` | Максимальная доступная для выбора дата | +| `view` | `'day' \| 'month' \| 'year' \| 'time' \| 'date'` | `'day'` | Начальный режим панели: дни, месяцы или годы | +| `showOtherMonths` | `boolean` | `true` | Показывать даты соседних месяцев в сетке | +| `selectOtherMonths` | `boolean` | `false` | Разрешить выбор дат соседних месяцев | +| `hourLabel` | `string` | `'Часы'` | Подпись поля часов в блоке времени (при `showTime=true`) | +| `minuteLabel` | `string` | `'Минуты'` | Подпись поля минут в блоке времени (при `showTime=true`) | +| `(onSelect)` | `EventEmitter` | — | Событие выбора даты в сетке | +| `(onMonthChange)` | `EventEmitter` | — | Событие смены отображаемого месяца | +| `(onYearChange)` | `EventEmitter` | — | Событие смены отображаемого года | +| `(onClear)` | `EventEmitter` | — | Событие очистки значения (при `clearable=true`) | +| `[(ngModel)]` / `[formControl]` | `Date \| Date[] \| null` | `null` | Выбранное значение через ControlValueAccessor | > `invalid` — управляется через связанный `NgControl` (соответствует Figma-состоянию `state=danger`). При работе с реактивными формами невалидное состояние подтягивается из валидаторов автоматически. @@ -56,19 +63,15 @@ updated: '2026-10-06' ### Single / Default (одна дата) -Figma: ``, state=default, has-placeholder=true, has-floatlabel=false — nodeId `431:3111` +Figma: ``, state=default, has-placeholder=true, has-float-label=false — nodeId `431:3111` ```html - + ``` ### Range (выбор диапазона) -Figma: ``, state=default, has-placeholder=true, has-floatlabel=false — nodeId `431:3111` +Figma: ``, state=default, has-placeholder=true, has-float-label=false — nodeId `431:3111` ```html `, state=default, has-placeholder=true, has-floatlabel=false — nodeId `431:3111` +Figma: ``, state=default, has-placeholder=true, has-float-label=false — nodeId `431:3111` ```html `, show-time=true — раскрывающаяся пане Figma: `` — раскрытая панель календаря ```html - + ``` ### С границами min/max @@ -151,7 +150,7 @@ Figma: ``, show-clear=true ```html `, show-clear=true ### Readonly (только для чтения) -Figma: ``, state=readonly, has-placeholder=true, has-floatlabel=false — nodeId `14980:36452` +Figma: ``, state=readonly, has-placeholder=true, has-float-label=false — nodeId `14980:36452` ```html - + ``` ### Disabled (отключённое поле) -Figma: ``, state=disabled, has-placeholder=true, has-floatlabel=false — nodeId `431:3070` +Figma: ``, state=disabled, has-placeholder=true, has-float-label=false — nodeId `431:3070` ```html @@ -185,17 +180,14 @@ disabledControl = new FormControl({ value: null, disabled: true }); ### Невалидное состояние (formControl + валидация) -Figma: ``, state=danger, has-placeholder=true, has-floatlabel=false — nodeId `431:3080` (невалидное состояние определяется через NgControl автоматически) +Figma: ``, state=danger, has-placeholder=true, has-float-label=false — nodeId `431:3080` (невалидное состояние определяется через NgControl автоматически) ```ts dateControl = new FormControl(null, [Validators.required]); ``` ```html - + ``` ## Slots @@ -214,6 +206,7 @@ dateControl = new FormControl(null, [Validators.required]); ## Do / Don't **Do:** + - Используйте `[(ngModel)]` или `[formControl]` — компонент реализует `ControlValueAccessor` и именно через них передаётся выбранное значение. - Для диапазона и нескольких дат задавайте `selectionMode="range"` / `selectionMode="multiple"` и храните значение как `Date[]`. - Ограничивайте доступные даты через `minDate` / `maxDate` для бронирований и дедлайнов. @@ -221,7 +214,14 @@ dateControl = new FormControl(null, [Validators.required]); - Включайте `[showTime]="true"`, когда нужно выбрать дату вместе со временем. **Don't:** + - Не задавайте `[disabled]="true"` как Input-атрибут напрямую — компонент не объявляет `@Input() disabled`; передавайте через `FormControl` или `ControlValueAccessor`. - Не используйте поле без `[(ngModel)]` / `[formControl]` — без привязки выбранное значение не синхронизируется с моделью. - Не задавайте `invalid` вручную — невалидное состояние вычисляется из связанного `NgControl`. - Не применяйте date-picker для свободного текста или приблизительной даты — используйте [InputText](../inputtext/inputtext.figma.md). + +## Migration (2026-11-17) + +**BREAKING:** `size="medium"` → `size="base"`; `[showClear]` → `[clearable]`. +Новые возможности: обёртка label/caption/info, required, fluid, FloatLabel, `view="time"` и события onInput/onFocus/onBlur/onShow/onHide/onTodayClick/onClearClick. Существующее `view="date"` поддерживается как прежнее имя режима дней; каноническое значение — `day`. +Актуальная таблица входов и событий: [datepicker.md](../../../../docs/components-api/datepicker.md). diff --git a/src/lib/providers/prime-preset/tokens/components/date-picker.ts b/src/lib/providers/prime-preset/tokens/components/date-picker.ts index 1a7307f5..47276352 100644 --- a/src/lib/providers/prime-preset/tokens/components/date-picker.ts +++ b/src/lib/providers/prime-preset/tokens/components/date-picker.ts @@ -1,13 +1,275 @@ -/** - * Кастомная CSS-стилизация для компонента p-datepicker. - * Подключается в map-tokens.ts: `import { datePickerCss } from './components/date-picker'` - */ export const datePickerCss = ({ dt }: { dt: (token: string) => string }): string => ` - -.p-datepicker.p-datepicker { +.extra-date-picker { + display: flex; + flex-direction: column; + gap: ${dt('dimension.space.100')}; + width: fit-content; + max-width: 100%; + font-family: ${dt('fonts.fontFamily.base')}; +} +.extra-date-picker-body { + display: flex; + flex-direction: column; + gap: ${dt('dimension.space.100')}; + min-width: 0; +} +.extra-date-picker--left { + flex-direction: row; + align-items: flex-start; + gap: ${dt('dimension.space.200')}; +} +.extra-date-picker--left > .extra-date-picker-label { + margin-top: ${dt('datepicker.extend.extField.paddingY')}; +} +.extra-date-picker-label { display: inline-flex; + align-items: center; + gap: ${dt('dimension.space.100')}; + font-size: ${dt('fonts.fontSize.200')}; + line-height: ${dt('fonts.lineHeight.200')}; + color: ${dt('color.fg.default')}; +} +.extra-date-picker-label .ti { + color: ${dt('color.fg.muted')}; +} +.extra-date-picker-required { + color: ${dt('color.fg.status.danger.default')}; +} +.extra-date-picker--fluid, +.extra-date-picker--fluid > .extra-date-picker-body, +.extra-date-picker-body > .p-floatlabel { + width: 100%; +} +.extra-date-picker-field.p-datepicker { position: relative; - max-width: fit-content; + width: ${dt('datepicker.extend.extField.width')}; + max-width: 100%; +} +.extra-date-picker-field--fluid.p-datepicker { + width: 100%; +} +.extra-date-picker-field .p-datepicker-input.p-inputtext { + width: 100%; + min-width: 0; + font-family: ${dt('fonts.fontFamily.base')}; + font-weight: ${dt('fonts.fontWeight.regular')}; + font-size: ${dt('datepicker.extend.extField.fontSize')}; + line-height: ${dt('datepicker.extend.extField.lineHeight')}; + padding: ${dt('datepicker.extend.extField.paddingY')} ${dt('datepicker.extend.extField.paddingX')}; + height: calc(${dt('datepicker.extend.extField.lineHeight')} + (${dt('datepicker.extend.extField.paddingY')} * 2) + (${dt('datepicker.extend.extField.borderWidth')} * 2)); + background: ${dt('datepicker.extend.extField.background')}; + color: ${dt('datepicker.extend.extField.color')}; + border: ${dt('datepicker.extend.extField.borderWidth')} solid ${dt('datepicker.extend.extField.borderColor')}; + border-radius: ${dt('datepicker.extend.extField.borderRadius')}; + box-shadow: none; +} +.extra-date-picker-field .p-datepicker-input::placeholder { + color: ${dt('datepicker.extend.extField.placeholderColor')}; +} +.extra-date-picker-field .p-datepicker-input:not(:disabled):hover { + border-color: ${dt('datepicker.extend.extField.hoverBorderColor')}; +} +.extra-date-picker-field .p-datepicker-input:enabled:focus { + border-color: ${dt('datepicker.extend.extField.hoverBorderColor')}; + box-shadow: 0 0 0 ${dt('dimension.focusRing.width')} ${dt('datepicker.extend.extField.focusRingColor')}; +} +.extra-date-picker-field .p-datepicker-input.ng-invalid { + border-color: ${dt('datepicker.extend.extField.invalidBorderColor')}; +} +.extra-date-picker-field .p-datepicker-input.ng-invalid::placeholder { + color: ${dt('datepicker.extend.extField.invalidPlaceholderColor')}; +} +.extra-date-picker-field .p-datepicker-input.ng-invalid:focus { + box-shadow: 0 0 0 ${dt('dimension.focusRing.width')} ${dt('datepicker.extend.extField.invalidFocusRingColor')}; +} +.extra-date-picker-field .p-datepicker-input:disabled { + background: ${dt('datepicker.extend.extField.disabledBackground')}; + color: ${dt('datepicker.extend.extField.disabledColor')}; + opacity: 1; +} +.extra-date-picker-field--readonly { + pointer-events: none; +} +.extra-date-picker-field--readonly .p-datepicker-input.p-inputtext { + background: ${dt('datepicker.extend.extField.readonlyBackground')}; +} +.extra-date-picker-field .p-datepicker-input-icon-container { + inset-inline-end: ${dt('datepicker.extend.extField.paddingX')}; + margin: 0; + transform: translateY(-50%); +} +.extra-date-picker-field .p-datepicker-input-icon, +.extra-date-picker-field .p-datepicker-clear-icon { + font-size: ${dt('datepicker.extend.extField.iconSize')}; + width: ${dt('datepicker.extend.extField.iconSize')}; + height: ${dt('datepicker.extend.extField.iconSize')}; + line-height: 1; +} +.extra-date-picker-field .p-datepicker-clear-icon { + margin: 0; + transform: translateY(-50%); +} +.extra-date-picker-field:has(.p-datepicker-input-icon-container) + .p-datepicker-input { + padding-inline-end: calc(${dt('datepicker.extend.extField.paddingX')} + ${dt('datepicker.extend.extField.iconSize')} + ${dt('dimension.space.100')}); +} +.extra-date-picker-field:has(.p-datepicker-clear-icon):has( + .p-datepicker-input-icon-container + ) + .p-datepicker-input { + padding-inline-end: calc( + ${dt('datepicker.extend.extField.paddingX')} + (${dt('datepicker.extend.extField.iconSize')} * 2) + (${dt('dimension.space.100')} * 2) + ); +} +.extra-date-picker-field:has(.p-datepicker-input-icon-container) + .p-datepicker-clear-icon { + inset-inline-end: calc(${dt('datepicker.extend.extField.paddingX')} + ${dt('datepicker.extend.extField.iconSize')} + ${dt('dimension.space.100')}); +} +.extra-date-picker-field.p-datepicker:has(.p-datepicker-dropdown) + .p-datepicker-dropdown { + width: calc(${dt('datepicker.extend.extField.paddingX')} * 2 + ${dt('datepicker.extend.extField.iconSize')}); +} +.extra-date-picker-field .p-datepicker-input-icon-container { + color: ${dt('datepicker.inputIcon.color')}; +} +.extra-date-picker-panel.p-datepicker-panel { + width: ${dt('datepicker.extend.panelWidth')}; + max-width: calc(100% - ${dt('dimension.space.400')} * 2); +} +.extra-date-picker-panel .p-datepicker-custom-header > .p-button, +.extra-date-picker-panel .p-datepicker-custom-header > p-button { + flex: 0 0 auto; +} +.extra-date-picker-panel .p-datepicker-title > extra-select > .p-select { + flex: 1; + min-width: 0; +} +.extra-date-picker-panel .p-datepicker-title .p-select { + min-width: 0; + width: 100%; + border-radius: ${dt('datepicker.extend.extField.borderRadius')}; +} +.extra-date-picker-panel .p-datepicker-title .p-select-label { + width: auto; + min-width: 0; + padding: ${dt('datepicker.extend.extField.sm.paddingY')} 0 ${dt('datepicker.extend.extField.sm.paddingY')} ${dt('datepicker.extend.extField.paddingX')}; + font-weight: ${dt('fonts.fontWeight.regular')}; + font-size: ${dt('datepicker.extend.extField.sm.fontSize')}; + line-height: ${dt('datepicker.extend.extField.sm.lineHeight')}; +} +.extra-date-picker-panel .p-datepicker-title .p-select-dropdown { + width: calc(${dt('datepicker.extend.extField.paddingX')} + ${dt('dimension.space.100')} + ${dt('datepicker.extend.extField.sm.iconSize')}); +} +.extra-date-picker-panel .p-datepicker-day-cell { + padding: ${dt('datepicker.date.padding')}; +} +.extra-date-picker-panel .p-datepicker-day, +.extra-date-picker-panel .p-datepicker-weekday { + line-height: ${dt('fonts.lineHeight.300')}; +} +.extra-date-picker-panel .p-datepicker-time-input.p-inputtext { + width: ${dt('datepicker.extend.extTimePicker.inputWidth')}; + height: calc(${dt('fonts.lineHeight.200')} + (${dt('dimension.space.350')} * 2) + (${dt('dimension.borderWidth.100')} * 2)); + padding: ${dt('dimension.space.350')} ${dt('dimension.space.400')}; + font-size: ${dt('fonts.fontSize.200')}; + line-height: ${dt('fonts.lineHeight.200')}; + border-radius: ${dt('datepicker.extend.extField.borderRadius')}; + border-color: ${dt('datepicker.extend.extField.borderColor')}; +} +.extra-date-picker-panel.p-datepicker-timeonly > .p-datepicker-header { + display: none; +} +.extra-date-picker-panel.p-datepicker-timeonly + .p-datepicker-time-picker-custom { + border-top: none; +} +.extra-date-picker-panel .p-datepicker-month, +.extra-date-picker-panel .p-datepicker-year { + min-height: ${dt('datepicker.extend.navSize')}; +} +.extra-date-picker-panel .p-datepicker-buttonbar .p-button { + padding: ${dt('dimension.space.200')} ${dt('dimension.space.400')}; + font-size: ${dt('fonts.fontSize.300')}; + line-height: ${dt('fonts.lineHeight.550')}; +} +.extra-date-picker-field--float .p-datepicker-input.p-inputtext { + padding-block-start: calc( + ${dt('dimension.space.300')} + ${dt('fonts.lineHeight.200')} + ${dt('dimension.space.100')} + ); + padding-block-end: ${dt('dimension.space.400')}; +} +.extra-date-picker-body > .p-floatlabel > label { + left: ${dt('datepicker.extend.extField.paddingX')}; + color: ${dt('datepicker.extend.extField.placeholderColor')}; + font-family: ${dt('fonts.fontFamily.base')}; +} +.extra-date-picker-body > .p-floatlabel:has(input:not(:focus):not(.p-filled):not(:-webkit-autofill)):not(:has(.p-inputwrapper-filled)) > label { + top: 50%; + font-size: ${dt('fonts.fontSize.200')}; + line-height: ${dt('fonts.lineHeight.400')}; + transform: translateY(-50%); +} +.extra-date-picker-body > .p-floatlabel input:not(:focus)::placeholder { + color: transparent; +} +.extra-date-picker-body > .p-floatlabel:has(input:focus) > label, +.extra-date-picker-body > .p-floatlabel:has(input:-webkit-autofill) > label, +.extra-date-picker-body > .p-floatlabel:has(.p-inputwrapper-filled) > label { + top: ${dt('dimension.space.300')}; + font-size: ${dt('fonts.fontSize.100')}; + line-height: ${dt('fonts.lineHeight.200')}; + transform: none; +} + +.extra-date-picker-field--small .p-datepicker-input.p-inputtext { + font-size: ${dt('datepicker.extend.extField.sm.fontSize')}; + line-height: ${dt('datepicker.extend.extField.sm.lineHeight')}; + padding-block: ${dt('datepicker.extend.extField.sm.paddingY')}; + height: calc(${dt('datepicker.extend.extField.sm.lineHeight')} + (${dt('datepicker.extend.extField.sm.paddingY')} * 2) + (${dt('datepicker.extend.extField.borderWidth')} * 2)); +} +.extra-date-picker-field--small .p-datepicker-input-icon, +.extra-date-picker-field--small .p-datepicker-clear-icon { + font-size: ${dt('datepicker.extend.extField.sm.iconSize')}; + width: ${dt('datepicker.extend.extField.sm.iconSize')}; + height: ${dt('datepicker.extend.extField.sm.iconSize')}; +} + +.extra-date-picker-field--large .p-datepicker-input.p-inputtext { + font-size: ${dt('datepicker.extend.extField.lg.fontSize')}; + line-height: ${dt('datepicker.extend.extField.lg.lineHeight')}; + padding-block: ${dt('datepicker.extend.extField.lg.paddingY')}; + height: calc( + ${dt('datepicker.extend.extField.lg.lineHeight')} + (${dt('datepicker.extend.extField.lg.paddingY')} * 2) + (${dt('datepicker.extend.extField.borderWidth')} * 2) + ); +} +.extra-date-picker-field--large .p-datepicker-input-icon, +.extra-date-picker-field--large .p-datepicker-clear-icon { + font-size: ${dt('datepicker.extend.extField.lg.iconSize')}; + width: ${dt('datepicker.extend.extField.lg.iconSize')}; + height: ${dt('datepicker.extend.extField.lg.iconSize')}; +} + +.extra-date-picker-field--xlarge .p-datepicker-input.p-inputtext { + font-size: ${dt('datepicker.extend.extField.xlg.fontSize')}; + line-height: ${dt('datepicker.extend.extField.xlg.lineHeight')}; + padding-block: ${dt('datepicker.extend.extField.xlg.paddingY')}; + height: calc( + ${dt('datepicker.extend.extField.xlg.lineHeight')} + (${dt('datepicker.extend.extField.xlg.paddingY')} * 2) + (${dt('datepicker.extend.extField.borderWidth')} * 2) + ); +} +.extra-date-picker-field--xlarge.p-datepicker .p-datepicker-input-icon, +.extra-date-picker-field--xlarge.p-datepicker .p-datepicker-clear-icon { + font-size: ${dt('datepicker.extend.extField.xlg.iconSize')}; + width: ${dt('datepicker.extend.extField.xlg.iconSize')}; + height: ${dt('datepicker.extend.extField.xlg.iconSize')}; +} + +.extra-date-picker-field--float.p-datepicker .p-datepicker-input.p-inputtext { + height: ${dt('datepicker.extend.extField.floatHeight')}; + padding-block-start: calc( + ${dt('dimension.space.300')} + ${dt('fonts.lineHeight.200')} + ${dt('dimension.space.100')} + ); + padding-block-end: ${dt('dimension.space.400')}; } .p-datepicker-panel.p-datepicker-panel { @@ -15,8 +277,6 @@ export const datePickerCss = ({ dt }: { dt: (token: string) => string }): string overflow: hidden; } -/* Скрываем нативный заголовок с кнопками выбора месяца/года; - кастомный заголовок (pTemplate="header") рендерится вне .p-datepicker-calendar */ .p-datepicker-calendar .p-datepicker-header { display: none; } @@ -37,7 +297,8 @@ export const datePickerCss = ({ dt }: { dt: (token: string) => string }): string display: flex; align-items: center; gap: ${dt('datepicker.title.gap')}; - min-width: ${dt('datepicker.extend.extTitle.width')}; + width: ${dt('datepicker.extend.extTitle.width')}; + min-width: 0; margin: 0 auto; } @@ -46,90 +307,94 @@ export const datePickerCss = ({ dt }: { dt: (token: string) => string }): string } .p-datepicker-custom-header .p-button.p-button { - width: ${dt('datepicker.dropdown.width')}; - height: ${dt('datepicker.dropdown.width')}; + width: ${dt('datepicker.extend.navSize')}; + height: ${dt('datepicker.extend.navSize')}; padding: 0; display: flex; align-items: center; justify-content: center; } -.p-datepicker-today.p-datepicker-today > .p-datepicker-day:not(.p-datepicker-day-selected) { - border: ${dt('dimension.size.100')} solid ${dt('datepicker.extend.extToday.borderColor')}; +.p-datepicker-today.p-datepicker-today + > .p-datepicker-day:not(.p-datepicker-day-selected) { + border: ${dt('dimension.borderWidth.100')} solid ${dt('datepicker.extend.extToday.borderColor')}; } -.p-datepicker-today.p-datepicker-today:hover > .p-datepicker-day:not(.p-datepicker-day-selected), -.p-datepicker-day-preview.p-datepicker-day-preview:not(.p-datepicker-day-selected) { +.p-datepicker-today.p-datepicker-today:hover + > .p-datepicker-day:not(.p-datepicker-day-selected), +.p-datepicker-day-preview.p-datepicker-day-preview:not( + .p-datepicker-day-selected + ) { background: ${dt('datepicker.extend.extToday.hoverBackground')}; } -.p-datepicker-day-preview.p-datepicker-day-preview:not(.p-datepicker-day-selected) { +.p-datepicker-day-preview.p-datepicker-day-preview:not( + .p-datepicker-day-selected + ) { color: ${dt('datepicker.date.color')}; } .p-datepicker-day-view.p-datepicker-day-view { - width: stretch; + width: calc(100% - (${dt('datepicker.dayView.margin')} * 2)); border-collapse: separate; - table-layout: auto; + table-layout: fixed; + border-spacing: 0; margin: ${dt('datepicker.dayView.margin')}; } .p-datepicker-weekday { font-family: ${dt('fonts.fontFamily.base')}; - font-size: ${dt('fonts.fontSize.300')}; - font-weight: ${dt('fonts.fontWeight.demibold')}; + font-size: ${dt('fonts.fontSize.200')}; + font-weight: ${dt('datepicker.weekDay.fontWeight')}; } .p-datepicker-day { font-family: ${dt('fonts.fontFamily.base')}; - font-size: ${dt('fonts.fontSize.300')}; + font-size: ${dt('fonts.fontSize.200')}; font-weight: ${dt('fonts.fontWeight.regular')}; } -.p-datepicker-time-picker.p-datepicker-time-picker:not(.p-datepicker-time-picker-custom) { +.p-datepicker-time-picker.p-datepicker-time-picker:not( + .p-datepicker-time-picker-custom + ) { display: none; } .p-datepicker-buttonbar.p-datepicker-buttonbar .p-button.p-button { background: transparent; - color: ${dt('button.colorScheme.light.text.primary.color')}; + color: ${dt('color.fg.default')}; border: 0 none; font-family: ${dt('fonts.fontFamily.heading')}; - font-weight: ${dt('button.root.label.fontWeight')}; - transition: background-color ${dt('button.root.transitionDuration')}; + font-weight: ${dt('fonts.fontWeight.regular')}; + transition: background-color ${dt('datepicker.root.transitionDuration')}; } -.p-datepicker-buttonbar.p-datepicker-buttonbar .p-button.p-button:not(:disabled):hover { - background: ${dt('button.colorScheme.light.text.primary.hoverBackground')}; - color: ${dt('button.colorScheme.light.text.primary.color')}; +.p-datepicker-buttonbar.p-datepicker-buttonbar + .p-button.p-button:not(:disabled):hover { + background: ${dt('color.bg.neutral.weak.default')}; + color: ${dt('color.fg.default')}; } -.p-datepicker-buttonbar.p-datepicker-buttonbar .p-button.p-button:not(:disabled):active { - background: ${dt('button.colorScheme.light.text.primary.activeBackground')}; - color: ${dt('button.colorScheme.light.text.primary.color')}; +.p-datepicker-buttonbar.p-datepicker-buttonbar + .p-button.p-button:not(:disabled):active { + background: ${dt('color.bg.neutral.weak.active')}; + color: ${dt('color.fg.default')}; } .p-datepicker-clear-icon { display: flex; align-items: center; - inset-inline-end: ${dt('inputtext.root.paddingX')}; + inset-inline-end: ${dt('datepicker.extend.extField.paddingX')}; color: ${dt('datepicker.inputIcon.color')}; } .p-datepicker:has(.p-datepicker-input-icon-container) .p-datepicker-clear-icon { - inset-inline-end: calc((${dt('inputtext.root.paddingX')} * 1.5) + ${dt('inputtext.extend.iconSize')}); -} - -.p-datepicker:has(.p-inputtext-lg) .p-datepicker-dropdown .p-icon, -.p-datepicker:has(.p-inputtext-lg) .p-datepicker-input-icon, -.p-datepicker:has(.p-inputtext-lg) .p-datepicker-clear-icon .ti-x { - font-size: ${dt('inputtext.root.lg.fontSize')}; - width: ${dt('inputtext.root.lg.fontSize')}; - height: ${dt('inputtext.root.lg.fontSize')}; + inset-inline-end: calc((${dt('datepicker.extend.extField.paddingX')} * 1.5) + ${dt('datepicker.extend.extField.iconSize')}); } .p-datepicker.p-datepicker:not(.p-inputwrapper-filled) .p-datepicker-clear-icon, -.p-datepicker.p-datepicker:has(.p-datepicker-input:placeholder-shown) .p-datepicker-clear-icon { +.p-datepicker.p-datepicker:has(.p-datepicker-input:placeholder-shown) + .p-datepicker-clear-icon { display: none; } @@ -139,7 +404,7 @@ export const datePickerCss = ({ dt }: { dt: (token: string) => string }): string justify-content: center; gap: ${dt('datepicker.timePicker.gap')}; padding: ${dt('datepicker.timePicker.padding')}; - border-top: ${dt('dimension.size.100')} solid ${dt('datepicker.panel.borderColor')}; + border-top: ${dt('dimension.borderWidth.100')} solid ${dt('datepicker.timePicker.borderColor')}; } .p-datepicker-time-picker-custom .p-datepicker-time-field { @@ -147,20 +412,22 @@ export const datePickerCss = ({ dt }: { dt: (token: string) => string }): string flex-direction: column; align-items: center; gap: ${dt('datepicker.timePicker.buttonGap')}; - width: auto; + min-width: ${dt('datepicker.extend.extTimePicker.minWidth')}; } .p-datepicker-time-picker-custom .p-datepicker-time-label { font-family: ${dt('fonts.fontFamily.heading')}; font-size: ${dt('fonts.fontSize.100')}; font-weight: ${dt('fonts.fontWeight.regular')}; - line-height: 1; + line-height: ${dt('fonts.lineHeight.200')}; color: ${dt('datepicker.extend.extTimePicker.color')}; } .p-datepicker-time-picker-custom .p-inputnumber, -.p-datepicker-time-picker-custom .p-datepicker-time-input.p-datepicker-time-input { - width: ${dt('datepicker.extend.extTimePicker.minWidth')}; +.p-datepicker-time-picker-custom + .p-datepicker-time-input.p-datepicker-time-input { + width: ${dt('datepicker.extend.extTimePicker.inputWidth')}; + min-width: ${dt('datepicker.extend.extTimePicker.minWidth')}; text-align: center; } @@ -168,7 +435,7 @@ export const datePickerCss = ({ dt }: { dt: (token: string) => string }): string font-family: ${dt('fonts.fontFamily.heading')}; font-size: ${dt('fonts.fontSize.100')}; font-weight: ${dt('fonts.fontWeight.regular')}; - line-height: 1; + line-height: ${dt('fonts.lineHeight.200')}; color: ${dt('datepicker.extend.extTimePicker.color')}; margin-top: calc(${dt('fonts.fontSize.100')} + ${dt('datepicker.timePicker.buttonGap')}); } @@ -178,7 +445,52 @@ export const datePickerCss = ({ dt }: { dt: (token: string) => string }): string } :is(.p-datepicker-month-select, .p-datepicker-year-select) .p-select-label { - width: ${dt('dimension.size.1000')}; + min-width: 0; +} + +.extra-date-picker-field--inline.p-datepicker { + width: ${dt('datepicker.extend.panelWidth')}; +} +.extra-date-picker-panel.p-datepicker-panel { + display: flex; + flex-direction: column; +} +.extra-date-picker-panel.p-datepicker-panel-inline { + max-width: 100%; +} +.extra-date-picker-panel .p-datepicker-weekday-cell { + height: calc(${dt('datepicker.date.height')} + ${dt('datepicker.date.padding')} * 2); +} +.extra-date-picker-panel .p-datepicker-time-picker-custom { + order: 1; +} +.extra-date-picker-panel .p-datepicker-buttonbar { + order: 2; +} +.extra-date-picker-panel .p-datepicker-buttonbar .p-button.p-button { + height: ${dt('dimension.size.1150')}; + padding: ${dt('dimension.space.200')} ${dt('dimension.space.400')}; + font-size: ${dt('fonts.fontSize.300')}; + line-height: ${dt('fonts.lineHeight.550')}; } +.extra-date-picker-panel.p-datepicker-panel { + border: 0; + outline: ${dt('dimension.borderWidth.100')} solid ${dt('datepicker.panel.borderColor')}; +} +.extra-date-picker-panel .p-datepicker-custom-header { + border-bottom: 0; + box-shadow: 0 ${dt('dimension.borderWidth.100')} 0 ${dt('datepicker.header.borderColor')}; +} +.extra-date-picker-panel .p-datepicker-time-picker-custom { + border-top: 0; + box-shadow: 0 calc(-1 * ${dt('dimension.borderWidth.100')}) 0 ${dt('datepicker.timePicker.borderColor')}; +} +.extra-date-picker-panel .p-datepicker-buttonbar { + border-top: 0; + box-shadow: 0 calc(-1 * ${dt('dimension.borderWidth.100')}) 0 ${dt('datepicker.buttonbar.borderColor')}; +} +.extra-date-picker-panel.p-datepicker-timeonly .p-datepicker-time-picker-custom { + box-shadow: none; +} `; diff --git a/src/lib/providers/prime-preset/tokens/tokens.json b/src/lib/providers/prime-preset/tokens/tokens.json index 6ab0979e..f5266b98 100644 --- a/src/lib/providers/prime-preset/tokens/tokens.json +++ b/src/lib/providers/prime-preset/tokens/tokens.json @@ -2836,11 +2836,55 @@ "borderColor": "{color.border.neutral.bold.hover}" }, "extTitle": { - "width": "{dimension.size.1900}" + "width": "{dimension.size.1600}" }, "extTimePicker": { - "minWidth": "{dimension.size.1800}", - "color": "{color.fg.default}" + "minWidth": "{dimension.size.1100}", + "color": "{color.fg.default}", + "inputWidth": "2.9375rem" + }, + "panelWidth": "25.703125rem", + "navSize": "{dimension.size.1000}", + "extField": { + "width": "{dimension.size.1600}", + "borderWidth": "{dimension.borderWidth.100}", + "borderRadius": "{dimension.borderRadius.300}", + "paddingX": "{dimension.space.350}", + "paddingY": "{dimension.space.350}", + "fontSize": "{fonts.fontSize.300}", + "lineHeight": "{fonts.lineHeight.250}", + "iconSize": "{dimension.size.450}", + "background": "{color.bg.surface.default.default}", + "color": "{color.fg.default}", + "borderColor": "{color.border.neutral.strong}", + "hoverBorderColor": "{color.border.brand.strong}", + "invalidBorderColor": "{color.border.status.danger.strong}", + "invalidPlaceholderColor": "{color.fg.status.danger.hover}", + "placeholderColor": "{color.fg.muted}", + "disabledBackground": "{color.bg.surface.canvas.hover}", + "disabledColor": "{color.fg.muted}", + "readonlyBackground": "{color.bg.neutral.weak.default}", + "focusRingColor": "{color.border.focus}", + "invalidFocusRingColor": "{color.border.status.danger.focus}", + "sm": { + "fontSize": "{fonts.fontSize.200}", + "lineHeight": "{fonts.lineHeight.200}", + "paddingY": "{dimension.space.300}", + "iconSize": "{dimension.size.400}" + }, + "lg": { + "fontSize": "{fonts.fontSize.400}", + "lineHeight": "{fonts.lineHeight.400}", + "paddingY": "{dimension.space.400}", + "iconSize": "{dimension.size.500}" + }, + "xlg": { + "fontSize": "{fonts.fontSize.500}", + "lineHeight": "{fonts.lineHeight.550}", + "paddingY": "{dimension.space.400}", + "iconSize": "{dimension.size.600}" + }, + "floatHeight": "{dimension.size.1300}" } }, "colorScheme": { @@ -2869,15 +2913,15 @@ }, "today": { "background": "transparent", - "color": "{color.fg.inverse.default}" + "color": "{color.fg.default}" } } }, "panel": { "background": "{color.bg.surface.default.default}", - "borderColor": "{color.border.neutral.default}", + "borderColor": "{color.border.neutral.strong}", "color": "{color.fg.default}", - "borderRadius": "{dimension.borderRadius.400}", + "borderRadius": "{dimension.borderRadius.300}", "shadow": "{effects.elevation.400}", "padding": "{dimension.space.none}" }, @@ -2912,7 +2956,7 @@ "style": "none", "color": "{color.border.focus}", "offset": "{dimension.focusRing.offset}", - "shadow": "{effects.elevation.200}" + "shadow": "{dimension.size.none} {dimension.size.none} {dimension.size.none} {datepicker.dropdown.focusRing.width} {datepicker.dropdown.focusRing.color}" }, "sm": { "width": "{dimension.size.none}" @@ -2937,7 +2981,7 @@ }, "weekDay": { "padding": "{dimension.space.100}", - "fontWeight": "{fonts.fontWeight.bold}", + "fontWeight": "{fonts.fontWeight.medium}", "color": "{color.fg.default}" }, "date": { @@ -2946,7 +2990,7 @@ "rangeSelectedBackground": "{color.bg.neutral.weak.default}", "color": "{color.fg.default}", "hoverColor": "{color.fg.default}", - "selectedColor": "{color.fg.on.fill.default}", + "selectedColor": "{color.fg.inverse.default}", "rangeSelectedColor": "{color.fg.default}", "width": "{dimension.size.900}", "height": "{dimension.size.900}", @@ -2957,7 +3001,7 @@ "style": "none", "color": "{color.border.focus}", "offset": "{dimension.focusRing.offset}", - "shadow": "{effects.elevation.200}" + "shadow": "{dimension.size.none} {dimension.size.none} {dimension.size.none} {datepicker.date.focusRing.width} {datepicker.date.focusRing.color}" } }, "monthView": { diff --git a/src/stories/components/date-picker/date-picker.stories.ts b/src/stories/components/date-picker/date-picker.stories.ts index 0e66789a..a13ccce8 100644 --- a/src/stories/components/date-picker/date-picker.stories.ts +++ b/src/stories/components/date-picker/date-picker.stories.ts @@ -1,41 +1,202 @@ import { Meta, StoryObj, moduleMetadata } from '@storybook/angular'; -import { FormControl, ReactiveFormsModule } from '@angular/forms'; +import { Component, ViewEncapsulation } from '@angular/core'; +import { FormControl, ReactiveFormsModule, Validators } from '@angular/forms'; +import { fn } from 'storybook/test'; import { ExtraDatePickerComponent } from '../../../lib/components/date-picker/date-picker.component'; -import { DatePickerBasicComponent } from './examples/date-picker-basic.component'; -import { DatePickerRangeComponent } from './examples/date-picker-range.component'; -import { DatePickerTimeComponent } from './examples/date-picker-time.component'; -import { DatePickerButtonBarComponent } from './examples/date-picker-button-bar.component'; -import { DatePickerInlineComponent } from './examples/date-picker-inline.component'; -import { DatePickerDisabledComponent } from './examples/date-picker-disabled.component'; -import { DatePickerInvalidComponent } from './examples/date-picker-invalid.component'; -import { DatePickerClearIconComponent } from './examples/date-picker-clear-icon.component'; -import { DatePickerLocaleComponent } from './examples/date-picker-locale.component'; -type DatePickerArgs = ExtraDatePickerComponent & { - control: FormControl; +type DatePickerArgs = Pick< + ExtraDatePickerComponent, + | 'size' + | 'selectionMode' + | 'showIcon' + | 'showButtonBar' + | 'showTime' + | 'inline' + | 'invalid' + | 'readonly' + | 'placeholder' + | 'dateFormat' + | 'hourLabel' + | 'minuteLabel' + | 'clearable' + | 'iconDisplay' + | 'minDate' + | 'maxDate' + | 'view' + | 'showOtherMonths' + | 'selectOtherMonths' + | 'label' + | 'labelPosition' + | 'floatLabel' + | 'caption' + | 'captionSeverity' + | 'info' + | 'required' + | 'fluid' + | 'inputId' + | 'name' + | 'autocomplete' + | 'ariaLabel' + | 'ariaLabelledBy' + | 'autofocus' + | 'tabindex' + | 'onSelect' + | 'onMonthChange' + | 'onYearChange' + | 'onClear' + | 'onInput' + | 'onFocus' + | 'onBlur' + | 'onShow' + | 'onHide' + | 'onTodayClick' + | 'onClearClick' +> & { hourFormat: string | number; disabled: boolean; value: Date | Date[] | number | null }; +type RenderArgs = Partial< + Omit< + DatePickerArgs, + | 'onSelect' + | 'onMonthChange' + | 'onYearChange' + | 'onClear' + | 'onInput' + | 'onFocus' + | 'onBlur' + | 'onShow' + | 'onHide' + | 'onTodayClick' + | 'onClearClick' + > +>; +const INPUTS = [ + 'size', + 'selectionMode', + 'showIcon', + 'showButtonBar', + 'showTime', + 'inline', + 'invalid', + 'readonly', + 'placeholder', + 'dateFormat', + 'hourLabel', + 'minuteLabel', + 'clearable', + 'iconDisplay', + 'hourFormat', + 'minDate', + 'maxDate', + 'view', + 'showOtherMonths', + 'selectOtherMonths', + 'label', + 'labelPosition', + 'floatLabel', + 'caption', + 'captionSeverity', + 'info', + 'required', + 'fluid', + 'inputId', + 'name', + 'autocomplete', + 'ariaLabel', + 'ariaLabelledBy', + 'autofocus', + 'tabindex' +] as const; +const SAMPLE_DATE = new Date(2026, 10, 17, 10, 30); + +@Component({ + selector: 'extra-date-picker-story-host', + standalone: true, + template: '', + encapsulation: ViewEncapsulation.None, + styles: ['extra-date-picker-story-host { display: block; width: 100%; }'] +}) +class DatePickerStoryHostComponent {} + +function componentInputs(args: RenderArgs) { + return Object.fromEntries( + INPUTS.filter((key) => key !== 'invalid' && args[key] !== undefined).map((key) => [ + key, + key === 'hourFormat' + ? String(args[key]) + : ['minDate', 'maxDate'].includes(key) && typeof args[key] === 'number' + ? new Date(args[key] as number) + : args[key] + ]) + ); +} +const DEFAULTS: Record = { + size: 'base', + selectionMode: 'single', + showIcon: true, + iconDisplay: 'input', + inline: false, + showButtonBar: false, + showTime: false, + hourFormat: '24', + clearable: false, + readonly: false, + invalid: false, + view: 'day', + showOtherMonths: true, + selectOtherMonths: false, + hourLabel: 'Часы', + minuteLabel: 'Минуты', + dateFormat: 'dd.mm.yy', + label: '', + labelPosition: 'top', + floatLabel: false, + caption: '', + captionSeverity: 'base', + info: '', + required: false, + fluid: false, + autocomplete: 'off', + autofocus: false }; +function datePickerSource(args: RenderArgs): string { + const escape = (value: string) => value.replace(/&/g, '&').replace(/"/g, '"').replace(/'; +} +function render(args: RenderArgs) { + const inputs = componentInputs(args); + let value = args.value ?? null; + if (typeof value === 'number') value = new Date(value); + if (value && !Array.isArray(value) && args.selectionMode !== 'single' && args.selectionMode !== undefined) + value = [value]; + const control = new FormControl( + { value, disabled: !!args.disabled }, + args.invalid ? Validators.required : [] + ); + if (args.invalid) control.markAsTouched(); + const bindings = Object.keys(inputs).map((key) => '[' + key + ']="' + key + '"'); + return { + props: { ...args, ...inputs, control }, + template: + '' + }; +} const meta: Meta = { title: 'Components/Form/DatePicker', component: ExtraDatePickerComponent, - tags: ['autodocs'], + tags: ['autodocs', 'datepicker'], decorators: [ - moduleMetadata({ - imports: [ - ReactiveFormsModule, - ExtraDatePickerComponent, - DatePickerBasicComponent, - DatePickerRangeComponent, - DatePickerTimeComponent, - DatePickerButtonBarComponent, - DatePickerInlineComponent, - DatePickerDisabledComponent, - DatePickerInvalidComponent, - DatePickerClearIconComponent, - DatePickerLocaleComponent, - ], - }), + moduleMetadata({ imports: [ReactiveFormsModule, ExtraDatePickerComponent, DatePickerStoryHostComponent] }) ], + render, parameters: { docs: { description: { @@ -43,23 +204,26 @@ const meta: Meta = { \`\`\`typescript import { ExtraDatePickerComponent } from '@cdek-it/angular-ui-kit'; -\`\`\``, +\`\`\`` }, + source: { + language: 'html', + type: 'dynamic', + transform: (_source: string, context: { args: RenderArgs }) => datePickerSource(context.args) + } }, - designTokens: { - prefix: '--p-datepicker', - }, + designTokens: { prefix: '--p-datepicker' } }, argTypes: { size: { control: 'select', - options: ['small', 'medium', 'large', 'xlarge'], + options: ['small', 'base', 'large', 'xlarge'], description: 'Размер поля ввода', table: { category: 'Props', - defaultValue: { summary: 'medium' }, - type: { summary: "'small' | 'medium' | 'large' | 'xlarge'" }, - }, + defaultValue: { summary: 'base' }, + type: { summary: "'small' | 'base' | 'large' | 'xlarge'" } + } }, selectionMode: { control: 'select', @@ -68,87 +232,79 @@ import { ExtraDatePickerComponent } from '@cdek-it/angular-ui-kit'; table: { category: 'Props', defaultValue: { summary: 'single' }, - type: { summary: "'single' | 'multiple' | 'range'" }, - }, + type: { summary: "'single' | 'multiple' | 'range'" } + } }, showIcon: { control: 'boolean', description: 'Отображает иконку календаря', table: { category: 'Props', - defaultValue: { summary: 'true' }, - }, - }, - showClear: { - control: 'boolean', - description: 'Отображает иконку очистки содержимого поля', - table: { - category: 'Props', - defaultValue: { summary: 'false' }, - }, + defaultValue: { summary: 'true' } + } }, showButtonBar: { control: 'boolean', description: 'Отображает кнопки «Сегодня» и «Очистить» в подвале панели', table: { category: 'Props', - defaultValue: { summary: 'false' }, - }, + defaultValue: { summary: 'false' } + } }, showTime: { control: 'boolean', description: 'Включает выбор времени', table: { category: 'Props', - defaultValue: { summary: 'false' }, - }, + defaultValue: { summary: 'false' } + } }, inline: { control: 'boolean', description: 'Отображает календарь инлайн без поля ввода', table: { category: 'Props', - defaultValue: { summary: 'false' }, - }, + defaultValue: { summary: 'false' } + } }, invalid: { control: 'boolean', description: 'Флаг невалидности поля (меняет цвет границ)', table: { category: 'Props', - defaultValue: { summary: 'false' }, - }, + defaultValue: { summary: 'false' } + } }, disabled: { control: 'boolean', description: 'Управляется через FormControl (setDisabledState)', table: { category: 'Props', - defaultValue: { summary: 'false' }, - }, + defaultValue: { summary: 'false' } + } }, readonly: { control: 'boolean', description: 'Переводит поле в режим «только чтение»', table: { category: 'Props', - defaultValue: { summary: 'false' }, - }, + defaultValue: { summary: 'false' } + } }, placeholder: { control: 'text', description: 'Текст подсказки внутри поля', table: { - category: 'Props', - }, + category: 'Props' + } }, dateFormat: { control: 'text', description: 'Формат отображения даты', table: { category: 'Props', - defaultValue: { summary: 'dd.mm.yy' }, - }, + defaultValue: { summary: 'dd.mm.yy' } + } }, hourLabel: { control: 'text', @@ -156,8 +312,8 @@ import { ExtraDatePickerComponent } from '@cdek-it/angular-ui-kit'; table: { category: 'Props', defaultValue: { summary: 'Часы' }, - type: { summary: 'string' }, - }, + type: { summary: 'string' } + } }, minuteLabel: { control: 'text', @@ -165,431 +321,219 @@ import { ExtraDatePickerComponent } from '@cdek-it/angular-ui-kit'; table: { category: 'Props', defaultValue: { summary: 'Минуты' }, - type: { summary: 'string' }, - }, + type: { summary: 'string' } + } }, onSelect: { control: false, description: 'Событие выбора даты', table: { category: 'Events', - type: { summary: 'EventEmitter' }, - }, + type: { summary: 'EventEmitter' } + } }, + clearable: { + control: 'boolean', + description: 'Отображает иконку очистки содержимого поля', + table: { + category: 'Props', + defaultValue: { summary: 'false' } + } + }, + iconDisplay: { + control: 'select', + options: ['input', 'button'], + description: 'Где показывать иконку календаря: в поле ввода или отдельной кнопкой', + table: { category: 'Props' } + }, + hourFormat: { + control: 'select', + options: [24, 12], + description: 'Формат времени: 24 или 12 часов', + table: { category: 'Props' } + }, + minDate: { control: 'date', description: 'Минимальная доступная дата', table: { category: 'Props' } }, + maxDate: { control: 'date', description: 'Максимальная доступная дата', table: { category: 'Props' } }, + view: { + control: 'select', + options: ['day', 'month', 'year', 'time', 'date'], + description: 'Начальный вид панели: день, месяц, год или время', + table: { category: 'Props' } + }, + showOtherMonths: { + control: 'boolean', + description: 'Показывать дни соседних месяцев в сетке', + table: { category: 'Props' } + }, + selectOtherMonths: { + control: 'boolean', + description: 'Разрешает выбирать дни соседних месяцев', + table: { category: 'Props' } + }, + label: { control: 'text', description: 'Подпись поля', table: { category: 'Props' } }, + labelPosition: { + control: 'select', + options: ['top', 'left'], + description: 'Положение подписи: сверху или слева', + table: { category: 'Props' } + }, + floatLabel: { + control: 'boolean', + description: 'Подпись внутри поля, всплывающая при вводе', + table: { category: 'Props' } + }, + caption: { + control: 'text', + description: 'Подпись под полем — подсказка или сообщение', + table: { category: 'Props' } + }, + captionSeverity: { + control: 'select', + options: ['base', 'danger', 'success', 'warning', 'info'], + description: 'Тон подписи: обычный, ошибка, успех, предупреждение, информация', + table: { category: 'Props' } + }, + info: { control: 'text', description: 'Дополнительная подсказка под полем', table: { category: 'Props' } }, + required: { + control: 'boolean', + description: 'Поле обязательное: невалидно, пока значение не выбрано', + table: { category: 'Props' } + }, + fluid: { + control: 'boolean', + description: 'Растягивает поле на всю ширину контейнера', + table: { category: 'Props' } + }, + inputId: { + control: 'text', + description: 'id нативного input — для связки с внешним `; - - return { - props: { ...args, control: new FormControl(null) }, - template, - }; - }, - args: { placeholder: 'Выберите дату доставки' }, - parameters: { - docs: { - description: { - story: 'Базовый пример компонента. Используйте Controls для интерактивного изменения пропсов.', - }, - }, - }, -}; - -export const Range: Story = { - render: (args) => ({ - props: { ...args, control: new FormControl(null) }, - template: commonTemplate, - }), - args: { selectionMode: 'range', placeholder: 'Период доставки' }, + args: {}, parameters: { docs: { - description: { story: 'Выбор диапазона дат для указания периода доставки.' }, - source: { - language: 'ts', - code: ` -import { Component } from '@angular/core'; -import { FormControl, ReactiveFormsModule } from '@angular/forms'; -import { ExtraDatePickerComponent } from '@cdek-it/angular-ui-kit'; - -@Component({ - selector: 'app-date-picker-range', - standalone: true, - imports: [ExtraDatePickerComponent, ReactiveFormsModule], - template: \\\` - - \\\`, -}) -export class DatePickerRangeComponent { - datesControl = new FormControl(null); -} - `, - }, - }, - }, + description: { story: 'Базовый пример компонента. Используйте Controls для интерактивного изменения пропсов.' } + } + } }; -export const Time: Story = { - render: (args) => ({ - props: { ...args, control: new FormControl(null) }, - template: commonTemplate, - }), - args: { showTime: true, placeholder: 'Дата и время отправки' }, - parameters: { - docs: { - description: { story: 'Выбор даты и времени для указания точного момента отправки.' }, - source: { - language: 'ts', - code: ` -import { Component } from '@angular/core'; -import { FormControl, ReactiveFormsModule } from '@angular/forms'; -import { ExtraDatePickerComponent } from '@cdek-it/angular-ui-kit'; - -@Component({ - selector: 'app-date-picker-time', - standalone: true, - imports: [ExtraDatePickerComponent, ReactiveFormsModule], - template: \\\` - - \\\`, -}) -export class DatePickerTimeComponent { - dateControl = new FormControl(null); -} - `, - }, - }, - }, +export const Error: Story = { + args: { invalid: true, captionSeverity: 'danger' }, + parameters: { docs: { description: { story: 'Невалидное состояние поля выбора даты.' } } } }; -export const ButtonBar: Story = { - render: (args) => ({ - props: { ...args, control: new FormControl(null) }, - template: commonTemplate, - }), - args: { showButtonBar: true, placeholder: 'Дата отгрузки' }, - parameters: { - docs: { - description: { story: 'Панель кнопок «Сегодня» и «Очистить» для быстрого выбора.' }, - source: { - language: 'ts', - code: ` -import { Component } from '@angular/core'; -import { FormControl, ReactiveFormsModule } from '@angular/forms'; -import { ExtraDatePickerComponent } from '@cdek-it/angular-ui-kit'; - -@Component({ - selector: 'app-date-picker-button-bar', - standalone: true, - imports: [ExtraDatePickerComponent, ReactiveFormsModule], - template: \\\` - - \\\`, -}) -export class DatePickerButtonBarComponent { - dateControl = new FormControl(null); -} - `, - }, - }, - }, +export const Disabled: Story = { + args: { disabled: true }, + parameters: { docs: { description: { story: 'Заблокированное поле выбора даты (через FormControl).' } } } }; -export const Inline: Story = { - render: (args) => ({ - props: { ...args, control: new FormControl(null) }, - template: commonTemplate, - }), - args: { inline: true, placeholder: undefined }, - parameters: { - docs: { - description: { story: 'Инлайн-календарь без поля ввода.' }, - source: { - language: 'ts', - code: ` -import { Component } from '@angular/core'; -import { FormControl, ReactiveFormsModule } from '@angular/forms'; -import { ExtraDatePickerComponent } from '@cdek-it/angular-ui-kit'; +export const Readonly: Story = { args: { readonly: true, value: SAMPLE_DATE } }; -@Component({ - selector: 'app-date-picker-inline', - standalone: true, - imports: [ExtraDatePickerComponent, ReactiveFormsModule], - template: \\\` - - \\\`, -}) -export class DatePickerInlineComponent { - dateControl = new FormControl(null); -} - `, - }, - }, - }, -}; +export const FloatLabel: Story = { args: { floatLabel: true } }; -export const Disabled: Story = { - render: (args) => ({ - props: { ...args, control: new FormControl({ value: null, disabled: true }) }, - template: commonTemplate, - }), - args: { placeholder: 'Дата заблокирована' }, +export const Range: Story = { + args: { selectionMode: 'range', placeholder: 'Период доставки' }, parameters: { - docs: { - description: { story: 'Заблокированное поле выбора даты (через FormControl).' }, - source: { - language: 'ts', - code: ` -import { Component } from '@angular/core'; -import { FormControl, ReactiveFormsModule } from '@angular/forms'; -import { ExtraDatePickerComponent } from '@cdek-it/angular-ui-kit'; - -@Component({ - selector: 'app-date-picker-disabled', - standalone: true, - imports: [ExtraDatePickerComponent, ReactiveFormsModule], - template: \\\` - - \\\`, -}) -export class DatePickerDisabledComponent { - dateControl = new FormControl({ value: null, disabled: true }); -} - `, - }, - }, - }, + docs: { description: { story: 'Выбор диапазона дат для указания периода доставки.' } } + } }; -export const Invalid: Story = { - render: (args) => ({ - props: { ...args, control: new FormControl(null) }, - template: commonTemplate, - }), - args: { invalid: true, placeholder: 'Некорректная дата' }, - parameters: { - docs: { - description: { story: 'Невалидное состояние поля выбора даты.' }, - source: { - language: 'ts', - code: ` -import { Component } from '@angular/core'; -import { FormControl, ReactiveFormsModule } from '@angular/forms'; -import { ExtraDatePickerComponent } from '@cdek-it/angular-ui-kit'; - -@Component({ - selector: 'app-date-picker-invalid', - standalone: true, - imports: [ExtraDatePickerComponent, ReactiveFormsModule], - template: \\\` - - \\\`, -}) -export class DatePickerInvalidComponent { - dateControl = new FormControl(null); -} - `, - }, - }, - }, +export const Clearable: Story = { + args: { clearable: true, value: SAMPLE_DATE }, + parameters: { docs: { description: { story: 'Иконка очистки для быстрого сброса выбранной даты.' } } } }; -export const ClearIcon: Story = { - render: (args) => ({ - props: { ...args, control: new FormControl(null) }, - template: commonTemplate, - }), - args: { showClear: true, placeholder: 'Дата с очисткой' }, - parameters: { - docs: { - description: { story: 'Иконка очистки для быстрого сброса выбранной даты.' }, - source: { - language: 'ts', - code: ` -import { Component } from '@angular/core'; -import { FormControl, ReactiveFormsModule } from '@angular/forms'; -import { ExtraDatePickerComponent } from '@cdek-it/angular-ui-kit'; +export const Fluid: Story = { args: { fluid: true } }; -@Component({ - selector: 'app-date-picker-clear-icon', - standalone: true, - imports: [ExtraDatePickerComponent, ReactiveFormsModule], - template: \\\` - - \\\`, -}) -export class DatePickerClearIconComponent { - dateControl = new FormControl(null); -} - `, - }, - }, - }, +export const Inline: Story = { + args: { inline: true, label: '', caption: '' }, + parameters: { docs: { description: { story: 'Инлайн-календарь без поля ввода.' } } } }; -export const Locale: Story = { - render: () => ({ - template: ``, - }), - parameters: { - controls: { disable: true }, - docs: { - description: { - story: - 'Названия месяцев и дней недели, а также подписи кнопок навигации для скринридера берутся из перевода PrimeNG и обновляются при его смене в рантайме. Подписи блока времени задаются через `hourLabel` и `minuteLabel`.', - }, - source: { - language: 'ts', - code: ` -import { Component, inject } from '@angular/core'; -import { FormControl, ReactiveFormsModule } from '@angular/forms'; -import { PrimeNG } from 'primeng/config'; -import type { Translation } from 'primeng/api'; -import { ExtraButtonComponent, ExtraDatePickerComponent } from '@cdek-it/angular-ui-kit'; -import { RU_TRANSLATION } from '@cdek-it/angular-ui-kit/providers'; - -const EN_TRANSLATION: Partial = { - today: 'Today', - clear: 'Clear', - chooseDate: 'Choose Date', - prevMonth: 'Previous Month', - nextMonth: 'Next Month', - firstDayOfWeek: 0, - dayNames: ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'], - dayNamesShort: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'], - dayNamesMin: ['Su', 'Mo', 'Tu', 'We', 'Th', 'Fr', 'Sa'], - monthNames: [ - 'January', - 'February', - 'March', - 'April', - 'May', - 'June', - 'July', - 'August', - 'September', - 'October', - 'November', - 'December' - ], - monthNamesShort: ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'] +export const Time: Story = { + args: { showTime: true }, + parameters: { docs: { description: { story: 'Выбор даты и времени для указания точного момента отправки.' } } } }; -@Component({ - selector: 'app-date-picker-locale', - standalone: true, - imports: [ExtraDatePickerComponent, ExtraButtonComponent, ReactiveFormsModule], - template: \\\` -
-
- - -
- -
- \\\`, -}) -export class DatePickerLocaleComponent { - private readonly primeng = inject(PrimeNG); - - dateControl = new FormControl(null); - lang: 'en' | 'ru' = 'en'; - - constructor() { - this.primeng.setTranslation(EN_TRANSLATION); - } +export const TimeOnly: Story = { args: { view: 'time' } }; - setLang(lang: 'en' | 'ru'): void { - this.lang = lang; - this.primeng.setTranslation(lang === 'en' ? EN_TRANSLATION : RU_TRANSLATION); - } -} - `, - }, - }, - }, +export const ButtonBar: Story = { + args: { showButtonBar: true }, + parameters: { docs: { description: { story: 'Панель кнопок «Сегодня» и «Очистить» для быстрого выбора.' } } } }; diff --git a/src/stories/components/date-picker/examples/date-picker-clear-icon.component.ts b/src/stories/components/date-picker/examples/date-picker-clear-icon.component.ts index 688b0237..68e83aea 100644 --- a/src/stories/components/date-picker/examples/date-picker-clear-icon.component.ts +++ b/src/stories/components/date-picker/examples/date-picker-clear-icon.component.ts @@ -5,7 +5,7 @@ import { ExtraDatePickerComponent } from '../../../../lib/components/date-picker const template = ` `; @@ -14,7 +14,7 @@ const template = ` selector: 'app-date-picker-clear-icon', standalone: true, imports: [ExtraDatePickerComponent, ReactiveFormsModule], - template, + template }) export class DatePickerClearIconComponent { dateControl = new FormControl(null);