dejanandClaude Opus 5
0875ae2688
Recherche an der Quelle statt an der Dokumentation. Zwei Ergebnisse: 1. Carbon regelt Datenvisualisierung nur teilweise. Farben, Gitter, Achsen, Tooltip und Tickanzahl sind verbindlich festgelegt — Paddings, Margins und Dashboard-Raster dagegen NICHT. Die Carbon-Seiten zu Chart-Anatomie und Dashboards tragen ausdrücklich den Hinweis "this guidance is a work in progress" und enthalten keine Zahlenwerte. Unsere Abstandswerte stammen deshalb aus der Carbon-Spacing-Skala und der Planung mit dem Branchenpartner, nicht aus der Data-Viz-Norm. Das steht jetzt so in DESIGN-SYSTEM.md §0. 2. Eine echte Abweichung gefunden: Der Tooltip ist seit Carbon v11 hell (--cds-layer-02 #ffffff auf --cds-text-primary #161616, abgesetzt allein durch den Schatten). Unser Theme führte den dunklen v10-Stand (#393939) und berief sich dabei auf das ausgelieferte Stylesheet — die Angabe war veraltet. Korrigiert. Neu: - docs/carbon-referenz.json — kanonische Werte mit Quelle, Version und Prüfdatum, gezogen aus @carbon/charts 1.23.0 styles.min.css und configuration.ts. Bewusste Abweichungen (Balkenbreite 48 statt 16, feste Kategoriefarben statt n-Serien-Paletten) sind dort begründet. - scripts/verify-carbon.mjs + npm run verify:carbon — gleicht chartTheme.ts gegen die Referenz ab und bricht bei Drift ab. - docs/PRUEFFRAGEN.md — Prüffragen für die Gestaltungsabnahme mit nachprüfbarem Ja/Nein, plus Leseliste (FT Visual Vocabulary, IBCS, Cleveland & McGill, Few, Datawrapper Academy). Die 14er-Palette wurde gegen die CSS-Variablen --cds-charts-14-1-* geprüft und stimmt exakt; ebenso Gitter #e0e0e0, Achse #8d8d8d und Achsentext #525252. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QPeZNwSeU7qG3RRCwaxEZX
87 lines
2.5 KiB
TypeScript
87 lines
2.5 KiB
TypeScript
"use client";
|
|
|
|
import React from "react";
|
|
import { CHART, TOOLTIP_SCHATTEN } from "../../utils/chartTheme";
|
|
|
|
/**
|
|
* Einheitlicher Tooltip für alle Charts.
|
|
*
|
|
* Carbon-Vorgabe (@carbon/charts, .cds--cc--tooltip): helle Fläche
|
|
* (--cds-layer-02), Text in --cds-text-primary, 12 px, abgesetzt allein durch
|
|
* den Schatten — kein Rahmen, kein Doppelpunkt zwischen Name und Wert,
|
|
* maximal 270 px breit.
|
|
*
|
|
* Bis Carbon v10 war der Tooltip dunkel (#393939). Viele Quellen im Netz
|
|
* zeigen noch diesen Stand; maßgeblich ist das ausgelieferte Stylesheet.
|
|
* Geprüft von scripts/verify-carbon.mjs.
|
|
*
|
|
* Die Props sind bewusst weit typisiert: Recharts reicht sein internes
|
|
* Payload-Format durch, das je nach Chart-Typ leicht abweicht.
|
|
*/
|
|
interface TooltipPayload {
|
|
name?: unknown;
|
|
value?: unknown;
|
|
color?: string;
|
|
dataKey?: unknown;
|
|
}
|
|
|
|
export function ChartTooltip({
|
|
active,
|
|
label,
|
|
payload,
|
|
formatWert,
|
|
labelPrefix,
|
|
}: {
|
|
active?: boolean;
|
|
label?: unknown;
|
|
payload?: readonly TooltipPayload[];
|
|
formatWert: (wert: number) => string;
|
|
labelPrefix?: string;
|
|
}) {
|
|
if (!active || !payload?.length) return null;
|
|
|
|
const reihen = payload
|
|
.filter((eintrag) => typeof eintrag.value === "number")
|
|
.map((eintrag) => ({
|
|
name: String(eintrag.name ?? eintrag.dataKey ?? ""),
|
|
value: eintrag.value as number,
|
|
color: eintrag.color,
|
|
}));
|
|
|
|
if (!reihen.length) return null;
|
|
|
|
const labelText = label === undefined || label === null ? "" : String(label);
|
|
|
|
return (
|
|
<div
|
|
className="pointer-events-none max-w-[270px] rounded-md px-3 py-2"
|
|
style={{
|
|
background: CHART.tooltipBg,
|
|
color: CHART.tooltipFg,
|
|
boxShadow: TOOLTIP_SCHATTEN,
|
|
}}
|
|
>
|
|
{labelText ? (
|
|
<div className="mb-1 text-[12px]" style={{ color: CHART.textSekundaer }}>
|
|
{labelPrefix ? `${labelPrefix} ` : ""}
|
|
{labelText}
|
|
</div>
|
|
) : null}
|
|
<div className="flex flex-col gap-0.5">
|
|
{reihen.map((reihe) => (
|
|
<div key={reihe.name} className="flex items-center gap-2 text-[12px]">
|
|
{reihe.color ? (
|
|
<span
|
|
className="h-2.5 w-2.5 flex-none rounded-sm"
|
|
style={{ background: reihe.color }}
|
|
/>
|
|
) : null}
|
|
<span style={{ color: CHART.textSekundaer }}>{reihe.name}</span>
|
|
<span className="ml-auto font-semibold tabular-nums">{formatWert(reihe.value)}</span>
|
|
</div>
|
|
))}
|
|
</div>
|
|
</div>
|
|
);
|
|
}
|