dropzoneとJavaScript:ファイル選択・ドロップ・アップロードの違い
この記事では、ドラッグ&ドロップ用に提案されたdropzone属性の役割と、現在は非推奨で実用に向かない理由を説明します。
この記事でわかること
dropzone属性が目指した機能- 現在は廃止・未対応で使わない理由
- 現行APIとファイル選択を使った代替設計
dropzone:3つの意味を分けて考える
ファイルをドラッグして置きたいとき、古いHTML属性、ブラウザのAPI(JavaScriptから使う機能)、JavaScriptライブラリを区別すると、必要な方法を選びやすくなります。
- 古いHTML属性について知りたい
dropzone属性は新しい実装に使いません - 標準のJavaScriptで試したい
ファイル選択とドロップを試す - Dropzoneライブラリを使いたい
同じ名前の別の仕組みです
dropzone属性は使わず、ファイル入力から始める
dropzone属性は現在のHTML標準から削除されています。属性を書くだけでは、ファイルを選ぶ操作やアップロード処理は作れません。
<label for="files">ファイルを選ぶ</label>
<input id="files" type="file" multiple>
<div id="drop-area">ここにファイルをドロップ</div>
<ul id="file-list"></ul>
ファイルを選ぶ・ドロップする
このデモは、ファイル名と大きさを表示します。ファイルの中身は読み取らず、サーバーへ送信しません。
この枠にファイルをドロップできます。スマートフォンやキーボードでは、上のファイル選択を使ってください。
ファイルはまだ選ばれていません。アップロードはしていません。
ドロップされたファイル名を表示するコード
const input = document.querySelector("#files");
const area = document.querySelector("#drop-area");
const list = document.querySelector("#file-list");
function showFiles(files) {
list.replaceChildren();
for (const file of files) {
const li = document.createElement("li");
li.textContent = file.name;
list.appendChild(li);
}
}
input.addEventListener("change", () => showFiles(input.files));
area.addEventListener("dragover", (event) => {
if (Array.from(event.dataTransfer.types).includes("Files")) {
event.preventDefault();
}
});
area.addEventListener("drop", (event) => {
if (!event.dataTransfer.files.length) return;
event.preventDefault();
showFiles(event.dataTransfer.files);
});
上のコードは、id="drop-area"の枠とid="file-list"のulを用意した後で動かします。dragoverで既定の動作を止め、dropで受け取ったファイルを調べます。ファイル名はtextContentで表示します。
| 段階 | 何が起きるか |
|---|---|
| 選択 | ブラウザが選んだファイルを扱える状態。上のデモはここまでです。 |
| プレビュー | 必要なファイルの中身を読み、画像などを表示する。 |
| アップロード | サーバーへ送り、応答を確認する。ファイル名の表示だけでは完了しません。 |
Dropzoneライブラリを探している場合
Dropzoneは、プレビューやアップロードを補助するJavaScriptライブラリです。古いdropzone属性とは別物です。導入する場合も、送信先のサーバー処理と、ファイルの種類・大きさ・中身の検証が必要です。
The HTML "dropzone" attribute was proposed to specify how dropped files (copy, move, or link) are handled as part of drag-and-drop functionality, but it is effectively deprecated because it is hardly supported by modern browsers.
dropzone 属性
dropzone属性とは
属性の概要
dropzone属性は、HTML5のドラフト仕様の段階で提案された、ドラッグアンドドロップ(Drag and Drop)操作をより簡単に扱うための属性です。例えば、<div>や<section>などの要素に対してdropzoneを指定することで、ユーザーがファイルなどをドラッグ&ドロップしやすくするというのが主な目的でした。
しかし、2023年現在、dropzone属性は実装状況が十分ではなく、公式なHTML Living Standardからは削除されています。ブラウザによっては無視されるか、実験的な機能として対応している可能性があるものの、実質的には利用が推奨されない属性になっています。
ドラッグアンドドロップAPIとの関係
HTML5で導入されたドラッグアンドドロップ機能には、JavaScriptのイベント(dragstart, dragover, dropなど)を使う「Drag and Drop API」が存在します。このAPIを利用すれば、要素をドラッグ可能にしたり、ドロップされたファイルを読み取ったりといった操作が可能です。
dropzone属性はこのAPIの簡易的なものとして位置づけられていましたが、仕様としては完成しておらず、多くのブラウザが正式サポートを見送った経緯があります。
基本的な仕組みと使用例
属性値の種類
本来の仕様上では、dropzone属性には以下のような値を指定することができるとされていました:
copy- ドロップしたファイルやデータを“コピー”扱いにする
move- ドロップしたファイルやデータを“移動”扱いにする
link- ドロップしたファイルやデータを“リンク”扱いにする
複数指定する場合には、スペース区切りで書くことが想定されていました (例: dropzone="copy move")。
しかし、前述の通り実際のブラウザがどこまで正確に対応しているかは定かではありません。
一般的なHTMLでの記述例
もしもdropzoneがブラウザに対応している場合のサンプルは次のようになります:
HTML
<div id="drop-area" dropzone="copy move">
ここにファイルをドロップしてください
</div>
このコードは、<div>要素に対してcopyとmoveを指定している例です。ユーザーがファイルをドラッグしてきてこの領域にドロップした時、適切に処理されることを意図します。
ただし、多くのブラウザでは上記のコードだけでは何も起こらず、JavaScriptによるイベントのハンドリングが必要になります。
対応ブラウザと実装状況
主要ブラウザの対応
- Chrome
- 公式に廃止された仕様のため、
dropzone属性は無視されると考えられます。 - Firefox
- 同上。無視されると考えられます。
- Safari
- 一部で実験的にサポートしていた報告もありますが、動作が不安定または廃止されている可能性が高いです。
- Edge
- 旧Edge(Edge Legacy)はIEエンジンをベースにしていましたが、
dropzoneは有効活用されていません。現在のChromium版Edgeでも基本的にはChromeと同様です。 - Internet Explorer
- そもそもHTML5の多くのドラフト仕様を部分実装で終えており、
dropzoneはサポートしていません。
結論として、dropzone属性はほぼサポートされていないか、常に無視されるという認識でよいでしょう。
サポートされていたとしても、ブラウザ差異が大きく、実践的に使うのは困難です。
実用的な利用方法
上記の通り、dropzone属性自体はブラウザ間でほぼ機能しないため、実践的にドラッグアンドドロップ機能を実装したい場合はJavaScriptのDrag and Drop APIを直接利用するのが一般的です。
Drag and Drop APIの基本的な流れ
- ドラッグを開始させる
-
- ドラッグ可能にしたい要素で
draggable="true"を設定する dragstartイベントでデータをセットする (例:event.dataTransfer.setData)
- ドラッグ可能にしたい要素で
- ドロップ先で受け取る
-
- ドロップ先の要素で
dragoverイベントを拾い、event.preventDefault()する (ドロップを受け付け可能にする) dropイベントでevent.dataTransfer.getDataを使い、ドラッグされたデータを取得する
- ドロップ先の要素で
- ファイル読み取り等を行う
-
- ファイルを受け取る場合、
event.dataTransfer.files配列でファイルオブジェクトを取得し、FileReader APIなどで読み込む
- ファイルを受け取る場合、
ファイルのドラッグアンドドロップ
ファイルをドロップさせるだけなら、フォーム要素の<input type="file">を使う方法のほうが手軽に思えますが、WebアプリケーションのUI/UX向上や、アップロードする前にプレビューを見せる・アップロード枚数を制限するなどの高度な操作をしたい場合は、Drag and Drop APIとFile APIを組み合わせることがよくあります。
実践的なサンプルコード
以下は、dropzone属性を実際に書いてはいるものの、あくまで機能を実現しているのはJavaScriptのDrag and Drop APIだという例を示します。dropzone属性が実質機能しなくても、JavaScriptがあればドラッグアンドドロップは動作します。
HTML
<div id="drop-area" dropzone="copy move">
ここにファイルをドロップしてください
</div>
<p id="drop-result" role="status" aria-live="polite"></p>
<script>
const dropArea = document.getElementById('drop-area');
// ドラッグ要素が領域内に入ってきたとき
dropArea.addEventListener('dragenter', (event) => {
event.preventDefault();
dropArea.classList.add('hover');
});
// ドラッグ要素が領域内を移動しているとき
dropArea.addEventListener('dragover', (event) => {
event.preventDefault();
});
// ドラッグ要素が領域外に出たとき
dropArea.addEventListener('dragleave', () => {
dropArea.classList.remove('hover');
});
// ファイルがドロップされたとき
dropArea.addEventListener('drop', (event) => {
event.preventDefault();
dropArea.classList.remove('hover');
// ドロップされたファイルを取得
const files = event.dataTransfer.files;
if (files.length > 0) {
document.getElementById('drop-result').textContent = `${files.length} 個のファイルがドロップされました。`;
// ファイルの処理を行う(アップロードやプレビュー表示など)
}
});
</script>
このサンプルのポイントは以下の通りです:
dropzone="copy move"を指定してはいるものの、このコードはブラウザによっては何もしません。- ドラッグ時やドロップ時にイベントをハンドリングしているのは
dragenter,dragover,dragleave,dropなどのJavaScriptイベントです。 event.preventDefault()を忘れるとドロップが無効化されてしまうブラウザもあるため注意しましょう。alertではなく、実際にはアップロード処理やプレビュー処理などを行うことが多いです。
dropzone属性の代替手段・応用方法
代替手段
- Drag and Drop API (JavaScript)
- 先ほども説明した通り、実際にドラッグアンドドロップを実現する場合は
dropzone属性ではなく、JavaScriptのイベントハンドラを用いるのが主流です。 - ライブラリの活用
-
- jQueryのプラグインや様々なドラッグアンドドロップ用のライブラリ・フレームワークが存在します。
- Vue.jsやReactなどのフレームワークでも、ドラッグアンドドロップをサポートするコンポーネントが多く作られています。
応用方法
- ファイルプレビュー
- ドロップされた画像やPDFのプレビューを即座に表示する
- 複数ファイルの同時アップロード
- ドラッグしたファイルを一括アップロード
- 動的なUI変更
- ドロップ時に別の要素にファイルの情報を表示するインタラクティブな仕組み
- ドラッグ後のカスタム処理
- 他の要素と組み合わせて、ドラッグ&ドロップで並び替えを行ったり、移動をトリガーにアニメーションをするなど
注意点・よくある誤解
dropzoneは指定するだけでドラッグ&ドロップが完結するわけではない- どのブラウザでも、ほぼ間違いなくJavaScriptによる補完が必要です。
- ブラウザ間の挙動が統一されていない
- 一部のブラウザは独自実装をしていたり、まったく機能しなかったりと差異が大きいです。
- HTML標準仕様からも外されている
- 現行のHTML Living Standardには含まれないため、新規プロジェクトで採用しても長期的にサポートされる可能性が低いです。
- セキュリティ面での配慮が必要
- ドラッグ&ドロップしたファイルをそのまま実行してしまうような処理は危険です。必ず受け取ったファイル形式・サイズ・内容の検証を行う必要があります。
- ユーザー体験を向上させる工夫
- ドラッグ中にガイドを表示したり、ドロップ可能領域をハイライトするなど、ユーザーが分かりやすいUIを心がけます。
まとめ
dropzone属性はHTML5のドラフトで提案されましたが、現在は非推奨・未実装の要素が多いため、実用上は使わない方が無難です。- ドラッグ&ドロップ機能を実現するには、基本的にJavaScriptのDrag and Drop APIを使用します。
- ファイルのプレビューやアップロードなど、より高度なドラッグ&ドロップ機能を構築したい場合も、
dropzone属性に頼るのではなく、APIとライブラリを組み合わせて実装しましょう。 - HTML Living Standardに含まれていない属性であることを理解し、今後の仕様変更やブラウザ対応に注意しつつ、互換性を考えて設計するのが重要です。