サンキーダイアグラムライブラリ比較

3つのアプローチでフローや流れ・変遷を可視化し、実装方法とスタイルを比較

1. Recharts(実験的サポート)

RechartsはSankeyコンポーネントを実験的機能として提供。node・linkのデータをそのまま渡すだけで基本的なサンキーダイアグラムを描画できる。ただし実験的機能のためAPIが変更される可能性があり、本番利用には注意が必要。

✓ 実験的機能✓ 宣言的API✓ Reactネイティブ✓ ダーク自動追従
特徴: Reactコンポーネントとして宣言的に実装可能。ただしAPIは実験的段階のため変更される可能性があります。
tsx
'use client';
import { Sankey, Tooltip, ResponsiveContainer } from 'recharts';

const data = {
  nodes: [
    { name: '訪問者' }, { name: '検索流入' }, { name: 'SNS流入' },
    { name: '購入' }, { name: '登録' }, { name: '離脱' },
  ],
  links: [
    { source: 0, target: 1, value: 5000 },
    { source: 0, target: 2, value: 3000 },
    { source: 1, target: 3, value: 1200 },
    { source: 1, target: 4, value: 800 },
    { source: 1, target: 5, value: 3000 },
    { source: 2, target: 3, value: 600 },
    { source: 2, target: 4, value: 400 },
    { source: 2, target: 5, value: 2000 },
  ],
};

export function RechartsSankeyDiagram() {
  return (
    <ResponsiveContainer width="100%" height={300}>
      <Sankey data={data} nodePadding={16} link={{ stroke: '#aaa', strokeOpacity: 0.3 }}>
        <Tooltip />
      </Sankey>
    </ResponsiveContainer>
  );
}

AIプロンプトテンプレート

React + Tailwind CSSで、Recharts(実験的サポート)を使ったサンキーダイアグラムを実装してください。

- 使用ライブラリ: recharts の Sankey・Tooltip コンポーネント(実験的機能)
- サンプルデータ: ECサイトのユーザー流入経路から購入完了までのフロー(10ノード・12リンク)を用意すること。links の source・target はノードの数値インデックスで指定すること
- インタラクティブ: Tooltip コンポーネントを追加してホバー時にノード・リンクの値を表示すること
- フロー表示: リンクの幅でフロー量を視覚的に表現すること(自動計算)
- 設定: nodePadding・nodeWidth・margin を指定して基本的なレイアウトを調整すること
- 注意: 実験的機能のためAPIが変更される可能性があること、本番利用には注意が必要であることをコメントに記載すること

このプロンプトはあくまでたたき台です。AIの回答はモデルやバージョン、会話の文脈によって毎回異なります。意図通りに動かない場合は、条件を追記・修正してお使いください。

2. Nivo(@nivo/sankey)

@nivo/sankeyパッケージでサンキーダイアグラムをネイティブサポート。ノードの色・幅・余白、リンクの透明度・カーブなど豊富なカスタマイズが可能。ホバー時のハイライトやツールチップも標準搭載で、視覚的に洗練されたフロー図を簡単に実装できる。

✓ 専用パッケージ✓ 美しいデザイン✓ インタラクティブ✓ ダーク自動追従
特徴: 豊富なカスタマイズオプションとインタラクション機能を標準搭載。本番利用に最もおすすめ。
tsx
'use client';
import { ResponsiveSankey } from '@nivo/sankey';

const data = {
  nodes: [
    { id: '訪問者' }, { id: '検索流入' }, { id: 'SNS流入' },
    { id: '購入' }, { id: '登録' }, { id: '離脱' },
  ],
  links: [
    { source: '訪問者', target: '検索流入', value: 5000 },
    { source: '訪問者', target: 'SNS流入', value: 3000 },
    { source: '検索流入', target: '購入', value: 1200 },
    { source: '検索流入', target: '登録', value: 800 },
    { source: '検索流入', target: '離脱', value: 3000 },
    { source: 'SNS流入', target: '購入', value: 600 },
    { source: 'SNS流入', target: '登録', value: 400 },
    { source: 'SNS流入', target: '離脱', value: 2000 },
  ],
};

export function NivoSankeyDiagram() {
  return (
    <div style={{ height: 400 }}>
      <ResponsiveSankey
        data={data}
        margin={{ top: 40, right: 180, bottom: 40, left: 50 }}
        align="justify"
        colors={{ scheme: 'category10' }}
        nodeThickness={18}
        nodeSpacing={24}
        linkOpacity={0.3}
        enableLinkGradient={true}
        labelPosition="outside"
        labelPadding={16}
      />
    </div>
  );
}

AIプロンプトテンプレート

React + Tailwind CSSで、Nivo(@nivo/sankey)を使ったサンキーダイアグラムを実装してください。

- 使用ライブラリ: @nivo/sankey の ResponsiveSankey コンポーネント
- サンプルデータ: ECサイトのユーザー流入経路から購入完了までのフロー(10ノード・12リンク)を { nodes: [{ id }], links: [{ source, target, value }] } 形式で用意すること
- インタラクティブ: ホバー時にノードとリンクのハイライト・ツールチップを表示すること(標準搭載)
- フロー表示: enableLinkGradient={true} でリンクをグラデーション表現し、linkOpacity・linkContract でスタイルを調整すること
- レスポンシブ: ResponsiveSankey を使って親要素の幅に応じてサイズが変わるよう対応すること
- スタイリング: colors・nodeThickness・nodeSpacing・labelPosition・labelOrientation を設定して洗練されたデザインにすること

このプロンプトはあくまでたたき台です。AIの回答はモデルやバージョン、会話の文脈によって毎回異なります。意図通りに動かない場合は、条件を追記・修正してお使いください。

3. D3.js(カスタム実装)

d3-sankeyプラグインを使用したカスタム実装。レイアウト計算をD3に任せつつ、SVG描画をReactで制御するアプローチ。実装コストは高いが、ノードの配置・リンクのカーブ・アニメーションまで完全にコントロールできる。大規模・複雑なフロー図に最適。

✓ 完全カスタマイズ✓ d3-sankey✓ 高い表現力✓ ダーク自動追従
検索流入SNS流入直接流入広告流入トップページ商品一覧商品詳細カート購入完了離脱
特徴: d3-sankeyでレイアウトを計算し、ReactでSVG描画。実装コストが高い分、完全なカスタマイズが可能。
tsx
'use client';
import { useMemo } from 'react';
import { sankey as createSankeyLayout, sankeyLinkHorizontal, type SankeyNode } from 'd3-sankey';

type NodeExtra = { id: string };
type LinkExtra = { value: number };

const data = {
  nodes: [
    { id: '検索流入' },
    { id: 'SNS流入' },
    { id: '直接流入' },
    { id: '広告流入' },
    { id: 'トップページ' },
    { id: '商品一覧' },
    { id: '商品詳細' },
    { id: 'カート' },
    { id: '購入完了' },
    { id: '離脱' },
  ],
  links: [
    { source: '検索流入', target: 'トップページ', value: 4000 },
    { source: 'SNS流入', target: 'トップページ', value: 2000 },
    { source: '直接流入', target: 'トップページ', value: 1500 },
    { source: '広告流入', target: '商品詳細', value: 2500 },
    { source: 'トップページ', target: '商品一覧', value: 5200 },
    { source: 'トップページ', target: '離脱', value: 2300 },
    { source: '商品一覧', target: '商品詳細', value: 3800 },
    { source: '商品一覧', target: '離脱', value: 1400 },
    { source: '商品詳細', target: 'カート', value: 3200 },
    { source: '商品詳細', target: '離脱', value: 3100 },
    { source: 'カート', target: '購入完了', value: 2100 },
    { source: 'カート', target: '離脱', value: 1100 },
  ],
};

const NODE_COLORS = [
  '#3b82f6', '#8b5cf6', '#10b981', '#f59e0b', '#6366f1',
  '#0ea5e9', '#84cc16', '#f97316', '#22c55e', '#ef4444',
];
const WIDTH = 700;
const HEIGHT = 420;

// d3-sankey はノードとリンクの座標の計算だけを担当し、SVG は React の JSX で描く
export function D3SankeyDiagram() {
  const { nodes, links } = useMemo(() => {
    const layout = createSankeyLayout<NodeExtra, LinkExtra>()
      .nodeId((d) => d.id)
      .nodeWidth(20)
      .nodePadding(14)
      .extent([
        [10, 10],
        [WIDTH - 10, HEIGHT - 10],
      ]);
    return layout({
      nodes: data.nodes.map((d) => ({ ...d })),
      links: data.links.map((d) => ({ ...d })),
    });
  }, []);

  // リンクは sankeyLinkHorizontal でパスを作り、太さ(link.width)でフロー量を表す
  const linkPath = sankeyLinkHorizontal();

  return (
    <svg viewBox="0 0 700 420" className="w-full" style={{ fontFamily: 'sans-serif' }}>
      {links.map((link, i) => {
        const source = link.source as SankeyNode<NodeExtra, LinkExtra>;
        return (
          <path
            key={i}
            d={linkPath(link) ?? ''}
            fill="none"
            stroke={NODE_COLORS[(source.index ?? 0) % NODE_COLORS.length]}
            strokeWidth={Math.max(1, link.width ?? 1)}
            strokeOpacity={0.35}
          />
        );
      })}
      {nodes.map((node, i) => {
        const x0 = node.x0 ?? 0;
        const x1 = node.x1 ?? 0;
        const y0 = node.y0 ?? 0;
        const y1 = node.y1 ?? 0;
        const isRight = x0 > WIDTH / 2;
        return (
          <g key={node.id}>
            <rect
              x={x0}
              y={y0}
              width={x1 - x0}
              height={Math.max(1, y1 - y0)}
              fill={NODE_COLORS[i % NODE_COLORS.length]}
              fillOpacity={0.9}
              rx={2}
            />
            <text
              x={isRight ? x0 - 6 : x1 + 6}
              y={(y0 + y1) / 2}
              textAnchor={isRight ? 'end' : 'start'}
              dominantBaseline="middle"
              fill="currentColor"
              fontSize={11}
            >
              {node.id}
            </text>
          </g>
        );
      })}
    </svg>
  );
}

AIプロンプトテンプレート

React + Tailwind CSSで、D3.js(カスタム実装)を使ったサンキーダイアグラムを実装してください。

- 使用ライブラリ: d3-sankey の sankey(createSankeyLayout)・sankeyLinkHorizontal でレイアウトを計算し、SVG描画をReactで制御するカスタム実装
- サンプルデータ: ECサイトのユーザー流入経路から購入完了までのフロー(10ノード・12リンク)を用意すること
- インタラクティブ: なし(表示専用。高度なインタラクションは別途 useStateで実装すること)
- フロー表示: sankeyLinkHorizontal() でリンクのSVGパスを生成し、strokeWidth に link.width を設定してフロー量を表現すること
- レイアウト: nodeWidth・nodePadding・extent を設定してノードの配置を調整すること
- スタイリング: ノードは fill・fillOpacity で色分けし、リンクは stroke・strokeOpacity で半透明のフロー表現にすること

このプロンプトはあくまでたたき台です。AIの回答はモデルやバージョン、会話の文脈によって毎回異なります。意図通りに動かない場合は、条件を追記・修正してお使いください。

ライブラリ比較

アプローチレンダリングサンキー対応インタラクションおすすめ用途
RechartsSVG△ 実験的◯プロトタイプ・検証用途
NivoSVG◎ 専用パッケージ◎デザイン重視のダッシュボード
D3.js カスタムSVG◎ d3-sankey◎複雑・大規模なフロー図

選択のポイント

  • Recharts: 手軽に試したい場合や社内ツールなどで実験的機能でも問題ない用途に。APIの安定性に注意が必要。
  • Nivo: @nivo/sankeyが最もバランスが良く、導入コストを抑えつつ高品質なサンキーダイアグラムを実現できる。本番環境への導入に最もおすすめ。
  • D3.js: ノードの手動配置や独自アニメーションなど、高度なカスタマイズが必要な場合に選択。実装コストは最も高い。

典型的な使用例

  • 🛒ユーザー導線分析:流入経路から購入完了までのユーザーフローとボトルネックを可視化
  • 💰エネルギーフロー:発電源から消費先までのエネルギー流量を表現
  • 📊予算配分フロー:部門間の予算配分と実績の流れを可視化
  • 🌍貿易フロー:国・地域間の輸出入量の流れを表現

⚠️ 使用時の注意点

  • •ノード数・リンク数が多すぎると視認性が大幅に低下するため、主要なフローに絞って表示する
  • •循環参照(A→B→A)はサンキーダイアグラムでは表現できないため、データ設計時に注意する
  • •リンクの太さが値に比例するため、極端に値が小さいリンクは視認困難になる場合がある
  • •左から右へのフローが基本であり、逆方向のリンクは混乱を招くため避ける

サンキーダイアグラムは、フローや転換の量を矢印の幅で表現するグラフ。データがどこからどこへどのくらい流れているかを直感的に示す。

エネルギーの流れ・予算の配分・ユーザーの遷移フロー・貿易フローなど、資源・情報の流量を可視化する場面で使われる。

主なバリエーション
  • 基本型(左右フロー)
  • 多段型(複数ステップ)
  • カラー分類型
  • インタラクティブ型(ホバー強調)
  • 垂直型(上下フロー)

📊 使用しているサンプルデータ(クリックで表示)

ECサイトのユーザー流入経路から購入完了までのフローデータです。ノードとリンクの2つの配列で構成されます。

関連する逆引きリファレンス