Skip to content

feat(image): add ExtraImage component and preview toolbar - #200

Merged
AxyIX merged 2 commits into
feature/form-caption-figma-syncfrom
feature/media-image-figma-sync
Nov 20, 2026
Merged

AxyIX merged 2 commits into
feature/form-caption-figma-syncfrom
feature/media-image-figma-sync

Conversation

@khaliulin

Copy link
Copy Markdown
Contributor

Сводка

Добавлен ExtraImageComponent — обёртка над p-image (эталона Figma нет) — и доработана панель предпросмотра: размеры и цвета на токенах, исправлены hover и focus, иконки заменяются слотами, маска использует backdrop. Stories разделены по одному состоянию, Docs и токены обновлены.

Изменения

  • Компонент extra-image (7 входов) и директива слотов extraImageTemplate для иконок панели.
  • components.image: 19 токенов; панель 36/16, белый фон с тенью, hover/focus, маска.
  • CSS панели и override анимации маски.
  • Stories: Default, Preview, Width, Crop, Frame — по одному представлению; Docs и image.figma.md обновлены.

Изменения API

  • Добавлены входы src, alt, width, height, preview, imageClass, styleClass и слоты rotateRightIcon, rotateLeftIcon, zoomOutIcon, zoomInIcon, closeIcon.
  • Экспорт ExtraImageTemplateDirective.
  • Ломающих изменений нет.

Технические заметки для ревьюеров

  • focusRing — fg.brand.active (green 700): border.focus даёт alpha 20% и контраст ~1.14:1 к белому.
  • Маска: surface.backdrop плюс override p-overlay-mask-enter/leave, иначе фон задаёт анимация Aura.
  • height-атрибут не фиксирует высоту из-за img { height: auto } (Tailwind preflight); высота задаётся imageClass.
  • styleClass применяется к inline-корню: для border/padding нужен inline-block, иначе граница рисуется полосой.
  • В диапазон PR также попадает глобальное включение expanded Controls (.storybook/preview.ts) из ветки feature/storybook-controls-expanded.

Визуальные изменения

  • Панель 290×66 → 230×54, кнопки 48 → 36, иконки 24 → 16, серый фон → белый с тенью.
  • Hover: белое на светло-сером → neutral.medium / fg.default; focus: видимое кольцо 2px green 700.
  • Маска: rgba(0,0,0,0.4) → 0.3.

Проверка

  • check-component image — PASS.
  • check-stories-source image — PASS, 5/5.
  • check-stories-bg и check-stories-controls — PASS.
  • check-stories-descriptions image — SKIPPED: эталона image в origin/main нет.
  • Prettier — PASS; Storybook на 390, 900 и 1200 — без ошибок в консоли.
  • check-dt-refs — FAIL только унаследованные: 4 мёртвые ссылки confirm-dialog и 16 коллизий multiselect/radiobutton; по image находок нет.

Известные проблемы и открытые вопросы

  • check-dt-refs не зелёный из-за чужих компонентов, к image не относится.
  • Кольцо фокуса отличается от border.focus ради контраста — подтвердить у дизайна.
  • Эталона Figma у Image нет: токены собраны вручную.

Стек

База: feature/form-caption-figma-sync (#193). Ветка: feature/media-image-figma-sync, один коммит c1703f50; в диапазон входит глобальное изменение .storybook/preview.ts.

1. Обёртка extra-image над p-image: 7 входов и слоты extraImageTemplate для иконок панели.
2. Панель: 36px кнопки, 16px иконки, белый фон с тенью, hover/focus из токенов, маска через backdrop.
3. Stories по одному состоянию: Default, Preview, Width, Crop, Frame; Docs и токены обновлены.

Заметки для ревьюеров:
- 19 токенов в components.image; focusRing — fg.brand.active (green 700) ради контраста.
- API: 7 входов и 5 слотов, ломающих изменений нет; эталона Figma нет.
- descriptions-gate — SKIPPED: компонента нет в origin/main.
@AxyIX

AxyIX commented Nov 20, 2026

Copy link
Copy Markdown
Collaborator

В PR #200 нашёл 4 проблемы. Проверял c1703f50 относительно целевой ветки feature/form-caption-figma-sync (bb4a31d1).

  1. [P1] После уничтожения компонента остаётся заблокирована прокрутка страницы.
    Воспроизвёл: открыть preview и удалить extra-image через @if. Маска исчезает, но на body остаются p-overflow-hidden и overflow: hidden. Нужна очистка открытого предпросмотра при уничтожении обёртки. [image.component.ts:63](

    export class ExtraImageComponent implements AfterContentInit {
    ).

  2. [P2] Новый токен фона preview фактически игнорируется.
    Объявлен image.previewMask.background, тогда как Aura использует image.preview.mask.background. Оба пути превращаются в --p-image-preview-mask-background, и итоговое значение остаётся унаследованным: rgba(0,0,0,0.4) / 0.6 вместо указанного нейтрального цвета. Нужно переопределить родную группу токенов. [tokens.json:5882](

    ).

  3. [P2] Иконка открытия preview плохо различима в тёмной теме.
    color.fg.on.brand.default разрешается в тёмный #2b2e33 в обеих темах. На затемнённом изображении значок глаза практически сливается с фоном — это видно на штатном изображении из stories. Нужен цвет, контрастирующий с маской в обеих темах. [tokens.json:5886](

    "color": "{color.fg.on.brand.default}"
    ).

  4. [P2] Кавычки в Controls ломают story.
    Значения напрямую вставляются в HTML. Например, alt = Фото "Аватар" вызывает ошибку JIT-компиляции Opening tag "extra-image" not terminated. Для живого шаблона нужны биндинги к props, для примера кода — экранирование значений. [image.stories.ts:115](

    const attrs = [`src="${args.src ?? ''}"`, `alt="${args.alt ?? ''}"`];
    ).

Сборка библиотеки и typecheck Storybook прошли после генерации documentation.json. Статические слоты иконок работают. Проверки выполнял в отдельном checkout; локальные изменения в main сохранены.

1. Снимать блокировку прокрутки body при уничтожении обёртки с открытым предпросмотром.
2. Переопределить нативные токены image.preview.mask: фон маски и контрастный цвет иконки.
3. Перевести живой шаблон story на биндинги и экранировать значения Controls в snippet.
4. Добавить регрессионный тест на снятие блокировки прокрутки при уничтожении.

Заметки для ревьюеров:
- Токены изменены только в components.image; check-component и check-stories-source проходят.
- Karma-тест ExtraImageComponent и сборка библиотеки проходят; e2e image — 12 passed, 2 known.
@khaliulin

khaliulin commented Nov 20, 2026 •

Copy link
Copy Markdown
Contributor Author
  1. [P1] Исправлено: в ngOnDestroy закрываю preview и снимаю блокировку body (closePreview() + unblockBodyScroll()). Тест: preview → уничтожение → p-overflow-hidden снят. image.component.ts, spec.

  2. [P2] Исправлено: вместо previewMask/previewIcon — нативная группа preview.mask.{background,color}, переопределяется нативная переменная. Маска нейтральная в двух темах. tokens.json, image.ts.

  3. [P2] Исправлено: иконка берёт preview.mask.color = {color.fg.default} — тёмная на светлой маске, белая на тёмной; контраст проверен в обеих темах. tokens.json, image.figma.md.

  4. [P2] Исправлено: живой шаблон story — на биндингах к props, в snippet значения Controls экранируются (&, ", <); alt с кавычками не ломает JIT. image.stories.ts.

Проверено: build:lib, check-component, check-stories-source, Karma-тест; e2e image — 12 passed, 2 known.

@AxyIX
AxyIX merged commit e501457 into feature/form-caption-figma-sync Nov 20, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants