Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .storybook/preview.ts
Original file line number Diff line number Diff line change
Expand Up @@ -68,6 +68,9 @@ const preview: Preview = {
globals: { theme: 'light' },
},
controls: {
// Полная таблица в панели Controls: имя, описание, тип, дефолт и группы категорий.
// В компактном режиме Storybook 10 описание пропса не отображается.
expanded: true,
matchers: {
color: /(background|color)$/i,
date: /Date$/i
Expand Down
69 changes: 35 additions & 34 deletions docs/components-api/multiselect.md
Original file line number Diff line number Diff line change
Expand Up @@ -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` | — |

# Стекозависимые пропсы

Expand Down
19 changes: 16 additions & 3 deletions src/lib/components/multiselect/multiselect.component.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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,
Expand Down Expand Up @@ -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: [
{
Expand Down Expand Up @@ -99,7 +108,7 @@ let nextInputId = 0;
<ng-container [ngTemplateOutlet]="fieldTpl" />
}
@if (caption) {
<div class="extra-multiselect-caption">{{ caption }}</div>
<extra-caption [severity]="captionSeverity">{{ caption }}</extra-caption>
}
</div>
</div>
Expand Down Expand Up @@ -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"
Expand Down Expand Up @@ -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;
Expand Down Expand Up @@ -243,6 +255,7 @@ export class ExtraMultiSelectComponent implements ControlValueAccessor, OnInit,
get multiselectClasses(): Record<string, boolean> {
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
Expand Down
5 changes: 5 additions & 0 deletions src/lib/providers/prime-preset/map-tokens.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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';
Expand Down Expand Up @@ -94,6 +95,10 @@ const presetTokens: Preset<AuraBaseDesignTokens> = {
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
Expand Down
Loading
Loading