Skip to content

ui-table

@mmm/ui-table

Installation

Terminal window
pnpm add @mmm/ui-table

Peer 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 Karten
  • MmmPaginatorComponent (<mmm-paginator>)
  • TableFilterBar (<mmm-table-filter-bar>): Chip-Leiste, die aus Filterdefinitionen gerendert wird
  • Chip (<mmm-chip>): Toggle- und Selection-Chip
  • Menu / MenuItem (<mmm-menu>, <mmm-menu-item>): Overflow-Menue mit item-, checkbox- und radio-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

InputTypBeschreibung
searchbooleanSuchfeld ueber der Tabelle
filtersMmmTableFilter<T>[]Filter-Chips (siehe unten)
sortControlboolean”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
showEntryCountbooleanZeile “N Eintraege” (nach Suche und Filter) ueber der Tabelle

Filter-API

Input / OutputTypBeschreibung
filtersMmmTableFilter<T>[]Filterdefinitionen; leer = keine Chip-Leiste
filterValuemodel<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
filterDebouncenumberVerzoegerung fuer filterChange in ms
filterChangeMmmTableFilterValueEntprellt 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

InputTypBeschreibung
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 / OutputTypBeschreibung
selectablebooleanCheckbox je Zeile und “alle auswaehlen” im Kopf. Braucht rowId
selectedIdsmodel<string[]>Ids der gewaehlten Zeilen (aus rowId), zweiseitig bindbar. Ids, die aus rows verschwinden, fallen heraus
bulkActionsMmmTableBulkAction<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
selectionChangeMmmTableSelection<T>{ ids, rows } nach jeder Aenderung der Auswahl
bulkActionClickMmmTableBulkActionEvent<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:

Terminal window
pnpm build

Publish passiert ueber die Bitbucket-Pipeline.