recharts NPM (開発者のための仕組み)

イントロダクション

現代のウェブ開発において、インタラクティブでダイナミックなデータビジュアライゼーションを作成することは、ユーザーエクスペリエンスを向上させ、データに基づいた意思決定を行う上で非常に重要です。 Rechartsは、独立したReactコンポーネントに基づいて構築された構成可能で再定義されたチャートライブラリであり、このようなビジュアライゼーションを作成するための強力で使いやすいソリューションを提供します。

この記事では、Rechartsの特徴とその利点、そしてReactアプリケーションでRechartsを使い始める方法について説明します。 また、IronPDFライブラリを調べて、ウェブサイトURLやHTML文字列からPDFを生成し、作成されたグラフを表示するためにRechartsとどのようにうまく組み合わさるかを確認します。

レチャートを選ぶ理由

Recharts npmパッケージは、いくつかの理由で際立っている：

1. 使いやすさ: 宣言的アプローチが React のコンポーネントベースのアーキテクチャとよく合致しており、既に React に精通している開発者にとって直感的です。

2. コンポーザビリティ: Rechartsコンポーネントは高いコンポーザビリティを備えており、開発者がよりシンプルなコンポーネントを組み合わせることで複雑なチャートを構築することができます。カスタマイズ: 多くのカスタマイズが可能で、開発者がチャートのほぼすべての側面を調整することができます。

3. レスポンシブとアダプティブ: Rechartsは、チャートがレスポンシブであり、さまざまな画面サイズや解像度にうまく適応することを保証します。

レチャート入門

Rechartsはコンポーザブル・チャート・ライブラリです：

リチャートのインストール

npm (推奨インストール方法)

Rechartsを使い始めるには、npmかyarn経由でインストールする必要がある。 Node.jsとnpmがインストールされていることを確認し、プロジェクト・ディレクトリで以下のコマンドを実行する：

npm install recharts // recharts installed for release testing

npm install recharts // recharts installed for release testing

以下に示すように、umdまたはdevビルドを使用してRechartsをインストールすることもできます：

ウムド

UMD ビルドは、unpkg.com でも利用できます。

<script src="https://unpkg.com/react/umd/react.production.min.js"></script>
<script src="https://unpkg.com/react-dom/umd/react-dom.production.min.js"></script>
<script src="https://unpkg.com/recharts/umd/Recharts.min.js"></script>

<script src="https://unpkg.com/react/umd/react.production.min.js"></script>
<script src="https://unpkg.com/react-dom/umd/react-dom.production.min.js"></script>
<script src="https://unpkg.com/recharts/umd/Recharts.min.js"></script>

デビルド

$ git clone https://github.com/recharts/recharts.git
$ cd recharts
$ npm install
$ npm run build

$ git clone https://github.com/recharts/recharts.git
$ cd recharts
$ npm install
$ npm run build

デモ

基本的な使用法

簡単な折れ線グラフを作成して、サンプルデータを視覚化してみよう。

1. RechartsのReactコンポーネントをインポート: Rechartsライブラリから必要なコンポーネントをインポートします。 リリースブランチから、Rechartsモジュールを選んで実装することができます。

  import React from 'react';
  import { LineChart, Line, XAxis, YAxis, CartesianGrid, Tooltip, Legend, ResponsiveContainer } from 'recharts';

js

2. データを準備: グラフに表示するデータセットを作成します。

  const data = [
        { name: 'Page A', uv: 4000, pv: 2400, amt: 2400 },
        { name: 'Page B', uv: 3000, pv: 1398, amt: 2210 },
        { name: 'Page C', uv: 2000, pv: 9800, amt: 2290 },
        { name: 'Page D', uv: 2780, pv: 3908, amt: 2000 },
        { name: 'Page E', uv: 1890, pv: 4800, amt: 2181 },
        { name: 'Page F', uv: 2390, pv: 3800, amt: 2500 },
        { name: 'Page G', uv: 3490, pv: 4300, amt: 2100 },
      ];

js

3. チャートをレンダリング: Rechartsコンポーネントを使用して、視覚テストプラットフォームの向上のためにチャートをレンダリングします。

  const SimpleLineChart = () => (
        <ResponsiveContainer width="100%" height={400}>
          <LineChart
            width={500}
            height={300}
            data={data}
            margin={{
              top: 5, right: 30, left: 20, bottom: 5,
            }}
          >
            <CartesianGrid strokeDasharray="3 3" />
            <XAxis dataKey="name" />
            <YAxis />
            <Tooltip />
            <Legend />
            <Line type="monotone" dataKey="pv" stroke="#8884d8" activeDot={{ r: 8 }} />
            <Line type="monotone" dataKey="uv" stroke="#82ca9d" />
          </LineChart>
        </ResponsiveContainer>
      );
      export default SimpleLineChart;

js

出力

カスタマイズと高度な機能

原則的に、Rechartsはすべてのコンポーネントをカスタマイズし、拡張するさまざまな方法を提供します：

カスタムツールチップ: より詳しい情報を表示するためにカスタムツールチップを作成できます。

アニメーション: チャートをより魅力的にするために、アニメーションを追加します。

インタラクティビティ: グラフをよりインタラクティブにするために、クリックハンドラーなどのインタラクティブ機能を実装します。

• 異なるチャートタイプ: Rechartsは、棒グラフ、円グラフ、エリアチャートなど、さまざまなチャートタイプをサポートしています。

例棒グラフのカスタマイズ

ここでは、カスタマイズした棒グラフを作成する方法を説明します：

1. 必要なコンポーネントをインポート:

import React from 'react';
import { BarChart, Bar, XAxis, YAxis, CartesianGrid, Tooltip, Legend, ResponsiveContainer } from 'recharts';

js

2. データの準備：

const data = [
      { name: 'Page A', uv: 4000, pv: 2400, amt: 2400 },
      { name: 'Page B', uv: 3000, pv: 1398, amt: 2210 },
      { name: 'Page C', uv: 2000, pv: 9800, amt: 2290 },
      { name: 'Page D', uv: 2780, pv: 3908, amt: 2000 },
      { name: 'Page E', uv: 1890, pv: 4800, amt: 2181 },
      { name: 'Page F', uv: 2390, pv: 3800, amt: 2500 },
      { name: 'Page G', uv: 3490, pv: 4300, amt: 2100 },
    ];

js

3. バーチャートをレンダリングする：

const CustomizedBarChart = () => (
      <ResponsiveContainer width="100%" height={400}>
        <BarChart
          width={500}
          height={300}
          data={data}
          margin={{
            top: 20, right: 30, left: 20, bottom: 5,
          }}
        >
          <CartesianGrid strokeDasharray="3 3" />
          <XAxis dataKey="name" />
          <YAxis />
          <Tooltip />
          <Legend />
          <Bar dataKey="pv" fill="#8884d8" />
          <Bar dataKey="uv" fill="#82ca9d" />
        </BarChart>
      </ResponsiveContainer>
    );
    export default CustomizedBarChart;

js

出力

IronPDFの紹介

IronPDF for Node.jsは、Node.jsアプリケーション内でPDF生成を容易にするために設計された堅牢なnpmパッケージです。 HTMLコンテンツ、URL、既存のPDFファイルからPDF文書を作成することができます。 請求書、レポート、その他のドキュメントの作成において、IronPDFは直感的なAPIと豊富な機能でプロセスを簡素化します。

IronPDFの主な機能

HTML から PDF への変換: HTML コンテンツを PDF ドキュメントに簡単に変換し、ウェブコンテンツから動的な PDF を生成するのに最適です。

URLからPDFへの変換: プログラムでWebページのコンテンツをキャプチャして、URLから直接PDFファイルを作成します。

PDF操作: 既存のPDFドキュメントを簡単に統合、分割、操作することができます。 IronPDFはページの追加、ドキュメントの分割などを可能にします。

PDFセキュリティ: PDFドキュメントをパスワードで暗号化したりデジタル署名を適用したりして保護し、機密文書を不正アクセスから守ります。

高品質な出力: テキスト、画像、フォーマットの正確なレンダリングにより、オリジナルの内容に忠実な高品質のPDFドキュメントを生成します。

クロスプラットフォーム互換性: IronPDFは、Windows、Linux、macOSを含むさまざまなプラットフォームに対応しており、幅広い開発環境に適しています。

シンプルな統合： npmパッケージを使用して、Node.jsアプリケーションにIronPDFを簡単に統合できます。 十分に文書化されたAPIにより、PDF生成機能をプロジェクトに簡単に組み込むことができます。

Webアプリケーション、サーバーサイドスクリプト、コマンドラインツールのいずれを構築する場合でも、IronPDFはプロフェッショナルグレードのPDFドキュメントを効率的かつ確実に作成することができます。

IronPDFを使ってリチャートでPDFを作成する

依存関係をインストール: まず、以下のコマンドを使用して新しいNext.jsプロジェクトを作成するか、より詳細な手順についてはこちらを参照してください。

npx create-next-app@latest recharts-pdf --use-npm --example "https://github.com/vercel/next-learn/tree/main/basics/learn-starter"

npx create-next-app@latest recharts-pdf --use-npm --example "https://github.com/vercel/next-learn/tree/main/basics/learn-starter"

次に、プロジェクト・ディレクトリに移動する：

cd recharts-pdf

cd recharts-pdf

以下のyarnコマンドを使って必要なパッケージをインストールする：

yarn add @ironsoftware/ironpdf @ironsoftware/ironpdf-engine-windows-x64
yarn add recharts

yarn add @ironsoftware/ironpdf @ironsoftware/ironpdf-engine-windows-x64
yarn add recharts

PDF生成API: 最初のステップは、PDFドキュメントを生成するためのバックエンドAPIを作成することです。 IronPDFはサーバーサイドでしか動作しないので、ユーザーがPDFを生成したいときに呼び出すAPIを作らなければなりません。

pages/api/pdf.jsのパスにファイルを作成し、以下の内容を追加する：

// pages/api/pdf.js
import {IronPdfGlobalConfig, PdfDocument} from "@ironsoftware/ironpdf";
// Apply your IronPDF license key
IronPdfGlobalConfig.getConfig().licenseKey = "Your license key";
export default async function handler(req, res) {
    try {
        const url = req.query.url
        const pdf = await PdfDocument.fromUrl(url);
        const data = await pdf.saveAsBuffer();
        console.error('data PDF:', data);
        res.setHeader('Content-Type', 'application/pdf');
        res.setHeader('Content-Disposition', 'attachment; filename=awesomeIron.pdf');
        res.send(data);
    } catch (error) {
        console.error('Error generating PDF:', error);
        res.status(500).end();
    }
}

js

IronPDFにはライセンスキーが必要です。ライセンスキーをこちらから入手し、上記のコードに配置してください。

ユーザーからURLを受け取り、そのURLからPDFを生成する以下のコードをindex.jsファイルに追加します。

"use client";
import { useState, HTMLDivElement } from "react";
import Head from "next/head";
import styles from "../../styles/Home.module.css";
import {
  LineChart,
  Line,
  XAxis,
  YAxis,
  CartesianGrid,
  Tooltip,
  Legend,
  ResponsiveContainer,
  BarChart,
  Bar,
} from "recharts";
import { useCurrentPng } from "recharts-to-png";
import FileSaver from "file-saver";
const data = [
  { name: "Page A", uv: 4000, pv: 2400, amt: 2400 },
  { name: "Page B", uv: 3000, pv: 1398, amt: 2210 },
  { name: "Page C", uv: 2000, pv: 9800, amt: 2290 },
  { name: "Page D", uv: 2780, pv: 3908, amt: 2000 },
  { name: "Page E", uv: 1890, pv: 4800, amt: 2181 },
  { name: "Page F", uv: 2390, pv: 3800, amt: 2500 },
  { name: "Page G", uv: 3490, pv: 4300, amt: 2100 },
];
const barData = [
  { name: "Page A", uv: 4000, pv: 2400, amt: 2400 },
  { name: "Page B", uv: 3000, pv: 1398, amt: 2210 },
  { name: "Page C", uv: 2000, pv: 9800, amt: 2290 },
  { name: "Page D", uv: 2780, pv: 3908, amt: 2000 },
  { name: "Page E", uv: 1890, pv: 4800, amt: 2181 },
  { name: "Page F", uv: 2390, pv: 3800, amt: 2500 },
  { name: "Page G", uv: 3490, pv: 4300, amt: 2100 },
];
export default function RechartsDemo() {
  const [text, setText] = useState("");
  const [imgSrc, setImg] = useState("");
  // Implement useGenerateImage to get an image of any element (not just a Recharts component)
  const [getPng, { ref, isLoading }] = useCurrentPng();
  const handleDownload = async () => {
    const png = await getPng();
    // Verify that png is not undefined
    if (png) {
        setImg(png);
      // Download with FileSaver
      FileSaver.saveAs(png, "myChart.png");
    }
  };
  const generatePdf = async () => {
    try {
      const response = await fetch("/api/pdf?url=" + text, {
        method: "GET",
      });
      const blob = await response.blob();
      const url = window.URL.createObjectURL(new Blob([blob]));
      const link = document.createElement("a");
      link.href = url;
      link.setAttribute("download", "awesomeIron.pdf");
      document.body.appendChild(link);
      link.click();
      link.parentNode.removeChild(link);
    } catch (error) {
      console.error("Error generating PDF:", error);
    }
  };
  const handleChange = (event) => {
    setText(event.target.value);
  };
  return (
    <div className={styles.container} ref={ref}>
      <Head>
        <title>Generate PDF Using IronPDF</title>
        <link rel="icon" href="/favicon.ico" />
      </Head>
      <main>
        <div>
          <h1>Demo Recharts and Generate PDF Using IronPDF</h1>
          <ResponsiveContainer width="100%" height={400}>
            <LineChart
              ref={ref}
              width={500}
              height={300}
              data={data}
              margin={{
                top: 5,
                right: 30,
                left: 20,
                bottom: 5,
              }}
            >
              <CartesianGrid strokeDasharray="3 3" />
              <XAxis dataKey="name" />
              <YAxis />
              <Tooltip />
              <Legend />
              <Line
                type="monotone"
                dataKey="pv"
                stroke="#8884d8"
                activeDot={{ r: 8 }}
              />
              <Line type="monotone" dataKey="uv" stroke="#82ca9d" />
            </LineChart>
          </ResponsiveContainer>
          <ResponsiveContainer width="100%" height={400}>
            <BarChart
              width={500}
              height={300}
              data={barData}
              margin={{
                top: 20,
                right: 30,
                left: 20,
                bottom: 5,
              }}
            >
              <CartesianGrid strokeDasharray="3 3" />
              <XAxis dataKey="name" />
              <YAxis />
              <Tooltip />
              <Legend />
              <Bar dataKey="pv" fill="#8884d8" />
              <Bar dataKey="uv" fill="#82ca9d" />
            </BarChart>
          </ResponsiveContainer>
          <p>
            <span>Enter Url To Convert to PDF:</span>{" "}
          </p>
          <button style={{ margin: 20, padding: 5 }} onClick={generatePdf}>
            Generate PDF
          </button>
        </div>
      </main>
      <style jsx>{`
        main {
          padding: 5rem 0;
          flex: 1;
          display: flex;
          flex-direction: column;
          justify-content: top;
          align-items: center;
        }
        footer {
          width: 100%;
          height: 100px;
          border-top: 1px solid #eaeaea;
          display: flex;
          justify-content: center;
          align-items: center;
        }
        footer img {
          margin-left: 0.5rem;
        }
        footer a {
          display: flex;
          justify-content: center;
          align-items: center;
          text-decoration: none;
          color: inherit;
        }
        code {
          background: #fafafa;
          border-radius: 5px;
          padding: 0.75rem;
          font-size: 1.1rem;
          font-family: Menlo, Monaco, Lucida Console, Liberation Mono,
            DejaVu Sans Mono, Bitstream Vera Sans Mono, Courier New, monospace;
        }
      `}</style>
      <style jsx global>{`
        html,
        body {
          padding: 0;
          margin: 0;
          font-family: -apple-system, BlinkMacSystemFont, Segoe UI, Roboto,
            Oxygen, Ubuntu, Cantarell, Fira Sans, Droid Sans, Helvetica Neue,
            sans-serif;
        }
        * {
          box-sizing: border-box;
        }
      `}</style>
    </div>
  );
}

js

コードの説明

1. IronPDFを使ったPDF生成APIをpages/api/pdf.jsに追加しました。

2. 次に、前に作成した2種類のチャートを追加する。

3. 次に、入力フィールドとボタンを追加して、ユーザーURLを受け入れ、PDF生成をトリガーします。

4. 生成されたPDFを以下に示す。

出力

以下は、上記の出力で'Generate PDF'ボタンを押したときに出力されるPDFです。

IronPDFライセンス

無料トライアルライセンスキーを取得して、購入前にIronPDFの豊富な機能をお試しください。 永続ライセンスに関する詳細は、ライセンスページでご覧いただけます。

ライセンスキーをここに入力します：

import {IronPdfGlobalConfig, PdfDocument} from "@ironsoftware/ironpdf";
// Apply your IronPDF license key
IronPdfGlobalConfig.getConfig().licenseKey = "Add Your key here";

js

結論

Rechartsは、Reactアプリケーションでダイナミックでインタラクティブなデータビジュアライゼーションの作成を簡素化する強力なライブラリです。 その使いやすさ、コンポーザビリティ、豊富なカスタマイズ・オプションは、堅牢なチャートでアプリケーションを強化したい開発者にとって最高の選択肢となる。

シンプルな折れ線グラフから複雑な複数系列のビジュアライゼーションまで、Rechartsは成功に必要なツールを提供します。 あなたの次のプロジェクトで試してみて、シームレスなデータ可視化の利点を体験してください。 IronPDF は強力なPDF生成ツールであり、Rechartsと併用して生成されたグラフを表示および共有することができます。 PDFの作成と操作を支援する効果的なツールを探している開発者は、IronPDFを試してみる必要がある。