
Multi-series grouped tooltip combining all series data points for a single X-index focus.
components/tanstack-charts/tooltip/grouped-tooltip.tsx
import { type ChartPoint, bandX, defineChart, dot, lineY, whenFocused } from "@tanstack/charts";
import { motion } from "@tanstack/charts/motion";
import { tooltip } from "@tanstack/charts/tooltip";
import { portal } from "@tanstack/charts/tooltip/portal";
import { Chart } from "@tanstack/react-charts/core";
import { useMemo } from "react";
import { scaleLinear, scaleUtc } from "d3-scale";
import { Layers } from "lucide-react";
import { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from "@/components/ui/card";
interface GroupedTooltipDatum {
date: Date;
industry: string;
unemployed: number;
}
const motionRenderer = motion({
initial: "always",
transition: { type: "spring", stiffness: 170, damping: 18, mass: 1 },
});
const industryNames = ["Tech", "Finance", "Services"];
function generateDemoData(): GroupedTooltipDatum[] {
const baseDate = new Date(2025, 0, 1);
const results: GroupedTooltipDatum[] = [];
for (let i = 0; i < 10; i++) {
const d = new Date(baseDate);
d.setMonth(baseDate.getMonth() + i);
results.push({ date: d, industry: "Tech", unemployed: 120 + Math.sin(i * 0.5) * 20 });
results.push({ date: d, industry: "Finance", unemployed: 190 + Math.cos(i * 0.6) * 30 });
results.push({ date: d, industry: "Services", unemployed: 150 + Math.sin(i * 0.8) * 15 });
}
return results;
}
function shadcnTooltipContent<TDatum>(points: readonly ChartPoint<TDatum>[]) {
if (points.length === 0) return { title: "", rows: [] };
const dateVal = (points[0].datum as GroupedTooltipDatum)?.date;
const dateObj = dateVal ? (dateVal instanceof Date ? dateVal : new Date(dateVal)) : null;
const titleStr =
dateObj && !isNaN(dateObj.getTime())
? dateObj.toLocaleDateString("en-US", { month: "short", year: "numeric" })
: "";
return {
title: titleStr,
rows: points.map((p) => {
const d = p.datum as GroupedTooltipDatum;
return {
label: d.industry,
value: `${d.unemployed.toFixed(0)}k unemployed`,
color: p.color || "var(--chart-1)",
};
}),
};
}
export function GroupedTooltipChart() {
const data = useMemo(() => generateDemoData(), []);
const dates = useMemo(() => {
return data.filter((row) => row.industry === industryNames[0]);
}, [data]);
const definition = useMemo(
() =>
defineChart(
{
renderer: motionRenderer,
marks: [
whenFocused(
bandX(dates, {
id: "focus-date-band",
x: "date",
fill: "var(--foreground)",
fillOpacity: 0.08,
inset: 3,
radius: 4,
}),
{ match: "x" },
),
lineY(data, {
id: "grouped-lines",
x: "date",
y: "unemployed",
color: "industry",
strokeWidth: 2,
}),
dot(data, {
id: "grouped-points",
x: "date",
y: "unemployed",
z: "industry",
color: "industry",
r: 3,
}),
],
scales: {
x: {
scale: scaleUtc,
axis: {
line: false,
label: "Month",
ticks: {
size: 0,
padding: 10,
format: (d: Date) => d.toLocaleDateString("en-US", { month: "short" }),
},
},
},
y: {
scale: scaleLinear().domain([80, 240]),
grid: true,
axis: {
line: false,
label: "Unemployed Volume (k)",
ticks: { size: 0 },
},
},
},
color: {
domain: industryNames,
range: ["var(--chart-1)", "var(--chart-2)", "var(--chart-3)"],
},
margin: { top: 24, right: 24, bottom: 32, left: 45 },
theme: {
foreground: "var(--muted-foreground)",
grid: "var(--border)",
background: "transparent",
},
},
{
focus: "group-x",
tooltip: {
use: tooltip,
portal,
anchor: "group-center",
placement: "auto",
className:
"font-sans shadow-none! rounded-md bg-popover text-popover-foreground border p-2 text-xs",
content: (points) => shadcnTooltipContent(points),
},
},
),
[data, dates],
);
return (
<Card className="w-full max-w-xl">
<CardHeader>
<CardTitle>Group-Focused Category Tooltip</CardTitle>
<CardDescription>
Multi-series grouped tooltip combining all series data points for a single X-index focus
</CardDescription>
</CardHeader>
<CardContent>
<div className="h-[250px] w-full">
<Chart
definition={definition}
renderer={motionRenderer}
height={250}
ariaLabel="Group-Focused Category Tooltip Chart"
/>
</div>
</CardContent>
<CardFooter className="flex-col items-start gap-2 text-sm">
<div className="flex items-center gap-2 leading-none font-medium">
Hovering highlights shared temporal band across all 3 sector series{" "}
<Layers className="h-4 w-4 text-blue-500" />
</div>
<div className="text-muted-foreground leading-none">
Group-center anchor presents a unified popover card detailing all active series
</div>
</CardFooter>
</Card>
);
}
export default GroupedTooltipChart;