ノードヘルプ

dropzone npm(開発者向けの使い方)

ファイルのアップロードはウェブアプリケーションで一般的な機能であり、ユーザーフレンドリーにすることは良いユーザー体験において重要です。 このプロセスを簡素化する人気のあるライブラリの一つはDropzone.jsです。 Reactと組み合わせると、Dropzoneはドラッグ&ドロップによるファイルアップロードを実装するための強力なツールになります。 react-dropzoneは、最小限の開発努力で完璧にシームレスに統合されます。 この記事では、React アプリケーションに Dropzone を統合する方法を、Dropzone.js ライブラリの優れたラッパーである react-dropzone パッケージを使用して説明します。

この記事では、PDFドキュメントを生成、編集、管理するためのIronPDF NPMパッケージも見ていきます。

ReactでDropzoneを使用する理由とは?

Dropzone は、ファイルアップロードを円滑にするためのさまざまな機能を提供します:

ドラッグ&ドロップインターフェース

ユーザーがファイルをドラッグアンドドロップしてファイルを選択できるようにします。 ファイルダイアログをプログラムで追加します。

2. プレビュー

ドロップされたファイルからデフォルトの画像サムネイルプレビューを表示します。 表示ファイルのプレビューはUIの読みやすさを向上させます。

3. 複数ファイルのアップロード

複数のファイルを一度にアップロードすることをサポートします。

4. カスタマイズ可能

さまざまなオプションとコールバックによって高いカスタマイズ性があります。 ファイルダイアログの開き方やファイル選択ダイアログをカスタマイズできます。

5. 大きなファイルの分割アップロード

チャンクアップロードを使用して大きなファイルをアップロードします。

6. イベントを処理する

ファイルダイアログのキャンセルコールバックやブラウザの画像リサイズイベントを処理できます。

Reactアプリケーションのセットアップ

Dropzoneを統合する前に、Reactアプリケーションがセットアップされていることを確認してください。もしまだ設定されていない場合は、Create React Appを使用して新しいReactプロジェクトを作成できます。

npx create-react-app dropzone-demo
cd dropzone-demo
npx create-react-app dropzone-demo
cd dropzone-demo
SHELL

react-dropzoneのインストール

Dropzone を React プロジェクトで使用するには、react-dropzone パッケージをインストールする必要があります。

npm install react-dropzone
or
yarn add react-dropzone
npm install react-dropzone
or
yarn add react-dropzone
SHELL

react-dropzoneの基本的な使用法

以下は、Reactコンポーネントでのreact-dropzone使用の簡単な例です:

import React, { useCallback } from 'react';
import { useDropzone } from 'react-dropzone'; // import dropzone
const DropzoneComponent = () => {
  const onDrop = useCallback((acceptedFiles) => {
    console.log(acceptedFiles);
  }, []);
  const { getRootProps, getInputProps, isDragActive } = useDropzone({ onDrop });
  return (
    <div {...getRootProps()} style={dropzoneStyle}>
      {
        isDragActive ?
          <p>Drop the files here ...</p> :
          <p>Drag 'n' drop some files here, or click to select files</p>
      }
    </div>
  );
};
const dropzoneStyle = {
  border: '2px dashed #0087F7',
  borderRadius: '5px',
  padding: '20px',
  textAlign: 'center',
  cursor: 'pointer'
};
export default DropzoneComponent;
js
JAVASCRIPT

ファイルのアップロード処理

ファイルがドロップまたは選択されると、onDrop コールバックが受け入れられたファイルの配列を受け取ります。 その後、サーバーにアップロードするなどしてファイルを処理できます。 以下の方法で、fetchを使用してファイルをアップロードするようにonDropコールバックを拡張できます:

const onDrop = useCallback((acceptedFiles) => {
  const formData = new FormData();
  acceptedFiles.forEach((file) => {
    formData.append('files', file);
  });
  fetch('https://your-upload-endpoint', {
    method: 'POST',
    body: formData,
  })
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));
}, []);
js
JAVASCRIPT

プレビューを表示

アップロードされたファイルのプレビューを表示することもできます。 これを行う方法の例は次のとおりです。

import React, { useCallback, useState } from 'react';
import { useDropzone } from 'react-dropzone';
const DropzoneComponent = () => {
  const [files, setFiles] = useState([]);
  const onDrop = useCallback((acceptedFiles) => {
    setFiles(acceptedFiles.map(file => Object.assign(file, {
      preview: URL.createObjectURL(file)
    })));
  }, []);
  const { getRootProps, getInputProps, isDragActive } = useDropzone({ onDrop });
  const thumbs = files.map(file => (
    <div key={file.name}>
      <img
        src={file.preview}
        style={{ width: '100px', height: '100px' }}
        alt={file.name}
      />
    </div>
  ));
  return (
    <div>
      <div {...getRootProps()} style={dropzoneStyle}>
        {
          isDragActive ?
            <p>Drop the files here ...</p> :
            <p>Drag 'n' drop some files here, or click to select files</p>
        }
      </div>
      <div>
        {thumbs}
      </div>
    </div>
  );
};
const dropzoneStyle = {
  border: '2px dashed #0087F7',
  borderRadius: '5px',
  padding: '20px',
  textAlign: 'center',
  cursor: 'pointer'
};
export default DropzoneComponent;
js
JAVASCRIPT

出力

dropzone npm(開発者向けの動作方法):図1 - こちらがreact-dropzoneアプリケーションの見た目です。1つまたは複数のファイルをドラッグ&ドロップ/選択できます。

クリーンアップ

メモリリークを防ぐために、オブジェクトURLを無効にすることが重要です。 useEffectフックを使用することでこれを達成できます。

import { useEffect } from 'react';
useEffect(() => {
  // Make sure to revoke the data uris to avoid memory leaks
  return () => files.forEach(file => URL.revokeObjectURL(file.preview));
}, [files]);
js
JAVASCRIPT

IronPDFの紹介

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

dropzone npm (開発者向けの使用方法): 図2 - IronPDF for Node.js: Node.js用PDFライブラリ

IronPDFの主な機能には以下が含まれます

1.HTMLからPDFへの変換

HTMLコンテンツを簡単にPDF文書に変換。 この機能は、ウェブコンテンツからダイナミックPDFを生成する場合に特に便利です。

2. URLからPDFへの変換

URLから直接PDFを生成します。 これにより、ウェブページのコンテンツを取得し、プログラムによってPDFファイルとして保存することができます。

3. PDF操作

既存のPDF文書を簡単に結合、分割、操作できます。 IronPDFは、ページの追加、ドキュメントの分割など、PDFファイルを操作する機能を提供します。

4. PDFセキュリティ

PDF文書をパスワードで暗号化したり、電子署名を適用したりして保護します。 IronPDFは不正アクセスから機密文書を保護するオプションを提供します。

5. 高品質な出力

テキスト、画像、書式を正確にレンダリングして、高品質のPDF文書を作成します。 IronPDFは生成されたPDFが元のコンテンツに忠実であることを保証します。

6. クロスプラットフォーム互換性

IronPDFはWindows、Linux、macOSを含む様々なプラットフォームと互換性があり、幅広い開発環境に適しています。

7. 簡単な統合

Node.jsアプリケーションにIronPDFをnpmパッケージを使って簡単に統合できます。 APIは十分に文書化されているので、PDF生成機能をプロジェクトに組み込むのは簡単です。

ウェブアプリケーション、サーバーサイドスクリプト、またはコマンドラインツールを構築中であっても、IronPDFを使用することで、効率的かつ信頼性の高い方法でプロフェッショナルなPDFドキュメントを作成できます。

IronPDFを使用してPDFドキュメントを生成し、Dropzone NPMパッケージを使用する

依存関係をインストールする: まず、新しいNext.jsプロジェクトを作成します(まだ作成していない場合)は、以下のコマンドを使用します: セットアップについてはページを参照してください。

npx create-next-app@latest demo-dropzone-ironpdf --use-npm --example "https://github.com/vercel/next-learn/tree/main/basics/learn-starter"
npx create-next-app@latest demo-dropzone-ironpdf --use-npm --example "https://github.com/vercel/next-learn/tree/main/basics/learn-starter"
SHELL

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

cd demo-dropzone-ironpdf
cd demo-dropzone-ironpdf
SHELL

必要なパッケージをインストールする:

npm install @ironsoftware/ironpdf
npm install react-dropzone
npm install @ironsoftware/ironpdf
npm install react-dropzone
SHELL

PDFを作成する: それでは、IronPDFを使用してPDFを生成する簡単な例を作成しましょう。 Next.jsコンポーネント(例:pages/index.tsx)に次のコードを追加します:

import Head from 'next/head';
import styles from '../styles/Home.module.css';
import {ToastContainer, toast} from 'react-toastify';
import 'react-toastify/dist/ReactToastify.css';
import {useState} from "react";
import DropzoneComponent from "../components/mydropzone";
export default function Home() {
    const [textInput, setTextInput] = useState('');
    const notify = () => {
        toast.success("Success! This is a success message.", {
            position: "top-right"
        });
        toast.info("Information message", {
            position: "bottom-left"
        });
        toast.warn("Warning message", {
            autoClose: 5000
        });
        toast.error("Error message", {
            className: 'custom-toast',
            style: {background: 'red', color: 'white'}
        });
    };
    const generatePdf = async () => {
        try {
            const response = await fetch('/api/pdf?url='+textInput);
            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) => {
        setTextInput(event.target.value);
    }
    return (
        <div className={styles.container}>
            <Head>
                <title>Generate PDF Using IronPDF</title>
                <link rel="icon" href="/favicon.ico"/>
            </Head>
            <main>
                <h1>Demo Drop Zone and Generate PDF Using IronPDF</h1>
                <DropzoneComponent/>
                <p>
                    <span>Enter Url To Convert to PDF:</span>{" "}
                </p>
                <button style={{margin:20, padding:5}} onClick={generatePdf}>Generate PDF</button>
            </main>          
            <style jsx>{`
                main {
                    padding: 5rem 0;
                    flex: 1;
                    display: flex;
                    flex-direction: column;
                    justify-content: center;
                    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
JAVASCRIPT

IronPDFはNode.js上でのみ動作するため、次にNode.jsでPDFを生成するアプリ用のAPIを追加します。

pages/api フォルダーに pdf.js ファイルを作成し、以下のソースコードを追加します。

// pages/api/pdf.js
import {IronPdfGlobalConfig, PdfDocument} from "@ironsoftware/ironpdf";
// Apply your IronPDF license key
IronPdfGlobalConfig.getConfig().licenseKey = "Add Your key here";
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
JAVASCRIPT

注: 上記のコードにあなた自身のライセンスキーを追加してください。

アプリを実行する: Next.jsアプリを開始します。

npm run dev
or
yarn dev
npm run dev
or
yarn dev
SHELL

出力

dropzone npm(開発者向けの使い方):図3 - DropzoneとIronPDFを統合したNext.jsアプリケーションがどのように見えるかを示しています。URLを入力し、生成ボタンをクリックすると、そのURLのHTMLコンテンツをIronPDFを使用してPDFに変換できます。

ウェブサイトのURLを入力してPDFを生成し、「PDFを生成」をクリックしてください。 以下のように、awesomeIron.pdfという名前のファイルがダウンロードされます。

ドロップゾーン npm (開発者向けの仕組み): 図 4 - IronPDFを使用して生成された出力PDF

次に、ドロップゾーンをクリックし、ダウンロードしたファイルを選択してください。これにより、名前が下部に表示されたプレビューが表示されます:awesomeIron.pdf

ドロップゾーン npm (開発者向けの仕組み):図 5 - Dropzoneで提供されたリンクから生成された awesomeIron.pdf ファイルを選択してダウンロードできます。

IronPDFライセンス

IronPDF ページ。

以下に示すようにアプリにライセンスキーを配置してください。

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

結論

Dropzonereact-dropzone を使用して React と統合するのは、ファイルアップロード体験を大幅に向上させる簡単なプロセスです。 ドラッグアンドドロップ、ファイルプレビュー、広範なカスタマイズオプションなどの機能を備えたreact-dropzoneは、Reactプロジェクトに貴重な追加機能となるでしょう。 その機能を探り始め、あなたのアプリケーションのニーズに合わせて調整しましょう!

IronPDF は、汎用性の高いPDF生成および操作ライブラリであり、アプリケーションに容易に統合できます。 IronPDF は、開発者が開始するのに役立つ詳細なドキュメントコード例を提供します。

この記事で説明されている手順に従うことで、Reactアプリケーションに強力なファイルアップロードコンポーネントを作成し、現代のアプリケーションにPDFファイル生成機能を統合することができます。

Darrius Serrant
フルスタックソフトウェアエンジニア(WebOps)

Darrius Serrantは、マイアミ大学でコンピュータサイエンスの学士号を取得しており、Iron SoftwareでフルスタックWebOpsマーケティングエンジニアとして働いています。若い頃からコーディングに魅了され、コンピューティングを神秘的でありながらアクセスしやすいものと見なし、それが創造性と問題解決のための完璧な媒体であると感じました。

Iron Softwareでは、新しいものを作り出し、複雑な概念を簡単にすることでより理解しやすくすることを楽しんでいます。彼は常駐の開発者の一人として、学生に教えることを志願し、自分の専門知識を次世代と共有しています。

Darriusにとって、彼の仕事は評価され、実際に影響があることで充実しています。

< 以前
WebSockets Node.js js(開発者向けの仕組み)
次へ >
tailwind npm(開発者向けの動作方法)