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
54 changes: 24 additions & 30 deletions docs/components-api/textarea.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,36 +4,30 @@

> ✅ **Реализован**: `ExtraTextareaComponent` (`@cdek-it/angular-ui-kit`) соответствует спецификации.

| Свойство | Описание | Типизация | По умолчанию |
| ---------------- | ----------------------------------------------------------------------------- | ---------------------------------- | ------------ |
| `placeholder` | текст подсказки внутри поля | `string` | `''` |
| `label` | текст названия поля | `string` | `''` |
| `labelPosition` | положение лейбла | `top \| left` | `top` |
| `floatLabel` | лейбл-плейсхолдер, всплывающий над полем при фокусе/значении | `boolean` | `false` |
| `clearable` | отображение иконки для очистки поля | `boolean` | `false` |
| `resizable` | разрешить изменение размера поля перетаскиванием (нативный resize-уголок) | `boolean` | `true` |
| `caption` | текст пояснения под полем | `string` | `''` |
| `info` | текст с доп. информацией (показывается в тултипе иконки ti-info-circle) | `string` | `''` |
| `size` | размер поля | `small \| base \| large \| xlarge` | `base` |
| `fluid` | растягивает поле на всю ширину контейнера | `boolean` | `false` |
| `autoResize` | автоподстройка высоты поля под содержимое при вводе | `boolean` | `false` |
| `rows` | стартовая высота поля в строках | `number` | `3` |
| `cols` | ширина поля в символах | `number` | — |
| `autofocus` | автофокус при монтировании компонента | `boolean` | `false` |
| `readonly` | только для чтения | `boolean` | `false` |
| `required` | поле обязательно для заполнения | `boolean` | `false` |
| `name` | имя поля (нативный атрибут `name`); используется браузером для автозаполнения | `string` | — |
| `autocomplete` | значение нативного атрибута `autocomplete` | `string` | — |
| `maxLength` | максимальное количество символов | `number` | — |
| `ariaLabel` | метка для программ экранного доступа | `string` | — |
| `ariaLabelledBy` | `id` внешнего элемента-метки для доступности | `string` | — |
| `tabindex` | порядок перехода по Tab | `number` | — |

`labelPosition`/`floatLabel` — раздельные пропы (не тройной enum `left \| top \| float`, как было в
черновике спеки): `labelPosition` отвечает только за top/left, `floatLabel` — отдельный независимый
переключатель поверх любого из них (см. `docs/naming-rules.md`, раздел «Позиции»). При
`floatLabel=true` значение `labelPosition` для позиционирования самого лейбла не используется —
лейбл всегда всплывает поверх поля.
| Свойство | Описание | Типизация | По умолчанию |
| ----------------- | --------------------------------------------------------------------------------------- | ---------------------------------- | ------------ |
| `placeholder` | текст подсказки внутри поля | `string` | `''` |
| `label` | текст названия поля | `string` | `''` |
| `labelPosition` | положение лейбла: сверху, плавающий (всплывает над полем при фокусе/значении) или слева | `default \| float \| left` | `default` |
| `clearable` | отображение иконки для очистки поля | `boolean` | `false` |
| `resizable` | разрешить изменение размера поля перетаскиванием (нативный resize-уголок) | `boolean` | `true` |
| `caption` | текст пояснения под полем | `string` | `''` |
| `captionSeverity` | вариант подписи (цвет и иконка): `base`, `success`, `warning`, `danger`, `info` | `ExtraCaptionSeverity` | `base` |
| `info` | текст с доп. информацией (показывается в тултипе иконки ti-info-circle) | `string` | `''` |
| `size` | размер поля | `small \| base \| large \| xlarge` | `base` |
| `fluid` | растягивает поле на всю ширину контейнера | `boolean` | `false` |
| `autoResize` | автоподстройка высоты поля под содержимое при вводе | `boolean` | `false` |
| `rows` | стартовая высота поля в строках | `number` | `3` |
| `cols` | ширина поля в символах | `number` | — |
| `autofocus` | автофокус при монтировании компонента | `boolean` | `false` |
| `readonly` | только для чтения | `boolean` | `false` |
| `required` | поле обязательно для заполнения | `boolean` | `false` |
| `name` | имя поля (нативный атрибут `name`); используется браузером для автозаполнения | `string` | — |
| `autocomplete` | значение нативного атрибута `autocomplete` | `string` | — |
| `maxLength` | максимальное количество символов | `number` | — |
| `ariaLabel` | метка для программ экранного доступа | `string` | — |
| `ariaLabelledBy` | `id` внешнего элемента-метки для доступности | `string` | — |
| `tabindex` | порядок перехода по Tab | `number` | — |

`resizable` — исправленное по `docs/naming-rules.md` имя (булево «возможность действия» → суффикс
`*able`, в черновике спеки было `resize`).
Expand Down
49 changes: 38 additions & 11 deletions src/lib/components/textarea/textarea.component.ts
Original file line number Diff line number Diff line change
@@ -1,7 +1,10 @@
import {
AfterViewInit,
booleanAttribute,
ChangeDetectionStrategy,
ChangeDetectorRef,
Component,
ElementRef,
EventEmitter,
forwardRef,
inject,
Expand All @@ -28,9 +31,10 @@ import { IconField } from 'primeng/iconfield';
import { InputIcon } from 'primeng/inputicon';
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';

export type ExtraTextareaSize = 'small' | 'base' | 'large' | 'xlarge';
export type ExtraTextareaLabelPosition = 'top' | 'left';
export type ExtraTextareaLabelPosition = 'default' | 'float' | 'left';
export type ExtraTextareaResizeEvent = Event | Record<string, unknown>;

let nextInputId = 0;
Expand All @@ -39,7 +43,16 @@ let nextInputId = 0;
selector: 'extra-textarea',
standalone: true,
changeDetection: ChangeDetectionStrategy.OnPush,
imports: [Textarea, IconField, InputIcon, FloatLabel, NgClass, NgTemplateOutlet, ExtraTooltipDirective],
imports: [
Textarea,
IconField,
InputIcon,
FloatLabel,
NgClass,
NgTemplateOutlet,
ExtraTooltipDirective,
ExtraCaptionComponent
],
host: { style: 'display: contents' },
providers: [
{
Expand All @@ -57,26 +70,26 @@ let nextInputId = 0;
<!-- Без label/caption поле не оборачиваем — сохраняем прежнюю DOM-структуру
(важно для p-inputgroup, где textarea обязана быть прямым flex-элементом). -->
@if (label || caption) {
<div class="extra-textarea" [class.extra-textarea--left]="labelPosition === 'left' && !floatLabel">
@if (label && labelPosition === 'left' && !floatLabel) {
<div class="extra-textarea" [class.extra-textarea--left]="labelPosition === 'left'">
@if (label && labelPosition === 'left') {
<ng-container [ngTemplateOutlet]="labelTpl" />
}
<div class="extra-textarea-body">
@if (floatLabel) {
@if (labelPosition === 'float') {
<p-floatlabel variant="in">
<ng-container [ngTemplateOutlet]="fieldTpl" />
@if (label) {
<ng-container [ngTemplateOutlet]="labelTpl" />
}
</p-floatlabel>
} @else {
@if (label && labelPosition === 'top') {
@if (label && labelPosition === 'default') {
<ng-container [ngTemplateOutlet]="labelTpl" />
}
<ng-container [ngTemplateOutlet]="fieldTpl" />
}
@if (caption) {
<div class="extra-textarea-caption">{{ caption }}</div>
<extra-caption [severity]="captionSeverity">{{ caption }}</extra-caption>
}
</div>
</div>
Expand All @@ -86,8 +99,11 @@ let nextInputId = 0;

<ng-template #labelTpl>
<label class="extra-textarea-label" [for]="inputId">
@if (requiredMark) {
<span class="extra-textarea-required" aria-hidden="true">*</span>
}
{{ label }}
@if (info) {
@if (info && labelPosition !== 'float') {
<i class="extra-textarea-label-icon ti ti-info-circle" [extra-tooltip]="info"></i>
}
</label>
Expand Down Expand Up @@ -165,19 +181,28 @@ let nextInputId = 0;
</ng-template>
`
})
export class ExtraTextareaComponent implements ControlValueAccessor, OnInit, OnChanges, Validator {
export class ExtraTextareaComponent implements ControlValueAccessor, OnInit, OnChanges, Validator, AfterViewInit {
private readonly _injector = inject(Injector);
private readonly _cdr = inject(ChangeDetectorRef);
private readonly _host = inject<ElementRef<HTMLElement>>(ElementRef);
private _ngControl: NgControl | null = null;

ngOnInit(): void {
this._ngControl = this._injector.get(NgControl, null, { self: true, optional: true });
}

// Атрибут autofocus на элементе, созданном Angular после загрузки страницы, браузер игнорирует
ngAfterViewInit(): void {
if (this.autofocus) this._host.nativeElement.querySelector('textarea')?.focus();
}

@Input() placeholder = '';
@Input() label = '';
@Input() labelPosition: ExtraTextareaLabelPosition = 'top';
@Input({ transform: booleanAttribute }) floatLabel = false;
/** Показывает маркер «*» перед лейблом (визуальный, валидацию не включает). */
@Input() requiredMark = false;
@Input() labelPosition: ExtraTextareaLabelPosition = 'default';
@Input() caption = '';
@Input() captionSeverity: ExtraCaptionSeverity = 'base';
@Input() info = '';
@Input({ transform: booleanAttribute }) clearable = false;
@Input({ transform: booleanAttribute }) resizable = true;
Expand Down Expand Up @@ -254,6 +279,7 @@ export class ExtraTextareaComponent implements ControlValueAccessor, OnInit, OnC

writeValue(value: string): void {
this.modelValue = value ?? '';
this._cdr.markForCheck();
}

registerOnChange(fn: (value: string) => void): void {
Expand All @@ -266,5 +292,6 @@ export class ExtraTextareaComponent implements ControlValueAccessor, OnInit, OnC

setDisabledState(isDisabled: boolean): void {
this.disabled = isDisabled;
this._cdr.markForCheck();
}
}
8 changes: 3 additions & 5 deletions src/lib/components/textarea/textarea.figma.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,8 +25,7 @@ updated: '2026-10-03'
|----------|-----|--------------|---------|
| `required` | `boolean` | `false` | Поле обязательно для заполнения: контрол невалиден, пока значение не введено/не выбрано; работает как NG_VALIDATORS-валидатор |
| `label` | `string` | `''` | Текст названия поля |
| `labelPosition` | `'top' \| 'left'` | `'top'` | Положение лейбла — соответствует Figma, но без устаревшего третьего значения `float` (вынесено в `floatLabel`, см. `docs/naming-rules.md`) |
| `floatLabel` | `boolean` | `false` | Лейбл-плейсхолдер, всплывающий над полем — отдельный переключатель, а не третье значение `labelPosition`; при `true` значение `labelPosition` для позиционирования лейбла не используется |
| `labelPosition` | `'default' \| 'float' \| 'left'` | `'default'` | Положение лейбла: сверху, плавающий внутри поля (`float`, Figma `has-float-label=true`) или слева |
| `caption` | `string` | `''` | Пояснение под полем |
| `info` | `string` | `''` | Текст тултипа иконки `ti-info-circle` рядом с лейблом |
| `clearable` | `boolean` | `false` | Показывает иконку очистки (×) при наличии значения — соответствует Figma-свойству `show-clear`; имя приведено к `*able`-конвенции (было `showClear`) |
Expand Down Expand Up @@ -152,7 +151,7 @@ Figma: `<Textarea>`, state=default, placeholder=true, has-floatlabel=false — n
Figma: `<Textarea>`, has-floatlabel=true

```html
<extra-textarea label="Комментарий" [floatLabel]="true" [(ngModel)]="comment"></extra-textarea>
<extra-textarea label="Комментарий" labelPosition="float" [(ngModel)]="comment"></extra-textarea>
```

### С кнопкой очистки (clearable)
Expand Down Expand Up @@ -215,7 +214,7 @@ descriptionControl = new FormControl('', [Validators.required, Validators.maxLen

## Related

- [InputText](../inputtext/inputtext.figma.md) — однострочное поле с тем же паттерном label/caption/info (но пока со старым тройным `labelPosition` — не копировать)
- [InputText](../inputtext/inputtext.figma.md) — однострочное поле с тем же паттерном label/caption/info
- [InputGroup](../inputgroup/inputgroup.figma.md) — обёртка с prefix/suffix-слотами
- [Токены](../../figma-code-connect/tokens.md) — цветовые токены состояний поля
- [Conventions](../../figma-code-connect/conventions.md) — соглашения маппинга Figma → Angular
Expand All @@ -233,5 +232,4 @@ descriptionControl = new FormControl('', [Validators.required, Validators.maxLen
**Don't:**
- Не подменяйте `value` через прямой DOM — теряется `dirty`-state и Angular-реактивность.
- Не задавайте `[disabled]="true"` как `@Input` — компонент его не объявляет; передавайте через `FormControl`.
- Не комбинируйте `labelPosition="left"` с ожиданием, что оно повлияет на `floatLabel=true` — при включённом `floatLabel` лейбл всегда всплывает над полем независимо от `labelPosition`.
- Не используйте `extra-textarea` для короткого однострочного текста — для него [InputText](../inputtext/inputtext.figma.md).
Loading
Loading