React でドラッグ&ドロップによるファイルアップロードを実装
ファイルを選択しただけでは、まだサーバーには届いていません。ファイルを一つ選択し、ローカルの Node.js 受信サーバーにアップロードして、保存できたかを確認する React のドロップゾーンを作成します。選択の拒否やリクエストの失敗にも対応し、最初のアップロードに別のアップロードが重ならないようにします。
react-dropzone はファイル選択を処理します。ドラッグ&ドロップとファイル選択ダイアログの両方に対応します。転送には fetch() を使い、受信サーバーがファイルの書き込みを完了した後にのみ成功を返します。
小規模な React プロジェクトのセットアップ
最新のパッチを適用した Node.js 24 または 26 の LTS リリースを使い、Corepack を別途インストールしてください。このチュートリアルでは Yarn 4.12.0 を使います。アカウントやクラウドストレージを使わない、ローカルの学習用プロジェクトです。
以前の Linux での検証では、Node.js 24.15.0、React と React DOM 19.3.0、react-dropzone 20.1.2、esbuild 0.28.2、TypeScript 6.0.3、Chromium 145 を使いました。2026年11月7日に、同じパッケージバージョンと Chromium 145 を使い、Node.js 24.22.2 と 26.13.0 のそれぞれで、例全体を再テストしました。どちらも Corepack 0.34.5 と Yarn 4.12.0 を使用しています。以前の Node.js 固定バージョンではなく、保守されているパッチを使ってください。Node の10月のセキュリティ更新は、両方のリリース系列を対象としています。
デモは Yarn Plug’n’Play プロジェクトの外に作成してください。esbuild は親ディレクトリからマニフェストを検出するため、このデモのパッケージ解決が上書きされることがあります。セットアップでは、ファイルを作成する前に .pnp.cjs と
.pnp.js の有無を確認します。
プロジェクトを作成したいディレクトリで、次のコードを Bash に貼り付けてください。丸括弧により、シェルの作業ディレクトリはその親ディレクトリのままになります。react-dropzone-demo がすでに存在する場合は、別の新しい親ディレクトリを選んでください。このブロックは、既存のプロジェクトを意図的に上書きしないようにしています。ローカルの ignorePath 設定により、親プロジェクトの yarnPath による上書きで Yarn のバージョンが変わるのを防ぎます。
(
set -e
node --input-type=module -e '
import { existsSync } from "node:fs"
import { dirname, join } from "node:path"
for (let dir = process.cwd(); ; dir = dirname(dir)) {
if ([".pnp.cjs", ".pnp.js"].some(name => existsSync(join(dir, name)))) {
throw new Error("Choose a directory outside a Yarn Plug’n’Play project.")
}
if (dir === dirname(dir)) break
}
'
mkdir react-dropzone-demo
cd react-dropzone-demo
printf '%s\n' '{"private":true,"type":"module","packageManager":"yarn@4.12.0"}' > package.json
printf 'nodeLinker: node-modules\nenableGlobalCache: false\nignorePath: true\n' > .yarnrc.yml
touch yarn.lock
mkdir src public
corepack yarn add --exact react@19.3.0 react-dom@19.3.0 react-dropzone@20.1.2 \
esbuild@0.28.2 typescript@6.0.3 @types/react@19.3.0 @types/react-dom@19.3.0
)
以下のファイルはすべて react-dropzone-demo 内に保存してください。コンパイラーとバンドラーがどちらもこのプロジェクトの設定を使うように、tsconfig.json を作成します。
{
"compilerOptions": {
"target": "ES2022",
"lib": ["ES2022", "DOM", "DOM.Iterable"],
"module": "ESNext",
"moduleResolution": "Bundler",
"jsx": "react-jsx",
"strict": true,
"noEmit": true,
"allowImportingTsExtensions": true,
"skipLibCheck": true,
"types": ["react", "react-dom"]
},
"include": ["src/**/*.tsx"]
}
ファイルの選択とアップロード結果の表示
次のコードを src/DragAndDropUpload.tsx として保存してください。ドロップゾーンは、5 MiB 以下の PNG、JPEG、GIF、PDF、またはテキストファイルを一つ受け付けます。無効な選択が行われると、前の選択は解除されます。許可されるファイルと拒否されるファイルを同時にドロップすると、全体が拒否されます。そのため、アップロードをクリックしても、一部だけが通知なしで送信されることはありません。
import { useId, useRef, useState, type ReactNode } from 'react'
import { useDropzone } from 'react-dropzone'
const accept = {
'image/png': ['.png'],
'image/jpeg': ['.jpg', '.jpeg'],
'image/gif': ['.gif'],
'application/pdf': ['.pdf'],
'text/plain': ['.txt'],
}
export function DragAndDropUpload(): ReactNode {
const hintId = useId()
const [file, setFile] = useState<File | null>(null)
const [busy, setBusy] = useState(false)
const [status, setStatus] = useState('Choose a file to begin.')
const [error, setError] = useState('')
const uploading = useRef(false)
const { getRootProps, getInputProps, isDragActive } = useDropzone({
accept,
multiple: false,
maxSize: 5 * 1024 * 1024,
disabled: busy,
onDrop(accepted, rejected) {
if (uploading.current) return
setError('')
setStatus('Choose a file to begin.')
if (rejected.length > 0 || accepted.length !== 1) {
setFile(null)
setError('Choose one PNG, JPEG, GIF, PDF, or text file no larger than 5 MiB.')
return
}
setFile(accepted[0])
setStatus('Ready to upload.')
},
})
async function upload(): Promise<void> {
if (!file || uploading.current) return
uploading.current = true
setBusy(true)
setError('')
setStatus('Uploading…')
try {
const body = new FormData()
body.append('file', file)
const response = await fetch('/api/upload', {
method: 'POST',
body,
signal: AbortSignal.timeout(30_000),
})
if (!response.ok) {
setStatus('Upload rejected.')
setError(`The server rejected the upload (HTTP ${response.status}). Fix the cause, then retry.`)
return
}
setStatus('Saved on the server.')
setFile(null)
} catch {
setStatus('Upload unconfirmed.')
setError('Could not confirm the upload. Check the connection and server, then retry.')
} finally {
uploading.current = false
setBusy(false)
}
}
return (
<section aria-label="File upload">
<div {...getRootProps({
role: 'button',
'aria-label': 'Choose a file',
'aria-describedby': hintId,
className: isDragActive ? 'dropzone active' : 'dropzone',
})}>
<input {...getInputProps({ 'aria-label': 'Upload file', disabled: busy })} />
<p>{isDragActive ? 'Drop the file here.' : 'Drop a file here, or click to choose.'}</p>
</div>
<p id={hintId}>One PNG, JPEG, GIF, PDF, or text file. Maximum 5 MiB.</p>
<p>{file ? `Selected: ${file.name}` : 'No file selected.'}</p>
<button type="button" onClick={upload} disabled={busy || file === null}>
{busy ? 'Uploading…' : error && file ? 'Retry upload' : 'Upload'}
</button>
<p role="status">{status}</p>
{error ? <p role="alert">{error}</p> : null}
</section>
)
}
リクエストが処理中の間は、状態に応じて選択とアップロードの操作が無効になります。さらに ref により、React が無効状態を描画する前の素早い連続呼び出しも防ぎます。リクエストに失敗した場合は、Retry upload で再試行できるようにファイルを保持し、保存を確認できた場合は選択を解除します。
リクエストの Content-Type は自分で設定しないでください。FormData の送信時に、ブラウザーが multipart の境界を設定します。また、response.ok も確認してください。fetch は HTTP エラーレスポンスでも解決します。サーバーによる拒否もこれに含まれます。30秒のタイムアウトは、クライアントが結果を確認できなかったことを意味します。サーバーではすでにファイルが保存されている可能性があるため、再試行で別のコピーが作られることがあります。
ローカル受信サーバーの追加
プロジェクトルートに server.ts を保存してください。ページを配信するとともに、file という名前の multipart フィールドを
/api/upload で一つ受け付けるため、ブラウザーと受信サーバーは同一オリジンになります。リクエストが成功するたびに、uploads/ 配下に UUID 名の新しいファイルを書き込み、HTTP 201 を返します。保存先のパスはターミナルに出力されます。既存のファイルは、サーバーを停止した後もそのまま残ります。デモでアップロードしたファイルが不要になったら削除してください。
この受信サーバーはローカルテスト用です。フィールド数、サイズ、申告された MIME タイプを確認しますが、ファイル選択ダイアログのフィルターも MIME メタデータも、実際のバイト列の内容を証明するものではありません。各リクエストをバッファリングし、ファイルと multipart のオーバーヘッドを合わせて 6 MiB のリクエスト上限を設けています。本番環境に配置する受信サーバーには、内容の検証、認証、ストレージクォータ、および上限に適したストリーミング multipart パーサーが必要です。
import { randomUUID } from 'node:crypto'
import { once } from 'node:events'
import { mkdir, readFile, writeFile } from 'node:fs/promises'
import { createServer, type IncomingMessage, type ServerResponse } from 'node:http'
import { join } from 'node:path'
const allowedTypes = new Set([
'image/png', 'image/jpeg', 'image/gif', 'application/pdf', 'text/plain',
])
const uploads = join(import.meta.dirname, 'uploads')
const assets = new Map<string, { body: Buffer; type: string }>()
async function handle(request: IncomingMessage, response: ServerResponse): Promise<void> {
const asset = assets.get(request.url ?? '')
if (request.method === 'GET' && asset) {
response.writeHead(200, { 'Content-Type': asset.type }).end(asset.body)
return
}
if (request.method !== 'POST' || request.url !== '/api/upload') {
response.writeHead(404).end()
return
}
const chunks: Buffer[] = []
let bytes = 0
for await (const chunk of request) {
if (!Buffer.isBuffer(chunk)) throw new Error('Expected request bytes')
bytes += chunk.length
if (bytes > 6 * 1024 * 1024) {
response.writeHead(413).end()
return
}
chunks.push(chunk)
}
let form: FormData
try {
form = await new Response(Buffer.concat(chunks), {
headers: { 'Content-Type': request.headers['content-type'] ?? '' },
}).formData()
} catch {
response.writeHead(400).end()
return
}
const entries = [...form.entries()]
const file = form.get('file')
if (entries.length !== 1 || !(file instanceof File)) {
response.writeHead(400).end()
return
}
if (file.size > 5 * 1024 * 1024) {
response.writeHead(413).end()
return
}
if (!allowedTypes.has(file.type)) {
response.writeHead(415).end()
return
}
const id = randomUUID()
await writeFile(join(uploads, id), Buffer.from(await file.arrayBuffer()), { flag: 'wx' })
console.log(`Saved uploads/${id}`)
response.writeHead(201).end()
}
async function main(): Promise<void> {
const port = Number(process.argv[2] ?? 0)
if (!Number.isInteger(port) || port < 0 || port > 65535) throw new Error('Invalid port')
for (const [route, name, type] of [
['/', 'index.html', 'text/html; charset=utf-8'],
['/app.js', 'app.js', 'text/javascript; charset=utf-8'],
['/app.css', 'app.css', 'text/css; charset=utf-8'],
]) {
assets.set(route, { body: await readFile(join(import.meta.dirname, 'public', name)), type })
}
await mkdir(uploads, { recursive: true })
const server = createServer((request, response) => {
void handle(request, response).catch(() => {
console.error('Request failed; check that the uploads directory is writable.')
if (!response.headersSent) response.writeHead(500)
response.end()
})
})
server.listen(port, '127.0.0.1')
await once(server, 'listening')
const address = server.address()
if (!address || typeof address === 'string') throw new Error('Missing server address')
console.log(`Open http://127.0.0.1:${address.port}/`)
}
main().catch((error: unknown) => {
console.error('Server could not start:', error)
process.exitCode = 1
})
ポートをゼロにすると、Node が未使用のポートを選択します。サーバーは、このマシンのループバックアドレスだけにバインドします。起動時の確認で、URL を出力する前にビルド済みのアセットを読み込むため、ビルドが存在しなければ即座に失敗します。
操作部品の視認性の改善
public/app.css を保存してください。フォーカスの輪郭線は残してください。キーボード操作中の利用者が、現在の位置を把握するために必要です。長いファイル名は、ページの幅を広げずに折り返します。
body { font: 1rem/1.5 system-ui, sans-serif; margin: 0; color: #17202a; background: #fff; }
main { max-width: 36rem; margin: 2rem auto; padding: 1rem; overflow-wrap: anywhere; }
.dropzone { border: 2px dashed #2367a1; border-radius: 0.5rem; padding: 1.5rem; cursor: pointer; }
.dropzone.active { background: #e7f2ff; }
.dropzone:focus-visible, button:focus-visible { outline: 3px solid #17202a; outline-offset: 4px; }
.dropzone[aria-disabled="true"], button:disabled { cursor: not-allowed; opacity: 0.6; }
button { font: inherit; padding: 0.5rem 1rem; }
[role="alert"] { color: #9b1c1c; }
コンポーネントのマウントと実行
src/main.tsx を保存してください。
import { createRoot } from 'react-dom/client'
import { DragAndDropUpload } from './DragAndDropUpload.tsx'
const root = document.getElementById('root')
if (!root) throw new Error('Missing root element')
createRoot(root).render(<main><h1>Upload a file</h1><DragAndDropUpload /></main>)
public/index.html を保存してください。上記のスタイルシートと、次にビルドする JavaScript バンドルを読み込みます。
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>React file upload</title>
<link rel="icon" href="data:,">
<link rel="stylesheet" href="/app.css">
</head>
<body>
<div id="root"></div>
<script type="module" src="/app.js"></script>
</body>
</html>
セットアップコマンドを実行したのと同じ親ディレクトリで、型チェック、バンドル、受信サーバーの起動を行います。
(
cd react-dropzone-demo &&
corepack yarn exec tsc --project tsconfig.json &&
corepack yarn exec esbuild src/main.tsx --bundle --format=esm --jsx=automatic \
--tsconfig=tsconfig.json --outfile=public/app.js &&
node server.ts
)
ターミナルに出力された URL を開いてください。ファイルを選択し、Upload をクリックします。ページには最初に Uploading… が表示され、受信サーバーの応答後に Saved on the server. が表示されます。uploads/ 内のファイルを元のファイルと比較してください。生成されたファイル名は変わりますが、バイト列は一致するはずです。Ctrl+C でサーバーを停止します。ファイルを編集したら、このビルドと起動のブロックを再実行してください。自動リロードはありません。ビルドに失敗するとブロックの実行が止まり、古いバンドルが配信されるのを防ぎます。
選択、拒否、復旧の確認
Tab キーで Choose a file に移動し、Enter または Space キーでファイル選択ダイアログを開いてください。ルート要素の props がキーボード操作を処理し、入力要素の props がネイティブのファイル入力要素を接続します。ステータス領域とアラート領域は、フォーカスを移動させずにフィードバックを伝えます。クリックやタップでもダイアログを開けるため、ドラッグ操作は必須ではありません。公開前に、対象のモバイルブラウザーと支援技術でテストしてください。このチュートリアルでのブラウザー検証は、デスクトップ版 Chromium が対象です。
小さなファイルのアップロード成功に加え、次の失敗ケースも試してください。
- 5 MiB を超えるファイル、未対応の種類のファイル、または二つのファイルを同時にドロップします。ページに選択ルールが表示され、Upload が無効になります。
- リクエストの処理中に、別のファイルの選択や再アップロードを試します。現在のファイルは選択されたままで、リクエストが完了するまで操作部品は無効のままになります。
- ファイルを選択した後でサーバーを停止し、Upload をクリックします。Upload unconfirmed. が表示され、ファイルは保持されるはずです。実行ブロックの
node server.tsをnode server.ts PORTに置き換え、以前の URL のポート番号を指定して、同じポートでサーバーを再起動します。その後、Retry upload を選択します。そのポートが使用中の場合は、通知なしで別のオリジンに移るのではなく、起動に失敗します。
再開可能な転送が必要な場合の Uppy の選択
この例は通常の multipart リクエストを一つ送信します。中断した転送の再開や、アップロード済みの割合の表示には対応していません。より大規模なアップローダーを作る場合は、Uppy の React 統合を出発点として、アップロード用プラグインを選んでください。Uppy の Tus プラグインは再開可能な転送を追加し、互換性のある tus サーバーを必要とします。この例の /api/upload 受信サーバーは、そのプロトコルを実装していません。
