コンポーネント一覧へ戻る

これは何か
ラベル・大きな数字・増減の pill・小さな折れ線を並べた白い KPI カードです。画面に入ると折れ線が左から描かれ、下の面がふわっと現れて、終点が小さく光ります。ラベル・値・増減・データ点を差し替えて、ダッシュボードの一列や分析機能の紹介にそのまま置けます。
TSX の全文です。アカウントは不要です。
sparkline-kpi-card.tsx
"use client"; import * as React from "react";import { ArrowDownRight, ArrowUpRight } from "lucide-react";import { cn } from "@/lib/utils"; export const SPARKLINE_KPI_DEFAULT_POINTS: readonly number[] = [ 31, 34, 32, 37, 36, 41, 39, 44, 43, 47, 46, 52,]; export type SparklineKpiCardProps = React.ComponentPropsWithoutRef<"div"> & { label: string; /** Pre-formatted figure, e.g. "$48,210". */ value: React.ReactNode; /** Change text, e.g. "+12.4%". */ delta?: string; /** Green up arrow when true, red down arrow when false. */ positive?: boolean; /** Oldest first. 2+ values. */ points?: readonly number[]; /** Caption after the delta, e.g. "vs last month". */ comparison?: string;}; const EASE = "cubic-bezier(0.22, 1, 0.36, 1)";const W = 300;const H = 76;const PAD_Y = 8;/** Room on the right so the end dot is not clipped. */const PAD_R = 16; function round(n: number) { return Math.round(n * 100) / 100;} /** Smooth path through the points (Catmull-Rom → cubic Bézier). */function buildPath(values: readonly number[]) { const min = Math.min(...values); const max = Math.max(...values); const span = max - min || 1; const pts = values.map((v, i) => ({ x: round((i / (values.length - 1)) * (W - PAD_R)), y: round(H - PAD_Y - ((v - min) / span) * (H - PAD_Y * 2)), })); let d = `M ${pts[0]?.x ?? 0} ${pts[0]?.y ?? H}`; for (let i = 0; i < pts.length - 1; i += 1) { const p0 = pts[i - 1] ?? pts[i]!; const p1 = pts[i]!; const p2 = pts[i + 1]!; const p3 = pts[i + 2] ?? p2; const c1 = { x: round(p1.x + (p2.x - p0.x) / 6), y: round(p1.y + (p2.y - p0.y) / 6) }; const c2 = { x: round(p2.x - (p3.x - p1.x) / 6), y: round(p2.y - (p3.y - p1.y) / 6) }; d += ` C ${c1.x} ${c1.y}, ${c2.x} ${c2.y}, ${p2.x} ${p2.y}`; } const last = pts[pts.length - 1] ?? { x: W, y: H }; return { line: d, area: `${d} L ${last.x} ${H} L 0 ${H} Z`, end: last };} const CSS = `@keyframes sparkline-kpi-card-ping { 0% { transform: scale(1); opacity: 0.5; } 100% { transform: scale(3); opacity: 0; } }.sparkline-kpi-card-ping { animation: sparkline-kpi-card-ping 1.8s cubic-bezier(0.22, 1, 0.36, 1) 1.6s infinite; }@media (prefers-reduced-motion: reduce) { .sparkline-kpi-card-ping { animation: none; opacity: 0; } }`; export const SparklineKpiCard = React.forwardRef<HTMLDivElement, SparklineKpiCardProps>( ( { label, value, delta, positive = true, points = SPARKLINE_KPI_DEFAULT_POINTS, comparison = "vs last month", className, ...props }, ref, ) => { const values = points.length >= 2 ? points : SPARKLINE_KPI_DEFAULT_POINTS; const { line, area, end } = React.useMemo(() => buildPath(values), [values]); const localRef = React.useRef<HTMLDivElement>(null); React.useImperativeHandle(ref, () => localRef.current as HTMLDivElement); const [drawn, setDrawn] = React.useState(false); const gradientId = React.useId().replace(/:/g, ""); const color = positive ? "#10b981" : "#f43f5e"; const Arrow = positive ? ArrowUpRight : ArrowDownRight; React.useEffect(() => { const node = localRef.current; if (!node || typeof IntersectionObserver === "undefined") { setDrawn(true); return; } const observer = new IntersectionObserver( ([entry]) => { if (entry?.isIntersecting) { setDrawn(true); observer.disconnect(); } }, { threshold: 0.35 }, ); observer.observe(node); return () => observer.disconnect(); }, []); return ( <div ref={localRef} data-tsuna-id="sparkline-kpi-card" className={cn( "w-[340px] max-w-full overflow-hidden rounded-[26px] bg-white pt-5 text-zinc-950", "shadow-[0_30px_60px_-34px_rgba(15,23,42,0.35),0_0_0_1px_rgba(15,23,42,0.05)]", className, )} {...props} > <style>{CSS}</style> <div className="px-5"> <span className="text-[13px] font-medium text-zinc-500">{label}</span> <div className="mt-1.5 flex flex-wrap items-center gap-x-3 gap-y-1"> <span className="text-[34px] leading-none font-semibold tabular-nums tracking-[-0.04em]"> {value} </span> {delta ? ( <span className={cn( "inline-flex items-center gap-0.5 rounded-full px-2 py-1 text-[12px] font-semibold tabular-nums", positive ? "bg-emerald-50 text-emerald-700" : "bg-rose-50 text-rose-700", )} > <Arrow aria-hidden className="size-3.5" strokeWidth={2.6} /> {delta} </span> ) : null} </div> {delta && comparison ? ( <span className="mt-1.5 block text-[12px] text-zinc-400">{comparison}</span> ) : null} </div> <svg role="img" aria-label={`${label} trend, ${values.length} points`} viewBox={`0 0 ${W} ${H}`} preserveAspectRatio="none" className="mt-4 block h-[76px] w-full overflow-visible" > <defs> <linearGradient id={gradientId} x1="0" y1="0" x2="0" y2="1"> <stop offset="0%" stopColor={color} stopOpacity="0.22" /> <stop offset="100%" stopColor={color} stopOpacity="0" /> </linearGradient> </defs> <path d={area} fill={`url(#${gradientId})`} className="motion-reduce:!transition-none" style={{ opacity: drawn ? 1 : 0, transition: `opacity 900ms ${EASE} 500ms` }} /> <path d={line} pathLength={100} fill="none" stroke={color} strokeWidth={2.25} strokeLinecap="round" strokeLinejoin="round" className="motion-reduce:!transition-none" style={{ strokeDasharray: "100 100", strokeDashoffset: drawn ? 0 : 100, transition: `stroke-dashoffset 1400ms ${EASE}`, }} /> </svg> <div className="relative h-0"> <span aria-hidden className="absolute size-2.5 -translate-x-1/2 -translate-y-1/2 rounded-full ring-[3px] ring-white motion-reduce:!transition-none" style={{ left: `${(end.x / W) * 100}%`, top: -(H - end.y), backgroundColor: color, opacity: drawn ? 1 : 0, transform: `translate(-50%, -50%) scale(${drawn ? 1 : 0.4})`, transition: `opacity 300ms ${EASE} 1250ms, transform 420ms ${EASE} 1250ms`, }} > <span className="sparkline-kpi-card-ping absolute inset-0 rounded-full" style={{ backgroundColor: color }} /> </span> </div> </div> ); },); SparklineKpiCard.displayName = "SparklineKpiCard";ガイドを読む
コンポーネント
スパークライン KPI カード
ラベル・大きな数字・増減の pill・小さな折れ線を並べた白い KPI カードです。画面に入ると折れ線が左から描かれ、下の面がふわっと現れて、終点が小さく光ります。ラベル・値・増減・データ点を差し替えて、ダッシュボードの一列や分析機能の紹介にそのまま置けます。
Verified Technical Spec
- アニメーション
- CSS / Tailwind
- Reduced motion
- 確認済み
- キーボードフォーカス
- ソース上では未検出
- 対応環境
- Tailwind CSS v3.4 + v4 · React 19 / Next.js 15 App Router + Vite / Remix 対応
含まれるもの
- ソースを Cursor / Claude に渡してエージェントに組み込める
- React · TypeScript · Tailwind CSS · Lucide の完成 UI
依存パッケージ
- React 19.0.0
- Typescript 5.7.2
- Tailwindcss 3.4.16
- Lucide-react 1.23.0
技術スタック
- React
- TypeScript
- Tailwind CSS
- Lucide
バージョン 1.0.0





