From 3abe076d3f51b44227f20656e1d2861b190a9bb5 Mon Sep 17 00:00:00 2001 From: Danil Khaliulin Date: Fri, 13 Nov 2026 22:55:42 +0800 Subject: [PATCH 1/4] feat(multiselect): sync styles and API with Figma MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 1. Токены multiselect приведены к эталону Figma: 26 замен (геометрия поля 272/10/12/12, размеры sm/lg, состояния, опции, группы, оверлей, иконки), extend.paddingX/paddingY удалены как дубли root-ветки (коллизия G7). 2. Токены multiselect впервые включены в пресет: map-tokens.ts спредит tokens.components.multiselect вместе с multiselectCss, раньше применялась только тема Aura с дефолтами. 3. Добавлен CSS слоя кита (multiselect.ts на dt()): раскладка обёртки label/caption, лейбл, поле с min-width 272 и ограничением max-width 100% против раздувания контентом, focus/invalid ring, readonly, xlarge-мода, FloatLabel по поведению InputText, группы uppercase, шапка панели только с фильтром. 4. API: добавлен captionSeverity (подпись через ExtraCaptionComponent с severity), required работает как NG_VALIDATORS, в floatLabel не передаётся placeholder, showHeader/showToggleAll по референсу Overlay. 5. Stories переделаны по шагу 4a: Default, Error, Disabled, Readonly, Chips, Fluid, FloatLabel — одна сторис один экземпляр; комбинаторные examples/ удалены; хост-компонент фиксирует ширину превью 272px по референсу. 6. Документация API (docs/components-api/multiselect.md) дополнена captionSeverity. Заметки для ревьюеров: - API: новый @Input captionSeverity: 'base'|'success'|'warning'|'danger'|'info' = 'base' (не ломает); required стал NG_VALIDATORS-валидатором (пустое поле = invalid, раньше был декоративным); остальные входы без изменений. - Токены: extend.paddingX/paddingY удалены осознанно — в эталоне Figma это та же переменная (один targetVariableId), PrimeUIX схлопывал оба пути в одну CSS-переменную; diff.mjs покажет 2 missing, это ожидаемо. - Токены: option.selectedFocusBackground = bg.neutral.weak.default — намеренное отклонение от эталона (medium.active) по приёмке, история итераций в comp-json/FORM/MultiSelect/CHANGES.md. - Технические детали: showHeader/showToggleAll отключают чекбокс «выбрать всё» (в референсе Overlay его нет); ширина поля в stories фиксирована хост-компонентом с encapsulation: None (scoped-стиль сториса не видит PrimeNG-разметку); поле не выходит за фиксированный родитель благодаря max-width: 100% на детях extra-multiselect-body. - Поведение FloatLabel приведено к InputText: в покое лейбл в центре вместо placeholder, при фокусе поднимается (референс Figma рисует статично поднятым — вопрос дизайну зафиксирован). --- docs/components-api/multiselect.md | 69 +-- .../multiselect/multiselect.component.ts | 19 +- src/lib/providers/prime-preset/map-tokens.ts | 5 + .../tokens/components/multiselect.ts | 175 ++++++ .../providers/prime-preset/tokens/tokens.json | 46 +- .../examples/multiselect-chips.component.ts | 77 --- .../multiselect-disabled.component.ts | 68 --- .../examples/multiselect-grouped.component.ts | 126 ---- .../examples/multiselect-invalid.component.ts | 73 --- .../examples/multiselect-labels.component.ts | 123 ---- .../multiselect/multiselect.stories.ts | 541 ++++++++++++++---- 11 files changed, 691 insertions(+), 631 deletions(-) create mode 100644 src/lib/providers/prime-preset/tokens/components/multiselect.ts delete mode 100644 src/stories/components/multiselect/examples/multiselect-chips.component.ts delete mode 100644 src/stories/components/multiselect/examples/multiselect-disabled.component.ts delete mode 100644 src/stories/components/multiselect/examples/multiselect-grouped.component.ts delete mode 100644 src/stories/components/multiselect/examples/multiselect-invalid.component.ts delete mode 100644 src/stories/components/multiselect/examples/multiselect-labels.component.ts diff --git a/docs/components-api/multiselect.md b/docs/components-api/multiselect.md index 5e87dcba..ab1dc7b9 100644 --- a/docs/components-api/multiselect.md +++ b/docs/components-api/multiselect.md @@ -4,40 +4,41 @@ > ✅ **Реализован**: `ExtraMultiSelectComponent` (`@cdek-it/angular-ui-kit`) соответствует спецификации. -| Свойство | Описание | Типизация | По умолчанию | -| --------------------- | ----------------------------------------------------------------------- | -------------------------------------------------------------- | ------------------------- | -| `placeholder` | текст подсказки внутри поля | `string` | `''` | -| `label` | текст названия поля | `string` | `''` | -| `labelPosition` | положение лейбла | `top \| left` | `top` | -| `floatLabel` | плавающий лейбл внутри поля | `boolean` | `false` | -| `showChips` | отображать выбранные значения в виде chips | `boolean` | `false` | -| `chipIcon` | класс иконки tabler icon для элементов при отображении chips | `string` | — | -| `chipClearable` | отображение иконки удаления chip | `boolean` | `true` | -| `clearable` | отображение иконки для очистки поля | `boolean` | `false` | -| `showCheckbox` | отображать чекбокс у option | `boolean` | `true` | -| `showFilter` | отображать фильтр в оверлее | `boolean` | `false` | -| `filterPlaceholder` | текст подсказки в фильтре | `string` | — | -| `options` | список элементов или список групп с элементами | `ExtraMultiSelectGroup[] \| ExtraMultiSelectOption[] \| any[]` | — | -| `optionLabel` | наименование поля, содержащего отображаемое значение | `string` | — | -| `optionValue` | наименование поля, значение которого используется как значение модели | `string` | — | -| `optionDisabled` | наименование булева поля опции, отключающего её выбор | `string` | — | -| `optionGroupLabel` | наименование поля группы, содержащего её название | `string` | — | -| `optionGroupChildren` | наименование поля группы со списком дочерних опций | `string` | `'items'` | -| `group` | включает группировку опций (данные — `ExtraMultiSelectGroup[]`) | `boolean` | `false` | -| `caption` | текст пояснения под полем | `string` | `''` | -| `info` | текст с доп. информацией (показывается в тултипе иконки ti-info-circle) | `string` | `''` | -| `size` | размер поля | `small \| base \| large \| xlarge` | `base` | -| `readonly` | только для чтения | `boolean` | `false` | -| `required` | поле обязательно для заполнения | `boolean` | `false` | -| `loading` | состояние загрузки опций | `boolean` | `false` | -| `fluid` | растягивает поле на всю ширину контейнера | `boolean` | `false` | -| `appendTo` | контейнер для отрисовки выпадающей панели | `any` | `'body'` | -| `emptyMessage` | сообщение при пустом списке опций | `string` | `'Нет данных'` | -| `emptyFilterMessage` | сообщение при отсутствии результатов фильтрации | `string` | `'Результаты не найдены'` | -| `ariaLabel` | метка для программ экранного доступа | `string` | — | -| `ariaLabelledBy` | `id` внешнего элемента-метки для доступности | `string` | — | -| `autofocus` | автофокус при монтировании компонента | `boolean` | `false` | -| `tabindex` | порядок перехода по Tab | `number` | — | +| Свойство | Описание | Типизация | По умолчанию | +| --------------------- | ------------------------------------------------------------------------------- | -------------------------------------------------------------- | ------------------------- | +| `placeholder` | текст подсказки внутри поля | `string` | `''` | +| `label` | текст названия поля | `string` | `''` | +| `labelPosition` | положение лейбла | `top \| left` | `top` | +| `floatLabel` | плавающий лейбл внутри поля | `boolean` | `false` | +| `showChips` | отображать выбранные значения в виде chips | `boolean` | `false` | +| `chipIcon` | класс иконки tabler icon для элементов при отображении chips | `string` | — | +| `chipClearable` | отображение иконки удаления chip | `boolean` | `true` | +| `clearable` | отображение иконки для очистки поля | `boolean` | `false` | +| `showCheckbox` | отображать чекбокс у option | `boolean` | `true` | +| `showFilter` | отображать фильтр в оверлее | `boolean` | `false` | +| `filterPlaceholder` | текст подсказки в фильтре | `string` | — | +| `options` | список элементов или список групп с элементами | `ExtraMultiSelectGroup[] \| ExtraMultiSelectOption[] \| any[]` | — | +| `optionLabel` | наименование поля, содержащего отображаемое значение | `string` | — | +| `optionValue` | наименование поля, значение которого используется как значение модели | `string` | — | +| `optionDisabled` | наименование булева поля опции, отключающего её выбор | `string` | — | +| `optionGroupLabel` | наименование поля группы, содержащего её название | `string` | — | +| `optionGroupChildren` | наименование поля группы со списком дочерних опций | `string` | `'items'` | +| `group` | включает группировку опций (данные — `ExtraMultiSelectGroup[]`) | `boolean` | `false` | +| `caption` | текст пояснения под полем | `string` | `''` | +| `captionSeverity` | вариант подписи (цвет и иконка): `base`, `success`, `warning`, `danger`, `info` | `ExtraCaptionSeverity` | `base` | +| `info` | текст с доп. информацией (показывается в тултипе иконки ti-info-circle) | `string` | `''` | +| `size` | размер поля | `small \| base \| large \| xlarge` | `base` | +| `readonly` | только для чтения | `boolean` | `false` | +| `required` | поле обязательно для заполнения | `boolean` | `false` | +| `loading` | состояние загрузки опций | `boolean` | `false` | +| `fluid` | растягивает поле на всю ширину контейнера | `boolean` | `false` | +| `appendTo` | контейнер для отрисовки выпадающей панели | `any` | `'body'` | +| `emptyMessage` | сообщение при пустом списке опций | `string` | `'Нет данных'` | +| `emptyFilterMessage` | сообщение при отсутствии результатов фильтрации | `string` | `'Результаты не найдены'` | +| `ariaLabel` | метка для программ экранного доступа | `string` | — | +| `ariaLabelledBy` | `id` внешнего элемента-метки для доступности | `string` | — | +| `autofocus` | автофокус при монтировании компонента | `boolean` | `false` | +| `tabindex` | порядок перехода по Tab | `number` | — | # Стекозависимые пропсы diff --git a/src/lib/components/multiselect/multiselect.component.ts b/src/lib/components/multiselect/multiselect.component.ts index 8bd30b38..82f4e996 100644 --- a/src/lib/components/multiselect/multiselect.component.ts +++ b/src/lib/components/multiselect/multiselect.component.ts @@ -27,6 +27,7 @@ import { AnimationEvent as NativeAnimationEvent } from '@angular/animations'; import { MultiSelect } from 'primeng/multiselect'; import { FloatLabel } from 'primeng/floatlabel'; import { ExtraTooltipDirective } from '@cdek-it/angular-ui-kit/components/tooltip'; +import { ExtraCaptionComponent, ExtraCaptionSeverity } from '@cdek-it/angular-ui-kit/components/caption'; import type { MultiSelectBlurEvent, MultiSelectChangeEvent, @@ -62,7 +63,15 @@ let nextInputId = 0; @Component({ selector: 'extra-multi-select', standalone: true, - imports: [MultiSelect, NgClass, NgTemplateOutlet, FormsModule, FloatLabel, ExtraTooltipDirective], + imports: [ + MultiSelect, + NgClass, + NgTemplateOutlet, + FormsModule, + FloatLabel, + ExtraTooltipDirective, + ExtraCaptionComponent + ], host: { style: 'display: contents' }, providers: [ { @@ -99,7 +108,7 @@ let nextInputId = 0; } @if (caption) { -
{{ caption }}
+ {{ caption }} } @@ -128,9 +137,11 @@ let nextInputId = 0; [optionGroupLabel]="optionGroupLabel" [optionGroupChildren]="optionGroupChildren" [group]="group" - [placeholder]="placeholder" + [placeholder]="floatLabel ? '' : placeholder" [filter]="showFilter" [filterPlaceHolder]="filterPlaceholder" + [showHeader]="showFilter" + [showToggleAll]="false" [showClear]="clearable" [display]="showChips ? 'chip' : 'comma'" [chipIcon]="chipIcon" @@ -185,6 +196,7 @@ export class ExtraMultiSelectComponent implements ControlValueAccessor, OnInit, @Input() optionGroupChildren = 'items'; @Input() group = false; @Input() caption = ''; + @Input() captionSeverity: ExtraCaptionSeverity = 'base'; @Input() info = ''; @Input() size: ExtraMultiSelectSize = 'base'; @Input() readonly = false; @@ -243,6 +255,7 @@ export class ExtraMultiSelectComponent implements ControlValueAccessor, OnInit, get multiselectClasses(): Record { return { 'p-multiselect-xlg': this.size === 'xlarge', + 'p-multiselect-readonly': this.readonly, 'p-invalid': this.invalid, 'extra-multiselect-no-checkbox': !this.showCheckbox, 'extra-multiselect-chips-locked': !this.chipClearable diff --git a/src/lib/providers/prime-preset/map-tokens.ts b/src/lib/providers/prime-preset/map-tokens.ts index 929e6bde..5f304520 100644 --- a/src/lib/providers/prime-preset/map-tokens.ts +++ b/src/lib/providers/prime-preset/map-tokens.ts @@ -19,6 +19,7 @@ import { inputgroupCss } from './tokens/components/inputgroup'; import { megamenuCss } from './tokens/components/megamenu'; import { selectCss } from './tokens/components/select'; import { messageCss } from './tokens/components/message'; +import { multiselectCss } from './tokens/components/multiselect'; import { inputotpCss } from './tokens/components/inputotp'; import { carouselCss } from './tokens/components/carousel'; import { galleriaCss } from './tokens/components/galleria'; @@ -94,6 +95,10 @@ const presetTokens: Preset = { inputmask: { css: inputmaskCss }, + multiselect: { + ...(tokens.components.multiselect as unknown as ComponentsDesignTokens['multiselect']), + css: multiselectCss + }, inputgroup: { ...(tokens.components.inputgroup as unknown as ComponentsDesignTokens['inputgroup']), css: inputgroupCss diff --git a/src/lib/providers/prime-preset/tokens/components/multiselect.ts b/src/lib/providers/prime-preset/tokens/components/multiselect.ts new file mode 100644 index 00000000..5d5d9558 --- /dev/null +++ b/src/lib/providers/prime-preset/tokens/components/multiselect.ts @@ -0,0 +1,175 @@ +export const multiselectCss = ({ dt }: { dt: (token: string) => string }): string => ` + + /* ─── Раскладка обёртки с label/caption ─── + Шаблон ExtraMultiSelectComponent оборачивает поле в .extra-multiselect только когда + задан label или caption. Без этих правил div остаётся block-элементом: inline-лейбл + при labelPosition="top" встаёт в одну строку с полем, а при "left" — выдавливается + на строку выше (labelPosition работает ровно наоборот спецификации). */ + .extra-multiselect { + display: flex; + flex-direction: column; + } + + .extra-multiselect--left { + flex-direction: row; + align-items: flex-start; + gap: ${dt('dimension.space.200')}; + } + + .extra-multiselect--left > .extra-multiselect-label { + padding-block: calc(${dt('multiselect.root.paddingY')} + ${dt('multiselect.extend.borderWidth')}); + } + + .extra-multiselect-body { + display: flex; + flex-direction: column; + /* без flex-start поле растягивается на всю ширину обёртки и игнорирует [fluid]="false" */ + align-items: flex-start; + gap: ${dt('dimension.space.100')}; + min-width: 0; + } + + /* Поле (или его p-floatlabel-обёртка) не должно вылезать за пределы фиксированного + родителя: inline-flex с min-width:auto у flex-ребёнка пускает контент шире контейнера. */ + .extra-multiselect-body > :is(.p-multiselect, .p-floatlabel) { + max-width: 100%; + } + + .extra-multiselect--left > .extra-multiselect-body { + flex: 1 1 auto; + } + + .extra-multiselect-body > .p-floatlabel:has(.p-multiselect-fluid) { + width: 100%; + } + + /* ─── Label ─── */ + .extra-multiselect-label { + display: inline-flex; + align-items: center; + gap: ${dt('dimension.space.100')}; + color: ${dt('color.fg.default')}; + font-family: ${dt('fonts.fontFamily.base')}; + font-size: ${dt('fonts.fontSize.300')}; + font-weight: ${dt('fonts.fontWeight.regular')}; + line-height: ${dt('fonts.lineHeight.300')}; + cursor: pointer; + } + + .extra-multiselect-label-icon { + color: ${dt('color.fg.subtle')}; + font-size: ${dt('multiselect.extend.iconSize')}; + cursor: help; + } + + .extra-multiselect-body > .p-floatlabel > .extra-multiselect-label { + cursor: pointer; + } + + /* ─── Поле ─── */ + .p-multiselect.p-component { + min-width: ${dt('multiselect.extend.width')}; + border-width: ${dt('multiselect.extend.borderWidth')}; + line-height: ${dt('fonts.lineHeight.250')}; + + /* multiselect.dropdown.width приходит из DS как {dimension.size.1700} = 17rem (272px): + зона chevron съедает почти всю ширину поля и выдавливает подпись в многоточие, + а .p-multiselect-clear-icon позиционируется от этой же переменной и уезжает к середине. + Переопределяем саму переменную — за ней следуют обе точки использования. */ + --p-multiselect-dropdown-width: calc(${dt('multiselect.root.paddingX')} * 2 + ${dt('multiselect.extend.iconSize')}); + } + + .p-multiselect.p-component .p-multiselect-label { + font-family: ${dt('fonts.fontFamily.base')}; + } + + .p-multiselect.p-component.p-multiselect-sm { + line-height: ${dt('fonts.lineHeight.200')}; + } + + .p-multiselect.p-component.p-multiselect-lg { + line-height: ${dt('fonts.lineHeight.400')}; + } + + /* xlarge PrimeNG не знает: обёртка ставит p-multiselect-xlg поверх large. + Мода xlarge DS (form/*): font 20, paddingX 12, paddingY 14, lineHeight 26, icon 20. */ + .p-multiselect.p-component.p-multiselect-xlg { + line-height: ${dt('fonts.lineHeight.550')}; + --p-multiselect-dropdown-width: calc(${dt('multiselect.root.paddingX')} * 2 + ${dt('dimension.size.600')}); + } + + .p-multiselect.p-component.p-multiselect-xlg .p-multiselect-label { + font-size: ${dt('fonts.fontSize.500')}; + padding-block: ${dt('dimension.space.400')}; + padding-inline: ${dt('multiselect.root.paddingX')}; + } + + .p-multiselect.p-component.p-multiselect-xlg :is(.p-multiselect-dropdown .p-icon, .p-multiselect-clear-icon, .p-multiselect-loading-icon) { + font-size: ${dt('dimension.size.600')}; + width: ${dt('dimension.size.600')}; + height: ${dt('dimension.size.600')}; + } + + .p-multiselect.p-component .p-multiselect-label.p-multiselect-label-empty { + padding: 0; + } + + /* ─── Focus ─── */ + .p-multiselect.p-component:not(.p-disabled).p-focus { + box-shadow: 0 0 0 ${dt('multiselect.root.focusRing.width')} ${dt('multiselect.root.focusRing.color')}; + } + + .p-multiselect.p-component.p-invalid.p-focus { + border-color: ${dt('multiselect.root.invalidBorderColor')}; + box-shadow: 0 0 0 ${dt('multiselect.root.focusRing.width')} ${dt('color.border.status.danger.focus')}; + } + + /* ─── Readonly ─── */ + .p-multiselect.p-component.p-multiselect-readonly { + background: ${dt('multiselect.extend.readonlyBackground')}; + border-color: ${dt('multiselect.root.borderColor')}; + color: ${dt('multiselect.root.color')}; + cursor: default; + pointer-events: none; + } + + .p-multiselect.p-component.p-multiselect-readonly :is(.p-multiselect-dropdown, .p-multiselect-clear-icon) { + color: ${dt('multiselect.root.placeholderColor')}; + } + + /* ─── Опции и группы ─── */ + .p-multiselect-option, + .p-multiselect-option-group { + font-family: ${dt('fonts.fontFamily.base')}; + } + + .p-multiselect-option-group { + text-transform: uppercase; + } + + .p-multiselect-empty-message { + font-family: ${dt('fonts.fontFamily.base')}; + } + + /* ─── FloatLabel (variant in) ─── + Поведение как у InputText: в покое лейбл стоит в центре поля вместо placeholder + (placeholder в float-режиме не передаётся), при фокусе и значении уменьшается + до 12/14 и поднимается. Геометрия значения по референсу Figma: + 10px до лейбла-зоны, лейбл 14px, 4px до значения, 14px снизу. */ + .p-floatlabel-in:has(.p-multiselect.p-component) label { + font-family: ${dt('fonts.fontFamily.base')}; + font-weight: ${dt('fonts.fontWeight.regular')}; + line-height: ${dt('fonts.lineHeight.250')}; + color: ${dt('color.fg.muted')}; + } + + .p-floatlabel-in:has(.p-multiselect.p-component) label .extra-multiselect-label-icon { + display: none; + } + + .p-floatlabel-in .p-multiselect.p-component .p-multiselect-label { + font-family: ${dt('fonts.fontFamily.base')}; + padding-block-start: calc(${dt('dimension.space.300')} + ${dt('fonts.lineHeight.200')} + ${dt('dimension.space.100')}); + padding-block-end: ${dt('dimension.space.400')}; + } +`; diff --git a/src/lib/providers/prime-preset/tokens/tokens.json b/src/lib/providers/prime-preset/tokens/tokens.json index c8cb9366..50ffe2bc 100644 --- a/src/lib/providers/prime-preset/tokens/tokens.json +++ b/src/lib/providers/prime-preset/tokens/tokens.json @@ -4243,8 +4243,6 @@ }, "multiselect": { "extend": { - "paddingX": "{dimension.space.150}", - "paddingY": "{dimension.space.150}", "borderWidth": "{dimension.borderWidth.100}", "iconSize": "{dimension.size.450}", "width": "{dimension.size.1700}", @@ -4252,25 +4250,25 @@ }, "root": { "shadow": "{effects.elevation.none}", - "paddingX": "{dimension.space.400}", - "paddingY": "{dimension.space.400}", - "borderRadius": "{dimension.borderRadius.400}", + "paddingX": "{dimension.space.350}", + "paddingY": "{dimension.space.350}", + "borderRadius": "{dimension.borderRadius.300}", "transitionDuration": "{effects.transition.duration.200}", "sm": { - "fontSize": "{fonts.fontSize.300}", - "paddingX": "{dimension.space.200}", - "paddingY": "{dimension.space.200}" + "fontSize": "{fonts.fontSize.200}", + "paddingX": "{dimension.space.350}", + "paddingY": "{dimension.space.300}" }, "lg": { - "fontSize": "{fonts.fontSize.300}", - "paddingX": "{dimension.space.400}", + "fontSize": "{fonts.fontSize.400}", + "paddingX": "{dimension.space.350}", "paddingY": "{dimension.space.400}" }, "focusRing": { "width": "{dimension.focusRing.width}", "style": "none", "offset": "{dimension.focusRing.offset}", - "shadow": "{effects.elevation.none}", + "shadow": "{effects.focusRing.none}", "color": "{color.border.focus}" }, "background": "{color.bg.surface.default.default}", @@ -4283,23 +4281,23 @@ "filledHoverBackground": "{color.bg.surface.default.default}", "focusBorderColor": "{color.border.brand.strong}", "hoverBorderColor": "{color.border.brand.strong}", - "invalidBorderColor": "{color.border.status.danger.subtle}", + "invalidBorderColor": "{color.border.status.danger.strong}", "invalidPlaceholderColor": "{color.fg.status.danger.hover}", "placeholderColor": "{color.fg.muted}" }, "dropdown": { "width": "{dimension.size.1700}", - "color": "{color.fg.active}" + "color": "{color.fg.muted}" }, "overlay": { "borderRadius": "{dimension.borderRadius.400}", "shadow": "{effects.elevation.400}", "background": "{color.bg.surface.default.default}", - "borderColor": "{color.border.neutral.default}", + "borderColor": "{color.border.neutral.strong}", "color": "{color.fg.default}" }, "list": { - "padding": "{dimension.space.100}", + "padding": "{dimension.space.200}", "header": { "padding": "{dimension.space.400} {dimension.space.400} {dimension.space.none} {dimension.space.400}" }, @@ -4309,28 +4307,28 @@ "borderRadius": "{dimension.borderRadius.200}" }, "option": { - "padding": "{dimension.space.200} {dimension.space.400}", + "padding": "{dimension.space.350} {dimension.space.300}", "borderRadius": "{dimension.borderRadius.200}", "gap": "{dimension.space.200}", "color": "{color.fg.default}", "focusBackground": "{color.bg.neutral.weak.default}", "focusColor": "{color.fg.default}", - "selectedBackground": "{color.bg.neutral.strong.selected}", - "selectedColor": "{color.fg.on.fill.default}", - "selectedFocusBackground": "{color.bg.neutral.strong.active}", - "selectedFocusColor": "{color.fg.on.fill.active}" + "selectedBackground": "{color.bg.neutral.translucent.faint}", + "selectedColor": "{color.fg.default}", + "selectedFocusBackground": "{color.bg.neutral.weak.default}", + "selectedFocusColor": "{color.fg.default}" }, "optionGroup": { - "fontWeight": "{fonts.fontWeight.demibold}", - "padding": "{dimension.space.200} {dimension.space.400}", - "background": "{color.bg.surface.raised.default}", + "fontWeight": "{fonts.fontWeight.regular}", + "padding": "{dimension.space.350} {dimension.space.300}", + "background": "{color.bg.neutral.translucent.faint}", "color": "{color.fg.muted}" }, "emptyMessage": { "padding": "{dimension.space.200} {dimension.space.400}" }, "clearIcon": { - "color": "{color.fg.active}" + "color": "{color.fg.muted}" } }, "paginator": { diff --git a/src/stories/components/multiselect/examples/multiselect-chips.component.ts b/src/stories/components/multiselect/examples/multiselect-chips.component.ts deleted file mode 100644 index 375e5b69..00000000 --- a/src/stories/components/multiselect/examples/multiselect-chips.component.ts +++ /dev/null @@ -1,77 +0,0 @@ -import { ChangeDetectionStrategy, Component } from '@angular/core'; -import { FormControl, ReactiveFormsModule } from '@angular/forms'; -import { StoryObj } from '@storybook/angular'; -import { ExtraMultiSelectComponent } from '../../../../lib/components/multiselect/multiselect.component'; - -const CITIES = [ - { name: 'Новосибирск', code: 'NSK' }, - { name: 'Москва', code: 'MSK' }, - { name: 'Санкт-Петербург', code: 'SPB' }, - { name: 'Екатеринбург', code: 'EKB' } -]; - -const template = ` - -`; - -@Component({ - selector: 'app-multiselect-chips', - standalone: true, - changeDetection: ChangeDetectionStrategy.OnPush, - imports: [ExtraMultiSelectComponent, ReactiveFormsModule], - template -}) -export class MultiSelectChipsComponent { - control = new FormControl([CITIES[0], CITIES[2]]); - cities = CITIES; -} - -export const Chips: StoryObj = { - render: () => ({ - template: `` - }), - parameters: { - controls: { disable: true }, - docs: { - description: { - story: - 'Выбранные значения отображаются как chips (`showChips`) вместо списка через запятую. Каждый chip можно удалить по крестику — событие `(onRemove)`.' - }, - source: { - language: 'ts', - code: ` -import { Component } from '@angular/core'; -import { FormControl, ReactiveFormsModule } from '@angular/forms'; -import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; - -@Component({ - standalone: true, - imports: [ExtraMultiSelectComponent, ReactiveFormsModule], - template: \` - - \`, -}) -export class MultiSelectChipsExample { - control = new FormControl(null); - cities = [ - { name: 'Новосибирск', code: 'NSK' }, - { name: 'Москва', code: 'MSK' }, - ]; -} - ` - } - } - } -}; diff --git a/src/stories/components/multiselect/examples/multiselect-disabled.component.ts b/src/stories/components/multiselect/examples/multiselect-disabled.component.ts deleted file mode 100644 index 735ccca9..00000000 --- a/src/stories/components/multiselect/examples/multiselect-disabled.component.ts +++ /dev/null @@ -1,68 +0,0 @@ -import { FormControl, ReactiveFormsModule } from '@angular/forms'; -import { StoryObj } from '@storybook/angular'; -import { ExtraMultiSelectComponent } from '../../../../lib/components/multiselect/multiselect.component'; - -const OPTIONS = [ - { name: 'Новосибирск', code: 'NSK' }, - { name: 'Москва', code: 'MSK' }, - { name: 'Санкт-Петербург', code: 'SPB' } -]; - -export const Disabled: StoryObj = { - name: 'Disabled', - render: () => { - const control = new FormControl({ value: [OPTIONS[0]], disabled: true }); - return { - props: { control, options: OPTIONS }, - template: ` - - ` - }; - }, - decorators: [ - (story: any) => ({ - ...story(), - moduleMetadata: { - imports: [ExtraMultiSelectComponent, ReactiveFormsModule] - } - }) - ], - parameters: { - controls: { disable: true }, - docs: { - description: { story: 'Отключённое состояние — управляется через FormControl.' }, - source: { - language: 'ts', - code: ` -import { Component } from '@angular/core'; -import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; - -@Component({ - standalone: true, - imports: [ExtraMultiSelectComponent, ReactiveFormsModule], - template: \` - - \`, -}) -export class MultiSelectDisabledExample { - control = new FormControl({ value: [], disabled: true }); - options = [ - { name: 'Новосибирск', code: 'NSK' }, - { name: 'Москва', code: 'MSK' }, - ]; -} - ` - } - } - } -}; diff --git a/src/stories/components/multiselect/examples/multiselect-grouped.component.ts b/src/stories/components/multiselect/examples/multiselect-grouped.component.ts deleted file mode 100644 index ffeec17b..00000000 --- a/src/stories/components/multiselect/examples/multiselect-grouped.component.ts +++ /dev/null @@ -1,126 +0,0 @@ -import { ChangeDetectionStrategy, Component, Input } from '@angular/core'; -import { FormControl, ReactiveFormsModule, Validators } from '@angular/forms'; -import { - ExtraMultiSelectComponent, - ExtraMultiSelectSize -} from '../../../../lib/components/multiselect/multiselect.component'; - -const GROUPED_OPTIONS = [ - { - name: 'Германия', - options: [ - { name: 'Берлин', code: 'BE' }, - { name: 'Франкфурт', code: 'FR' }, - { name: 'Гамбург', code: 'HA' } - ] - }, - { - name: 'США', - options: [ - { name: 'Чикаго', code: 'CH' }, - { name: 'Лос-Анджелес', code: 'LA' }, - { name: 'Нью-Йорк', code: 'NY' } - ] - } -]; - -const template = ` - -`; - -@Component({ - selector: 'app-multiselect-grouped', - standalone: true, - changeDetection: ChangeDetectionStrategy.OnPush, - imports: [ExtraMultiSelectComponent, ReactiveFormsModule], - template -}) -export class MultiSelectGroupedComponent { - @Input() size: ExtraMultiSelectSize = 'base'; - @Input() showFilter = false; - control = new FormControl(null); - options = GROUPED_OPTIONS; - - @Input() set disabled(val: boolean) { - val ? this.control.disable() : this.control.enable(); - } - - @Input() set invalid(val: boolean) { - this.control.setValidators(val ? [Validators.required] : []); - this.control.updateValueAndValidity(); - if (val) this.control.markAsTouched(); - } -} - -export const Grouped = { - render: (args: any) => ({ - props: { - size: args['size'], - showFilter: args['showFilter'], - disabled: args['disabled'], - invalid: args['invalid'] - }, - template: `` - }), - parameters: { - docs: { - description: { - story: - 'Опции, сгруппированные по категориям, через `[group]="true"` + `optionGroupLabel`/`optionGroupChildren`.' - }, - source: { - language: 'ts', - code: ` -import { Component } from '@angular/core'; -import { FormControl, ReactiveFormsModule } from '@angular/forms'; -import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; - -@Component({ - standalone: true, - imports: [ExtraMultiSelectComponent, ReactiveFormsModule], - template: \` - - \`, -}) -export class MultiSelectGroupedExample { - control = new FormControl(null); - options = [ - { - name: 'Германия', - options: [ - { name: 'Берлин', code: 'BE' }, - { name: 'Франкфурт', code: 'FR' }, - ], - }, - { - name: 'США', - options: [ - { name: 'Нью-Йорк', code: 'NY' }, - { name: 'Чикаго', code: 'CH' }, - ], - }, - ]; -} - ` - } - } - } -}; diff --git a/src/stories/components/multiselect/examples/multiselect-invalid.component.ts b/src/stories/components/multiselect/examples/multiselect-invalid.component.ts deleted file mode 100644 index 72eb5589..00000000 --- a/src/stories/components/multiselect/examples/multiselect-invalid.component.ts +++ /dev/null @@ -1,73 +0,0 @@ -import { FormControl, ReactiveFormsModule, Validators } from '@angular/forms'; -import { StoryObj } from '@storybook/angular'; -import { ExtraMultiSelectComponent } from '../../../../lib/components/multiselect/multiselect.component'; - -const OPTIONS = [ - { name: 'Новосибирск', code: 'NSK' }, - { name: 'Москва', code: 'MSK' }, - { name: 'Санкт-Петербург', code: 'SPB' } -]; - -export const Invalid: StoryObj = { - name: 'Invalid', - render: () => { - const control = new FormControl(null, Validators.required); - control.markAsTouched(); - return { - props: { control, options: OPTIONS }, - template: ` - - ` - }; - }, - decorators: [ - (story: any) => ({ - ...story(), - moduleMetadata: { - imports: [ExtraMultiSelectComponent, ReactiveFormsModule] - } - }) - ], - parameters: { - controls: { disable: true }, - docs: { - description: { - story: - 'Невалидное состояние — определяется через валидаторы `FormControl` (нужно, чтобы контрол также был touched).' - }, - source: { - language: 'ts', - code: ` -import { Component } from '@angular/core'; -import { FormControl, Validators, ReactiveFormsModule } from '@angular/forms'; -import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; - -@Component({ - standalone: true, - imports: [ExtraMultiSelectComponent, ReactiveFormsModule], - template: \` - - \`, -}) -export class MultiSelectInvalidExample { - control = new FormControl(null, Validators.required); - options = [ - { name: 'Новосибирск', code: 'NSK' }, - { name: 'Москва', code: 'MSK' }, - ]; -} - ` - } - } - } -}; diff --git a/src/stories/components/multiselect/examples/multiselect-labels.component.ts b/src/stories/components/multiselect/examples/multiselect-labels.component.ts deleted file mode 100644 index 70b487f5..00000000 --- a/src/stories/components/multiselect/examples/multiselect-labels.component.ts +++ /dev/null @@ -1,123 +0,0 @@ -import { ChangeDetectionStrategy, Component } from '@angular/core'; -import { FormControl, ReactiveFormsModule } from '@angular/forms'; -import { StoryObj } from '@storybook/angular'; -import { ExtraMultiSelectComponent } from '../../../../lib/components/multiselect/multiselect.component'; - -const CITIES = [ - { name: 'Новосибирск', code: 'NSK' }, - { name: 'Москва', code: 'MSK' }, - { name: 'Санкт-Петербург', code: 'SPB' }, - { name: 'Екатеринбург', code: 'EKB' }, - { name: 'Казань', code: 'KZN' } -]; - -const template = ` -
- - - - -
-`; - -@Component({ - selector: 'app-multiselect-labels', - standalone: true, - changeDetection: ChangeDetectionStrategy.OnPush, - imports: [ExtraMultiSelectComponent, ReactiveFormsModule], - template -}) -export class MultiSelectLabelsComponent { - control = new FormControl(null); - cities = CITIES; -} - -export const Labels: StoryObj = { - render: () => ({ - template: `` - }), - parameters: { - controls: { disable: true }, - docs: { - description: { - story: - 'Положения лейбла (labelPosition): top — сверху (по умолчанию), left — слева от поля; floatLabel — плавающий лейбл внутри поля. Info показывается иконкой ti-info-circle с тултипом, caption — пояснение под полем.' - }, - source: { - language: 'ts', - code: ` -import { Component } from '@angular/core'; -import { FormControl, ReactiveFormsModule } from '@angular/forms'; -import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; - -@Component({ - selector: 'app-multiselect-labels', - standalone: true, - imports: [ExtraMultiSelectComponent, ReactiveFormsModule], - template: \` - - - - - - \`, -}) -export class MultiSelectLabelsComponent { - control = new FormControl(null); - cities = [ - { name: 'Новосибирск', code: 'NSK' }, - { name: 'Москва', code: 'MSK' }, - ]; -} - ` - } - } - } -}; diff --git a/src/stories/components/multiselect/multiselect.stories.ts b/src/stories/components/multiselect/multiselect.stories.ts index c471f93c..f87e8228 100644 --- a/src/stories/components/multiselect/multiselect.stories.ts +++ b/src/stories/components/multiselect/multiselect.stories.ts @@ -1,13 +1,31 @@ +import { ChangeDetectionStrategy, Component, ViewEncapsulation } from '@angular/core'; import { Meta, moduleMetadata, StoryObj } from '@storybook/angular'; import { FormControl, ReactiveFormsModule, Validators } from '@angular/forms'; import { ExtraMultiSelectComponent } from '../../../lib/components/multiselect/multiselect.component'; -import { MultiSelectLabelsComponent, Labels } from './examples/multiselect-labels.component'; -import { MultiSelectGroupedComponent, Grouped } from './examples/multiselect-grouped.component'; -import { MultiSelectChipsComponent, Chips } from './examples/multiselect-chips.component'; -import { Disabled } from './examples/multiselect-disabled.component'; -import { Invalid } from './examples/multiselect-invalid.component'; -const CITIES = [ +/** Хост-обёртка сториса: фиксирует ширину поля шириной референса Figma (272px). + * encapsulation: None — стили должны действовать на PrimeNG-разметку внутри extra-multi-select, + * обычный scoped-стиль сториса её не видит. */ +@Component({ + selector: 'multiselect-story-host', + standalone: true, + imports: [ExtraMultiSelectComponent], + encapsulation: ViewEncapsulation.None, + changeDetection: ChangeDetectionStrategy.OnPush, + template: `
`, + styles: ` + .multiselect-story-fix { + width: 272px; + } + + .multiselect-story-fix .p-multiselect { + width: 100%; + } + ` +}) +class MultiSelectStoryHostComponent {} + +const OPTIONS = [ { name: 'Новосибирск', code: 'NSK' }, { name: 'Москва', code: 'MSK' }, { name: 'Санкт-Петербург', code: 'SPB' }, @@ -15,7 +33,11 @@ const CITIES = [ { name: 'Казань', code: 'KZN' } ]; -type MultiSelectArgs = ExtraMultiSelectComponent & { disabled: boolean; invalid: boolean }; +type MultiSelectArgs = ExtraMultiSelectComponent & { + disabled: boolean; + invalid: boolean; + value: { name: string; code: string }[]; +}; const meta: Meta = { title: 'Components/Form/MultiSelect', @@ -23,13 +45,7 @@ const meta: Meta = { tags: ['autodocs'], decorators: [ moduleMetadata({ - imports: [ - ExtraMultiSelectComponent, - ReactiveFormsModule, - MultiSelectLabelsComponent, - MultiSelectGroupedComponent, - MultiSelectChipsComponent - ] + imports: [ExtraMultiSelectComponent, ReactiveFormsModule, MultiSelectStoryHostComponent] }) ], parameters: { @@ -38,25 +54,18 @@ const meta: Meta = { description: { component: `Выпадающий список для выбора нескольких значений из набора опций. Поддерживает чекбоксы у опций, отображение выбранных значений как chips, группировку и фильтрацию. -Реализован по спецификации \`docs/components-api/multiselect.md\`. +Реализовано по спецификации [multiselect.md](https://github.com/cdek-it/angular-ui-kit/blob/main/docs/components-api/multiselect.md). \`\`\`typescript import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; -\`\`\`` +\`\`\` + +Значение подключается через \`[(ngModel)]\` или \`[formControl]\` (ControlValueAccessor). Состояния disabled и invalid управляются через FormControl.` } } }, argTypes: { - // ── Свойства ───────────────────────────────────────────── - placeholder: { - control: 'text', - description: 'Текст подсказки при пустом поле', - table: { - category: 'Свойства', - defaultValue: { summary: "''" }, - type: { summary: 'string' } - } - }, + // ── Свойства (docs/components-api/multiselect.md) ───────────────────── label: { control: 'text', description: 'Текст названия поля', @@ -78,7 +87,7 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; }, floatLabel: { control: 'boolean', - description: 'Плавающий лейбл внутри поля', + description: 'Лейбл-плейсхолдер, всплывающий над полем при фокусе/значении', table: { category: 'Свойства', defaultValue: { summary: 'false' }, @@ -87,7 +96,7 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; }, showChips: { control: 'boolean', - description: 'Отображать выбранные значения в виде chips вместо списка через запятую', + description: 'Выбранные значения в виде chips вместо строки через запятую', table: { category: 'Свойства', defaultValue: { summary: 'false' }, @@ -96,7 +105,7 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; }, chipClearable: { control: 'boolean', - description: 'Отображение иконки удаления chip (при showChips)', + description: 'Иконка удаления у chip (при showChips)', table: { category: 'Свойства', defaultValue: { summary: 'true' }, @@ -105,7 +114,7 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; }, clearable: { control: 'boolean', - description: 'Отображение иконки для очистки всего поля', + description: 'Иконка очистки всего поля', table: { category: 'Свойства', defaultValue: { summary: 'false' }, @@ -114,7 +123,7 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; }, showCheckbox: { control: 'boolean', - description: 'Отображать чекбокс у каждой опции в панели', + description: 'Чекбокс у каждой опции в панели', table: { category: 'Свойства', defaultValue: { summary: 'true' }, @@ -123,13 +132,21 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; }, showFilter: { control: 'boolean', - description: 'Отображать строку поиска в выпадающей панели', + description: 'Строка поиска в выпадающей панели', table: { category: 'Свойства', defaultValue: { summary: 'false' }, type: { summary: 'boolean' } } }, + filterPlaceholder: { + control: 'text', + description: 'Подсказка в строке поиска (при showFilter)', + table: { + category: 'Свойства', + type: { summary: 'string' } + } + }, caption: { control: 'text', description: 'Текст пояснения под полем', @@ -139,9 +156,28 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; type: { summary: 'string' } } }, + captionSeverity: { + control: 'select', + options: ['base', 'success', 'warning', 'danger', 'info'], + description: 'Вариант подписи (цвет и иконка), Figma `_` variant', + table: { + category: 'Свойства', + defaultValue: { summary: "'base'" }, + type: { summary: "'base' | 'success' | 'warning' | 'danger' | 'info'" } + } + }, info: { control: 'text', - description: 'Текст с доп. информацией (показывается в тултипе иконки ti-info-circle)', + description: 'Текст тултипа иконки рядом с лейблом', + table: { + category: 'Свойства', + defaultValue: { summary: "''" }, + type: { summary: 'string' } + } + }, + placeholder: { + control: 'text', + description: 'Подсказка при пустом поле', table: { category: 'Свойства', defaultValue: { summary: "''" }, @@ -160,7 +196,7 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; }, readonly: { control: 'boolean', - description: 'Режим только для чтения', + description: 'Только для чтения', table: { category: 'Свойства', defaultValue: { summary: 'false' }, @@ -169,7 +205,7 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; }, loading: { control: 'boolean', - description: 'Состояние загрузки опций', + description: 'Индикатор загрузки вместо chevron', table: { category: 'Свойства', defaultValue: { summary: 'false' }, @@ -178,73 +214,170 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; }, fluid: { control: 'boolean', - description: 'Растягивает поле на всю ширину контейнера', + description: 'Растягивать поле на всю ширину контейнера', table: { category: 'Свойства', defaultValue: { summary: 'false' }, type: { summary: 'boolean' } } }, - // Hidden props (заданы через рендер Default, не выносятся в Controls) - options: { table: { disable: true } }, - optionLabel: { table: { disable: true } }, - optionValue: { table: { disable: true } }, - optionDisabled: { table: { disable: true } }, - optionGroupLabel: { table: { disable: true } }, - optionGroupChildren: { table: { disable: true } }, - group: { table: { disable: true } }, - chipIcon: { table: { disable: true } }, - filterPlaceholder: { table: { disable: true } }, - appendTo: { table: { disable: true } }, - emptyMessage: { table: { disable: true } }, - emptyFilterMessage: { table: { disable: true } }, - // ── Состояния (управляются через FormControl) ───────────── - disabled: { + required: { control: 'boolean', - description: 'Отключает взаимодействие — управляется через FormControl', + description: 'Поле обязательно для заполнения (NG_VALIDATORS)', table: { - category: 'Состояния', + category: 'Свойства', defaultValue: { summary: 'false' }, type: { summary: 'boolean' } } }, - invalid: { + group: { control: 'boolean', - description: 'Невалидное состояние — вычисляется из NgControl (Validators)', + description: 'Группировка опций (options с группами)', table: { - category: 'Состояния', + category: 'Данные', defaultValue: { summary: 'false' }, type: { summary: 'boolean' } } }, - // Hidden computed/internal members - modelValue: { table: { disable: true } }, - multiselectClasses: { table: { disable: true } }, + // ── Данные ───────────────────────────────────────────────────────────── + options: { + control: 'object', + description: 'Массив опций или групп', + table: { + category: 'Данные', + type: { summary: 'ExtraMultiSelectOption[] | ExtraMultiSelectGroup[]' } + } + }, + optionLabel: { + control: 'text', + description: 'Поле опции с текстом', + table: { + category: 'Данные', + defaultValue: { summary: 'undefined' }, + type: { summary: 'string' } + } + }, + optionValue: { + control: 'text', + description: 'Поле опции со значением', + table: { + category: 'Данные', + type: { summary: 'string' } + } + }, + optionDisabled: { + control: 'text', + description: 'Поле опции с признаком disabled', + table: { + category: 'Данные', + type: { summary: 'string' } + } + }, + optionGroupLabel: { + control: 'text', + description: 'Поле группы с заголовком', + table: { + category: 'Данные', + type: { summary: 'string' } + } + }, + optionGroupChildren: { + control: 'text', + description: 'Поле группы со списком опций', + table: { + category: 'Данные', + defaultValue: { summary: "'items'" }, + type: { summary: 'string' } + } + }, + // ── Дополнительно ────────────────────────────────────────────────────── + ariaLabel: { + control: 'text', + description: 'Метка для программ экранного доступа', + table: { + category: 'Дополнительно', + type: { summary: 'string' } + } + }, + ariaLabelledBy: { + control: 'text', + description: 'ID внешнего элемента-метки', + table: { + category: 'Дополнительно', + type: { summary: 'string' } + } + }, + autofocus: { + control: 'boolean', + description: 'Автофокус при монтировании поля', + table: { + category: 'Дополнительно', + defaultValue: { summary: 'false' }, + type: { summary: 'boolean' } + } + }, + tabindex: { + control: { type: 'number', step: 1 }, + description: 'Порядок перехода по Tab', + table: { + category: 'Дополнительно', + type: { summary: 'number' } + } + }, + appendTo: { + control: 'text', + description: "Куда рендерить панель ('body' или CSS-селектор)", + table: { + category: 'Дополнительно', + defaultValue: { summary: "'body'" }, + type: { summary: 'string' } + } + }, + emptyMessage: { + control: 'text', + description: 'Текст пустого списка', + table: { + category: 'Дополнительно', + defaultValue: { summary: "'Нет данных'" }, + type: { summary: 'string' } + } + }, + emptyFilterMessage: { + control: 'text', + description: 'Текст при пустом результате фильтра', + table: { + category: 'Дополнительно', + defaultValue: { summary: "'Результаты не найдены'" }, + type: { summary: 'string' } + } + }, + // ── Внутренние (не контролируются) ───────────────────────────────────── + chipIcon: { + control: 'text', + description: 'Иконка chip (переопределяется шаблоном)', + table: { category: 'Дополнительно', type: { summary: 'string' } } + }, primeSize: { table: { disable: true } }, + multiselectClasses: { table: { disable: true } }, inputId: { table: { disable: true } }, - writeValue: { table: { disable: true } }, - registerOnChange: { table: { disable: true } }, - registerOnTouched: { table: { disable: true } }, - setDisabledState: { table: { disable: true } }, - handleChange: { table: { disable: true } }, - handleClear: { table: { disable: true } }, - handleRemove: { table: { disable: true } }, - handleFocus: { table: { disable: true } }, - handleBlur: { table: { disable: true } }, - // ── События ──────────────────────────────────────────────── + invalid: { table: { disable: true } }, + disabled: { table: { disable: true } }, + modelValue: { table: { disable: true } }, + // ── Состояния (управляются через FormControl) ────────────────────────── + // ── События ──────────────────────────────────────────────────────────── onChange: { control: false, - description: 'Срабатывает при изменении выбора', + description: 'Срабатывает при выборе значения', table: { category: 'События', type: { summary: 'EventEmitter' } } }, onFilter: { control: false, - description: 'Срабатывает при вводе в строку фильтра', + description: 'Срабатывает при вводе в строку поиска', table: { category: 'События', type: { summary: 'EventEmitter' } } }, onClear: { control: false, - description: 'Срабатывает при очистке всех значений', + description: 'Срабатывает при очистке поля', table: { category: 'События', type: { summary: 'EventEmitter' } } }, onShow: { @@ -274,8 +407,7 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; } }, args: { - placeholder: 'Выберите города', - label: '', + label: 'Label', labelPosition: 'top', floatLabel: false, showChips: false, @@ -283,58 +415,261 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; clearable: false, showCheckbox: true, showFilter: false, - caption: '', - info: '', + filterPlaceholder: undefined, + caption: 'Caption', + captionSeverity: 'base', + info: 'Info', + placeholder: 'Placeholder', size: 'base', readonly: false, loading: false, fluid: false, + required: false, + group: false, + options: OPTIONS, + optionLabel: 'name', + optionValue: undefined, + optionDisabled: undefined, + optionGroupLabel: undefined, + optionGroupChildren: 'items', + ariaLabel: undefined, + ariaLabelledBy: undefined, + autofocus: false, + tabindex: undefined, + appendTo: 'body', + emptyMessage: 'Нет данных', + emptyFilterMessage: 'Результаты не найдены', + chipIcon: undefined, disabled: false, - invalid: false + invalid: false, + value: [] } }; export default meta; type Story = StoryObj; +// ── Один рендер компонента: все свойства настраиваются в Controls ──────────── +interface RenderArgs { + label?: string; + labelPosition?: string; + floatLabel?: boolean; + showChips?: boolean; + chipClearable?: boolean; + clearable?: boolean; + showCheckbox?: boolean; + showFilter?: boolean; + filterPlaceholder?: string; + caption?: string; + captionSeverity?: string; + info?: string; + placeholder?: string; + size?: string; + readonly?: boolean; + loading?: boolean; + fluid?: boolean; + required?: boolean; + group?: boolean; + ariaLabel?: string; + ariaLabelledBy?: string; + autofocus?: boolean; + tabindex?: number; + optionLabel?: string; + invalid?: boolean; + disabled?: boolean; + value?: { name: string; code: string }[]; +} + +const renderMultiSelect = (args: RenderArgs, forced: { floatLabel?: boolean; showChips?: boolean } = {}) => { + const a = { ...args, ...forced }; + const parts: string[] = []; + + if (a.label) parts.push(`label="${a.label}"`); + if (a.labelPosition && a.labelPosition !== 'top') parts.push(`labelPosition="${a.labelPosition}"`); + if (a.floatLabel) parts.push(`[floatLabel]="true"`); + if (a.showChips) parts.push(`[showChips]="true"`); + if (!a.chipClearable) parts.push(`[chipClearable]="false"`); + if (a.clearable) parts.push(`[clearable]="true"`); + if (!a.showCheckbox) parts.push(`[showCheckbox]="false"`); + if (a.showFilter) parts.push(`[showFilter]="true"`); + if (a.filterPlaceholder) parts.push(`filterPlaceholder="${a.filterPlaceholder}"`); + if (a.caption) parts.push(`caption="${a.caption}"`); + if (a.captionSeverity && a.captionSeverity !== 'base') parts.push(`captionSeverity="${a.captionSeverity}"`); + if (a.info) parts.push(`info="${a.info}"`); + if (a.placeholder) parts.push(`placeholder="${a.placeholder}"`); + if (a.size && a.size !== 'base') parts.push(`size="${a.size}"`); + if (a.readonly) parts.push(`[readonly]="true"`); + if (a.loading) parts.push(`[loading]="true"`); + if (a.fluid) parts.push(`[fluid]="true"`); + if (a.required) parts.push(`required`); + if (a.group) parts.push(`[group]="true" optionGroupLabel="name"`); + if (a.ariaLabel) parts.push(`ariaLabel="${a.ariaLabel}"`); + if (a.ariaLabelledBy) parts.push(`ariaLabelledBy="${a.ariaLabelledBy}"`); + if (a.autofocus) parts.push(`[autofocus]="true"`); + if (a.tabindex != null) parts.push(`[tabindex]="${a.tabindex}"`); + if (a.optionLabel) parts.push(`optionLabel="${a.optionLabel}"`); + + const validators = a.invalid ? [Validators.required] : []; + const control = new FormControl({ value: a.value ?? null, disabled: !!a.disabled }, validators); + if (a.invalid) control.markAsTouched(); + + const options = a.group + ? [ + { name: 'Группа 1', items: OPTIONS.slice(0, 2) }, + { name: 'Группа 2', items: OPTIONS.slice(2) } + ] + : OPTIONS; + + // Ширина поля в примерах зафиксирована шириной референса Figma (272px): сверки идут 1:1 + // с макетом, поле не растягивается на всё превью и не раздувается контентом (chips/список + // значений уходят в ellipsis). Fluid-пример — без обёртки: там поле обязано занять контейнер. + const template = `${a.fluid ? '' : ''}${a.fluid ? '' : ''}`; + + // invalid и disabled живут во FormControl: у компонента invalid — геттер без сеттера, + // и Storybook на попытке его присвоить роняет ошибку в консоль + return { props: { control, options }, template }; +}; + // ── Default ────────────────────────────────────────────────────────────────── export const Default: Story = { name: 'Default', - render: (args) => { - const parts: string[] = []; + render: (args) => renderMultiSelect(args), + parameters: { + docs: { + description: { + story: + 'Поле с лейблом сверху (labelPosition="top") или слева (labelPosition="left"). Размер (small, base, large, xlarge), chips, caption, info, фильтр, группировка, fluid, readonly, disabled и invalid меняются в Controls; disabled и invalid управляются через FormControl.' + }, + source: { + language: 'html', + code: ` + - if (args.label) parts.push(`label="${args.label}"`); - if (args.labelPosition && args.labelPosition !== 'top') parts.push(`labelPosition="${args.labelPosition}"`); - if (args.floatLabel) parts.push(`[floatLabel]="true"`); - if (args.showChips) parts.push(`[showChips]="true"`); - if (!args.chipClearable) parts.push(`[chipClearable]="false"`); - if (args.clearable) parts.push(`[clearable]="true"`); - if (!args.showCheckbox) parts.push(`[showCheckbox]="false"`); - if (args.showFilter) parts.push(`[showFilter]="true"`); - if (args.caption) parts.push(`caption="${args.caption}"`); - if (args.info) parts.push(`info="${args.info}"`); - if (args.placeholder) parts.push(`placeholder="${args.placeholder}"`); - if (args.size && args.size !== 'base') parts.push(`size="${args.size}"`); - if (args.readonly) parts.push(`[readonly]="true"`); - if (args.loading) parts.push(`[loading]="true"`); - if (args.fluid) parts.push(`[fluid]="true"`); + + - const validators = args.invalid ? [Validators.required] : []; - const control = new FormControl({ value: null, disabled: args.disabled }, validators); - if (args.invalid) control.markAsTouched(); + + - const template = ``; + + - return { props: { ...args, control, options: CITIES }, template }; - }, + + + + + + +control = new FormControl({ value: null, disabled: true }); +control = new FormControl(null, Validators.required); + + +` + } + } + } +}; + +// ── Error / Disabled / Readonly / Chips / Fluid: пресеты Figma ─────────────── +export const Error: Story = { + name: 'Error', + args: { invalid: true }, + render: (args) => renderMultiSelect(args), + parameters: { + docs: { + description: { story: 'Figma `state=danger`. Невалидность берётся из NgControl: красная рамка по Validators.' }, + source: { + language: 'html', + code: ` +` + } + } + } +}; + +export const Disabled: Story = { + name: 'Disabled', + args: { disabled: true }, + render: (args) => renderMultiSelect(args), + parameters: { + docs: { + description: { story: 'Figma `state=disabled`. Отключение через FormControl.' }, + source: { + language: 'html', + code: ` +` + } + } + } +}; + +export const Readonly: Story = { + name: 'Readonly', + args: { readonly: true, value: [OPTIONS[0], OPTIONS[1]] }, + render: (args) => renderMultiSelect(args), + parameters: { + docs: { + description: { story: 'Figma `state=readonly`. Значение видно, но панель не открывается.' }, + source: { + language: 'html', + code: `` + } + } + } +}; + +export const Chips: Story = { + name: 'Chips', + args: { showChips: true, value: [OPTIONS[0], OPTIONS[1]] }, + render: (args) => renderMultiSelect(args), parameters: { docs: { description: { - story: 'Базовый пример компонента. Используйте Controls для интерактивного изменения пропсов.' + story: + 'Figma `chips=true`. Выбранные значения отображаются chips; клик по × на chip удаляет значение и зовёт `onRemove`.' + }, + source: { + language: 'html', + code: `` + } + } + } +}; + +export const Fluid: Story = { + name: 'Fluid', + args: { fluid: true }, + render: (args) => renderMultiSelect(args), + parameters: { + docs: { + description: { story: 'Свойство кода `fluid`: поле растягивается на всю ширину контейнера.' }, + source: { + language: 'html', + code: `` } } } }; -// ── Re-exports from example components ──────────────────────────────────── -export { Labels, Grouped, Chips, Disabled, Invalid }; +// ── FloatLabel: плавающий лейбл внутри поля ────────────────────────────────── +export const FloatLabel: Story = { + name: 'FloatLabel', + args: { floatLabel: true, label: 'FloatLabel' }, + argTypes: { + floatLabel: { control: false }, + labelPosition: { control: false } + }, + render: (args) => renderMultiSelect(args, { floatLabel: true }), + parameters: { + docs: { + description: { + story: + 'Figma `has-float-label=true`. Плавающий лейбл (`[floatLabel]="true"`): в покое стоит в поле, при фокусе и значении поднимается над ним. labelPosition в этом виде не действует.' + }, + source: { + language: 'html', + code: `` + } + } + } +}; From e5074d0d9d8727205439b43016727737ce0fc599 Mon Sep 17 00:00:00 2001 From: Danil Khaliulin Date: Tue, 17 Nov 2026 14:05:41 +0800 Subject: [PATCH 2/4] fix(multiselect): restore standalone example components MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 1. Восстановить 5 исходных example-файлов компонента вместо лишнего удаления. 2. Согласовать примеры с актуальными типами и API, сохранив исходные описания. 3. Проверить snippets текущих stories, изменённые Controls и строгую Angular-компиляцию восстановленных примеров. Заметки для ревьюеров: - Область: только примеры и stories multiselect; производственные компоненты и токены в этом коммите не меняются. - Stories: сохранён текущий список отдельных примеров; исходные example-файлы доступны рядом с ним. - Проверки: Angular-компиляция восстановленных примеров и обязательные gates snippets и описаний проходят. --- .../examples/multiselect-chips.component.ts | 77 +++++ .../multiselect-disabled.component.ts | 68 +++++ .../examples/multiselect-grouped.component.ts | 126 ++++++++ .../examples/multiselect-invalid.component.ts | 73 +++++ .../examples/multiselect-labels.component.ts | 123 ++++++++ .../multiselect/multiselect.stories.ts | 286 +++++++----------- 6 files changed, 574 insertions(+), 179 deletions(-) create mode 100644 src/stories/components/multiselect/examples/multiselect-chips.component.ts create mode 100644 src/stories/components/multiselect/examples/multiselect-disabled.component.ts create mode 100644 src/stories/components/multiselect/examples/multiselect-grouped.component.ts create mode 100644 src/stories/components/multiselect/examples/multiselect-invalid.component.ts create mode 100644 src/stories/components/multiselect/examples/multiselect-labels.component.ts diff --git a/src/stories/components/multiselect/examples/multiselect-chips.component.ts b/src/stories/components/multiselect/examples/multiselect-chips.component.ts new file mode 100644 index 00000000..375e5b69 --- /dev/null +++ b/src/stories/components/multiselect/examples/multiselect-chips.component.ts @@ -0,0 +1,77 @@ +import { ChangeDetectionStrategy, Component } from '@angular/core'; +import { FormControl, ReactiveFormsModule } from '@angular/forms'; +import { StoryObj } from '@storybook/angular'; +import { ExtraMultiSelectComponent } from '../../../../lib/components/multiselect/multiselect.component'; + +const CITIES = [ + { name: 'Новосибирск', code: 'NSK' }, + { name: 'Москва', code: 'MSK' }, + { name: 'Санкт-Петербург', code: 'SPB' }, + { name: 'Екатеринбург', code: 'EKB' } +]; + +const template = ` + +`; + +@Component({ + selector: 'app-multiselect-chips', + standalone: true, + changeDetection: ChangeDetectionStrategy.OnPush, + imports: [ExtraMultiSelectComponent, ReactiveFormsModule], + template +}) +export class MultiSelectChipsComponent { + control = new FormControl([CITIES[0], CITIES[2]]); + cities = CITIES; +} + +export const Chips: StoryObj = { + render: () => ({ + template: `` + }), + parameters: { + controls: { disable: true }, + docs: { + description: { + story: + 'Выбранные значения отображаются как chips (`showChips`) вместо списка через запятую. Каждый chip можно удалить по крестику — событие `(onRemove)`.' + }, + source: { + language: 'ts', + code: ` +import { Component } from '@angular/core'; +import { FormControl, ReactiveFormsModule } from '@angular/forms'; +import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; + +@Component({ + standalone: true, + imports: [ExtraMultiSelectComponent, ReactiveFormsModule], + template: \` + + \`, +}) +export class MultiSelectChipsExample { + control = new FormControl(null); + cities = [ + { name: 'Новосибирск', code: 'NSK' }, + { name: 'Москва', code: 'MSK' }, + ]; +} + ` + } + } + } +}; diff --git a/src/stories/components/multiselect/examples/multiselect-disabled.component.ts b/src/stories/components/multiselect/examples/multiselect-disabled.component.ts new file mode 100644 index 00000000..735ccca9 --- /dev/null +++ b/src/stories/components/multiselect/examples/multiselect-disabled.component.ts @@ -0,0 +1,68 @@ +import { FormControl, ReactiveFormsModule } from '@angular/forms'; +import { StoryObj } from '@storybook/angular'; +import { ExtraMultiSelectComponent } from '../../../../lib/components/multiselect/multiselect.component'; + +const OPTIONS = [ + { name: 'Новосибирск', code: 'NSK' }, + { name: 'Москва', code: 'MSK' }, + { name: 'Санкт-Петербург', code: 'SPB' } +]; + +export const Disabled: StoryObj = { + name: 'Disabled', + render: () => { + const control = new FormControl({ value: [OPTIONS[0]], disabled: true }); + return { + props: { control, options: OPTIONS }, + template: ` + + ` + }; + }, + decorators: [ + (story: any) => ({ + ...story(), + moduleMetadata: { + imports: [ExtraMultiSelectComponent, ReactiveFormsModule] + } + }) + ], + parameters: { + controls: { disable: true }, + docs: { + description: { story: 'Отключённое состояние — управляется через FormControl.' }, + source: { + language: 'ts', + code: ` +import { Component } from '@angular/core'; +import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; + +@Component({ + standalone: true, + imports: [ExtraMultiSelectComponent, ReactiveFormsModule], + template: \` + + \`, +}) +export class MultiSelectDisabledExample { + control = new FormControl({ value: [], disabled: true }); + options = [ + { name: 'Новосибирск', code: 'NSK' }, + { name: 'Москва', code: 'MSK' }, + ]; +} + ` + } + } + } +}; diff --git a/src/stories/components/multiselect/examples/multiselect-grouped.component.ts b/src/stories/components/multiselect/examples/multiselect-grouped.component.ts new file mode 100644 index 00000000..ffeec17b --- /dev/null +++ b/src/stories/components/multiselect/examples/multiselect-grouped.component.ts @@ -0,0 +1,126 @@ +import { ChangeDetectionStrategy, Component, Input } from '@angular/core'; +import { FormControl, ReactiveFormsModule, Validators } from '@angular/forms'; +import { + ExtraMultiSelectComponent, + ExtraMultiSelectSize +} from '../../../../lib/components/multiselect/multiselect.component'; + +const GROUPED_OPTIONS = [ + { + name: 'Германия', + options: [ + { name: 'Берлин', code: 'BE' }, + { name: 'Франкфурт', code: 'FR' }, + { name: 'Гамбург', code: 'HA' } + ] + }, + { + name: 'США', + options: [ + { name: 'Чикаго', code: 'CH' }, + { name: 'Лос-Анджелес', code: 'LA' }, + { name: 'Нью-Йорк', code: 'NY' } + ] + } +]; + +const template = ` + +`; + +@Component({ + selector: 'app-multiselect-grouped', + standalone: true, + changeDetection: ChangeDetectionStrategy.OnPush, + imports: [ExtraMultiSelectComponent, ReactiveFormsModule], + template +}) +export class MultiSelectGroupedComponent { + @Input() size: ExtraMultiSelectSize = 'base'; + @Input() showFilter = false; + control = new FormControl(null); + options = GROUPED_OPTIONS; + + @Input() set disabled(val: boolean) { + val ? this.control.disable() : this.control.enable(); + } + + @Input() set invalid(val: boolean) { + this.control.setValidators(val ? [Validators.required] : []); + this.control.updateValueAndValidity(); + if (val) this.control.markAsTouched(); + } +} + +export const Grouped = { + render: (args: any) => ({ + props: { + size: args['size'], + showFilter: args['showFilter'], + disabled: args['disabled'], + invalid: args['invalid'] + }, + template: `` + }), + parameters: { + docs: { + description: { + story: + 'Опции, сгруппированные по категориям, через `[group]="true"` + `optionGroupLabel`/`optionGroupChildren`.' + }, + source: { + language: 'ts', + code: ` +import { Component } from '@angular/core'; +import { FormControl, ReactiveFormsModule } from '@angular/forms'; +import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; + +@Component({ + standalone: true, + imports: [ExtraMultiSelectComponent, ReactiveFormsModule], + template: \` + + \`, +}) +export class MultiSelectGroupedExample { + control = new FormControl(null); + options = [ + { + name: 'Германия', + options: [ + { name: 'Берлин', code: 'BE' }, + { name: 'Франкфурт', code: 'FR' }, + ], + }, + { + name: 'США', + options: [ + { name: 'Нью-Йорк', code: 'NY' }, + { name: 'Чикаго', code: 'CH' }, + ], + }, + ]; +} + ` + } + } + } +}; diff --git a/src/stories/components/multiselect/examples/multiselect-invalid.component.ts b/src/stories/components/multiselect/examples/multiselect-invalid.component.ts new file mode 100644 index 00000000..72eb5589 --- /dev/null +++ b/src/stories/components/multiselect/examples/multiselect-invalid.component.ts @@ -0,0 +1,73 @@ +import { FormControl, ReactiveFormsModule, Validators } from '@angular/forms'; +import { StoryObj } from '@storybook/angular'; +import { ExtraMultiSelectComponent } from '../../../../lib/components/multiselect/multiselect.component'; + +const OPTIONS = [ + { name: 'Новосибирск', code: 'NSK' }, + { name: 'Москва', code: 'MSK' }, + { name: 'Санкт-Петербург', code: 'SPB' } +]; + +export const Invalid: StoryObj = { + name: 'Invalid', + render: () => { + const control = new FormControl(null, Validators.required); + control.markAsTouched(); + return { + props: { control, options: OPTIONS }, + template: ` + + ` + }; + }, + decorators: [ + (story: any) => ({ + ...story(), + moduleMetadata: { + imports: [ExtraMultiSelectComponent, ReactiveFormsModule] + } + }) + ], + parameters: { + controls: { disable: true }, + docs: { + description: { + story: + 'Невалидное состояние — определяется через валидаторы `FormControl` (нужно, чтобы контрол также был touched).' + }, + source: { + language: 'ts', + code: ` +import { Component } from '@angular/core'; +import { FormControl, Validators, ReactiveFormsModule } from '@angular/forms'; +import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; + +@Component({ + standalone: true, + imports: [ExtraMultiSelectComponent, ReactiveFormsModule], + template: \` + + \`, +}) +export class MultiSelectInvalidExample { + control = new FormControl(null, Validators.required); + options = [ + { name: 'Новосибирск', code: 'NSK' }, + { name: 'Москва', code: 'MSK' }, + ]; +} + ` + } + } + } +}; diff --git a/src/stories/components/multiselect/examples/multiselect-labels.component.ts b/src/stories/components/multiselect/examples/multiselect-labels.component.ts new file mode 100644 index 00000000..70b487f5 --- /dev/null +++ b/src/stories/components/multiselect/examples/multiselect-labels.component.ts @@ -0,0 +1,123 @@ +import { ChangeDetectionStrategy, Component } from '@angular/core'; +import { FormControl, ReactiveFormsModule } from '@angular/forms'; +import { StoryObj } from '@storybook/angular'; +import { ExtraMultiSelectComponent } from '../../../../lib/components/multiselect/multiselect.component'; + +const CITIES = [ + { name: 'Новосибирск', code: 'NSK' }, + { name: 'Москва', code: 'MSK' }, + { name: 'Санкт-Петербург', code: 'SPB' }, + { name: 'Екатеринбург', code: 'EKB' }, + { name: 'Казань', code: 'KZN' } +]; + +const template = ` +
+ + + + +
+`; + +@Component({ + selector: 'app-multiselect-labels', + standalone: true, + changeDetection: ChangeDetectionStrategy.OnPush, + imports: [ExtraMultiSelectComponent, ReactiveFormsModule], + template +}) +export class MultiSelectLabelsComponent { + control = new FormControl(null); + cities = CITIES; +} + +export const Labels: StoryObj = { + render: () => ({ + template: `` + }), + parameters: { + controls: { disable: true }, + docs: { + description: { + story: + 'Положения лейбла (labelPosition): top — сверху (по умолчанию), left — слева от поля; floatLabel — плавающий лейбл внутри поля. Info показывается иконкой ti-info-circle с тултипом, caption — пояснение под полем.' + }, + source: { + language: 'ts', + code: ` +import { Component } from '@angular/core'; +import { FormControl, ReactiveFormsModule } from '@angular/forms'; +import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; + +@Component({ + selector: 'app-multiselect-labels', + standalone: true, + imports: [ExtraMultiSelectComponent, ReactiveFormsModule], + template: \` + + + + + + \`, +}) +export class MultiSelectLabelsComponent { + control = new FormControl(null); + cities = [ + { name: 'Новосибирск', code: 'NSK' }, + { name: 'Москва', code: 'MSK' }, + ]; +} + ` + } + } + } +}; diff --git a/src/stories/components/multiselect/multiselect.stories.ts b/src/stories/components/multiselect/multiselect.stories.ts index f87e8228..626b6745 100644 --- a/src/stories/components/multiselect/multiselect.stories.ts +++ b/src/stories/components/multiselect/multiselect.stories.ts @@ -42,7 +42,7 @@ type MultiSelectArgs = ExtraMultiSelectComponent & { const meta: Meta = { title: 'Components/Form/MultiSelect', component: ExtraMultiSelectComponent, - tags: ['autodocs'], + tags: ['autodocs', 'multiselect'], decorators: [ moduleMetadata({ imports: [ExtraMultiSelectComponent, ReactiveFormsModule, MultiSelectStoryHostComponent] @@ -51,16 +51,18 @@ const meta: Meta = { parameters: { designTokens: { prefix: '--p-multiselect' }, docs: { + source: { + language: 'html', + transform: (_code: string, context: { args: RenderArgs }) => multiSelectExample(context.args).template + }, description: { component: `Выпадающий список для выбора нескольких значений из набора опций. Поддерживает чекбоксы у опций, отображение выбранных значений как chips, группировку и фильтрацию. -Реализовано по спецификации [multiselect.md](https://github.com/cdek-it/angular-ui-kit/blob/main/docs/components-api/multiselect.md). +Реализован по спецификации \`docs/components-api/multiselect.md\`. \`\`\`typescript import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; -\`\`\` - -Значение подключается через \`[(ngModel)]\` или \`[formControl]\` (ControlValueAccessor). Состояния disabled и invalid управляются через FormControl.` +\`\`\`` } } }, @@ -87,7 +89,7 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; }, floatLabel: { control: 'boolean', - description: 'Лейбл-плейсхолдер, всплывающий над полем при фокусе/значении', + description: 'Плавающий лейбл внутри поля', table: { category: 'Свойства', defaultValue: { summary: 'false' }, @@ -96,7 +98,7 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; }, showChips: { control: 'boolean', - description: 'Выбранные значения в виде chips вместо строки через запятую', + description: 'Отображать выбранные значения в виде chips вместо списка через запятую', table: { category: 'Свойства', defaultValue: { summary: 'false' }, @@ -105,7 +107,7 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; }, chipClearable: { control: 'boolean', - description: 'Иконка удаления у chip (при showChips)', + description: 'Отображение иконки удаления chip (при showChips)', table: { category: 'Свойства', defaultValue: { summary: 'true' }, @@ -114,7 +116,7 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; }, clearable: { control: 'boolean', - description: 'Иконка очистки всего поля', + description: 'Отображение иконки для очистки всего поля', table: { category: 'Свойства', defaultValue: { summary: 'false' }, @@ -123,7 +125,7 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; }, showCheckbox: { control: 'boolean', - description: 'Чекбокс у каждой опции в панели', + description: 'Отображать чекбокс у каждой опции в панели', table: { category: 'Свойства', defaultValue: { summary: 'true' }, @@ -132,7 +134,7 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; }, showFilter: { control: 'boolean', - description: 'Строка поиска в выпадающей панели', + description: 'Отображать строку поиска в выпадающей панели', table: { category: 'Свойства', defaultValue: { summary: 'false' }, @@ -168,7 +170,7 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; }, info: { control: 'text', - description: 'Текст тултипа иконки рядом с лейблом', + description: 'Текст с доп. информацией (показывается в тултипе иконки ti-info-circle)', table: { category: 'Свойства', defaultValue: { summary: "''" }, @@ -177,7 +179,7 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; }, placeholder: { control: 'text', - description: 'Подсказка при пустом поле', + description: 'Текст подсказки при пустом поле', table: { category: 'Свойства', defaultValue: { summary: "''" }, @@ -196,7 +198,7 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; }, readonly: { control: 'boolean', - description: 'Только для чтения', + description: 'Режим только для чтения', table: { category: 'Свойства', defaultValue: { summary: 'false' }, @@ -205,7 +207,7 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; }, loading: { control: 'boolean', - description: 'Индикатор загрузки вместо chevron', + description: 'Состояние загрузки опций', table: { category: 'Свойства', defaultValue: { summary: 'false' }, @@ -214,7 +216,7 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; }, fluid: { control: 'boolean', - description: 'Растягивать поле на всю ширину контейнера', + description: 'Растягивает поле на всю ширину контейнера', table: { category: 'Свойства', defaultValue: { summary: 'false' }, @@ -360,24 +362,24 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; primeSize: { table: { disable: true } }, multiselectClasses: { table: { disable: true } }, inputId: { table: { disable: true } }, - invalid: { table: { disable: true } }, - disabled: { table: { disable: true } }, + invalid: { control: 'boolean', description: 'Невалидное состояние — вычисляется из NgControl (Validators)' }, + disabled: { control: 'boolean', description: 'Отключает взаимодействие — управляется через FormControl' }, modelValue: { table: { disable: true } }, // ── Состояния (управляются через FormControl) ────────────────────────── // ── События ──────────────────────────────────────────────────────────── onChange: { control: false, - description: 'Срабатывает при выборе значения', + description: 'Срабатывает при изменении выбора', table: { category: 'События', type: { summary: 'EventEmitter' } } }, onFilter: { control: false, - description: 'Срабатывает при вводе в строку поиска', + description: 'Срабатывает при вводе в строку фильтра', table: { category: 'События', type: { summary: 'EventEmitter' } } }, onClear: { control: false, - description: 'Срабатывает при очистке поля', + description: 'Срабатывает при очистке всех значений', table: { category: 'События', type: { summary: 'EventEmitter' } } }, onShow: { @@ -449,139 +451,105 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit'; export default meta; type Story = StoryObj; -// ── Один рендер компонента: все свойства настраиваются в Controls ──────────── -interface RenderArgs { - label?: string; - labelPosition?: string; - floatLabel?: boolean; - showChips?: boolean; - chipClearable?: boolean; - clearable?: boolean; - showCheckbox?: boolean; - showFilter?: boolean; - filterPlaceholder?: string; - caption?: string; - captionSeverity?: string; - info?: string; - placeholder?: string; - size?: string; - readonly?: boolean; - loading?: boolean; - fluid?: boolean; - required?: boolean; - group?: boolean; - ariaLabel?: string; - ariaLabelledBy?: string; - autofocus?: boolean; - tabindex?: number; - optionLabel?: string; - invalid?: boolean; - disabled?: boolean; - value?: { name: string; code: string }[]; -} +const MULTISELECT_INPUTS = [ + 'placeholder', + 'label', + 'labelPosition', + 'floatLabel', + 'showChips', + 'chipIcon', + 'chipClearable', + 'clearable', + 'showCheckbox', + 'showFilter', + 'filterPlaceholder', + 'options', + 'optionLabel', + 'optionValue', + 'optionDisabled', + 'optionGroupLabel', + 'optionGroupChildren', + 'group', + 'caption', + 'captionSeverity', + 'info', + 'size', + 'readonly', + 'required', + 'ariaLabel', + 'ariaLabelledBy', + 'autofocus', + 'tabindex', + 'loading', + 'fluid', + 'appendTo', + 'emptyMessage', + 'emptyFilterMessage' +] as const; +type RenderArgs = Partial< + Pick +>; -const renderMultiSelect = (args: RenderArgs, forced: { floatLabel?: boolean; showChips?: boolean } = {}) => { - const a = { ...args, ...forced }; - const parts: string[] = []; - - if (a.label) parts.push(`label="${a.label}"`); - if (a.labelPosition && a.labelPosition !== 'top') parts.push(`labelPosition="${a.labelPosition}"`); - if (a.floatLabel) parts.push(`[floatLabel]="true"`); - if (a.showChips) parts.push(`[showChips]="true"`); - if (!a.chipClearable) parts.push(`[chipClearable]="false"`); - if (a.clearable) parts.push(`[clearable]="true"`); - if (!a.showCheckbox) parts.push(`[showCheckbox]="false"`); - if (a.showFilter) parts.push(`[showFilter]="true"`); - if (a.filterPlaceholder) parts.push(`filterPlaceholder="${a.filterPlaceholder}"`); - if (a.caption) parts.push(`caption="${a.caption}"`); - if (a.captionSeverity && a.captionSeverity !== 'base') parts.push(`captionSeverity="${a.captionSeverity}"`); - if (a.info) parts.push(`info="${a.info}"`); - if (a.placeholder) parts.push(`placeholder="${a.placeholder}"`); - if (a.size && a.size !== 'base') parts.push(`size="${a.size}"`); - if (a.readonly) parts.push(`[readonly]="true"`); - if (a.loading) parts.push(`[loading]="true"`); - if (a.fluid) parts.push(`[fluid]="true"`); - if (a.required) parts.push(`required`); - if (a.group) parts.push(`[group]="true" optionGroupLabel="name"`); - if (a.ariaLabel) parts.push(`ariaLabel="${a.ariaLabel}"`); - if (a.ariaLabelledBy) parts.push(`ariaLabelledBy="${a.ariaLabelledBy}"`); - if (a.autofocus) parts.push(`[autofocus]="true"`); - if (a.tabindex != null) parts.push(`[tabindex]="${a.tabindex}"`); - if (a.optionLabel) parts.push(`optionLabel="${a.optionLabel}"`); - - const validators = a.invalid ? [Validators.required] : []; - const control = new FormControl({ value: a.value ?? null, disabled: !!a.disabled }, validators); - if (a.invalid) control.markAsTouched(); - - const options = a.group +const multiSelectExample = (args: RenderArgs) => { + const options = args.group ? [ - { name: 'Группа 1', items: OPTIONS.slice(0, 2) }, - { name: 'Группа 2', items: OPTIONS.slice(2) } + { [args.optionGroupLabel ?? 'name']: 'Группа 1', [args.optionGroupChildren ?? 'items']: OPTIONS.slice(0, 2) }, + { [args.optionGroupLabel ?? 'name']: 'Группа 2', [args.optionGroupChildren ?? 'items']: OPTIONS.slice(2) } ] - : OPTIONS; - - // Ширина поля в примерах зафиксирована шириной референса Figma (272px): сверки идут 1:1 - // с макетом, поле не растягивается на всё превью и не раздувается контентом (chips/список - // значений уходят в ellipsis). Fluid-пример — без обёртки: там поле обязано занять контейнер. - const template = `${a.fluid ? '' : ''}${a.fluid ? '' : ''}`; + : args.options; + const values = { + ...args, + options, + optionGroupLabel: args.group ? (args.optionGroupLabel ?? 'name') : args.optionGroupLabel + }; + const escape = (value: string) => value.replace(/&/g, '&').replace(/"/g, '"').replace(/' }; +}; - // invalid и disabled живут во FormControl: у компонента invalid — геттер без сеттера, - // и Storybook на попытке его присвоить роняет ошибку в консоль - return { props: { control, options }, template }; +const renderMultiSelect = (args: RenderArgs) => { + const example = multiSelectExample(args); + const control = new FormControl( + { value: args.value ?? null, disabled: !!args.disabled }, + args.invalid ? [Validators.required] : [] + ); + if (args.invalid) control.markAsTouched(); + const template = args.fluid + ? example.template + : '' + example.template + ''; + return { + props: { ...Object.fromEntries(MULTISELECT_INPUTS.map((key) => [key, example.values[key]])), control }, + template + }; }; -// ── Default ────────────────────────────────────────────────────────────────── export const Default: Story = { name: 'Default', render: (args) => renderMultiSelect(args), parameters: { docs: { - description: { - story: - 'Поле с лейблом сверху (labelPosition="top") или слева (labelPosition="left"). Размер (small, base, large, xlarge), chips, caption, info, фильтр, группировка, fluid, readonly, disabled и invalid меняются в Controls; disabled и invalid управляются через FormControl.' - }, - source: { - language: 'html', - code: ` - - - - - - - - - - - - - - - - - -control = new FormControl({ value: null, disabled: true }); -control = new FormControl(null, Validators.required); - - -` - } + description: { story: 'Базовый пример компонента. Используйте Controls для интерактивного изменения пропсов.' } } } }; -// ── Error / Disabled / Readonly / Chips / Fluid: пресеты Figma ─────────────── export const Error: Story = { name: 'Error', args: { invalid: true }, render: (args) => renderMultiSelect(args), parameters: { docs: { - description: { story: 'Figma `state=danger`. Невалидность берётся из NgControl: красная рамка по Validators.' }, - source: { - language: 'html', - code: ` -` + description: { + story: + 'Невалидное состояние — определяется через валидаторы `FormControl` (нужно, чтобы контрол также был touched).' } } } @@ -591,31 +559,13 @@ export const Disabled: Story = { name: 'Disabled', args: { disabled: true }, render: (args) => renderMultiSelect(args), - parameters: { - docs: { - description: { story: 'Figma `state=disabled`. Отключение через FormControl.' }, - source: { - language: 'html', - code: ` -` - } - } - } + parameters: { docs: { description: { story: 'Отключённое состояние — управляется через FormControl.' } } } }; export const Readonly: Story = { name: 'Readonly', args: { readonly: true, value: [OPTIONS[0], OPTIONS[1]] }, - render: (args) => renderMultiSelect(args), - parameters: { - docs: { - description: { story: 'Figma `state=readonly`. Значение видно, но панель не открывается.' }, - source: { - language: 'html', - code: `` - } - } - } + render: (args) => renderMultiSelect(args) }; export const Chips: Story = { @@ -626,11 +576,7 @@ export const Chips: Story = { docs: { description: { story: - 'Figma `chips=true`. Выбранные значения отображаются chips; клик по × на chip удаляет значение и зовёт `onRemove`.' - }, - source: { - language: 'html', - code: `` + 'Выбранные значения отображаются как chips (`showChips`) вместо списка через запятую. Каждый chip можно удалить по крестику — событие `(onRemove)`.' } } } @@ -639,36 +585,18 @@ export const Chips: Story = { export const Fluid: Story = { name: 'Fluid', args: { fluid: true }, - render: (args) => renderMultiSelect(args), - parameters: { - docs: { - description: { story: 'Свойство кода `fluid`: поле растягивается на всю ширину контейнера.' }, - source: { - language: 'html', - code: `` - } - } - } + render: (args) => renderMultiSelect(args) }; -// ── FloatLabel: плавающий лейбл внутри поля ────────────────────────────────── export const FloatLabel: Story = { name: 'FloatLabel', args: { floatLabel: true, label: 'FloatLabel' }, - argTypes: { - floatLabel: { control: false }, - labelPosition: { control: false } - }, - render: (args) => renderMultiSelect(args, { floatLabel: true }), + render: (args) => renderMultiSelect(args), parameters: { docs: { description: { story: - 'Figma `has-float-label=true`. Плавающий лейбл (`[floatLabel]="true"`): в покое стоит в поле, при фокусе и значении поднимается над ним. labelPosition в этом виде не действует.' - }, - source: { - language: 'html', - code: `` + 'Положения лейбла (labelPosition): top — сверху (по умолчанию), left — слева от поля; floatLabel — плавающий лейбл внутри поля. Info показывается иконкой ti-info-circle с тултипом, caption — пояснение под полем.' } } } From 432da06da334d07cd3766d3405e87d983aea34ee Mon Sep 17 00:00:00 2001 From: Danil Khaliulin Date: Wed, 18 Nov 2026 13:50:51 +0200 Subject: [PATCH 3/4] chore(multiselect): 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 показывает описание, тип, дефолт и группы категорий. 2. Гейты: controls 33/33, descriptions 31/31, source 7/7. --- src/stories/components/multiselect/multiselect.stories.ts | 1 + 1 file changed, 1 insertion(+) diff --git a/src/stories/components/multiselect/multiselect.stories.ts b/src/stories/components/multiselect/multiselect.stories.ts index 626b6745..d6e2a246 100644 --- a/src/stories/components/multiselect/multiselect.stories.ts +++ b/src/stories/components/multiselect/multiselect.stories.ts @@ -49,6 +49,7 @@ const meta: Meta = { }) ], parameters: { + controls: { expanded: true }, designTokens: { prefix: '--p-multiselect' }, docs: { source: { From 1f671a290f79e7d73e20a02369cf3838ab08cbb3 Mon Sep 17 00:00:00 2001 From: Danil Khaliulin Date: Wed, 18 Nov 2026 15:44:00 +0300 Subject: [PATCH 4/4] chore(multiselect): show control descriptions in Controls panel MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Включает глобальный controls.expanded в .storybook/preview.ts (иначе на ветке панель Controls остаётся компактной до мержа инфраструктурной ветки). --- .storybook/preview.ts | 3 +++ src/stories/components/multiselect/multiselect.stories.ts | 1 - 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/.storybook/preview.ts b/.storybook/preview.ts index bd5a1c5f..78c56666 100644 --- a/.storybook/preview.ts +++ b/.storybook/preview.ts @@ -68,6 +68,9 @@ const preview: Preview = { globals: { theme: 'light' }, }, controls: { + // Полная таблица в панели Controls: имя, описание, тип, дефолт и группы категорий. + // В компактном режиме Storybook 10 описание пропса не отображается. + expanded: true, matchers: { color: /(background|color)$/i, date: /Date$/i diff --git a/src/stories/components/multiselect/multiselect.stories.ts b/src/stories/components/multiselect/multiselect.stories.ts index d6e2a246..626b6745 100644 --- a/src/stories/components/multiselect/multiselect.stories.ts +++ b/src/stories/components/multiselect/multiselect.stories.ts @@ -49,7 +49,6 @@ const meta: Meta = { }) ], parameters: { - controls: { expanded: true }, designTokens: { prefix: '--p-multiselect' }, docs: { source: {