現在,人們喜歡在浏覽網頁時做一些其他事情而不離開該網頁,這通常是通過ajax來實現.大多數情況,人們使用jQuery來實現,但是隨著浏覽器的進步,人們比不需要這麼做.這裡我們將介紹如何在不離開頁面的情況下將文件上傳到服務器,我們將使用與我們之前的文章中使用的相同的後端PHP代碼. 該腳本將上傳文件至服務器,同時顯示上傳進度,並最終返回上傳文件的鏈接地址.在某些情況下,你可能想要返回上傳文件的id或者其他的應用信息. Note: 該代碼不支持較老的ie浏覽器,通過Can I use我們只支持ie10+
Let's Code
我們將從HTML結構開始,然後是JavaScript,然後我將給您提供PHP代碼,這部分改編於之前教程 - 對PHP代碼將不會有太多的解釋。
HTML
我們只需要使用兩個輸入框,一個是文件類型file,另一個只是一個按鈕button,以便我們可以監聽到它被點擊發送文件上傳請求。 我們還將有一個div,我們改變寬度以突出顯示上傳的狀態。
如下所示:
<!doctype html> <html> <head> <meta charset="utf-8"> <title>JS File Upload with Progress</title> <style> .container { width: 500px; margin: 0 auto; } .progress_outer { border: 1px solid #000; } .progress { width: 20%; background: #DEDEDE; height: 20px; } </style> </head> <body> <div class='container'> <p> Select File: <input type='file' id='_file'> <input type='button' id='_submit' value='Upload!'> </p> <div class='progress_outer'> <div id='_progress' class='progress'></div> </div> </div> <script src='upload.js'></script> </body> </html>
你將看到我們寫了一點進度條樣式,並在底部加入腳本文件來處理文件上傳以及進度條展示.
JavaScript
首先, 我們需要拿到我們將要使用的標簽,他們已經用id標記上.
var _submit = document.getElementById('_submit'), _file = document.getElementById('_file'), _progress = document.getElementById('_progress');
下一步,給_submit添加點擊事件,用以上傳我們選擇的文件.為此,我們將使用addEventListener方法,點擊按鈕後讓其調用upload方法.
_submit.addEventListener('click', upload);
現在我們可以繼續處理上傳,有以下幾步:
檢查被選中的文件
我們的文件輸入框_file有一個查詢被選中文件隊列的參數files-如果你設置了multiple參數將可以選多個文件.我們做簡單的檢查判斷,如果該數組長度大於0,則繼續,否則直接返回.
if(_file.files.length === 0){ return; }
現在,我們能確保已選擇一個文件,我們將假定有一個文件,請記著數組的索引以0開頭.
動態創建要發送的文件數據
為此,我們需要使用FormData,並將數據加入其中.下一步,我們可以在第3步生成的request中發送我們的FormData.我們使用的append方法,第一個參數與輸入框的name屬性相似,第二個參數是值value. 這裡,我們將value設為我們選擇的第一個文件.
var data = new FormData(); data.append('SelectedFile', _file.files[0]);
當稍後向服務端發送數據時,我們將使用它.
通過上傳腳本創建XMLHttpRequest
這部分是非常基礎的,我們將創建一個新的XMLHttpRequest
,並設置一些設置。首先我們將修改onreadystatechange
的值來定義請求狀態改變時的回調函數.該方法將會在狀態改變時檢查readyState,確保該值是我們想要的-在這個例子中就是4,代表請求完成.
第二步,我們將在upload屬性上添加progress事件.這樣我們能得到上傳進度用來更新進度條.
var request = new XMLHttpRequest(); request.onreadystatechange = function(){ if(request.readyState == 4){ try { var resp = JSON.parse(request.response); } catch (e){ var resp = { status: 'error', data: 'Unknown error occurred: [' + request.responseText + ']' }; } console.log(resp.status + ': ' + resp.data); } };
當請求成功後,我們用try ... catch包裹解析返回值的過程,若解析失敗,我們將創建我們自己的返回對象來使得後面的代碼能不報錯.可以自行決定如何處理返回值,這裡我們只是將其輸出至控制台.
現在我們來處理進度條:
request.upload.addEventListener('progress', function(e){ _progress.style.width = Math.ceil(e.loaded/e.total) * 100 + '%'; }, false);
這裡有一點點復雜,我們監聽一個事件,該事件對象有兩個我們比較關注的屬性,loaded和total.loaded表示已經上傳到服務器端的數值,total表示要發送的總數值,我們可以根據這兩個值計算一個百分比,來設置進度條的寬度.
Note: 這裡沒有加入任何動畫特效,但你可以根據需要自定義動畫效果.
上傳文件
現在我們可以發送請求,我們將通過POST請求到一個名為upload.php的文件,並使用send()方法,參數為data,這樣我們就可以發送數據:
request.open('POST', 'upload.php'); request.send(data);
下面給出完整的JavaScript代碼:
var _submit = document.getElementById('_submit'), _file = document.getElementById('_file'), _progress = document.getElementById('_progress'); var upload = function(){ if(_file.files.length === 0){ return; } var data = new FormData(); data.append('SelectedFile', _file.files[0]); var request = new XMLHttpRequest(); request.onreadystatechange = function(){ if(request.readyState == 4){ try { var resp = JSON.parse(request.response); } catch (e){ var resp = { status: 'error', data: 'Unknown error occurred: [' + request.responseText + ']' }; } console.log(resp.status + ': ' + resp.data); } }; request.upload.addEventListener('progress', function(e){ _progress.style.width = Math.ceil(e.loaded/e.total) * 100 + '%'; }, false); request.open('POST', 'upload.php'); request.send(data); } _submit.addEventListener('click', upload);
現在到了PHP...
PHP
這是我們使用的代碼,你將注意到一些區別,主要是我們用最上面的JSON方法來返回值都作為JSON格式輸出.這個PHP與之前文章中的代碼相同,這也就意味著該方法只適用於小於500Kb的PNG圖片.此外,成功信息將返回已上傳文件的路徑:
<?php // Output JSON function outputJSON($msg, $status = 'error'){ header('Content-Type: application/json'); die(json_encode(array( 'data' => $msg, 'status' => $status ))); } // Check for errors if($_FILES['SelectedFile']['error'] > 0){ outputJSON('An error ocurred when uploading.'); } if(!getimagesize($_FILES['SelectedFile']['tmp_name'])){ outputJSON('Please ensure you are uploading an image.'); } // Check filetype if($_FILES['SelectedFile']['type'] != 'image/png'){ outputJSON('Unsupported filetype uploaded.'); } // Check filesize if($_FILES['SelectedFile']['size'] > 500000){ outputJSON('File uploaded exceeds maximum upload size.'); } // Check if the file exists if(file_exists('upload/' . $_FILES['SelectedFile']['name'])){ outputJSON('File with that name already exists.'); } // Upload file if(!move_uploaded_file($_FILES['SelectedFile']['tmp_name'], 'upload/' . $_FILES['SelectedFile']['name'])){ outputJSON('Error uploading file - check destination is writeable.'); } // Success! outputJSON('File uploaded successfully to "' . 'upload/' . $_FILES['SelectedFile']['name'] . '".', 'success');
如果將所有內容都放在一起,您應該可以將文件上傳到您期望的位置,並在浏覽器的控制台內成功返回。
結束語
還有一些比較容易而又有效的方式來增強用戶體驗.通過將文件隊列的多個文件加入到FormData,可以實現多文件上傳. 有一點要說明,如果你是在本地做測試,你可能沒辦法看到進度條逐步變化,這取決於你本地機器的上傳速度,我建議在服務器上使用較大的png文件做測試.
以上所述是小編給大家介紹的Ajax上傳文件進度條Codular,希望對大家有所幫助,如果大家有任何疑問請給我留言,小編會及時回復大家的。在此也非常感謝大家對網站的支持!