ui-modal
@mmm/ui-modal
Installation
pnpm add @mmm/ui-modalPeer 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 Breakpointm)
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,maxHeightcontentPaddingoverflow:"auto","hidden"oder"visible"closeOnBackdropundcloseOnEscape(Standard jeweilstrue)ariaLabelpanelClassundbackdropClass
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 hochdialog.open(MyDialogComponent, { hero: { type: "illustration", src: "assets/illustration.svg", alt: "" },});
// Icon links, 24px Padding (16px mobil), kein Hintergrunddialog.open(MyDialogComponent, { hero: { type: "icon", icon: WarningIconComponent },});
// Icon zentriert auf Highlight-Hintergrunddialog.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).
| Variable | Mobil | Desktop |
|---|---|---|
--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-blur | rgba(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-height | 100% / 0 / 100% / 90dvh | fit-content / 580px / 800px / 90dvh |
--dialog-hero-icon-size | 96px | |
--dialog-hero-illustration-height, --dialog-hero-illustration-fit | 200px, cover | |
--dialog-hero-banner-bg, --dialog-hero-banner-fg | --mmm-main-colors-highlight, Weiß | |
--dialog-hero-bg, --dialog-hero-fg | pro 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-height | 1.75rem / 2rem | ab l: 2.375rem / 2.75rem |
--dialog-title-font-weight | 700 | |
--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-align | column-reverse, stretch | row, center |
--dialog-footer-gap | --dialog-item-gap | --dialog-group-gap |
--dialog-footer-group-gap | --dialog-item-gap | |
--dialog-footer-group-direction, --dialog-footer-item-width | column, 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:
pnpm buildPublish passiert ueber die Bitbucket-Pipeline.