psychology
SKILL.md – Heatmap
---
name: Heatmap
description: Onesown Blazor Komponente Heatmap (Grouping). Verwende diesen Skill wenn du die Heatmap-Komponente verwenden, konfigurieren oder debuggen moechtest.
---
# Heatmap
**Namespace:** `Onesown.Blazor.Components`
**Kategorie:** Grouping
**Basisklasse:** `OoComponentBase`
Heatmap: Raster aus Zeilen und Spalten, dessen Zellen nach ihrem Wert eingefärbt sind – etwa die Auslastung von Personen je Kalenderwoche. Die Farben kommen aus frei definierbaren Stufen oder aus einem Farbverlauf, die Zellgröße ist einstellbar.
**Live-Demo:** https://components.schini.com/demo/heatmap
## Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Rows`` | ``IEnumerable<HeatmapRow>`` | | Zeilen von oben nach unten. |
| ``Columns`` | ``IEnumerable<HeatmapColumn>`` | | Spalten von links nach rechts. |
| ``Cells`` | ``IEnumerable<HeatmapCell>`` | | Zellen mit Wert; verbunden mit Zeile und Spalte über RowKey und ColumnKey. Nicht angegebene Schnittpunkte bleiben leer. |
| ``Steps`` | ``IEnumerable<HeatmapStep>`` | | Farbstufen nach Wert. Null oder leer = Farbverlauf von MinColor nach MaxColor. |
| ``Min`` | ``double`` | | Wert, bei dem der Farbverlauf MinColor erreicht (ohne Steps). Standard: 0. |
| ``Max`` | ``double`` | ``100`` | Wert, bei dem der Farbverlauf MaxColor erreicht (ohne Steps). Standard: 100. |
| ``MinColor`` | ``string`` | ``"var(--oo-surface-2)"`` | Farbe für Min im Farbverlauf als CSS-Wert. Standard: "var(--oo-surface-2)". |
| ``MaxColor`` | ``string`` | ``"var(--oo-primary)"`` | Farbe für Max im Farbverlauf als CSS-Wert. Standard: "var(--oo-primary)". |
| ``TextColor`` | ``string`` | | Textfarbe in den Zellen als CSS-Wert. Null = automatische Kontrastfarbe auf gefüllten Zellen in Browsern mit contrast-color()-Unterstützung. |
| ``AlertColor`` | ``string`` | ``"var(--oo-danger)"`` | Farbe des schraffierten Streifens bei HeatmapCell.Alert als CSS-Wert. Standard: "var(--oo-danger)". |
| ``AlertText`` | ``string`` | | Erklärung des Streifens, etwa "einzelner Tag überbucht": erscheint in der Legende und wird Screenreadern vorgelesen. Null oder leer = keine Legende, kein Vorlesetext. |
| ``AlertHeight`` | ``string`` | | Höhe des Streifens als CSS-Länge oder Prozent der Zelle, etwa "0.5rem". Standard: "30%". |
| ``EmptyColor`` | ``string`` | ``"transparent"`` | Hintergrund leerer Zellen als CSS-Wert. Standard: "transparent". |
| ``EmptyText`` | ``string`` | ``"–"`` | Text in leeren Zellen. Standard: "–". Leerer Text = nichts anzeigen. |
| ``CellWidth`` | ``string`` | | Breite einer Zelle als CSS-Länge, etwa "4rem" oder "24px". Standard: "3.5rem". |
| ``CellHeight`` | ``string`` | | Höhe einer Zelle als CSS-Länge, etwa "2rem" oder "26px". Standard: "1.75rem". |
| ``RowHeaderWidth`` | ``string`` | | Breite der Zeilenköpfe als CSS-Länge. Standard: "10rem". Langer Text wird gekürzt und ist über den nativen Tooltip vollständig lesbar. |
| ``Gap`` | ``string`` | | Abstand zwischen den Zellen als CSS-Länge. Standard: "2px". |
| ``CellRadius`` | ``string`` | | Eckenrundung der Zellen als CSS-Wert oder OoRadius-Wert. Standard: OoRadius.Sm. |
| ``RowHeaderText`` | ``string`` | | Beschriftung der linken oberen Ecke über den Zeilenköpfen, etwa "Person". |
| ``Label`` | ``string`` | | Beschreibung der Heatmap für Screenreader (aria-label der Tabelle). |
| ``ShowValues`` | ``bool`` | ``true`` | Zahlen in den Zellen anzeigen. Standard: true. Bei false bleibt der Wert für Screenreader lesbar; HeatmapCell.Title kann zusätzlich einen Tooltip liefern. |
| ``ValueFormat`` | ``string`` | ``"{0:0.##}"`` | Formatierung des Werts nach string.Format, etwa "{0:0}%" oder "{0:0.0} h". Standard: "{0:0.##}". |
| ``ShowLegend`` | ``bool`` | | Legende unter der Heatmap anzeigen. Standard: false. |
| ``OnCellClick`` | ``EventCallback<HeatmapCell>`` | | Wird beim Klick auf eine Zelle mit Wert, Text oder Farbe aufgerufen. Die Zelle enthält dann einen nativen Button für Maus und Tastatur. |
## 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)
- Aufbau: Rows (HeatmapRow), Columns (HeatmapColumn) und Cells (HeatmapCell, verbunden über RowKey und ColumnKey)
- Beispiel: var zeilen = new[] { new HeatmapRow { Key = "anna", Text = "Anna" } }; var spalten = new[] { new HeatmapColumn { Key = "kw43", Text = "KW 43" } }; var zellen = new[] { new HeatmapCell { RowKey = "anna", ColumnKey = "kw43", Value = 85 } };
- Razor: <Heatmap Rows="zeilen" Columns="spalten" Cells="zellen" Label="Auslastung je Person und Woche" />
- Farbstufen: Steps="stufen" mit HeatmapStep (From, Color, TextColor, Label); es gilt die höchste Stufe, deren From der Wert erreicht
- Farbverlauf: ohne Steps läuft die Farbe linear von MinColor bei Min zu MaxColor bei Max (Standard 0 bis 100)
- Einzelne Zelle fest einfärben: HeatmapCell.Color und HeatmapCell.TextColor
- Leere Zellen (ohne Value und Text): EmptyColor (Standard transparent) und EmptyText (Standard "–", gedämpft)
- Größe der Zellen: CellWidth und CellHeight als CSS-Länge (Standard 3.5rem × 1.75rem), Breite der Zeilenköpfe über RowHeaderWidth, Abstand über Gap, Rundung über CellRadius
- Schriftgröße: Size="OoSize.Xxxs" bis OoSize.Xl; Xs, Sm und Md nutzen im Standardtheme denselben Basiswert
- Anzeige des Werts: ValueFormat="{0:0}%" (string.Format, Standard "{0:0.##}"); ShowValues="false" blendet Zahlen visuell aus, lässt sie aber für Screenreader lesbar
- Ohne explizite TextColor liegt Zelltext direkt auf der Zellfarbe; aktuelle Browser wählen dafür automatisch Schwarz oder Weiß mit hohem Kontrast
- Teilweise Überschreitung: HeatmapCell.Alert="true" zeichnet unten in der Zelle einen schraffierten Streifen in AlertColor (Standard var(--oo-danger)), Höhe über AlertHeight, Erklärung für Legende und Screenreader über AlertText
- Legende: ShowLegend="true" zeigt die Stufen mit Label bzw. bei einem Farbverlauf die Skala von Min bis Max; mit AlertText zusätzlich den Streifen
- Zusatzzeilen in der Zelle: HeatmapCell.Details steht klein untereinander unter dem Hauptwert; die Zelle wird dafür höher
- Klickbare Zellen: OnCellClick liefert die HeatmapCell; die Zellen sind dann per Tastatur erreichbar (Enter, Leertaste)
- Breite Heatmaps scrollen waagrecht, der Zeilenkopf bleibt stehen
- Tooltip pro Zelle über HeatmapCell.Title; Label beschreibt die Tabelle für Screenreader