From 44566ab1c295238eb08e53bdc2529036db7e4be9 Mon Sep 17 00:00:00 2001 From: Danil Khaliulin Date: Tue, 17 Nov 2026 02:38:18 +0800 Subject: [PATCH 1/4] feat(datepicker): sync styles and API with Figma MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 1. Привести геометрию поля, панели, ячеек и времени к токенам Figma в обеих темах. 2. Добавить label, caption, FloatLabel, размеры и события; переименовать medium в base и showClear в clearable. 3. Подключить ExtraSelectComponent для выбора месяца и года, сохранить локализацию и выбор диапазона. 4. Обновить документацию и двенадцать stories с динамическим кодом текущего примера и описаниями из main. Заметки для ревьюеров: - API: сохранён view=date как совместимый вариант day; required и состояния формы работают через CVA и валидаторы. - Токены: изменены только components.datepicker; общие стили и токены остальных компонентов не включены. - Поведение: FloatLabel возвращается в центр в пустом состоянии; Range показывает предварительное выделение и закрывается после выбора границ. - Проверки: API 110/110, unit 10/10, stories 12/12; общий lint недоступен из-за конфигурации и зависимостей среды. --- docs/components-api/datepicker.md | 102 ++- .../date-picker/date-picker.component.ts | 530 ++++++++---- .../date-picker/date-picker.figma.md | 114 +-- .../tokens/components/date-picker.ts | 412 ++++++++-- .../providers/prime-preset/tokens/tokens.json | 64 +- .../date-picker/date-picker.stories.ts | 773 ++++++++---------- .../examples/date-picker-basic.component.ts | 20 - .../date-picker-button-bar.component.ts | 21 - .../date-picker-clear-icon.component.ts | 21 - .../date-picker-disabled.component.ts | 20 - .../examples/date-picker-inline.component.ts | 20 - .../examples/date-picker-invalid.component.ts | 21 - .../examples/date-picker-locale.component.ts | 73 -- .../examples/date-picker-range.component.ts | 21 - .../examples/date-picker-time.component.ts | 21 - 15 files changed, 1233 insertions(+), 1000 deletions(-) delete mode 100644 src/stories/components/date-picker/examples/date-picker-basic.component.ts delete mode 100644 src/stories/components/date-picker/examples/date-picker-button-bar.component.ts delete mode 100644 src/stories/components/date-picker/examples/date-picker-clear-icon.component.ts delete mode 100644 src/stories/components/date-picker/examples/date-picker-disabled.component.ts delete mode 100644 src/stories/components/date-picker/examples/date-picker-inline.component.ts delete mode 100644 src/stories/components/date-picker/examples/date-picker-invalid.component.ts delete mode 100644 src/stories/components/date-picker/examples/date-picker-locale.component.ts delete mode 100644 src/stories/components/date-picker/examples/date-picker-range.component.ts delete mode 100644 src/stories/components/date-picker/examples/date-picker-time.component.ts 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..bd8f56d5 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,150 @@ 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'], table: { category: 'Props' } }, + hourFormat: { control: 'select', options: [24, 12], table: { category: 'Props' } }, + minDate: { control: 'date', table: { category: 'Props' } }, + maxDate: { control: 'date', table: { category: 'Props' } }, + view: { control: 'select', options: ['day', 'month', 'year', 'time', 'date'], table: { category: 'Props' } }, + showOtherMonths: { control: 'boolean', table: { category: 'Props' } }, + selectOtherMonths: { control: 'boolean', table: { category: 'Props' } }, + label: { control: 'text', table: { category: 'Props' } }, + labelPosition: { control: 'select', options: ['top', 'left'], table: { category: 'Props' } }, + floatLabel: { control: 'boolean', table: { category: 'Props' } }, + caption: { control: 'text', table: { category: 'Props' } }, + captionSeverity: { + control: 'select', + options: ['base', 'danger', 'success', 'warning', 'info'], + table: { category: 'Props' } + }, + info: { control: 'text', table: { category: 'Props' } }, + required: { control: 'boolean', table: { category: 'Props' } }, + fluid: { control: 'boolean', table: { category: 'Props' } }, + inputId: { control: 'text', table: { category: 'Props' } }, + name: { control: 'text', table: { category: 'Props' } }, + autocomplete: { control: 'text', table: { category: 'Props' } }, + ariaLabel: { control: 'text', table: { category: 'Props' } }, + ariaLabelledBy: { control: 'text', table: { category: 'Props' } }, + autofocus: { control: 'boolean', table: { category: 'Props' } }, + tabindex: { control: 'number', table: { category: 'Props' } }, + value: { control: 'date', table: { category: 'Props' } }, + onMonthChange: { control: false, table: { category: 'Events' } }, + onYearChange: { control: false, table: { category: 'Events' } }, + onClear: { control: false, table: { category: 'Events' } }, + onInput: { control: false, table: { category: 'Events' } }, + onFocus: { control: false, table: { category: 'Events' } }, + onBlur: { control: false, table: { category: 'Events' } }, + onShow: { control: false, table: { category: 'Events' } }, + onHide: { control: false, table: { category: 'Events' } }, + onTodayClick: { control: false, table: { category: 'Events' } }, + onClearClick: { control: false, table: { category: 'Events' } } }, args: { - size: 'medium', + ...DEFAULTS, + hourFormat: 24, + size: 'base', selectionMode: 'single', showIcon: true, - showClear: false, + clearable: false, showButtonBar: false, showTime: false, inline: false, invalid: false, disabled: false, readonly: false, - placeholder: 'Выберите дату доставки', + placeholder: 'Calendar', dateFormat: 'dd.mm.yy', - }, + label: 'Label', + caption: 'Caption', + info: 'Info', + required: true, + floatLabel: false, + fluid: false, + onSelect: fn(), + onMonthChange: fn(), + onYearChange: fn(), + onClear: fn(), + onInput: fn(), + onFocus: fn(), + onBlur: fn(), + onShow: fn(), + onHide: fn(), + onTodayClick: fn(), + onClearClick: fn() + } }; - -const commonTemplate = ` - -`; - export default meta; type Story = StoryObj; export const Default: Story = { - name: 'Default', - render: (args) => { - const parts: string[] = ['[formControl]="control"']; - - if (args.size && args.size !== 'medium') parts.push(`size="${args.size}"`); - if (args.selectionMode && args.selectionMode !== 'single') parts.push(`selectionMode="${args.selectionMode}"`); - if (args.placeholder) parts.push(`placeholder="${args.placeholder}"`); - if (args.dateFormat && args.dateFormat !== 'dd.mm.yy') parts.push(`dateFormat="${args.dateFormat}"`); - if (!args.showIcon) parts.push(`[showIcon]="false"`); - if (args.showClear) parts.push(`[showClear]="true"`); - if (args.showButtonBar) parts.push(`[showButtonBar]="true"`); - if (args.showTime) parts.push(`[showTime]="true"`); - if (args.inline) parts.push(`[inline]="true"`); - if (args.invalid) parts.push(`[invalid]="true"`); - if (args.readonly) parts.push(`[readonly]="true"`); - - const template = ``; - - return { - props: { ...args, control: new FormControl(null) }, - template, - }; - }, - args: { placeholder: 'Выберите дату доставки' }, + args: {}, parameters: { docs: { - description: { - story: 'Базовый пример компонента. Используйте Controls для интерактивного изменения пропсов.', - }, - }, - }, -}; - -export const Range: Story = { - render: (args) => ({ - props: { ...args, control: new FormControl(null) }, - template: commonTemplate, - }), - args: { selectionMode: 'range', 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-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'; +export const TimeOnly: Story = { args: { view: 'time' } }; - constructor() { - this.primeng.setTranslation(EN_TRANSLATION); - } - - 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-basic.component.ts b/src/stories/components/date-picker/examples/date-picker-basic.component.ts deleted file mode 100644 index 73a2b072..00000000 --- a/src/stories/components/date-picker/examples/date-picker-basic.component.ts +++ /dev/null @@ -1,20 +0,0 @@ -import { Component } from '@angular/core'; -import { FormControl, ReactiveFormsModule } from '@angular/forms'; -import { ExtraDatePickerComponent } from '../../../../lib/components/date-picker/date-picker.component'; - -const template = ` - -`; - -@Component({ - selector: 'app-date-picker-basic', - standalone: true, - imports: [ExtraDatePickerComponent, ReactiveFormsModule], - template, -}) -export class DatePickerBasicComponent { - dateControl = new FormControl(null); -} diff --git a/src/stories/components/date-picker/examples/date-picker-button-bar.component.ts b/src/stories/components/date-picker/examples/date-picker-button-bar.component.ts deleted file mode 100644 index a6ba0d33..00000000 --- a/src/stories/components/date-picker/examples/date-picker-button-bar.component.ts +++ /dev/null @@ -1,21 +0,0 @@ -import { Component } from '@angular/core'; -import { FormControl, ReactiveFormsModule } from '@angular/forms'; -import { ExtraDatePickerComponent } from '../../../../lib/components/date-picker/date-picker.component'; - -const template = ` - -`; - -@Component({ - selector: 'app-date-picker-button-bar', - standalone: true, - imports: [ExtraDatePickerComponent, ReactiveFormsModule], - template, -}) -export class DatePickerButtonBarComponent { - dateControl = new FormControl(null); -} 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 deleted file mode 100644 index 688b0237..00000000 --- a/src/stories/components/date-picker/examples/date-picker-clear-icon.component.ts +++ /dev/null @@ -1,21 +0,0 @@ -import { Component } from '@angular/core'; -import { FormControl, ReactiveFormsModule } from '@angular/forms'; -import { ExtraDatePickerComponent } from '../../../../lib/components/date-picker/date-picker.component'; - -const template = ` - -`; - -@Component({ - selector: 'app-date-picker-clear-icon', - standalone: true, - imports: [ExtraDatePickerComponent, ReactiveFormsModule], - template, -}) -export class DatePickerClearIconComponent { - dateControl = new FormControl(null); -} diff --git a/src/stories/components/date-picker/examples/date-picker-disabled.component.ts b/src/stories/components/date-picker/examples/date-picker-disabled.component.ts deleted file mode 100644 index f214e298..00000000 --- a/src/stories/components/date-picker/examples/date-picker-disabled.component.ts +++ /dev/null @@ -1,20 +0,0 @@ -import { Component } from '@angular/core'; -import { FormControl, ReactiveFormsModule } from '@angular/forms'; -import { ExtraDatePickerComponent } from '../../../../lib/components/date-picker/date-picker.component'; - -const template = ` - -`; - -@Component({ - selector: 'app-date-picker-disabled', - standalone: true, - imports: [ExtraDatePickerComponent, ReactiveFormsModule], - template, -}) -export class DatePickerDisabledComponent { - dateControl = new FormControl({ value: null, disabled: true }); -} diff --git a/src/stories/components/date-picker/examples/date-picker-inline.component.ts b/src/stories/components/date-picker/examples/date-picker-inline.component.ts deleted file mode 100644 index a36157d4..00000000 --- a/src/stories/components/date-picker/examples/date-picker-inline.component.ts +++ /dev/null @@ -1,20 +0,0 @@ -import { Component } from '@angular/core'; -import { FormControl, ReactiveFormsModule } from '@angular/forms'; -import { ExtraDatePickerComponent } from '../../../../lib/components/date-picker/date-picker.component'; - -const template = ` - -`; - -@Component({ - selector: 'app-date-picker-inline', - standalone: true, - imports: [ExtraDatePickerComponent, ReactiveFormsModule], - template, -}) -export class DatePickerInlineComponent { - dateControl = new FormControl(null); -} diff --git a/src/stories/components/date-picker/examples/date-picker-invalid.component.ts b/src/stories/components/date-picker/examples/date-picker-invalid.component.ts deleted file mode 100644 index 8486820d..00000000 --- a/src/stories/components/date-picker/examples/date-picker-invalid.component.ts +++ /dev/null @@ -1,21 +0,0 @@ -import { Component } from '@angular/core'; -import { FormControl, ReactiveFormsModule, Validators } from '@angular/forms'; -import { ExtraDatePickerComponent } from '../../../../lib/components/date-picker/date-picker.component'; - -const template = ` - -`; - -@Component({ - selector: 'app-date-picker-invalid', - standalone: true, - imports: [ExtraDatePickerComponent, ReactiveFormsModule], - template, -}) -export class DatePickerInvalidComponent { - dateControl = new FormControl(null); -} diff --git a/src/stories/components/date-picker/examples/date-picker-locale.component.ts b/src/stories/components/date-picker/examples/date-picker-locale.component.ts deleted file mode 100644 index a4593d18..00000000 --- a/src/stories/components/date-picker/examples/date-picker-locale.component.ts +++ /dev/null @@ -1,73 +0,0 @@ -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 } from '../../../../lib/components/button/button.component'; -import { ExtraDatePickerComponent } from '../../../../lib/components/date-picker/date-picker.component'; -import { RU_TRANSLATION } from '../../../../lib/providers/prime-preset/locale/ru'; - -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'] -}; - -const template = ` -
-
- - -
- -
-`; - -@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); - } - - setLang(lang: 'en' | 'ru'): void { - this.lang = lang; - this.primeng.setTranslation(lang === 'en' ? EN_TRANSLATION : RU_TRANSLATION); - } -} diff --git a/src/stories/components/date-picker/examples/date-picker-range.component.ts b/src/stories/components/date-picker/examples/date-picker-range.component.ts deleted file mode 100644 index 0ff46f8e..00000000 --- a/src/stories/components/date-picker/examples/date-picker-range.component.ts +++ /dev/null @@ -1,21 +0,0 @@ -import { Component } from '@angular/core'; -import { FormControl, ReactiveFormsModule } from '@angular/forms'; -import { ExtraDatePickerComponent } from '../../../../lib/components/date-picker/date-picker.component'; - -const template = ` - -`; - -@Component({ - selector: 'app-date-picker-range', - standalone: true, - imports: [ExtraDatePickerComponent, ReactiveFormsModule], - template, -}) -export class DatePickerRangeComponent { - datesControl = new FormControl(null); -} diff --git a/src/stories/components/date-picker/examples/date-picker-time.component.ts b/src/stories/components/date-picker/examples/date-picker-time.component.ts deleted file mode 100644 index cedc4671..00000000 --- a/src/stories/components/date-picker/examples/date-picker-time.component.ts +++ /dev/null @@ -1,21 +0,0 @@ -import { Component } from '@angular/core'; -import { FormControl, ReactiveFormsModule } from '@angular/forms'; -import { ExtraDatePickerComponent } from '../../../../lib/components/date-picker/date-picker.component'; - -const template = ` - -`; - -@Component({ - selector: 'app-date-picker-time', - standalone: true, - imports: [ExtraDatePickerComponent, ReactiveFormsModule], - template, -}) -export class DatePickerTimeComponent { - dateControl = new FormControl(null); -} From dfe448fc77e3761575983a41aec3d4a46aee13c8 Mon Sep 17 00:00:00 2001 From: Danil Khaliulin Date: Tue, 17 Nov 2026 03:00:16 +0800 Subject: [PATCH 2/4] fix(datepicker): restore standalone example components MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 1. Восстановить девять исходных файлов examples вместо лишнего удаления при обновлении stories. 2. Привести пример очистки к актуальному входу clearable. Заметки для ревьюеров: - API: публичный компонент не меняется; восстанавливаются базовый пример, состояния, диапазон, время, панель кнопок и локализация. - Stories: основной список и динамические snippets сохранены; наличие example-файлов не противоречит требованию одного отображаемого экземпляра. - Проверки: отдельная Angular-компиляция девяти примеров, TypeScript и gates snippets, descriptions и bg проходят. --- .../examples/date-picker-basic.component.ts | 20 +++++ .../date-picker-button-bar.component.ts | 21 ++++++ .../date-picker-clear-icon.component.ts | 21 ++++++ .../date-picker-disabled.component.ts | 20 +++++ .../examples/date-picker-inline.component.ts | 20 +++++ .../examples/date-picker-invalid.component.ts | 21 ++++++ .../examples/date-picker-locale.component.ts | 73 +++++++++++++++++++ .../examples/date-picker-range.component.ts | 21 ++++++ .../examples/date-picker-time.component.ts | 21 ++++++ 9 files changed, 238 insertions(+) create mode 100644 src/stories/components/date-picker/examples/date-picker-basic.component.ts create mode 100644 src/stories/components/date-picker/examples/date-picker-button-bar.component.ts create mode 100644 src/stories/components/date-picker/examples/date-picker-clear-icon.component.ts create mode 100644 src/stories/components/date-picker/examples/date-picker-disabled.component.ts create mode 100644 src/stories/components/date-picker/examples/date-picker-inline.component.ts create mode 100644 src/stories/components/date-picker/examples/date-picker-invalid.component.ts create mode 100644 src/stories/components/date-picker/examples/date-picker-locale.component.ts create mode 100644 src/stories/components/date-picker/examples/date-picker-range.component.ts create mode 100644 src/stories/components/date-picker/examples/date-picker-time.component.ts diff --git a/src/stories/components/date-picker/examples/date-picker-basic.component.ts b/src/stories/components/date-picker/examples/date-picker-basic.component.ts new file mode 100644 index 00000000..73a2b072 --- /dev/null +++ b/src/stories/components/date-picker/examples/date-picker-basic.component.ts @@ -0,0 +1,20 @@ +import { Component } from '@angular/core'; +import { FormControl, ReactiveFormsModule } from '@angular/forms'; +import { ExtraDatePickerComponent } from '../../../../lib/components/date-picker/date-picker.component'; + +const template = ` + +`; + +@Component({ + selector: 'app-date-picker-basic', + standalone: true, + imports: [ExtraDatePickerComponent, ReactiveFormsModule], + template, +}) +export class DatePickerBasicComponent { + dateControl = new FormControl(null); +} diff --git a/src/stories/components/date-picker/examples/date-picker-button-bar.component.ts b/src/stories/components/date-picker/examples/date-picker-button-bar.component.ts new file mode 100644 index 00000000..a6ba0d33 --- /dev/null +++ b/src/stories/components/date-picker/examples/date-picker-button-bar.component.ts @@ -0,0 +1,21 @@ +import { Component } from '@angular/core'; +import { FormControl, ReactiveFormsModule } from '@angular/forms'; +import { ExtraDatePickerComponent } from '../../../../lib/components/date-picker/date-picker.component'; + +const template = ` + +`; + +@Component({ + selector: 'app-date-picker-button-bar', + standalone: true, + imports: [ExtraDatePickerComponent, ReactiveFormsModule], + template, +}) +export class DatePickerButtonBarComponent { + dateControl = new FormControl(null); +} 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 new file mode 100644 index 00000000..68e83aea --- /dev/null +++ b/src/stories/components/date-picker/examples/date-picker-clear-icon.component.ts @@ -0,0 +1,21 @@ +import { Component } from '@angular/core'; +import { FormControl, ReactiveFormsModule } from '@angular/forms'; +import { ExtraDatePickerComponent } from '../../../../lib/components/date-picker/date-picker.component'; + +const template = ` + +`; + +@Component({ + selector: 'app-date-picker-clear-icon', + standalone: true, + imports: [ExtraDatePickerComponent, ReactiveFormsModule], + template +}) +export class DatePickerClearIconComponent { + dateControl = new FormControl(null); +} diff --git a/src/stories/components/date-picker/examples/date-picker-disabled.component.ts b/src/stories/components/date-picker/examples/date-picker-disabled.component.ts new file mode 100644 index 00000000..f214e298 --- /dev/null +++ b/src/stories/components/date-picker/examples/date-picker-disabled.component.ts @@ -0,0 +1,20 @@ +import { Component } from '@angular/core'; +import { FormControl, ReactiveFormsModule } from '@angular/forms'; +import { ExtraDatePickerComponent } from '../../../../lib/components/date-picker/date-picker.component'; + +const template = ` + +`; + +@Component({ + selector: 'app-date-picker-disabled', + standalone: true, + imports: [ExtraDatePickerComponent, ReactiveFormsModule], + template, +}) +export class DatePickerDisabledComponent { + dateControl = new FormControl({ value: null, disabled: true }); +} diff --git a/src/stories/components/date-picker/examples/date-picker-inline.component.ts b/src/stories/components/date-picker/examples/date-picker-inline.component.ts new file mode 100644 index 00000000..a36157d4 --- /dev/null +++ b/src/stories/components/date-picker/examples/date-picker-inline.component.ts @@ -0,0 +1,20 @@ +import { Component } from '@angular/core'; +import { FormControl, ReactiveFormsModule } from '@angular/forms'; +import { ExtraDatePickerComponent } from '../../../../lib/components/date-picker/date-picker.component'; + +const template = ` + +`; + +@Component({ + selector: 'app-date-picker-inline', + standalone: true, + imports: [ExtraDatePickerComponent, ReactiveFormsModule], + template, +}) +export class DatePickerInlineComponent { + dateControl = new FormControl(null); +} diff --git a/src/stories/components/date-picker/examples/date-picker-invalid.component.ts b/src/stories/components/date-picker/examples/date-picker-invalid.component.ts new file mode 100644 index 00000000..8486820d --- /dev/null +++ b/src/stories/components/date-picker/examples/date-picker-invalid.component.ts @@ -0,0 +1,21 @@ +import { Component } from '@angular/core'; +import { FormControl, ReactiveFormsModule, Validators } from '@angular/forms'; +import { ExtraDatePickerComponent } from '../../../../lib/components/date-picker/date-picker.component'; + +const template = ` + +`; + +@Component({ + selector: 'app-date-picker-invalid', + standalone: true, + imports: [ExtraDatePickerComponent, ReactiveFormsModule], + template, +}) +export class DatePickerInvalidComponent { + dateControl = new FormControl(null); +} diff --git a/src/stories/components/date-picker/examples/date-picker-locale.component.ts b/src/stories/components/date-picker/examples/date-picker-locale.component.ts new file mode 100644 index 00000000..a4593d18 --- /dev/null +++ b/src/stories/components/date-picker/examples/date-picker-locale.component.ts @@ -0,0 +1,73 @@ +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 } from '../../../../lib/components/button/button.component'; +import { ExtraDatePickerComponent } from '../../../../lib/components/date-picker/date-picker.component'; +import { RU_TRANSLATION } from '../../../../lib/providers/prime-preset/locale/ru'; + +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'] +}; + +const template = ` +
+
+ + +
+ +
+`; + +@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); + } + + setLang(lang: 'en' | 'ru'): void { + this.lang = lang; + this.primeng.setTranslation(lang === 'en' ? EN_TRANSLATION : RU_TRANSLATION); + } +} diff --git a/src/stories/components/date-picker/examples/date-picker-range.component.ts b/src/stories/components/date-picker/examples/date-picker-range.component.ts new file mode 100644 index 00000000..0ff46f8e --- /dev/null +++ b/src/stories/components/date-picker/examples/date-picker-range.component.ts @@ -0,0 +1,21 @@ +import { Component } from '@angular/core'; +import { FormControl, ReactiveFormsModule } from '@angular/forms'; +import { ExtraDatePickerComponent } from '../../../../lib/components/date-picker/date-picker.component'; + +const template = ` + +`; + +@Component({ + selector: 'app-date-picker-range', + standalone: true, + imports: [ExtraDatePickerComponent, ReactiveFormsModule], + template, +}) +export class DatePickerRangeComponent { + datesControl = new FormControl(null); +} diff --git a/src/stories/components/date-picker/examples/date-picker-time.component.ts b/src/stories/components/date-picker/examples/date-picker-time.component.ts new file mode 100644 index 00000000..cedc4671 --- /dev/null +++ b/src/stories/components/date-picker/examples/date-picker-time.component.ts @@ -0,0 +1,21 @@ +import { Component } from '@angular/core'; +import { FormControl, ReactiveFormsModule } from '@angular/forms'; +import { ExtraDatePickerComponent } from '../../../../lib/components/date-picker/date-picker.component'; + +const template = ` + +`; + +@Component({ + selector: 'app-date-picker-time', + standalone: true, + imports: [ExtraDatePickerComponent, ReactiveFormsModule], + template, +}) +export class DatePickerTimeComponent { + dateControl = new FormControl(null); +} From 9d518783372dd00b6c0f53fe7818dba51d2dd2bb Mon Sep 17 00:00:00 2001 From: Danil Khaliulin Date: Wed, 18 Nov 2026 13:54:08 +0200 Subject: [PATCH 3/4] chore(date-picker): show control descriptions in Controls panel MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 1. parameters.controls.expanded = true — панель Controls в Storybook 10 переключается с компактной на полную таблицу: имя, описание, тип, дефолт, контрол и группы категорий. 2. Добавлены описания 23 входов, у которых их не было (iconDisplay, hourFormat, minDate, maxDate, view, showOtherMonths, selectOtherMonths, label, labelPosition, floatLabel, caption, captionSeverity, info, required, fluid, inputId, name, autocomplete, ariaLabel, ariaLabelledBy, autofocus, tabindex, value). Существующие описания из main не тронуты. 3. Гейты: descriptions 24/24, controls 35/35, source 12/12, single 12/12. Заметки для ревьюеров: - Компонент и токены не менялись, только stories. --- .../date-picker/date-picker.stories.ts | 114 ++++++++++++++---- 1 file changed, 92 insertions(+), 22 deletions(-) diff --git a/src/stories/components/date-picker/date-picker.stories.ts b/src/stories/components/date-picker/date-picker.stories.ts index bd8f56d5..3af87a09 100644 --- a/src/stories/components/date-picker/date-picker.stories.ts +++ b/src/stories/components/date-picker/date-picker.stories.ts @@ -198,6 +198,7 @@ const meta: Meta = { ], render, parameters: { + controls: { expanded: true }, docs: { description: { component: `Компонент выбора даты и времени. Реализует \`ControlValueAccessor\` — работает с реактивными формами и \`ngModel\`. [Figma Design](https://www.figma.com/design/4TYeki0MDLhfPGJstbIicf/UI-kit-PrimeFace-(DS)?node-id=484-5726). @@ -340,33 +341,102 @@ import { ExtraDatePickerComponent } from '@cdek-it/angular-ui-kit'; defaultValue: { summary: 'false' } } }, - iconDisplay: { control: 'select', options: ['input', 'button'], table: { category: 'Props' } }, - hourFormat: { control: 'select', options: [24, 12], table: { category: 'Props' } }, - minDate: { control: 'date', table: { category: 'Props' } }, - maxDate: { control: 'date', table: { category: 'Props' } }, - view: { control: 'select', options: ['day', 'month', 'year', 'time', 'date'], table: { category: 'Props' } }, - showOtherMonths: { control: 'boolean', table: { category: 'Props' } }, - selectOtherMonths: { control: 'boolean', table: { category: 'Props' } }, - label: { control: 'text', table: { category: 'Props' } }, - labelPosition: { control: 'select', options: ['top', 'left'], table: { category: 'Props' } }, - floatLabel: { control: 'boolean', table: { category: 'Props' } }, - caption: { control: 'text', table: { category: 'Props' } }, + 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 — для связки с внешним