ApexCharts と ECharts は SSR で落ちない。dynamic import が必須なのは Plotly.js だけ
訂正react-apexcharts 2.2.0echarts-for-react 3.0.6plotly.js-dist-min 4.2.0
このサイトのグラフのページには、長いあいだ「ApexCharts・ECharts は SSR 非対応のため dynamic import が必要」と書いてありました。実際に確かめたところ、これは Plotly.js では正しく、ApexCharts と ECharts の React ラッパーでは不正確でした。説明を直したので、確かめた結果を残します。
確かめた結果
Node.js(window が無い環境)でそれぞれを import し、renderToString でサーバー側の出力を作りました。
| ライブラリ | サーバーでの結果 | dynamic import(ssr: false) |
|---|---|---|
| plotly.js-dist-min 4.2.0 | import した時点で ReferenceError: self is not defined | 必須 |
| echarts-for-react 3.0.6 | 空の <div>(高さだけ付く)を返す。落ちない | 必須ではない |
| react-apexcharts 2.2.0 | 空の <div> を返す。落ちない | 必須ではない |
それでも dynamic import を使う理由
ApexCharts と ECharts は、サーバーでは空の要素を返し、ブラウザで描画します。落ちはしませんが、グラフそのものはサーバーの HTML に入りません。そしてどちらもバンドルが大きいので、このサイトでは引き続き dynamic import で遅延読み込みをしています。理由が「落ちるから」ではなく「初期表示を軽くするため」に変わった、ということです。
tsx
import dynamic from 'next/dynamic';
// Plotly.js:サーバーで import すると落ちるので、ssr: false が必須
const Plot = dynamic(() => import('react-plotly.js'), { ssr: false });
// ECharts・ApexCharts:必須ではない。バンドルが大きいので遅延読み込みにしている
const ReactECharts = dynamic(() => import('echarts-for-react'), { ssr: false });直したところ
- ECharts の特徴の文(8 ページ)と ApexCharts の特徴の文(7 ページ)を、「SSR でも落ちない。バンドルが大きいため dynamic import で遅延読み込みしている」に直しました。
- データの可視化・グラフの「実装の落とし穴」と、よくある質問「SSR でチャートが表示されない」を、ライブラリごとに書き分けました。
- Plotly.js の説明は正しかったので、そのままです。
ライブラリを選ぶとき、「SSR で落ちるかどうか」と「サーバーの HTML にグラフが入るかどうか」は別の話です。「非対応」とひとまとめにせず、分けて確かめるのがよさそうです。
動くデモで確かめる
出典
この記事は、2026/11/04 の時点で、上のバージョンで確かめた内容です。