ui-table
@mmm/ui-table
Installation
pnpm add @mmm/ui-tablePeer Dependencies muessen im Service vorhanden sein:
- Angular 22 (
@angular/core,@angular/common,@angular/forms,@angular/router) - Angular CDK 22
@mmm/designsystem(>= 1.12) inkl.provideMmmIcons()in der App-Konfiguration- RxJS 7
Inhalt
Das Paket exportiert:
MmmTableComponent(<mmm-table>): sortierbare, paginierte Tabelle mit Suche, Filter-Chips, Zeilenaktionen, Zeilenauswahl mit Bulk-Aktionen und Zellen, die Text oder eine Komponente rendern; auf schmalen Viewports wahlweise als KartenMmmPaginatorComponent(<mmm-paginator>)TableFilterBar(<mmm-table-filter-bar>): Chip-Leiste, die aus Filterdefinitionen gerendert wirdChip(<mmm-chip>): Toggle- und Selection-ChipMenu/MenuItem(<mmm-menu>,<mmm-menu-item>): Overflow-Menue mititem-,checkbox- undradio-Eintraegen- Typen:
MmmTableColumn,MmmTableCellRenderer,MmmTableAction,MmmTableBulkAction,MmmTableSelection,MmmTableBulkActionEvent,MmmTableFilter,MmmTableToggleFilter,MmmTableSelectFilter,MmmTableDateRangeFilter,MmmTableFilterValue,MmmTableLayout,SortState - Helfer:
isFilterActive,selectedValues,sameFilterValue,dateRangeValue,isDateRange,toIsoDay,formatIsoDay,isCellRenderer
Chip und Menue sind nach den Konventionen des Designsystems gebaut (Standalone, ViewEncapsulation.None, Styles als Mixin unter src/lib/styling/components/) und koennen 1:1 dorthin umziehen.
Schnellstart
import { MmmTableComponent, MmmTableColumn, MmmTableFilter, MmmTableFilterValue,} from "@mmm/ui-table";
type Aktie = { name: string; branche: string; kgv: number; favorit: boolean; [key: string]: unknown;};
columns: MmmTableColumn<Aktie>[] = [ { key: "name", header: "Name", sortable: true }, { key: "branche", header: "Branche" }, { key: "kgv", header: "KGV", sortable: true },];
filters: MmmTableFilter<Aktie>[] = [ // Mehrfachauswahl (Checkbox-Menue), Chip zeigt "Branche (2)" { key: "branche", label: "Branche", type: "select", options: [ { value: "Technologie", label: "Technologie" }, { value: "Finanzen", label: "Finanzen" }, ], }, // Einfachauswahl (Radio-Menue) mit eigener Vergleichslogik { key: "kgv", label: "KGV", type: "select", multiple: false, clearable: true, options: [ { value: 15, label: "< 15" }, { value: 25, label: "< 25" }, ], predicate: (row, [max]) => row.kgv < Number(max), }, // Boolescher Filter als Toggle-Chip { key: "favorit", label: "Nur Favoriten", type: "toggle" }, // Zeitraum: Chip oeffnet den Designsystem-Datepicker im Range-Modus, // Wert ist { from?: "YYYY-MM-DD", to?: "YYYY-MM-DD" } { key: "datum", label: "Datum", type: "date-range", clearable: true },];
filterValue = signal<MmmTableFilterValue>({});<mmm-table caption="Aktien" [rows]="rows" [columns]="columns" [filters]="filters" [(filterValue)]="filterValue" [filterDebounce]="300" (filterChange)="load($event)" [search]="true" [sortControl]="true" [showEntryCount]="true"/>Toolbar
| Input | Typ | Beschreibung |
|---|---|---|
search | boolean | Suchfeld ueber der Tabelle |
filters | MmmTableFilter<T>[] | Filter-Chips (siehe unten) |
sortControl | boolean | ”Sortiert nach …”-Menue rechts neben den Chips; listet alle Spalten mit sortable: true. Erneutes Waehlen der aktiven Spalte kehrt die Richtung um, “Standard” hebt die Sortierung auf |
showEntryCount | boolean | Zeile “N Eintraege” (nach Suche und Filter) ueber der Tabelle |
Filter-API
| Input / Output | Typ | Beschreibung |
|---|---|---|
filters | MmmTableFilter<T>[] | Filterdefinitionen; leer = keine Chip-Leiste |
filterValue | model<MmmTableFilterValue> | Aktuelle Werte, zweiseitig bindbar. Toggle → true, Select → gewaehlte Optionswerte. Inaktive Filter fehlen im Objekt |
filterMode | "immediate" | "none" | immediate filtert clientseitig (Standard), none emittiert nur |
filterDebounce | number | Verzoegerung fuer filterChange in ms |
filterChange | MmmTableFilterValue | Entprellt und dedupliziert; emittiert auch {} nach dem Leeren, nicht beim Initialisieren |
Standard-Matching ohne predicate: Toggle prueft Boolean(row[field ?? key]), Select prueft selected.includes(row[field ?? key]), Date-Range vergleicht row[field ?? key] (Date, ISO-String oder Timestamp) tagesgenau und inklusive beider Grenzen. Der erste Klick im Kalender setzt from (Chip zeigt “ab …”), der zweite to; eine Grenze darf also fehlen. Innerhalb eines Filters gilt ODER, zwischen Filtern UND.
Chip-Beschriftung: Mehrfachauswahl zeigt Branche (2), Einfachauswahl zeigt KGV: < 15 (abschaltbar mit showValue: false), Zeitraum zeigt Datum: 01.06.2026 – 10.06.2026, Datum: ab … oder Datum: bis ….
Zellen
cell liefert den Text einer Zelle oder eine Komponente, die statt Text gerendert wird (MmmTableCellRenderer: { component, inputs }, gesetzt ueber NgComponentOutlet). Sortierung und Suche lesen weiterhin row[key], nicht das Ergebnis von cell; Rohwerte gehoeren also in die Zeile, die Darstellung in cell.
{ key: "status", header: "Status", sortable: true, cell: (row) => ({ component: StatusBadge, inputs: { status: row.status } }) },{ key: "createdAt", header: "Erstellt", sortable: true, cell: (row) => relativeTime(row.createdAt) },Zeilenaktionen
Eine Spalte mit actions rendert pro Zeile Buttons (MmmTableAction<T>: { key, label, ariaLabel?, variant?, hidden? }); label darf eine Funktion der Zeile sein. Ab drei sichtbaren Aktionen landet alles in einem ”⋮“-Menue; mit actionsMenu: "always" an der Spalte immer, unabhaengig von der Anzahl. hidden(row) blendet eine Aktion fuer einzelne Zeilen aus, die Grenze von drei bezieht sich auf die sichtbaren Aktionen der Zeile. Klicks kommen ueber actionClick als { key, row }.
{ key: "actions", header: "Aktionen", width: "1%", actionsMenu: "always", actions: [ { key: "open", label: "Oeffnen" }, { key: "copy", label: "Daten uebernehmen", hidden: (row) => row.state !== "COMPLETED" },] },Layout
| Input | Typ | Beschreibung |
|---|---|---|
layout | "table" | "cards" | "auto" | table (Standard) rendert die Tabelle, cards je Zeile eine Karte, auto Karten unterhalb des Designsystem-Breakpoints m und darueber die Tabelle |
Eine Karte listet die Zellen der Zeile als Beschriftung/Wert-Paare untereinander, die Beschriftung ist der Spaltenkopf. Zeilenaktionen liegen in Karten immer im ”⋮“-Menue, die Auswahl-Checkbox steht oben in der Karte, die Bulk-Leiste ueber den Karten. Sortieren geht in Karten ueber sortControl, einen klickbaren Kopf gibt es nicht; Suche, Filter und Paginierung bleiben gleich.
Wo auto umschaltet, entscheidet das Stylesheet der Tabelle mit den Viewport-Mixins des Designsystems (--mmm-table-auto-layout), die Komponente liest nur das Ergebnis. Die Karten liegen ohne Rahmen auf dem Seitenhintergrund (--mmm-backgrounds-primary-background), damit sie sich von einer weissen Karte abheben, die Zeilen trennt eine feine Linie; ueberschreibbar ueber --mmm-table-card-bg und --mmm-table-card-divider-color.
<mmm-table layout="auto" [rows]="rows" [columns]="columns" [sortControl]="true" />Zeilenauswahl und Bulk-Aktionen
| Input / Output | Typ | Beschreibung |
|---|---|---|
selectable | boolean | Checkbox je Zeile und “alle auswaehlen” im Kopf. Braucht rowId |
selectedIds | model<string[]> | Ids der gewaehlten Zeilen (aus rowId), zweiseitig bindbar. Ids, die aus rows verschwinden, fallen heraus |
bulkActions | MmmTableBulkAction<T>[] | Aktionen auf die Auswahl: { key, label, variant?, ariaLabel?, disabled?(rows) }. Bis zu zwei werden Buttons, ab drei landen alle in einem ”⋮“-Menue wie bei den Zeilenaktionen |
selectionChange | MmmTableSelection<T> | { ids, rows } nach jeder Aenderung der Auswahl |
bulkActionClick | MmmTableBulkActionEvent<T> | { key, ids, rows } beim Klick auf eine Bulk-Aktion |
Sobald Zeilen gewaehlt sind, legt sich die Bulk-Leiste ueber die Kopfzeile (die bleibt im DOM und bestimmt weiter die Spaltenbreiten, wird aber inert): Checkbox (“alle” / teilweise; Klick hebt die Auswahl auf), “N ausgewaehlt”, die Aktionen. “Alle auswaehlen” bezieht sich auf die Zeilen, die Suche und Filter gerade durchlassen; die Auswahl selbst darf ueber Seiten und Filter hinausgehen. Zeilenzustaende: Hover (--mmm-state-default-elements-hover), gewaehlt (--mmm-state-default-elements-ripple), Fokus (Rahmen um die Zeile, :focus-within); ueberschreibbar ueber --mmm-table-row-hover-bg, --mmm-table-row-selected-bg, --mmm-table-row-focus-color.
<mmm-table [rows]="rows" [columns]="columns" [rowId]="rowId" [selectable]="true" [(selectedIds)]="selectedIds" [bulkActions]="[{ key: 'delete', label: 'Loeschen', variant: 'destructive' }]" (bulkActionClick)="onBulk($event)"/>Breaking Change
Die Inputs filter und filterColumns sowie der Typ FilterState (Operation + Freitext pro Spalte) wurden durch filters / filterValue ersetzt.
Entwicklung
Build:
pnpm buildPublish passiert ueber die Bitbucket-Pipeline.