# @quantumart/qa-engine-page-structure-angular

> **@quantumart/qa-engine-page-structure-angular**

Latest version **1.3.5** (published 2025-05-29) · MIT license · 0 weekly downloads

## Install

```sh
npm install @quantumart/qa-engine-page-structure-angular
pnpm add @quantumart/qa-engine-page-structure-angular
yarn add @quantumart/qa-engine-page-structure-angular
bun add @quantumart/qa-engine-page-structure-angular
```

## Health

**Score 35/100 (D)** — status: maintenance-mode.

Positive: has types; esm support; no vulnerabilities.

Warnings: low downloads.

Negative: stale; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.3.5 |
| Published | 2025-05-29 |
| First published | 2022-12-09 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 1 |
| Unpacked size | 417.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Quantum Art |
| Maintainers | akuznetsova, celutp, russian_dragon, thorgnir, v.sarenkov, mxgr, garikmk |

## Links

- npm: https://www.npmjs.com/package/@quantumart/qa-engine-page-structure-angular
- npm.io page: https://npm.io/package/@quantumart/qa-engine-page-structure-angular

## Dependencies (1)

- [tslib](https://npm.io/package/tslib.md) ^2.6.1

## Recent versions

- 1.3.5 (latest) — 2025-05-29
- 1.3.4 — 2025-04-23
- 1.3.3 — 2024-04-22
- 1.3.2 — 2024-04-22
- 1.3.1 — 2023-09-20
- 1.2.3 — 2023-09-18
- 1.2.2 — 2023-09-07
- 1.2.1 — 2023-09-07
- 1.2.0 — 2023-09-07
- 1.1.2 — 2023-09-07
- 1.1.1 — 2023-09-05
- 1.1.0 — 2023-09-05
- 1.0.0-beta — 2023-07-25
- 0.3.3 — 2022-12-26
- 0.3.2 — 2022-12-23
- … 8 more at https://npm.io/package/@quantumart/qa-engine-page-structure-angular/versions

## README

**@quantumart/qa-engine-page-structure-angular**

Данная библиотека предоставляет набор инструментов для построения фронтенда для сайта на базе QP (Angular версия).

**Demo site**
* [Исходники](https://tfs.dev.qsupport.ru/tfs/QuantumartCollection/QA.Core/_git/QA.Engine.Demosite)
* [Площадка](http://demositerus.dev.qsupport.ru/)
* [QP](https://qp.dev.qsupport.ru/) (customer code: qa_demosite_rus)

**Описание**

Необходимый бэкенд для построения сайта:
* База данных на основе qp
* API на .NET Core с методом получения структуры сайта (дерево UniversalAbstractItem)
 
**Установка**
           
Установить npm пакет:

```npm install @quantumart/qa-engine-page-structure-angular```

**Пример подключения**

Импортировать модуль QaEnginePageStructureModule в основном модуле angular-приложения:
```typescript
...
import { QaEnginePageStructureModule, WidgetComponent } from '@quantumart/qa-engine-page-structure-angular';

@NgModule({
  ...  
  imports: [
    ...
    QaEnginePageStructureModule.forRoot({
      widgetPlatformApiUrl: environment.WIDGET_PLATFORM_API_URL,
      layoutWidgetZones: ['SiteHeaderZone', 'SiteFooterZone'],
      widgetMapping: new Map<string, Type<WidgetComponent>>([
        ['html_widget', HtmlWidgetComponent],
        ['banner_widget', BannerWidgetComponent],
        ['feedback_widget', FeedbackWidgetComponent],
        ...
      ]),
    }), 
    ...  
  ],
  ...
```
* widgetPlatformApiUrl - базовый URL API виджетной платформы
* layoutWidgetZones - список виджетных зон, размещенных в шаблоне
* widgetMapping - маппинг виджетов на angular-компоненты  

Определить angular-роуты:

```typescript
...
import {
    DynamicRoutesInitializer,
    InitialRequestComponent,
    LayoutWidgetsResolver,
    PageDetailsResolver
} from '@quantumart/qa-engine-page-structure-angular';

const routes: Routes = [
  {
    path: '**',
    component: InitialRequestComponent,
    canActivate: [DynamicRoutesInitializer],
  },
  {
    path: 'start-page',
    loadChildren: () => import('./start-page/start-page.module').then(m => m.StartPageModule),
    resolve: {
      details: PageDetailsResolver,
      staticWidgets: LayoutWidgetsResolver,
    },
    data: {
      nodeType: 'start_page',
    },
  },
  ...
];

``` 
Пример реализации компонента стартовой страницы: 

```typescript
import { NodeDetails } from '@quantumart/qa-engine-page-structure-angular';
import { SiteNodeComponent, SiteNodeService } from '../services';

export interface StartPageDetails extends NodeDetails {
  title: string;
}

@Component({
  selector: 'qa-start-page',
  templateUrl: './start-page.component.html',
  changeDetection: ChangeDetectionStrategy.OnPush
})
export class StartPageComponent implements SiteNodeComponent {
  public get id(): number {
    return this.siteNodeService.getNodeId();
  }

  public readonly pageDetails$ = this.siteNodeService.getDetails<StartPageDetails>();

  constructor(private readonly siteNodeService: SiteNodeService) {
  }
}

```
Пример реализации компонента виджета:
```typescript
...
import { WidgetComponent, WidgetDetails } from '@quantumart/qa-engine-page-structure-angular';

export interface HtmlWidgetDetails extends WidgetDetails {
  html: string;
}

@Component({
  selector: 'qa-html-widget',
  templateUrl: './html-widget.component.html',
  changeDetection: ChangeDetectionStrategy.OnPush,
})
export class HtmlWidgetComponent implements WidgetComponent {
  @Input() public widget!: HtmlWidgetDetails;
}

```

---
_Source: https://npm.io/package/@quantumart/qa-engine-page-structure-angular · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
