JavaScript による独自のファイルアップロード UI の作成
ネイティブのファイル入力を残し、標準では備わっていない画像プレビュー、選択項目を削除できるリスト、画像を読み込めない場合のフィードバックを追加します。この例では、プレビューの読み込み中でも選択内容を置き換えたり消去したりでき、古い処理結果が新しいリストを書き換えることはありません。ファイルはブラウザー内に留まり、このページからは送信されません。
ファイルアップロード UI が管理する範囲の決定
ネイティブの入力は、すでに複数ファイルの選択に対応しています。キーボードで操作できるよう入力を表示したまま、その File オブジェクトを使ってプレビューリストを作成します。ファイルを選択またはドロップすると、それまでの選択内容が置き換わります。Removeでは行を一つ削除し、Clear selectionではすべての行を削除します。ファイル選択ダイアログをキャンセルしても、リストは変わりません。
このデモでは、空でない JPEG、PNG、GIF 画像を一度に最大 10 個まで選択できます。各ファイルの上限は 2 MiB です。宣言された MIME タイプ、短いシグネチャ、ブラウザーでプレビューをデコードできるかを検証します。これらは選択内容へのフィードバックであり、コンテンツの安全性を証明するものではありません。accept 属性はファイル選択ダイアログへのヒントにすぎません。圧縮された小さなファイルでも、デコードすると大きな画像になる場合があります。バイト数の制限では、デコード後の画像のメモリー使用量を制限できません。
ブラウザー、Bash などの POSIX シェル、および 24.x 系の Node.js 24.15 以降、または 26.x 系の 26.5 以降が必要です。依存パッケージやビルド工程は不要です。サーバーの拡張子は .mts のままにしてください。CommonJS プロジェクト内でも、Node はこのファイルを ES モジュールとして扱います。
実験用のディレクトリから、新しいフォルダーを作成します。
mkdir file-preview-demo
そのディレクトリがすでに存在する場合は、ファイルを上書きせず、作業を止めて別の名前を選んでください。次の四つの例を、指定されたファイル名で file-preview-demo 内に保存します。
HTML 構造の設定
index.html として保存します。ラベル付きのネイティブ入力は、ファイルのドロップに代わるキーボード操作手段です。リストにはファイルごとのフィードバックを保持し、polite のステータス領域で現在の選択内容を通知します。
<!doctype html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Image selection preview</title>
<link rel="stylesheet" href="styles.css" />
<script src="script.js" defer></script>
</head>
<body>
<main>
<h1>Preview selected images</h1>
<section id="drop-zone" aria-label="Drop images">
<label for="file-input">Choose images</label>
<input id="file-input" type="file" multiple accept="image/jpeg,image/png,image/gif"
aria-describedby="file-help" />
<p id="file-help">Choose or drop up to 10 JPEG, PNG, or GIF images, each up to 2 MiB.</p>
</section>
<button id="clear-selection" type="button" disabled>Clear selection</button>
<p id="status" role="status" aria-atomic="true">No files selected. Nothing has been uploaded.</p>
<ul id="file-preview" aria-label="Selected images"></ul>
<noscript>Enable JavaScript to preview and manage your selection.</noscript>
</main>
</body>
</html>
CSS によるファイル入力のスタイル設定
styles.css として保存します。入力を非表示にせず、ファイル選択ボタンのスタイルを設定できます。システムカラーはブラウザーのライトテーマまたはダークテーマに従い、長いファイル名は各行の中で折り返されます。
:root { color-scheme: light dark; }
body {
font: 1rem/1.5 system-ui, sans-serif;
max-width: 42rem;
margin: 2rem auto;
padding: 0 1rem;
color: CanvasText;
background: Canvas;
}
#drop-zone { border: 2px dashed currentColor; padding: 1rem; }
#drop-zone.dragover { outline: 3px solid Highlight; }
label { display: block; font-weight: bold; }
input { max-width: 100%; }
button, input::file-selector-button { font: inherit; padding: 0.5rem; }
button { margin-block: 0.5rem; }
:focus-visible { outline: 3px solid Highlight; outline-offset: 3px; }
#file-preview { list-style: none; padding: 0; }
#file-preview li { border-block-start: 1px solid currentColor; padding-block: 1rem; }
#file-preview p { overflow-wrap: anywhere; }
#file-preview img { width: 8rem; height: 8rem; object-fit: contain; max-width: 100%; }
機能を拡張する JavaScript の実装
script.js として保存します。各行は自身のリーダーとオブジェクト URL を管理します。行を破棄するときは、まず非アクティブとしてマークしてから、保留中の読み取りを中止して URL を解放します。二つの非同期処理段階は、表示状態を変更する前にどちらもそのフラグを確認します。そのため、シグネチャの読み取りや画像のデコードが遅れて完了しても、削除済みの行は復活しません。
FileReader.abort()
は保留中の読み取りをキャンセルします。その abort イベントの処理で Promise も確定させます。ここで使う画像デコードには対応するキャンセルメソッドがないため、行が破棄済みであれば結果を破棄します。img.decode()
を使うことで、デコードに成功した後にのみサムネイルを表示できます。
const fileInput = document.getElementById('file-input')
const preview = document.getElementById('file-preview')
const clearButton = document.getElementById('clear-selection')
const dropZone = document.getElementById('drop-zone')
const status = document.getElementById('status')
const allowedTypes = ['image/jpeg', 'image/png', 'image/gif']
const maxSize = 2 * 1024 * 1024
let entries = []
function updateStatus() {
clearButton.disabled = entries.length === 0
const ready = entries.filter((entry) => entry.state === 'ready').length
const checking = entries.filter((entry) => entry.state === 'checking').length
const rejected = entries.filter((entry) => entry.state === 'rejected').length
status.textContent = entries.length === 0
? 'No files selected. Nothing has been uploaded.'
: `${ready} previews ready, ${checking} checking, ${rejected} rejected. Nothing has been uploaded.`
}
function dispose(entry) {
entry.active = false
if (entry.reader.readyState === FileReader.LOADING) entry.reader.abort()
if (entry.url !== null) URL.revokeObjectURL(entry.url)
entry.url = null
entry.image.removeAttribute('src')
}
function clearSelection() {
for (const entry of entries) dispose(entry)
entries = []
preview.replaceChildren()
fileInput.value = ''
updateStatus()
}
function removeEntry(entry) {
const index = entries.indexOf(entry)
const focusTarget = entries[index + 1]?.remove ?? entries[index - 1]?.remove ?? fileInput
entries.splice(index, 1)
dispose(entry)
entry.row.remove()
updateStatus()
focusTarget.focus()
}
function createEntry(file) {
const row = document.createElement('li')
const image = document.createElement('img')
image.alt = `Preview of ${file.name}`
image.hidden = true
const name = document.createElement('p')
name.textContent = file.name
const message = document.createElement('p')
message.textContent = 'Checking image…'
const remove = document.createElement('button')
remove.type = 'button'
remove.textContent = 'Remove'
remove.setAttribute('aria-label', `Remove ${file.name}`)
const entry = {
file, row, image, message, remove,
reader: new FileReader(), url: null, active: true, state: 'checking',
}
remove.addEventListener('click', () => removeEntry(entry))
row.append(image, name, message, remove)
preview.appendChild(row)
return entry
}
function finish(entry, state, message) {
entry.state = state
entry.message.textContent = message
updateStatus()
}
function checkFileSignature(file, reader = new FileReader()) {
return new Promise((resolve) => {
function complete(valid) {
reader.onload = reader.onerror = reader.onabort = null
resolve(valid)
}
reader.onerror = reader.onabort = () => complete(false)
reader.onload = () => {
const bytes = new Uint8Array(reader.result)
if (bytes.length < 4) return complete(false)
const header = Array.from(bytes, (byte) => byte.toString(16).padStart(2, '0')).join('')
const types = { '89504e47': 'image/png', '47494638': 'image/gif' }
const detectedType = header.startsWith('ffd8ff') ? 'image/jpeg' : types[header]
complete(detectedType === file.type)
}
reader.readAsArrayBuffer(file.slice(0, 4))
})
}
async function loadPreview(entry) {
const valid = await checkFileSignature(entry.file, entry.reader)
if (!entry.active) return
if (!valid) {
finish(entry, 'rejected', 'Cannot read this file, or its signature does not match its MIME type.')
return
}
entry.url = URL.createObjectURL(entry.file)
entry.image.src = entry.url
try {
await entry.image.decode()
if (!entry.active) return
entry.image.hidden = false
finish(entry, 'ready', 'Preview ready.')
} catch {
if (!entry.active) return
URL.revokeObjectURL(entry.url)
entry.url = null
entry.image.removeAttribute('src')
finish(entry, 'rejected', 'Image could not be decoded. Choose another file.')
}
}
function choose(files) {
if (files.length === 0) return
clearSelection()
if (files.length > 10) {
status.textContent = 'Choose no more than 10 files at once. Nothing has been uploaded.'
return
}
for (const file of files) {
const entry = createEntry(file)
entries.push(entry)
if (!allowedTypes.includes(file.type)) {
finish(entry, 'rejected', 'Choose a JPEG, PNG, or GIF with a recognized MIME type.')
} else if (file.size === 0 || file.size > maxSize) {
finish(entry, 'rejected', 'The image must be nonempty and no larger than 2 MiB.')
} else {
void loadPreview(entry)
}
}
updateStatus()
}
fileInput.addEventListener('change', () => {
choose(Array.from(fileInput.files))
// Retain the File objects ourselves so choosing the same files can fire change again.
fileInput.value = ''
})
clearButton.addEventListener('click', () => {
clearSelection()
fileInput.focus()
})
dropZone.addEventListener('dragover', (event) => {
event.preventDefault()
dropZone.classList.add('dragover')
})
dropZone.addEventListener('dragleave', () => dropZone.classList.remove('dragover'))
dropZone.addEventListener('drop', (event) => {
event.preventDefault()
dropZone.classList.remove('dragover')
choose(Array.from(event.dataTransfer.files))
})
window.addEventListener('pagehide', clearSelection)
ファイル名は textContent を通して表示するため、HTML を含む名前もテキストとして表示されます。画像が利用可能な間はオブジェクト URL を有効に保ってください。Remove、Clear selection、選択内容の置き換え、デコードの失敗、ページからの離脱時に URL を解放します。ページを再読み込みするか離れると、選択内容は失われます。
四バイトの検証で識別できるのは先頭部分だけです。ブラウザーでデコードに成功しても、破損したファイルが許容されている場合があります。どちらの段階も、画像が完全であることや、安全に保存できることを証明するものではありません。拒否された行は理由とともに表示されたままになり、削除することもできます。
プレビューページのローカル配信
server.mts として保存します。このサーバーはブラウザー用の三つのファイルだけを配信し、アップロード用エンドポイントは持ちません。デフォルトでは利用可能なループバックポートを選択します。固定ポートが必要な場合は、任意で PORT を設定してください。
import { readFile } from 'node:fs/promises'
import { createServer } from 'node:http'
async function main(): Promise<void> {
const portText = process.env.PORT ?? '0'
const port = Number(portText)
if (!/^\d+$/.test(portText) || !Number.isInteger(port) || port < 0 || port > 65535) {
throw new Error('PORT must be an integer from 0 to 65535.')
}
const assets = new Map<string, { body: Buffer; type: string }>()
for (const [route, file, type] of [
['/', 'index.html', 'text/html; charset=utf-8'],
['/styles.css', 'styles.css', 'text/css'],
['/script.js', 'script.js', 'text/javascript'],
]) {
assets.set(route, { body: await readFile(new URL(file, import.meta.url)), type })
}
const server = createServer((req, res) => {
if (req.method === 'GET' && req.url === '/favicon.ico') {
res.writeHead(204).end()
return
}
const asset = assets.get(req.url ?? '')
if (req.method !== 'GET' || !asset) {
res.writeHead(404).end('Not found.')
return
}
res.writeHead(200, { 'Content-Type': asset.type, 'Cache-Control': 'no-store' })
res.end(asset.body)
})
await new Promise<void>((resolve, reject) => {
server.once('error', reject)
server.listen(port, '127.0.0.1', resolve)
})
const address = server.address()
if (!address || typeof address === 'string') throw new Error('Missing TCP address')
console.log(`Open http://127.0.0.1:${address.port}`)
}
main().catch((error: unknown) => {
const code = error instanceof Error && 'code' in error ? error.code : ''
console.error(code === 'EADDRINUSE'
? 'Port is already in use. Choose another PORT or leave it unset.'
: 'Could not start preview server. Check PORT and the three browser files.')
process.exitCode = 1
})
file-preview-demo を作成した親ディレクトリから、次を実行します。
(cd file-preview-demo && node server.mts)
出力された URL をブラウザーで開きます。ターミナルを開いたままにし、終了時は Ctrl+C でサーバーを停止してください。シェルの作業場所は親ディレクトリのままです。サーバーは起動時にブラウザー用ファイルを読み込むため、編集後は再起動してください。ポートが使用中の場合、PORT が無効な場合、またはファイルが見つからない場合は、準備完了の URL を出力せず、ゼロ以外のステータスで起動を中止します。
ブラウザーの互換性
この手順は Linux 上で、Node.js 24.15.0、26.5.0、26.8.1 と、Chromium 145、152 を使ってテストしました。ネイティブの FileReader、オブジェクト URL、ドラッグ&ドロップ、img.decode() を使用します。ファイルをドロップできないデバイスでも、ファイル選択ダイアログを代わりに使えます。
選択操作の流れ全体を試してください。
- Tab キーで Choose images に移動し、ファイル選択ダイアログを開いて小さな画像を二つ選択します。各行にファイル名、サムネイル、Preview ready.が表示されることを確認します。ステータスには 2 previews ready, 0 checking, 0 rejected. Nothing has been uploaded.と表示されることを確認します。
- Tab キーで行の Remove ボタンに移動し、実行します。フォーカスは次の行の Remove ボタンに移動します。次の行がなければ前の行に、リストが空ならファイル入力に移動します。Clear selectionでも、フォーカスはファイル入力に戻ります。
- プレビューの読み込み中に、別のファイルを選択またはドロップします。以前の行は消え、読み取りが完了しても再表示されません。同じファイルをもう一度選択し、再選択できることを確認してください。ファイル選択ダイアログをキャンセルした場合は、現在のリストが維持されることを確認します。
- 空の画像、未対応のタイプ、2 MiB を超えるファイル、識別可能な先頭部分を持つ破損画像を試してください。それぞれの行に理由が表示されることを確認します。10 個を超えるファイルを選択した場合は、その選択全体が拒否されます。
選択内容とアップローダーの接続
このリストは自身の File オブジェクトを管理し、選択のたびにネイティブ入力をリセットします。そのため、この入力をフォームとして送信しても、選択したファイルは送信されません。送信機能を追加するには、保持している受け入れ済みファイルを送信し、削除や置き換えを保留中のリクエストと連携させてください。
送受信の完全な例は、独自の JavaScript アップローダーを参照してください。この例はリクエストごとに JPEG、PNG、PDF のいずれか一つを処理し、チェックサム付きの受領確認を返します。受信側は複数画像用のエンドポイントではなく、GIF も受け付けません。このプレビューリストにそのまま接続する受信側ではなく、別のチュートリアルとして扱ってください。公開アップロードサービスには、独自のサーバー側検証と認可が必要です。このローカル UI は、サーバー側の受け入れ処理も CSRF 対策も提供しません。
