SidebarLayout

Heatmap

Raster aus Zeilen und Spalten, dessen Zellen nach ihrem Wert eingefärbt sind, etwa die Auslastung je Person und Woche. Farben über Steps oder einen Farbverlauf, Zellgröße über CellWidth und CellHeight.

Farbstufen und Legende

Auslastung je Person und Kalenderwoche. Die Farben kommen aus Steps (HeatmapStep), die Legende aus ShowLegend. Mit Alert an der Zelle erscheint unten ein schraffierter Streifen, etwa wenn nur ein einzelner Tag überbucht ist; AlertText erklärt ihn in der Legende.

PersonKW 4320.10.KW 4427.10.KW 4503.11.KW 4610.11.KW 4717.11.
Anna Muster60%100%125%––
Ben Beispiel85%einzelner Tag überbucht100%–40%–
Cara Test–70%∞––
unter 100 % voll ausgelastet überbucht einzelner Tag überbucht

Farbverlauf

Ohne Steps läuft die Farbe von MinColor bei Min zu MaxColor bei Max. Beliebige CSS-Farben und Tokens sind möglich.

Standard08:0010:0012:0014:0016:00
Montag540759020
Dienstag15551006035
Mittwoch025458065
0 100
Eigene Farben08:0010:0012:0014:0016:00
Montag540759020
Dienstag15551006035
Mittwoch025458065
0 100

Größen

Zellgröße über CellWidth und CellHeight, Abstand über Gap, Rundung über CellRadius, Schrift über Size. Bei ShowValues="false" bleiben die Werte für Screenreader erhalten. Lange Zelltexte werden gekürzt.

Q1Q2Q3Q4
Team A3070100120
Team B9010045–
Q1Q2Q3Q4
Team A30 %70 %100 %120 %
Team B90 %100 %45 %–
Q1Q2Q3Q4
Team AVollständig ausgelastet–––
Team B––––

Klickbare Zellen

Mit OnCellClick sind die Zellen klickbar und per Tastatur erreichbar (Enter, Leertaste).

MoDiMi
Anna Muster–
Ben Beispiel––

Gewählt: –

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: &lt;Heatmap Rows="zeilen" Columns="spalten" Cells="zellen" Label="Auslastung je Person und Woche" /&gt;
- 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


Die Verbindung zum Server ist unterbrochen. Verbinde neu …

Neu verbinden hat nicht geklappt. Nächster Versuch in Sekunden.

Keine Verbindung zum Server. Bitte erneut versuchen oder die Seite neu laden.

Der Server hat die Sitzung angehalten.

Die Sitzung ließ sich nicht fortsetzen. Bitte erneut versuchen oder die Seite neu laden.