DataList
Liste von Datensätzen wie die Mail- und Kontaktliste in Outlook: Schmal steht jeder Eintrag als zweizeilige Karte da, ist die Liste selbst breit genug (Standard 44rem, Container-Abfrage auf die Liste), wird sie zur einzeiligen Tabelle mit Spaltenköpfen. Dazu aktiver Eintrag, hervorgehobene Zeilen, Mehrfachauswahl mit Kästchen sowie Strg- und Umschalt-Klick, Schnellaktionen beim Überfahren, Kontextmenü, Wischaktionen, ziehbare Zeilen, Pfeiltasten und „Mehr laden“.
Grundlagen: Kontaktliste
Schmal erscheint jeder Kontakt als Karte (Name, darunter die Adresse), ab 44rem Listenbreite als Tabelle mit Spaltenköpfen. Zum Ausprobieren das Fenster schmäler ziehen. Pfeil hoch/runter wechselt den Eintrag.
Aktiv: keiner
Postfach: Auswahl, Aktionen, Ziehen, Nachladen
Wie die Mail-Liste in Outlook: Ungelesene sind fett mit Balken links. Den Kreis überfahren oder anklicken wählt aus, ebenso Strg- und Umschalt-Klick. Beim Überfahren erscheinen Schnellaktionen, Rechtsklick öffnet das Kontextmenü, am Handy wischt man nach rechts (gelesen/ungelesen) oder links (löschen). Zeilen lassen sich ziehen.
Geöffnet: keine · Gezogen: –
SKILL.md – Datalist
---
name: DataList
description: Onesown Blazor Komponente DataList (Grouping). Verwende diesen Skill wenn du die DataList-Komponente verwenden, konfigurieren oder debuggen moechtest.
---
# DataList
**Namespace:** `Onesown.Blazor.Components`
**Kategorie:** Grouping
**Basisklasse:** `OoComponentBase`
**Generisch:** Ja (`DataList<TItem>` o.ae.)
Liste von Datensätzen wie die Mail- und Kontaktliste in Outlook: schmal als zweizeilige Karte (Primärtext, Zeichen, Sekundärtext, Meta, Beschreibung), ab einer Containerbreite (Standard 44rem) einzeilig als Tabelle mit Spaltenköpfen. Mit aktivem Eintrag, hervorgehobenen Zeilen (fett mit Balken links), Mehrfachauswahl (Kästchen, Strg-/Umschalt-Klick), Schnellaktionen beim Überfahren, Kontextmenü je Zeile, Wischaktionen, ziehbaren Zeilen, Pfeiltasten und „Mehr laden“.
**Live-Demo:** https://components.schini.com/demo/datalist
## Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Items`` | ``IEnumerable<TItem>`` | | Die anzuzeigenden Einträge in Anzeigereihenfolge. |
| ``ItemKey`` | ``Func<TItem, object>`` | | Liefert den eindeutigen Schlüssel eines Eintrags (für @key, aktiven Eintrag und Auswahl), etwa m => m.Id. Ohne Angabe zählt der Eintrag selbst (Equals). |
| ``LeadingTemplate`` | ``RenderFragment<TItem>`` | | Links vor dem Text, etwa ein Avatar oder Symbol. Bei Mehrfachauswahl liegt hier das Kästchen. |
| ``PrimaryTemplate`` | ``RenderFragment<TItem>`` | | Erste Zeile links, etwa Absender oder Name. Wird mit „…“ gekürzt. |
| ``IconsTemplate`` | ``RenderFragment<TItem>`` | | Kleine Zeichen rechts neben dem Primärtext, etwa Icons für Anhang, Antwort oder Fahne (Icon mit Size="OoSize.Xs"). |
| ``SecondaryTemplate`` | ``RenderFragment<TItem>`` | | Zweite Zeile links, etwa der Betreff. Wird mit „…“ gekürzt. |
| ``MetaTemplate`` | ``RenderFragment<TItem>`` | | Rechts neben dem Sekundärtext, etwa Datum oder Uhrzeit. Bricht nicht um. |
| ``DescriptionTemplate`` | ``RenderFragment<TItem>`` | | Dritte Zeile über die ganze Breite in gedämpfter Farbe, etwa die Vorschau einer Mail. Wird mit „…“ gekürzt. |
| ``QuickActionsTemplate`` | ``RenderFragment<TItem>`` | | Schnellaktionen, die beim Überfahren mit der Maus rechts oben über Zeichen und Meta erscheinen, etwa Buttons mit IconOnly. Ihre Klicks lösen die Zeile nicht aus. |
| ``ContextMenuTemplate`` | ``RenderFragment<TItem>`` | | Kontextmenü der Zeile per Rechtsklick: ContextMenuItem-Einträge. Ohne Angabe bleibt das Kontextmenü des Browsers. |
| ``Columns`` | ``RenderFragment`` | | Spaltendefinitionen (DataListColumn) für die breite Darstellung als Tabelle. Ohne Spalten bleibt die Liste immer zweizeilig. |
| ``TableBreakpoint`` | ``string`` | ``"44rem"`` | Breite der Liste, ab der sie als Tabelle mit Spaltenköpfen erscheint (Container-Abfrage auf die Liste selbst), etwa "50rem" oder "720px". Standard: "44rem". |
| ``StickyHeaderTop`` | ``string`` | ``"0"`` | Abstand der klebenden Spaltenköpfe vom oberen Rand des Scroll-Bereichs, etwa die Höhe einer eigenen klebenden Kopfzeile darüber ("2.75rem"). Standard: "0". |
| ``ItemHref`` | ``Func<TItem, string>`` | | Liefert die Adresse einer Zeile; die Zeile wird ein Link (Strg- und Mittelklick öffnen einen neuen Tab). |
| ``OnItemClick`` | ``EventCallback<TItem>`` | | Klick auf eine Zeile (auch per Pfeiltaste). Mit ItemHref läuft er zusätzlich zur Navigation, mit ClickNavigates="false" statt ihr. |
| ``ClickNavigates`` | ``bool`` | ``true`` | Nur mit ItemHref und OnItemClick bzw. @bind-ActiveItem: Navigiert ein normaler Linksklick zusätzlich? Standard: true. Mit false ruft ein normaler Klick nur OnItemClick auf (etwa um den Eintrag im Lesebereich zu öffnen). |
| ``ActiveItem`` | ``TItem`` | | Der geöffnete Eintrag, hellblau hinterlegt. Unterstützt @bind-ActiveItem. Zugeordnet über ItemKey. |
| ``ActiveItemChanged`` | ``EventCallback<TItem>`` | | EventCallback für @bind-ActiveItem: Klick oder Pfeiltaste wechselt den aktiven Eintrag. |
| ``KeyboardNavigation`` | ``bool`` | ``true`` | Pfeil hoch und runter wechseln zur vorigen bzw. nächsten Zeile (wie ein Klick), solange der Fokus in der Liste steht. Standard: true. |
| ``ItemHighlighted`` | ``Func<TItem, bool>`` | | Hebt Zeilen hervor, etwa ungelesene: Primärtext fett, Sekundärtext und Meta in Primärfarbe, farbiger Balken links. |
| ``ItemClass`` | ``Func<TItem, string>`` | | Zusätzliche CSS-Klasse je Zeile. |
| ``SelectionMode`` | ``OoSelectionMode`` | ``OoSelectionMode.None`` | Auswahl mit Kästchen: None (Standard), Single (höchstens ein Eintrag) oder Multiple (mit Strg- und Umschalt-Klick). |
| ``SelectedItems`` | ``IList<TItem>`` | | Die ausgewählten Einträge. Unterstützt @bind-SelectedItems; Einträge werden über ItemKey zugeordnet. |
| ``SelectedItemsChanged`` | ``EventCallback<IList<TItem>>`` | | EventCallback für @bind-SelectedItems; liefert die ausgewählten Einträge in Anzeigereihenfolge. |
| ``SelectText`` | ``string`` | ``"Auswählen"`` | Title des Kästchens zum Auswählen. Standard: "Auswählen". |
| ``DeselectText`` | ``string`` | ``"Auswahl aufheben"`` | Title des Kästchens eines ausgewählten Eintrags. Standard: "Auswahl aufheben". |
| ``SelectAllText`` | ``string`` | ``"Alle auswählen"`` | Title des Kästchens im Spaltenkopf, das alle Einträge auswählt. Standard: "Alle auswählen". |
| ``OnSwipeRight`` | ``EventCallback<TItem>`` | | Aktion beim Wischen nach rechts (am Handy). Ohne Handler gibt es kein Wischen nach rechts. |
| ``SwipeRightIcon`` | ``Func<TItem, string>`` | | Material-Symbol der Aktion nach rechts je Eintrag, etwa m => m.Gelesen ? "mark_email_unread" : "drafts". Standard: "star". |
| ``SwipeRightText`` | ``Func<TItem, string>`` | | Kurzer Text der Aktion nach rechts je Eintrag. Ohne Angabe nur das Symbol. |
| ``OnSwipeLeft`` | ``EventCallback<TItem>`` | | Aktion beim Wischen nach links (am Handy). Ohne Handler gibt es kein Wischen nach links. |
| ``SwipeLeftIcon`` | ``Func<TItem, string>`` | | Material-Symbol der Aktion nach links je Eintrag, etwa _ => "delete". Standard: "done". |
| ``SwipeLeftText`` | ``Func<TItem, string>`` | | Kurzer Text der Aktion nach links je Eintrag. Ohne Angabe nur das Symbol. |
| ``Draggable`` | ``bool`` | | Zeilen lassen sich mit der Maus ziehen (HTML5 Drag), etwa auf einen Ordner; die gezogene Zeile wird halb durchsichtig. Standard: false. |
| ``OnItemDragStart`` | ``EventCallback<TItem>`` | | Eine Zeile wird gezogen. |
| ``OnItemDragEnd`` | ``EventCallback<TItem>`` | | Das Ziehen einer Zeile endet (abgelegt oder abgebrochen). |
| ``EmptyContent`` | ``RenderFragment`` | | Inhalt bei leerer Liste, etwa ein EmptyState mit eigenem Text. Hat Vorrang vor EmptyText. |
| ``EmptyText`` | ``string`` | ``"Keine Einträge"`` | Text bei leerer Liste (als EmptyState mit Symbol inbox), wenn kein EmptyContent gesetzt ist. Leer: nichts anzeigen. Standard: "Keine Einträge". |
| ``HasMore`` | ``bool`` | | Es gibt weitere Einträge: Am Ende erscheint der Button „Mehr laden“. Standard: false. |
| ``OnLoadMore`` | ``EventCallback`` | | Klick auf „Mehr laden“. |
| ``LoadingMore`` | ``bool`` | | Lädt gerade nach: der Button „Mehr laden“ dreht sich und ist gesperrt. Standard: false. |
| ``LoadMoreText`` | ``string`` | ``"Mehr laden"`` | Beschriftung des Buttons zum Nachladen. Standard: "Mehr laden". |
## Geerbte Parameter (OoComponentBase)
Alle nicht deklarierten HTML-Attribute (``class``, ``style``, ``data-*``, ``aria-*``, ...) werden an das Root-Element weitergereicht.
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Size`` | ``string`` | | Größe der Komponente. Mögliche Werte: OoSize.Xs, OoSize.Sm, OoSize.Md, OoSize.Lg, OoSize.Xl. Wird als CSS-Klasse am Root-Element gesetzt. |
## Hinweise
- Natives HTML-Attribut class wird automatisch an das Root-Element weitergegeben
- Natives HTML-Attribut style wird automatisch an das Root-Element weitergegeben
- Alle weiteren nicht deklarierten Attribute (data-*, aria-*, id, tabindex, …) werden ebenfalls weitergereicht
- Größe der Komponente via Size mit OoSize-Konstanten steuern (OoSize.Xs bis OoSize.Xl)
- Einfachste Liste: Items="_kunden" ItemKey="k => k.Id" mit PrimaryTemplate und SecondaryTemplate (je ein Template mit dem Eintrag als context)
- Wie eine Mail-Liste: LeadingTemplate (Avatar), PrimaryTemplate (Absender), IconsTemplate (Anhang, Fahne), SecondaryTemplate (Betreff), MetaTemplate (Datum), DescriptionTemplate (Vorschau)
- Breit als Tabelle: im Parameter Columns je Spalte ein <DataListColumn TItem="..." Title="Von" Slot="OoDataListSlot.Primary" Width="minmax(10rem, 16rem)" />; eigener Zellinhalt mit CellTemplate; ohne Spalten bleibt die Liste immer Karte
- Ab welcher Breite die Tabelle erscheint: TableBreakpoint="50rem" (Breite der Liste selbst, nicht des Fensters)
- Geöffneter Eintrag: @bind-ActiveItem oder ActiveItem plus OnItemClick; Href je Zeile mit ItemHref (Strg- und Mittelklick öffnen einen neuen Tab)
- Panel öffnen statt navigieren: ItemHref, OnItemClick und ClickNavigates="false" – ein normaler Klick ruft nur OnItemClick auf
- Ungelesen o. Ä.: ItemHighlighted="m => !m.Gelesen" – Primärtext fett, Sekundärtext und Meta in Primärfarbe, Balken links
- Mehrfachauswahl: SelectionMode="OoSelectionMode.Multiple" @bind-SelectedItems="_auswahl" – das LeadingTemplate wird beim Überfahren und während einer Auswahl zum Kästchen; Strg-Klick schaltet um, Umschalt-Klick wählt einen Bereich
- Schnellaktionen rechts oben beim Überfahren (nur mit Maus): QuickActionsTemplate mit kleinen Ghost-Buttons (IconOnly, Size="OoSize.Sm")
- Kontextmenü per Rechtsklick: ContextMenuTemplate mit ContextMenuItem-Einträgen
- Wischen am Handy: OnSwipeRight/OnSwipeLeft mit SwipeRightIcon/SwipeLeftIcon (je Eintrag als Funktion, etwa gelesen/ungelesen)
- Zeilen ziehen (etwa auf einen Ordner): Draggable="true" OnItemDragStart="..." OnItemDragEnd="..."
- Nachladen: HasMore="true" OnLoadMore="..." LoadingMore="_laedt"; leere Liste: EmptyContent oder EmptyText
- Sitzt die Liste unter einer festen Kopfzeile im selben Scroll-Bereich: StickyHeaderTop="2.75rem" für die Spaltenköpfe