Skip to content

ui-modal

@mmm/ui-modal

Installation

Terminal window
pnpm add @mmm/ui-modal

Peer Dependencies muessen im Service vorhanden sein:

  • @angular/common, @angular/core, @angular/forms, @angular/router, rxjs
  • @mmm/designsystem (ab 1.17.1): liefert die CSS-Variablen und die Viewport-Breakpoints, mit denen das Layout des Dialogs umschaltet (mobil unterhalb von Breakpoint m)

Inhalt

Das Paket exportiert:

Schnellstart

const ref = dialog.open(MyDialogComponent, {
data: { id: "123" },
width: "760px",
maxWidth: "1000px",
maxHeight: "90dvh",
overflow: "auto",
});
ref.afterClosed().subscribe((result) => {
// Dialog-Ergebnis verarbeiten
});

Alle Größen bleiben innerhalb des Viewports. Ohne Größenangabe passt sich das Panel dynamisch an seinen Inhalt an.

Open-Optionen

  • width, minWidth, maxWidth, height, maxHeight
  • contentPadding
  • overflow: "auto", "hidden" oder "visible"
  • closeOnBackdrop und closeOnEscape (Standard jeweils true)
  • ariaLabel
  • panelClass und backdropClass

Dropdowns, Popover und andere Inhalte, die das Panel überlagern sollen, benötigen overflow: "visible":

dialog.open(MyDialogComponent, {
overflow: "visible",
});

Header und Aktionen

Bestehende Header-Direktiven bleiben unverändert:

<span mmm-modal-header>Dialogtitel</span>
<ng-template mmm-modal-actions-right>
<button type="button" (click)="ref.close()">Schließen</button>
</ng-template>

Hero

Oberhalb des Headers kann ein randloser Hero-Bereich gerendert werden. Er lässt sich direkt beim Öffnen über den Service konfigurieren, ohne die Dialog-Komponente anzupassen:

// Illustration, volle Breite, 200px hoch
dialog.open(MyDialogComponent, {
hero: { type: "illustration", src: "assets/illustration.svg", alt: "" },
});
// Icon links, 24px Padding (16px mobil), kein Hintergrund
dialog.open(MyDialogComponent, {
hero: { type: "icon", icon: WarningIconComponent },
});
// Icon zentriert auf Highlight-Hintergrund
dialog.open(MyDialogComponent, {
hero: { type: "icon", icon: WarningIconComponent, align: "center" },
});

icon akzeptiert eine Komponente (optional mit iconInputs) oder ein TemplateRef. background und color überschreiben Hintergrund und Icon-Farbe der zentrierten Variante.

Alternativ innerhalb der Dialog-Komponente per Template. Der Template-Inhalt wird als Bild bzw. Icon verwendet:

<ng-template mmm-modal-hero variant="illustration">
<img src="assets/illustration.svg" alt="" />
</ng-template>
<ng-template mmm-modal-hero variant="icon" align="center">
<mmm-icon>warning</mmm-icon>
</ng-template>
<!-- ohne variant: freier Inhalt ohne Padding und Hintergrund -->
<ng-template mmm-modal-hero>
<div class="my-hero">…</div>
</ng-template>

CSS-Variablen

Abstände, Farben und Typografie sind Custom Properties auf .mmm-dialog-host. Sie lassen sich global (auf .mmm-dialog-host), pro Dialog (per panelClass) oder pro Aufruf (Open-Optionen) überschreiben. Wo das Designsystem Tokens hat, werden sie als Standard verwendet. Mobile Werte gelten unterhalb von Breakpoint m, Desktop-Werte ab m (Titelgröße ab l).

Das Abstandsmodell: --dialog-pad-* ist der Rand rundherum, --dialog-group-gap der Abstand zwischen den Gruppen Hero, Header+Inhalt und Footer, --dialog-item-gap der Abstand innerhalb einer Gruppe (Titel zu Text, Button zu Button).

VariableMobilDesktop
--dialog-pad-inline, --dialog-pad-block--mmm-space-16--mmm-space-24
--dialog-group-gap--mmm-space-24
--dialog-item-gap--mmm-space-16
--dialog-backdrop-pad--mmm-space-16--mmm-space-24
--dialog-backdrop-bg, --dialog-backdrop-blurrgba(20,31,46,.52), 3px
--dialog-bg, --dialog-fg--mmm-greyscale-white, --mmm-typography-text-foreground
--dialog-radius, --dialog-shadow--mmm-border-radius-lg, --mmm-shadow-overlay-strong
--dialog-default-width / -min-width / -max-width / -max-height100% / 0 / 100% / 90dvhfit-content / 580px / 800px / 90dvh
--dialog-hero-icon-size96px
--dialog-hero-illustration-height, --dialog-hero-illustration-fit200px, cover
--dialog-hero-banner-bg, --dialog-hero-banner-fg--mmm-main-colors-highlight, Weiß
--dialog-hero-bg, --dialog-hero-fgpro Hero über background / color
--dialog-header-fg, --dialog-header-bg--mmm-main-colors-highlight, --dialog-bg
--dialog-header-gap--dialog-item-gap
--dialog-title-font-size / --dialog-title-line-height1.75rem / 2remab l: 2.375rem / 2.75rem
--dialog-title-font-weight700
--dialog-header-button-size, -radius, -hover-bg--mmm-space-24, --mmm-border-radius-xs, --mmm-state-default-elements-hover
--dialog-footer-bg--dialog-bg
--dialog-footer-direction, --dialog-footer-aligncolumn-reverse, stretchrow, center
--dialog-footer-gap--dialog-item-gap--dialog-group-gap
--dialog-footer-group-gap--dialog-item-gap
--dialog-footer-group-direction, --dialog-footer-item-widthcolumn, 100%row, auto

Die Open-Optionen width, minWidth, maxWidth, height, maxHeight, contentPadding und overflow setzen --dialog-width, --dialog-min-width, --dialog-max-width, --dialog-height, --dialog-max-height, --dialog-content-padding und --dialog-content-overflow am Panel.

Optional können Aktionen in einem festen Footer platziert werden:

<ng-template mmm-modal-footer-actions-left>
<button type="button" (click)="ref.close()">Abbrechen</button>
</ng-template>
<ng-template mmm-modal-footer-actions-right>
<button type="button" (click)="save()">Speichern</button>
</ng-template>

Middleware einbinden

RequestContext

CorrelationIdMiddleware

RequestLoggingMiddleware

AllExceptionsFilter

Logging

Entwicklung

Build:

Terminal window
pnpm build

Publish passiert ueber die Bitbucket-Pipeline.

Hinweise