Charts

Reactを使用したデータ可視化とチャートレンダリングのための柔軟なJavaScriptライブラリ。

Gravity UI Charts · npm package License CI storybook

10種類以上のグラフ(エリア、棒、線、円、散布図、ツリーマップなど)を備えたReactのグラフ描画ライブラリです。

インストール

npm install @gravity-ui/uikit @gravity-ui/charts

@gravity-ui/uikit は必須のピア依存関係です。グラフが依存するテーマ設定とスタイルを提供します。

使用方法

エントリーポイントで @gravity-ui/uikit のスタイルを一度インポートし、アプリを ThemeProvider でラップし、明示的な高さを持つコンテナ内に Chart をレンダリングしてください。

import {ThemeProvider} from '@gravity-ui/uikit';
import {Chart} from '@gravity-ui/charts';

import '@gravity-ui/uikit/styles/fonts.css';
import '@gravity-ui/uikit/styles/styles.css';

const data = {
  series: {
    data: [
      {
        type: 'line',
        name: 'Temperature',
        data: [
          {x: 0, y: 10},
          {x: 1, y: 25},
          {x: 2, y: 18},
          {x: 3, y: 30},
        ],
      },
    ],
  },
};

export default function App() {
  return (
    <ThemeProvider theme="light">
      <div style={{height: 300}}>
        <Chart data={data} />
      </div>
    </ThemeProvider>
  );
}

Chart は親要素のサイズに適合するため、ラッパー要素には高さが必要です。

ドキュメント

ライセンス

MIT License に基づいて配布されています。詳細は LICENSE を参照してください。

AIエージェント向け

Gravity UI アプリケーション向けの宣言的な React グラフ描画ライブラリです。単一の data 設定から、線グラフ、エリアグラフ、棒グラフ、円グラフ、散布図、ツリーマップなどのグラフを、アプリの他の部分と調和するテーマでレンダリングします。

使用すべき場合

  • 標準的なビジネスグラフ: lineareabar-x/bar-ypiescattertreemapwaterfallsankeyradarheatmapfunnelx-range
  • Gravity UI のテーマ設定(ライト/ダーク)に従い、@gravity-ui/uikit アプリとトークンを共有する必要があるビジュアライゼーション。
  • 命令的に描画するのではなく、宣言的なデータからグラフをレンダリングする場合。

使用すべきでない場合

  • まだ @gravity-ui/chartkit を使用しているプロジェクト。これは古いアダプターベースのラッパー(YAGR/Highcharts/D3)であり、このパッケージは最新のスタンドアロンレンダラーであり、ドロップインの代替ではありません。
  • 単純な表形式データ。@gravity-ui/table を使用してください。
  • React を使用しない、またはサーバーサイドのみのレンダリング。Chart は React SVG をレンダリングし、DOM を必要とします。

よくある間違い

  • コンポーネント名は Chart であり、ChartKit ではありません。 @gravity-ui/charts から {Chart} をインポートしてください。ChartKit は、別のレガシーパッケージである @gravity-ui/chartkit に属します。
  • data プロップは data で、形状は {series: {data: [...]}} です。 series.data の各エントリは、独自の typedata 配列を持つ 1 つのシリーズです。シリーズのトップレベル配列はありません。
  • サイズ指定のないコンテナでは何もレンダリングされません。 Chart は親要素を埋めるため、ラッパーに明示的な高さを指定してください。
  • uikit のセットアップが必要です。 ThemeProvider でラップし、@gravity-ui/uikit/styles/styles.css をインポートしてください。@gravity-ui/uikit は必須のピア依存関係です。

役立つドキュメント

AIエージェント向けドキュメント

インストールされているバージョンのエージェント可読ドキュメントは、node_modules/@gravity-ui/charts/dist/docs/INDEX.md にあります。

ライブラリについて
スターでライブラリを応援
バージョン
1.57.0
最終更新日
15.07.2026
リポジトリ
github.com/gravity-ui/charts
ライセンス
MIT License
メンテナー
コントリビューター