diff --git a/.storybook/preview.ts b/.storybook/preview.ts
index bd5a1c5f..78c56666 100644
--- a/.storybook/preview.ts
+++ b/.storybook/preview.ts
@@ -68,6 +68,9 @@ const preview: Preview = {
globals: { theme: 'light' },
},
controls: {
+ // Полная таблица в панели Controls: имя, описание, тип, дефолт и группы категорий.
+ // В компактном режиме Storybook 10 описание пропса не отображается.
+ expanded: true,
matchers: {
color: /(background|color)$/i,
date: /Date$/i
diff --git a/docs/components-api/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 }}
}
@@ -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/multiselect.stories.ts b/src/stories/components/multiselect/multiselect.stories.ts
index c471f93c..626b6745 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,26 +33,28 @@ 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',
component: ExtraMultiSelectComponent,
- tags: ['autodocs'],
+ tags: ['autodocs', 'multiselect'],
decorators: [
moduleMetadata({
- imports: [
- ExtraMultiSelectComponent,
- ReactiveFormsModule,
- MultiSelectLabelsComponent,
- MultiSelectGroupedComponent,
- MultiSelectChipsComponent
- ]
+ imports: [ExtraMultiSelectComponent, ReactiveFormsModule, MultiSelectStoryHostComponent]
})
],
parameters: {
designTokens: { prefix: '--p-multiselect' },
docs: {
+ source: {
+ language: 'html',
+ transform: (_code: string, context: { args: RenderArgs }) => multiSelectExample(context.args).template
+ },
description: {
component: `Выпадающий список для выбора нескольких значений из набора опций. Поддерживает чекбоксы у опций, отображение выбранных значений как chips, группировку и фильтрацию.
@@ -47,16 +67,7 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit';
}
},
argTypes: {
- // ── Свойства ─────────────────────────────────────────────
- placeholder: {
- control: 'text',
- description: 'Текст подсказки при пустом поле',
- table: {
- category: 'Свойства',
- defaultValue: { summary: "''" },
- type: { summary: 'string' }
- }
- },
+ // ── Свойства (docs/components-api/multiselect.md) ─────────────────────
label: {
control: 'text',
description: 'Текст названия поля',
@@ -130,6 +141,14 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit';
type: { summary: 'boolean' }
}
},
+ filterPlaceholder: {
+ control: 'text',
+ description: 'Подсказка в строке поиска (при showFilter)',
+ table: {
+ category: 'Свойства',
+ type: { summary: 'string' }
+ }
+ },
caption: {
control: 'text',
description: 'Текст пояснения под полем',
@@ -139,6 +158,16 @@ 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)',
@@ -148,6 +177,15 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit';
type: { summary: 'string' }
}
},
+ placeholder: {
+ control: 'text',
+ description: 'Текст подсказки при пустом поле',
+ table: {
+ category: 'Свойства',
+ defaultValue: { summary: "''" },
+ type: { summary: 'string' }
+ }
+ },
size: {
control: 'select',
options: ['small', 'base', 'large', 'xlarge'],
@@ -185,53 +223,150 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit';
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: { control: 'boolean', description: 'Невалидное состояние — вычисляется из NgControl (Validators)' },
+ disabled: { control: 'boolean', description: 'Отключает взаимодействие — управляется через FormControl' },
+ modelValue: { table: { disable: true } },
+ // ── Состояния (управляются через FormControl) ──────────────────────────
+ // ── События ────────────────────────────────────────────────────────────
onChange: {
control: false,
description: 'Срабатывает при изменении выбора',
@@ -274,8 +409,7 @@ import { ExtraMultiSelectComponent } from '@cdek-it/angular-ui-kit';
}
},
args: {
- placeholder: 'Выберите города',
- label: '',
+ label: 'Label',
labelPosition: 'top',
floatLabel: false,
showChips: false,
@@ -283,58 +417,187 @@ 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;
-// ── Default ──────────────────────────────────────────────────────────────────
+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 multiSelectExample = (args: RenderArgs) => {
+ const options = args.group
+ ? [
+ { [args.optionGroupLabel ?? 'name']: 'Группа 1', [args.optionGroupChildren ?? 'items']: OPTIONS.slice(0, 2) },
+ { [args.optionGroupLabel ?? 'name']: 'Группа 2', [args.optionGroupChildren ?? 'items']: OPTIONS.slice(2) }
+ ]
+ : args.options;
+ const values = {
+ ...args,
+ options,
+ optionGroupLabel: args.group ? (args.optionGroupLabel ?? 'name') : args.optionGroupLabel
+ };
+ const escape = (value: string) => value.replace(/&/g, '&').replace(/"/g, '"').replace(/' };
+};
+
+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
+ };
+};
+
export const Default: Story = {
name: 'Default',
- render: (args) => {
- const parts: string[] = [];
+ render: (args) => renderMultiSelect(args),
+ parameters: {
+ docs: {
+ description: { story: 'Базовый пример компонента. Используйте Controls для интерактивного изменения пропсов.' }
+ }
+ }
+};
- 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"`);
+export const Error: Story = {
+ name: 'Error',
+ args: { invalid: true },
+ render: (args) => renderMultiSelect(args),
+ parameters: {
+ docs: {
+ description: {
+ story:
+ 'Невалидное состояние — определяется через валидаторы `FormControl` (нужно, чтобы контрол также был touched).'
+ }
+ }
+ }
+};
- const validators = args.invalid ? [Validators.required] : [];
- const control = new FormControl({ value: null, disabled: args.disabled }, validators);
- if (args.invalid) control.markAsTouched();
+export const Disabled: Story = {
+ name: 'Disabled',
+ args: { disabled: true },
+ render: (args) => renderMultiSelect(args),
+ parameters: { docs: { description: { story: 'Отключённое состояние — управляется через FormControl.' } } }
+};
- const template = ``;
+export const Readonly: Story = {
+ name: 'Readonly',
+ args: { readonly: true, value: [OPTIONS[0], OPTIONS[1]] },
+ render: (args) => renderMultiSelect(args)
+};
- return { props: { ...args, control, options: CITIES }, template };
- },
+export const Chips: Story = {
+ name: 'Chips',
+ args: { showChips: true, value: [OPTIONS[0], OPTIONS[1]] },
+ render: (args) => renderMultiSelect(args),
parameters: {
docs: {
description: {
- story: 'Базовый пример компонента. Используйте Controls для интерактивного изменения пропсов.'
+ story:
+ 'Выбранные значения отображаются как chips (`showChips`) вместо списка через запятую. Каждый chip можно удалить по крестику — событие `(onRemove)`.'
}
}
}
};
-// ── Re-exports from example components ────────────────────────────────────
-export { Labels, Grouped, Chips, Disabled, Invalid };
+export const Fluid: Story = {
+ name: 'Fluid',
+ args: { fluid: true },
+ render: (args) => renderMultiSelect(args)
+};
+
+export const FloatLabel: Story = {
+ name: 'FloatLabel',
+ args: { floatLabel: true, label: 'FloatLabel' },
+ render: (args) => renderMultiSelect(args),
+ parameters: {
+ docs: {
+ description: {
+ story:
+ 'Положения лейбла (labelPosition): top — сверху (по умолчанию), left — слева от поля; floatLabel — плавающий лейбл внутри поля. Info показывается иконкой ti-info-circle с тултипом, caption — пояснение под полем.'
+ }
+ }
+ }
+};