ファイルのアップロードは、Web 開発における一般的な要件です。ファイルをアップロードするには、ファイル入力ボックスを使用する必要があります。ファイル入力に multiple 属性を追加すると、ファイル (サポートされていないブラウザでは、この属性は自動的に無視されます)
<input multiple type="file">
この入力ボックスをクリックすると、ファイルを選択するためのファイル参照ダイアログ ボックスが開きます。通常、入力ボックスは 1 つで十分です。 1 つのファイルをアップロードすることも、複数のファイルをアップロードすることもできます。複数の入力ボックスを使用してこれを処理できます。これは、multiple 属性をサポートしていないブラウザと互換性を持たせるために行われます。同時に、ユーザーは通常、複数のファイルは選択されません
(推奨学習: HTML ビデオ チュートリアル )
基本的なアップロード方法
フォームにファイル入力ボックスを設置し、フォーム送信時に選択したファイルをまとめて送信し、サーバーにアップロードすることができます。フォームにファイルが含まれている場合は、フォーム要素の enctype を変更する必要があります。属性は multipart/form-data
<form action="#" enctype="multipart/form-data" method="post"> <input name="file" type="file"> <button type="submit">Upload</button> </form>
です。このアップロード方法は従来の同期アップロードですアップロードされたファイルが大きい場合、多くの場合、長時間待つ必要があり、アップロードの完了後にページが再読み込みされます。続行する前に、アップロードが完了するまで待つ必要があります。
初期のブラウザは非同期アップロードをサポートしていませんが、iframe を使用してそれをシミュレートし、ページ内の
<form action="#" enctype="multipart/form-data" method="post" target="upload-frame"> <input name="file" type="file"> <button type="submit">Upload</button> </form> <iframe id="upload-frame" name="upload-frame" src="about:blank" style="display: none;"></iframe>
このようにして、フォームがアップロードのために送信されるときに、ページは再読み込みされません。その代わりに、iframe が再読み込みされます。ただし、iframe は元々非表示になっており、再読み込みされても認識されません。
ファイルへのアクセス
File API は、入力ボックスの files 属性を通じてファイルにアクセスする機能を提供します。これにより、コレクションである FileList が取得されます。ファイルが 1 つだけ選択されている場合は、ファイルの最初の要素が取得されます。コレクションはこのファイルです
var input = document.querySelector('input[type="file"]') var file = input.files[0] console.log(file.name) // 文件名称 console.log(file.size) // 文件大小 console.log(file.type) // 文件类型
ファイル API をサポートするブラウザは caniuse を参照できます
Ajax アップロード
これは、ファイル コンテンツに直接アクセスできるためです。ファイル API を使用して、XMLHttpRequest オブジェクトを使用してファイルを直接アップロードし、それをパラメータとして XMLHttpRequest オブジェクトの send メソッドに渡します。このようにファイルを直接渡すことはお勧めできない理由があります。代わりに、
FormDataオブジェクトを使用して、アップロードする必要があるファイルをパッケージ化します。FormData はコンストラクターです。これを使用する場合は、まず新しいインスタンスを作成し、 インスタンスの append を渡します。それにデータを追加する方法、アップロードする必要があるファイルを直接追加します
var xhr = new XMLHttpRequest() xhr.open('POST', '/upload/url', true) xhr.send(file)
var formData = new FormData() formData.append('file', file, file.name) // 第 3 个参数是文件名称 formData.append('username', 'Mary') // 还可以添加额外的参数
var formData = new FormData(document.querySelector('form'))
progress Event も提供します。このイベントに基づいて、アップロードの進行状況を知ることができます。
var xhr = new XMLHttpRequest() xhr.open('POST', '/upload/url', true) xhr.send(formData)
オブジェクトの場合、イベント ハンドラーでこのイベント オブジェクトの を使用して、loaded (アップロードされたバイト数) プロパティと total (合計数) プロパティを使用してアップロードを計算します。進捗###
function progressHandler(e) { var percent = Math.round((e.loaded / e.total) * 100) }
上面的计算会得到一个表示完成百分比的数字,不过这两个值也不一定总会有,保险一点先判断一下事件对象的 lengthComputable 属性
function progressHandler(e) { if (e.lengthComputable) { var percent = Math.round((e.loaded / e.total) * 100) } }
支持 Ajax 上传的浏览器可以参考 caniuse https://caniuse.com/#feat=xhr2
分割上传
使用文件对象的 slice 方法可以分割文件,给该方法传递两个参数,一个起始位置和一个结束位置,这会返回一个新的 Blob 对象,包含原文件从起始位置到结束位置的那一部分(文件 File 对象其实也是 Blob 对象,这可以通过 file instanceof Blob 确定,Blob 是 File 的父类)
var blob = file.slice(0, 1024) // 文件从字节位置 0 到字节位置 1024 那 1KB
将文件分割成几个 Blob 对象分别上传就能实现将大文件分割上传
function upload(file) { let formData = new FormData() formData.append('file', file) let xhr = new XMLHttpRequest() xhr.open('POST', '/upload/url', true) xhr.send(formData) } var blob = file.slice(0, 1024) upload(blob) // 上传第一部分 var blob2 = file.slice(1024, 2048) upload(blob2) // 上传第二部分 // 上传剩余部分
通常用一个循环来处理更方便
var pos = 0 // 起始位置 var size = 1024 // 块的大小 while (pos < file.size) { let blob = file.slice(pos, pos + size) // 结束位置 = 起始位置 + 块大小 upload(blob) pos += size // 下次从结束位置开始继续分割 }
服务器接收到分块文件进行重新组装的代码就不在这里展示了
使用这种方式上传文件会一次性发送多个 HTTP 请求,那么如何处理这种多个请求同时发送的情况呢?方法有很多,可以用 Promise 来处理,让每次上传都返回一个 promise 对象,然后用 Promise.all 方法来合并处理,Promise.all 方法接受一个数组作为参数,因此将每次上传返回的 promise 对象放在一个数组中
var promises = [] while (pos < file.size) { let blob = file.slice(pos, pos + size) promises.push(upload(blob)) // upload 应该返回一个 promise pos += size }
同时改造一下 upload 函数使其返回一个 promise
function upload(file) { return new Promise((resolve, reject) => { let formData = new FormData() formData.append('file', file) let xhr = new XMLHttpRequest() xhr.open('POST', '/upload/url', true) xhr.onload = () => resolve(xhr.responseText) xhr.onerror = () => reject(xhr.statusText) xhr.send(formData) }) }
当一切完成后
Promise.all(promises).then((response) => { console.log('Upload success!') }).catch((err) => { console.log(err) })
支持文件分割的浏览器可以参考 caniuse
判断一下文件对象是否有该方法就能知道浏览器是否支持该方法,对于早期的部分版本浏览器需要加上对应的浏览器厂商前缀
var slice = file.slice || file.webkitSlice || file.mozSlice if (slice) { let blob = slice.call(file, 0, 1024) // call upload(blob) } else { upload(file) // 不支持分割就只能直接上传整个文件了,或者提示文件过大 }
拖拽上传
通过拖拽 API 可以实现拖拽文件上传,默认情况下,拖拽一个文件到浏览器中,浏览器会尝试打开这个文件,要使用拖拽功能需要阻止这个默认行为
document.addEventListener('dragover', function(e) { e.preventDefault() e.stopPropagation() })
任意指定一个元素来作为释放拖拽的区域,给一个元素绑定 drop 事件
var element = document.querySelector('label') element.addEventListener('drop', function(e) { e.preventDefault() e.stopPropagation() // ... })
通过该事件对象的 dataTransfer 属性获取文件,然后上传即可
var file = e.dataTransfer.files[0] upload(file) // upload 函数前面已经定义
选择类型
给文件输入框添加 accept 属性即可指定选择文件的类型,比如要选择 png 格式的图片,则指定其值为 image/png,如果要允许选择所有类型的图片,就是 image/*
<input accept="image/*" type="file">
添加 capture 属性可以调用设备机能,比如 capture="camera" 可以调用相机拍照,不过这并不是一个标准属性,不同设备实现方式也不一样,需要注意
<input accept="image/*" capture="camera" type="file">
经测 iOS 设备添加该属性后只能拍照而不能从相册选择文件了,所以判断一下
if (iOS) { // iOS 用 navigator.userAgent 判断 input.removeAttribute('capture') }
不支持的浏览器会自动忽略这些属性
自定义样式
文件输入框在各个浏览器中呈现的样子都不大相同,而且给 input 定义样式也不是那么方便,如果有需要应用自定义样式,有一个技巧,可以用一个 label 关联到这个文件输入框,当点击这个 label 元素的时候就会触发文件输入框的点击,打开浏览文件的对话框,相当于点击了文件输入框一样的效果
<label for="file-input"></label> <input id="file-input" style="clip: rect(0,0,0,0); position: absolute;" type="file">
这时就可以将原本的文件输入框隐藏了,然后给 label 元素任意地应用样式,毕竟要给 label 元素应用样式比 input 方便得多
本文来自PHP中文网,html教程栏目,欢迎学习
以上がWeb開発におけるファイルアップロードのさまざまな実装方法(コード付き)の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。