Skip to content
Merged
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: 54 additions & 0 deletions docs/components-api/image.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
# Image

Обёртка над PrimeNG Image: изображение с предпросмотром (маска, тулбар, зум, поворот).

> **Эталон Figma отсутствует.** Компонент добавлен как обёртка над `p-image`; токены `components.image`
> собраны из семантического уровня и не сверяются с макетом. Подробности — `src/lib/components/image/image.figma.md`.

## Импорт

```typescript
import { ExtraImageComponent } from '@cdek-it/angular-ui-kit/components/image';
```

## Входы

| Вход | Тип | По умолчанию | Описание |
|---|---|---|---|
| `src` | `string` | — (обязательный) | URL изображения |
| `alt` | `string` | `''` | Альтернативный текст |
| `width` | `string` | `undefined` | Ширина (как HTML-атрибут) |
| `height` | `string` | `undefined` | Высота (как HTML-атрибут) |
| `preview` | `boolean` | `false` | Предпросмотр по клику |
| `imageClass` | `string` | `undefined` | CSS-класс изображения |
| `styleClass` | `string` | `undefined` | CSS-класс корневого элемента |

## Пример

```html
<extra-image src="assets/photo.jpg" alt="Фото" [preview]="true"></extra-image>
```

## Слоты панели предпросмотра

Иконки кнопок тулбара заменяются шаблонами `extraImageTemplate`:

| Слот | Кнопка |
|---|---|
| `rotateRightIcon` | поворот вправо |
| `rotateLeftIcon` | поворот влево |
| `zoomOutIcon` | уменьшить |
| `zoomInIcon` | увеличить |
| `closeIcon` | закрыть |

```html
<extra-image src="assets/photo.jpg" alt="Фото" [preview]="true">
<ng-template extraImageTemplate="closeIcon"><i class="ti ti-x"></i></ng-template>
</extra-image>
```

Шаблоны импортируются через `ExtraImageTemplateDirective` из `@cdek-it/angular-ui-kit/components/image`.

## Доступность

`alt` обязателен по смыслу: без него изображение озвучивается как декоративное.
13 changes: 13 additions & 0 deletions src/lib/components/image/image-template.directive.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
import { Directive, Input, TemplateRef } from '@angular/core';

export type ExtraImageTemplateName = 'rotateRightIcon' | 'rotateLeftIcon' | 'zoomOutIcon' | 'zoomInIcon' | 'closeIcon';

/** Именованный шаблон иконки панели предпросмотра. */
@Directive({
selector: '[extraImageTemplate]'
})
export class ExtraImageTemplateDirective {
@Input({ required: true }) extraImageTemplate!: ExtraImageTemplateName;

constructor(public template: TemplateRef<unknown>) {}
}
52 changes: 52 additions & 0 deletions src/lib/components/image/image.component.spec.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
import { Component } from '@angular/core';
import { ComponentFixture, TestBed } from '@angular/core/testing';
import { provideNoopAnimations } from '@angular/platform-browser/animations';
import { providePrimeNG } from 'primeng/config';

import { ExtraImageComponent } from './image.component';

@Component({
standalone: true,
imports: [ExtraImageComponent],
template: `
@if (show) {
<extra-image src="assets/images/avatar/avatar.png" alt="Аватар" [preview]="true"></extra-image>
}
`
})
class HostComponent {
show = true;
}

describe('ExtraImageComponent', () => {
let fixture: ComponentFixture<HostComponent>;

beforeEach(async () => {
await TestBed.configureTestingModule({
imports: [HostComponent],
providers: [provideNoopAnimations(), providePrimeNG({})]
}).compileComponents();

fixture = TestBed.createComponent(HostComponent);
fixture.detectChanges();
});

afterEach(() => {
document.body.classList.remove('p-overflow-hidden');
document.body.style.removeProperty('--scrollbar-width');
});

it('снимает блокировку прокрутки при уничтожении с открытым предпросмотром', () => {
const previewButton: HTMLElement | null = fixture.nativeElement.querySelector('.p-image-preview-mask');
expect(previewButton).withContext('кнопка предпросмотра').toBeTruthy();

previewButton!.click();
fixture.detectChanges();
expect(document.body.classList.contains('p-overflow-hidden')).withContext('прокрутка заблокирована').toBeTrue();

fixture.componentInstance.show = false;
fixture.detectChanges();

expect(document.body.classList.contains('p-overflow-hidden')).withContext('прокрутка разблокирована').toBeFalse();
});
});
119 changes: 119 additions & 0 deletions src/lib/components/image/image.component.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,119 @@
import {
AfterContentInit,
ChangeDetectionStrategy,
ChangeDetectorRef,
Component,
ContentChildren,
Input,
OnDestroy,
QueryList,
ViewChild
} from '@angular/core';
import { NgTemplateOutlet } from '@angular/common';
import { Image } from 'primeng/image';
import { unblockBodyScroll } from 'primeng/dom';
import { PrimeTemplate } from 'primeng/api';
import { ExtraImageTemplateDirective, ExtraImageTemplateName } from './image-template.directive';

/**
* Обёртка над PrimeNG Image: картинка с предпросмотром (маска, тулбар, зум, поворот).
*
* Эталона в Figma нет, токены `components.image` собраны вручную (см. `image.figma.md`).
*/
@Component({
selector: 'extra-image',
standalone: true,
changeDetection: ChangeDetectionStrategy.OnPush,
imports: [Image, PrimeTemplate, NgTemplateOutlet],
template: `
<p-image
[src]="src"
[alt]="alt"
[width]="width"
[height]="height"
[preview]="preview"
[imageClass]="imageClass"
[styleClass]="styleClass"
(onShow)="previewOpen = true"
(onHide)="previewOpen = false"
>
@if (rotateRightTpl) {
<ng-template pTemplate="rotaterighticon">
<ng-container [ngTemplateOutlet]="rotateRightTpl!.template"></ng-container>
</ng-template>
}
@if (rotateLeftTpl) {
<ng-template pTemplate="rotatelefticon">
<ng-container [ngTemplateOutlet]="rotateLeftTpl!.template"></ng-container>
</ng-template>
}
@if (zoomOutTpl) {
<ng-template pTemplate="zoomouticon">
<ng-container [ngTemplateOutlet]="zoomOutTpl!.template"></ng-container>
</ng-template>
}
@if (zoomInTpl) {
<ng-template pTemplate="zoominicon">
<ng-container [ngTemplateOutlet]="zoomInTpl!.template"></ng-container>
</ng-template>
}
@if (closeTpl) {
<ng-template pTemplate="closeicon">
<ng-container [ngTemplateOutlet]="closeTpl!.template"></ng-container>
</ng-template>
}
</p-image>
`
})
export class ExtraImageComponent implements AfterContentInit, OnDestroy {
/** URL изображения. */
@Input({ required: true }) src = '';
/** Альтернативный текст. */
@Input() alt = '';
/** Ширина изображения (строка, как в HTML-атрибуте). */
@Input() width: string | undefined;
/** Высота изображения (строка, как в HTML-атрибуте). */
@Input() height: string | undefined;
/** Включает предпросмотр по клику. */
@Input() preview = false;
/** CSS-класс самого изображения. */
@Input() imageClass: string | undefined;
/** CSS-класс корневого элемента. */
@Input() styleClass: string | undefined;

@ContentChildren(ExtraImageTemplateDirective) templates!: QueryList<ExtraImageTemplateDirective>;

@ViewChild(Image) private image?: Image;

/** Открыт ли предпросмотр: нужен, чтобы снять блокировку прокрутки при уничтожении. */
previewOpen = false;

rotateRightTpl?: ExtraImageTemplateDirective;
rotateLeftTpl?: ExtraImageTemplateDirective;
zoomOutTpl?: ExtraImageTemplateDirective;
zoomInTpl?: ExtraImageTemplateDirective;
closeTpl?: ExtraImageTemplateDirective;

constructor(private cdr: ChangeDetectorRef) {}

ngAfterContentInit(): void {
this.rotateRightTpl = this.findTemplate('rotateRightIcon');
this.rotateLeftTpl = this.findTemplate('rotateLeftIcon');
this.zoomOutTpl = this.findTemplate('zoomOutIcon');
this.zoomInTpl = this.findTemplate('zoomInIcon');
this.closeTpl = this.findTemplate('closeIcon');
this.cdr.detectChanges();
}

ngOnDestroy(): void {
// PrimeNG блокирует прокрутку body на открытом preview и снимает блокировку только
// в closePreview(). При уничтожении обёртки предпросмотр нужно закрыть самим.
if (!this.previewOpen && !this.image?.previewVisible) return;
this.image?.closePreview();
unblockBodyScroll();
}

private findTemplate(name: ExtraImageTemplateName): ExtraImageTemplateDirective | undefined {
return this.templates.find((tpl) => tpl.extraImageTemplate === name);
}
}
44 changes: 44 additions & 0 deletions src/lib/components/image/image.figma.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
---
component: ExtraImage
selector: extra-image
import:
symbol: ExtraImageComponent
from: '@cdek-it/angular-ui-kit/components/image'
figma:
fileKey: 'Q1BWgZ7zoV5UzlBOnjW0cM'
nodeId: ''
name: ''
status: experimental
updated: '2026-11-19'
---

# Image

**Эталон в Figma отсутствует.** В UI Kit DS v3.0 нет набора `<Image>`, поэтому компонент добавлен как обёртка над
PrimeNG `p-image` и **не сверяется** гейтом `check-figma-values`.

Токены `components.image` собраны вручную из семантического уровня (не из макета):

| Токен | Значение (семантика) | Где применён |
|---|---|---|
| `root.borderRadius` | `dimension.borderRadius.300` | скругление изображения |
| `preview.mask.background` | `color.bg.neutral.medium.default` | маска предпросмотра |
| `preview.mask.color` | `color.fg.default` | иконка предпросмотра |
| `mask.background` | `color.bg.surface.backdrop` | фон оверлея предпросмотра |
| `toolbar.background` | `color.bg.surface.raised.default` | тулбар предпросмотра |
| `toolbar.borderColor` | `color.border.neutral.default` | рамка тулбара |
| `toolbar.borderWidth` | `dimension.borderWidth.100` | толщина рамки тулбара |
| `toolbar.borderRadius` | `dimension.borderRadius.300` | радиус тулбара |
| `toolbar.padding` | `dimension.space.200` | внутренние отступы тулбара |
| `toolbar.gap` | `dimension.space.200` | расстояние между кнопками |
| `toolbar.shadow` | `effects.elevation.300` | тень тулбара |
| `action.size` | `dimension.size.1000` | размер кнопки (36px) |
| `action.iconSize` | `dimension.size.450` | размер иконки (16px) |
| `action.borderRadius` | `dimension.borderRadius.max` | скругление кнопки |
| `action.color` | `color.fg.default` | цвет иконки |
| `action.hoverBackground` | `color.bg.neutral.medium.default` | фон кнопки при наведении |
| `action.hoverColor` | `color.fg.default` | цвет иконки при наведении |
| `action.focusRing.width` | `dimension.focusRing.width` | толщина кольца фокуса |
| `action.focusRing.color` | `color.fg.brand.active` | цвет кольца фокуса |

Когда появится эталон в Figma — заменить значения на макетные и прогнать `check-figma-values`.
6 changes: 6 additions & 0 deletions src/lib/components/image/ng-package.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
{
"$schema": "ng-packagr/ng-package.schema.json",
"lib": {
"entryFile": "public_api.ts"
}
}
2 changes: 2 additions & 0 deletions src/lib/components/image/public_api.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
export * from './image.component';
export * from './image-template.directive';
5 changes: 5 additions & 0 deletions src/lib/providers/prime-preset/map-tokens.ts
Original file line number Diff line number Diff line change
Expand Up @@ -53,12 +53,17 @@ import { autocompleteCss } from './tokens/components/autocomplete';
import { popoverCss } from './tokens/components/popover';
import { selectbuttonCss } from './tokens/components/selectbutton';
import { fileuploadCss } from './tokens/components/fileupload';
import { imageCss } from './tokens/components/image';

const presetTokens: Preset<AuraBaseDesignTokens> = {
primitive: tokens.primitive as unknown as AuraBaseDesignTokens['primitive'],
semantic: tokens.semantic as unknown as AuraBaseDesignTokens['semantic'],
components: {
...(tokens.components as unknown as ComponentsDesignTokens),
image: {
...((tokens.components as unknown as Record<string, object>)['image'] ?? {}),
css: imageCss
},
avatar: {
...(tokens.components.avatar as unknown as ComponentsDesignTokens['avatar']),
css: avatarCss
Expand Down
74 changes: 74 additions & 0 deletions src/lib/providers/prime-preset/tokens/components/image.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
export const imageCss = ({ dt }: { dt: (token: string) => string }): string => `
.p-image {
border-radius: ${dt('image.root.borderRadius')};
overflow: hidden;
}

.p-image-preview-mask {
background: ${dt('image.preview.mask.background')};
}

.p-image-mask {
background: ${dt('image.mask.background')};
}

/* Aura задаёт фон маски анимацией с forwards — переопределяем её. */
.p-image-mask.p-overlay-mask-enter {
animation-name: p-image-mask-enter;
}

.p-image-mask.p-overlay-mask-leave {
animation-name: p-image-mask-leave;
}

@keyframes p-image-mask-enter {
from {
background: transparent;
}
to {
background: ${dt('image.mask.background')};
}
}

@keyframes p-image-mask-leave {
from {
background: ${dt('image.mask.background')};
}
to {
background: transparent;
}
}

.p-image-toolbar {
background: ${dt('image.toolbar.background')};
border: ${dt('image.toolbar.borderWidth')} solid ${dt('image.toolbar.borderColor')};
border-radius: ${dt('image.toolbar.borderRadius')};
padding: ${dt('image.toolbar.padding')};
gap: ${dt('image.toolbar.gap')};
box-shadow: ${dt('image.toolbar.shadow')};
}

.p-image-toolbar .p-image-action {
width: ${dt('image.action.size')};
height: ${dt('image.action.size')};
border-radius: ${dt('image.action.borderRadius')};
color: ${dt('image.action.color')};
}

.p-image-toolbar .p-image-action:hover {
background: ${dt('image.action.hoverBackground')};
color: ${dt('image.action.hoverColor')};
}

.p-image-toolbar .p-image-action:focus-visible {
outline: ${dt('image.action.focusRing.width')} solid ${dt('image.action.focusRing.color')};
outline-offset: 0;
box-shadow: none;
}

.p-image-toolbar .p-image-action .p-icon {
width: ${dt('image.action.iconSize')};
height: ${dt('image.action.iconSize')};
font-size: ${dt('image.action.iconSize')};
}
`;
Loading
Loading