From e240d4c8258555db46f1d5893ad8b36184cfda0e Mon Sep 17 00:00:00 2001 From: Danil Khaliulin Date: Fri, 13 Nov 2026 01:09:36 +0800 Subject: [PATCH 1/5] feat(textarea): sync styles and API with Figma MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 1. Добавлен недостающий css обёртки .extra-textarea: flex-раскладка, лейбл слева выровнен по верху поля, лейбл 14/14 и подпись 14/14 как в Figma, полная ширина для fluid-полей внутри обёрток. 2. line-height по размерам и паддинги приведены к формовым токенам Figma. 3. Переработан плавающий лейбл: лейбл 14/20 в покое и 12/14 поднятым, текст начинается под поднятым лейблом, placeholder скрыт в покое. 4. Добавлен вход requiredMark — красная «*» перед лейблом. 5. Добавлен вход captionSeverity (base, success, warning, danger, info); подпись рисует общий компонент extra-caption. 6. Поле фокусируется по autofocus после создания view: браузеры игнорируют атрибут autofocus у элементов, добавленных после загрузки страницы. 7. Сторис переработаны: одна сторис — один пресет Figma, один экземпляр, литералы в Source, Controls для всех 23 входов; старые example-компоненты удалены. Заметки для ревьюеров: - BREAKING относительно main: labelPosition принимает default | float | left; булев floatLabel, добавленный в main, удалён. Расходится со строками для полей ввода в docs/naming-rules.md — решение владельца. - API: новые входы requiredMark и captionSeverity (по умолчанию base); иконка info скрыта у плавающего лейбла, как в Figma. - Из main сохранены: required, name, autocomplete, maxLength, ariaLabel, ariaLabelledBy, tabindex, readonly. - Токены: components.textarea получает правила обёртки, лейбла, размеров и плавающего лейбла; в tokens.json добавлены соответствующие значения. - Известное отличие от Figma: float-поле при rows=3 высотой 88, в Figma 80 (80 — это min-height). - Открытый вопрос к дизайну: в Figma у float-поля в фокусе с placeholder лейбл остаётся 14/20, в коде поднимается до 12/14. Оставлено как есть по решению владельца. --- docs/components-api/textarea.md | 54 ++- .../components/textarea/textarea.component.ts | 49 ++- src/lib/components/textarea/textarea.figma.md | 8 +- .../tokens/components/textarea.ts | 102 ++++- .../providers/prime-preset/tokens/tokens.json | 26 +- .../examples/textarea-autoresize.component.ts | 48 --- .../examples/textarea-disabled.component.ts | 46 --- .../textarea-float-label.component.ts | 60 --- .../examples/textarea-invalid.component.ts | 47 --- .../examples/textarea-labels.component.ts | 69 ---- .../examples/textarea-readonly.component.ts | 46 --- .../examples/textarea-sizes.component.ts | 50 --- .../components/textarea/textarea.stories.ts | 352 +++++++++++++++--- 13 files changed, 476 insertions(+), 481 deletions(-) delete mode 100644 src/stories/components/textarea/examples/textarea-autoresize.component.ts delete mode 100644 src/stories/components/textarea/examples/textarea-disabled.component.ts delete mode 100644 src/stories/components/textarea/examples/textarea-float-label.component.ts delete mode 100644 src/stories/components/textarea/examples/textarea-invalid.component.ts delete mode 100644 src/stories/components/textarea/examples/textarea-labels.component.ts delete mode 100644 src/stories/components/textarea/examples/textarea-readonly.component.ts delete mode 100644 src/stories/components/textarea/examples/textarea-sizes.component.ts diff --git a/docs/components-api/textarea.md b/docs/components-api/textarea.md index 667ed0b5..626d90ee 100644 --- a/docs/components-api/textarea.md +++ b/docs/components-api/textarea.md @@ -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`). diff --git a/src/lib/components/textarea/textarea.component.ts b/src/lib/components/textarea/textarea.component.ts index 806ab49c..8c2b1c32 100644 --- a/src/lib/components/textarea/textarea.component.ts +++ b/src/lib/components/textarea/textarea.component.ts @@ -1,7 +1,10 @@ import { + AfterViewInit, booleanAttribute, ChangeDetectionStrategy, + ChangeDetectorRef, Component, + ElementRef, EventEmitter, forwardRef, inject, @@ -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; let nextInputId = 0; @@ -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: [ { @@ -57,12 +70,12 @@ let nextInputId = 0; @if (label || caption) { -
- @if (label && labelPosition === 'left' && !floatLabel) { +
+ @if (label && labelPosition === 'left') { }
- @if (floatLabel) { + @if (labelPosition === 'float') { @if (label) { @@ -70,13 +83,13 @@ let nextInputId = 0; } } @else { - @if (label && labelPosition === 'top') { + @if (label && labelPosition === 'default') { } } @if (caption) { -
{{ caption }}
+ {{ caption }} }
@@ -86,8 +99,11 @@ let nextInputId = 0; @@ -165,19 +181,28 @@ let nextInputId = 0; ` }) -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); 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; @@ -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 { @@ -266,5 +292,6 @@ export class ExtraTextareaComponent implements ControlValueAccessor, OnInit, OnC setDisabledState(isDisabled: boolean): void { this.disabled = isDisabled; + this._cdr.markForCheck(); } } diff --git a/src/lib/components/textarea/textarea.figma.md b/src/lib/components/textarea/textarea.figma.md index cbc7c23c..c4e10c7e 100644 --- a/src/lib/components/textarea/textarea.figma.md +++ b/src/lib/components/textarea/textarea.figma.md @@ -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`) | @@ -152,7 +151,7 @@ Figma: `