Skip to content
Open
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
62 changes: 32 additions & 30 deletions docs/components-api/select.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,36 +6,38 @@

Single-select: выбор одного значения из списка. У опций нет чекбоксов (множественный выбор с чекбоксами — это `ExtraMultiSelect`).

| Свойство | Описание | Типизация | По умолчанию |
| -------------------- | ----------------------------------------------------------------------- | ---------------------------------------------------- | ------------------------------------- |
| `placeholder` | текст подсказки внутри поля | `string` | `''` |
| `label` | текст названия поля | `string` | `''` |
| `labelPosition` | положение лейбла | `top \| left` | `top` |
| `floatLabel` | плавающий лейбл внутри поля (перекрывает `labelPosition`) | `boolean` | `false` |
| `options` | список элементов или список групп с элементами | `ExtraSelectGroup[] \| ExtraSelectOption[] \| any[]` | — |
| `optionLabel` | наименование поля, содержащего отображаемое значение | `string` | — |
| `optionValue` | наименование поля, значение которого используется как значение модели | `string` | — |
| `optionDisabled` | наименование булева поля опции, отключающего её выбор | `string` | — |
| `group` | включает группировку опций (данные — `ExtraSelectGroup[]`) | `boolean` | `false` |
| `clearable` | отображение иконки для очистки поля | `boolean` | `false` |
| `showCheckbox` | отображать отметку выбранного option | `boolean` | `true` |
| `showFilter` | показывает строку поиска в выпадающем списке | `boolean` | `false` |
| `editable` | разрешает ручной ввод произвольного значения в поле | `boolean` | `false` |
| `readonly` | только для чтения | `boolean` | `false` |
| `required` | поле обязательно для заполнения | `boolean` | `false` |
| `loading` | состояние загрузки опций | `boolean` | `false` |
| `caption` | текст пояснения под полем | `string` | `''` |
| `info` | текст с доп. информацией (показывается в тултипе иконки ti-info-circle) | `string` | `''` |
| `size` | размер поля | `small \| base \| large \| xlarge` | `base` |
| `emptyMessage` | сообщение при пустом списке опций | `string` | `'Нет данных'` |
| `emptyFilterMessage` | сообщение при отсутствии результатов фильтрации | `string` | `'Результаты не найдены'` |
| `inputId` | `id` нативного инпута — для связи с внешним `<label for="...">` | `string` | автогенерируемый (`extra-select-<n>`) |
| `appendTo` | контейнер для отрисовки выпадающей панели | `any` | `'body'` |
| `checkmarkIcon` | класс иконки tabler icon отметки выбранного пункта (при `showCheckbox`) | `string` | `'ti ti-check'` |
| `ariaLabel` | метка для программ экранного доступа | `string` | — |
| `ariaLabelledBy` | `id` внешнего элемента-метки для доступности | `string` | — |
| `autofocus` | автофокус при монтировании компонента | `boolean` | `false` |
| `tabindex` | порядок перехода по Tab | `number` | — |
| Свойство | Описание | Типизация | По умолчанию |
| -------------------- | ------------------------------------------------------------------------------- | ---------------------------------------------------- | ------------------------------------- |
| `placeholder` | текст подсказки внутри поля | `string` | `''` |
| `label` | текст названия поля | `string` | `''` |
| `labelPosition` | положение лейбла | `top \| left` | `top` |
| `floatLabel` | плавающий лейбл внутри поля (перекрывает `labelPosition`) | `boolean` | `false` |
| `options` | список элементов или список групп с элементами | `ExtraSelectGroup[] \| ExtraSelectOption[] \| any[]` | — |
| `optionLabel` | наименование поля, содержащего отображаемое значение | `string` | — |
| `optionValue` | наименование поля, значение которого используется как значение модели | `string` | — |
| `optionDisabled` | наименование булева поля опции, отключающего её выбор | `string` | — |
| `group` | включает группировку опций (данные — `ExtraSelectGroup[]`) | `boolean` | `false` |
| `clearable` | отображение иконки для очистки поля | `boolean` | `false` |
| `showCheckmark` | галочка у выбранной опции в списке (Figma `_<Select.Option>` checkmark) | `boolean` | `true` |
| `showFilter` | показывает строку поиска в выпадающем списке | `boolean` | `false` |
| `editable` | разрешает ручной ввод произвольного значения в поле | `boolean` | `false` |
| `readonly` | только для чтения | `boolean` | `false` |
| `required` | поле обязательно для заполнения | `boolean` | `false` |
| `loading` | состояние загрузки опций | `boolean` | `false` |
| `caption` | текст пояснения под полем | `string` | `''` |
| `captionSeverity` | вариант подписи (цвет и иконка): `base`, `success`, `warning`, `danger`, `info` | `ExtraCaptionSeverity` | `base` |
| `info` | текст с доп. информацией (показывается в тултипе иконки ti-info-circle) | `string` | `''` |
| `size` | размер поля | `small \| base \| large \| xlarge` | `base` |
| `fluid` | растягивает поле на всю ширину контейнера | `boolean` | `false` |
| `emptyMessage` | сообщение при пустом списке опций | `string` | `'Нет данных'` |
| `emptyFilterMessage` | сообщение при отсутствии результатов фильтрации | `string` | `'Результаты не найдены'` |
| `inputId` | `id` нативного инпута — для связи с внешним `<label for="...">` | `string` | автогенерируемый (`extra-select-<n>`) |
| `appendTo` | контейнер для отрисовки выпадающей панели | `any` | `'body'` |
| `checkmarkIcon` | код иконки tabler icon отметки выбранного пункта (при `showCheckmark`) | `string` | `'ti ti-check'` |
| `ariaLabel` | метка для программ экранного доступа | `string` | — |
| `ariaLabelledBy` | `id` внешнего элемента-метки для доступности | `string` | — |
| `autofocus` | автофокус при монтировании компонента | `boolean` | `false` |
| `tabindex` | порядок перехода по Tab | `number` | — |

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

Expand Down
24 changes: 18 additions & 6 deletions src/lib/components/select/select.component.ts
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,7 @@ import { FloatLabel } from 'primeng/floatlabel';
import { PrimeTemplate } from 'primeng/api';
import type { SelectChangeEvent, SelectFilterEvent } from 'primeng/types/select';
import { ExtraTooltipDirective } from '@cdek-it/angular-ui-kit/components/tooltip';
import { ExtraCaptionComponent, ExtraCaptionSeverity } from '@cdek-it/angular-ui-kit/components/caption';

export type ExtraSelectSize = 'small' | 'base' | 'large' | 'xlarge';
export type ExtraSelectLabelPosition = 'top' | 'left';
Expand Down Expand Up @@ -69,7 +70,15 @@ export class ExtraSelectOptionGroupDirective {}
@Component({
selector: 'extra-select',
standalone: true,
imports: [Select, NgTemplateOutlet, PrimeTemplate, FormsModule, FloatLabel, ExtraTooltipDirective],
imports: [
Select,
NgTemplateOutlet,
PrimeTemplate,
FormsModule,
FloatLabel,
ExtraTooltipDirective,
ExtraCaptionComponent
],
host: { style: 'display: contents' },
providers: [
{
Expand Down Expand Up @@ -105,7 +114,7 @@ export class ExtraSelectOptionGroupDirective {}
<ng-container [ngTemplateOutlet]="selectTpl" />
}
@if (caption) {
<div class="extra-select-caption">{{ caption }}</div>
<extra-caption [severity]="captionSeverity">{{ caption }}</extra-caption>
}
</div>
</div>
Expand Down Expand Up @@ -134,7 +143,7 @@ export class ExtraSelectOptionGroupDirective {}
[optionGroupLabel]="optionGroupLabel"
[optionGroupChildren]="optionGroupChildren"
[group]="group"
[placeholder]="placeholder"
[placeholder]="floatLabel ? '' : placeholder"
[filter]="showFilter"
[showClear]="clearable"
[editable]="editable"
Expand All @@ -147,7 +156,8 @@ export class ExtraSelectOptionGroupDirective {}
[inputId]="inputId"
[appendTo]="appendTo"
[size]="primeSize"
[checkmark]="showCheckbox"
[fluid]="fluid"
[checkmark]="showCheckmark"
[panelStyle]="panelStyle"
[emptyMessage]="emptyMessage"
[emptyFilterMessage]="emptyFilterMessage"
Expand Down Expand Up @@ -208,12 +218,14 @@ export class ExtraSelectComponent implements ControlValueAccessor, OnInit, OnCha
/** Плавающий лейбл внутри поля (PrimeNG `p-floatlabel`); перекрывает `labelPosition`. */
@Input({ transform: booleanAttribute }) floatLabel = false;
@Input() caption = '';
@Input() captionSeverity: ExtraCaptionSeverity = 'base';
@Input() info = '';
@Input() size: ExtraSelectSize = 'base';
@Input({ transform: booleanAttribute }) fluid = false;
@Input({ transform: booleanAttribute }) showFilter = false;
/** Отображение иконки очистки поля при наличии значения. */
@Input({ transform: booleanAttribute }) clearable = false;
@Input({ transform: booleanAttribute }) showCheckbox = true;
@Input({ transform: booleanAttribute }) showCheckmark = true;
@Input({ transform: booleanAttribute }) editable = false;
@Input({ transform: booleanAttribute }) readonly = false;
/** Поле обязательно для заполнения; в Angular работает как NG_VALIDATORS-валидатор. */
Expand Down Expand Up @@ -272,7 +284,7 @@ export class ExtraSelectComponent implements ControlValueAccessor, OnInit, OnCha

get panelStyle(): Record<string, string> {
const char = String.fromCodePoint(parseInt(this.checkmarkIcon, 16));
return { '--p-select-checkmark-content': `"${char}"` };
return { '--extra-select-checkmark-content': `"${char}"` };
}

/**
Expand Down
Loading
Loading