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/inputtext.md b/docs/components-api/inputtext.md index 9103c14b..6ca8f124 100644 --- a/docs/components-api/inputtext.md +++ b/docs/components-api/inputtext.md @@ -4,27 +4,28 @@ > ✅ **Реализован**: `ExtraInputTextComponent` (`@cdek-it/angular-ui-kit`) соответствует спецификации. -| Свойство | Описание | Типизация | По умолчанию | -| ---------------- | ----------------------------------------------------------------------------- | ---------------------------------- | ------------ | -| `placeholder` | текст подсказки внутри поля | `string` | `''` | -| `label` | текст названия поля | `string` | `''` | -| `labelPosition` | положение лейбла | `top \| left` | `top` | -| `floatLabel` | плавающий лейбл внутри поля (перекрывает `labelPosition`) | `boolean` | `false` | -| `clearable` | отображение иконки для очистки поля | `boolean` | `false` | -| `caption` | текст пояснения под полем | `string` | `''` | -| `info` | текст с доп. информацией (показывается в тултипе иконки ti-info-circle) | `string` | `''` | -| `size` | размер поля | `small \| base \| large \| xlarge` | `base` | -| `fluid` | растягивает поле на всю ширину контейнера | `boolean` | `false` | -| `type` | тип поля input | `text \| password` | `text` | -| `readonly` | только для чтения | `boolean` | `false` | -| `required` | поле обязательно для заполнения | `boolean` | `false` | -| `name` | имя поля (нативный атрибут `name`); используется браузером для автозаполнения | `string` | — | -| `autocomplete` | значение нативного атрибута `autocomplete` | `string` | — | -| `maxLength` | максимальное количество символов | `number` | — | -| `ariaLabel` | метка для программ экранного доступа | `string` | — | -| `ariaLabelledBy` | `id` внешнего элемента-метки для доступности | `string` | — | -| `autofocus` | автофокус при монтировании компонента | `boolean` | `false` | -| `tabindex` | порядок перехода по Tab | `number` | — | +| Свойство | Описание | Типизация | По умолчанию | +| ----------------- | ------------------------------------------------------------------------------- | ---------------------------------- | ------------ | +| `placeholder` | текст подсказки внутри поля | `string` | `''` | +| `label` | текст названия поля | `string` | `''` | +| `labelPosition` | положение лейбла: сверху, плавающий внутри поля или слева | `default \| float \| left` | `default` | +| `requiredMark` | маркер «\*» перед лейблом (только визуальный, валидацию не включает) | `boolean` | `false` | +| `clearable` | отображение иконки для очистки поля | `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` | +| `type` | тип поля input | `text \| password` | `text` | +| `readonly` | только для чтения | `boolean` | `false` | +| `required` | поле обязательно для заполнения | `boolean` | `false` | +| `name` | имя поля (нативный атрибут `name`); используется браузером для автозаполнения | `string` | — | +| `autocomplete` | значение нативного атрибута `autocomplete` | `string` | — | +| `maxLength` | максимальное количество символов | `number` | — | +| `ariaLabel` | метка для программ экранного доступа | `string` | — | +| `ariaLabelledBy` | `id` внешнего элемента-метки для доступности | `string` | — | +| `autofocus` | автофокус при монтировании компонента | `boolean` | `false` | +| `tabindex` | порядок перехода по Tab | `number` | — | # Стекозависимые пропсы diff --git a/src/lib/components/inputtext/inputtext.component.ts b/src/lib/components/inputtext/inputtext.component.ts index 4a80cd7a..5880679c 100644 --- a/src/lib/components/inputtext/inputtext.component.ts +++ b/src/lib/components/inputtext/inputtext.component.ts @@ -27,9 +27,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 ExtraInputTextSize = 'small' | 'base' | 'large' | 'xlarge'; -export type ExtraInputTextLabelPosition = 'top' | 'left'; +export type ExtraInputTextLabelPosition = 'default' | 'float' | 'left'; export type ExtraInputTextType = 'text' | 'password'; let nextInputId = 0; @@ -37,7 +38,16 @@ let nextInputId = 0; @Component({ selector: 'extra-input-text', standalone: true, - imports: [InputText, IconField, InputIcon, FloatLabel, NgClass, NgTemplateOutlet, ExtraTooltipDirective], + imports: [ + InputText, + IconField, + InputIcon, + FloatLabel, + NgClass, + NgTemplateOutlet, + ExtraTooltipDirective, + ExtraCaptionComponent + ], host: { style: 'display: contents' }, providers: [ { @@ -55,13 +65,12 @@ let nextInputId = 0; @if (label || caption) { - -
value: {{ email.value }} / status: {{ email.status }} / touched: {{ email.touched }}
- \`, -}) -export class InputTextReactiveFormsComponent { - email = new FormControl('', [Validators.required, Validators.email]); - - toggleDisabled(): void { - if (this.email.disabled) this.email.enable(); - else this.email.disable(); - } -} - ` + language: 'html', + transform: () => `