最近看了一些jQuery即時上傳的插件,總算看懂了些門路。現將其最為核心的一部分抽取出來,以期用最簡單的例子來說明jQuery圖片即時上傳的原理。
首先本用例一共包含3個文件:
1、上傳面板HTML文件。
2、上傳處理PHP文件。
3、jQuery庫。
第一、上傳面板HTML文件(index.html)。
其主要包含了jQuery庫、即時上傳所需js、表單和iframe框架。下面是其源碼,其中已附詳細注釋。
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 2 <html xmlns="http://www.w3.org/1999/xhtml"> 3 <head> 4 <title>jQuery Upload Image</title> 5 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 6 <meta http-equiv="Content-Language" content="zh-CN" /> 7 <!--<script type="text/javascript" src="jquery-1.6.2.min.js"></script>--> <!-- 本地jquery庫--> 8 <script type="text/javascript" src="http://files.cnblogs.com/Zjmainstay/jquery-1.6.2.min.js"></script> 9 </head> 10 <body> 11 <style> 12 #exec_target{display:none;width:0;height:0;} 13 #feedback{width:1200px;margin:0 auto;} 14 #feedback img{float:left;width:300px;height:300px;} 15 </style> 16 <script type="text/javascript"> 17 $(document).ready(function(){ 18 //選擇文件成功則提交表單 19 $("#upload_file").change(function(){ 20 if($("#upload_file").val() != '') $("#submit_form").submit(); 21 }); 22 //iframe加載響應,初始頁面時也有一次,此時data為null。 23 $("#exec_target").load(function(){ 24 var data = $(window.frames['exec_target'].document.body).find("textarea").html(); 25 //若iframe攜帶返回數據,則顯示在feedback中 26 if(data != null){ 27 $("#feedback").append(data.replace(/</g,'<').replace(/>/g,'>')); 28 $("#upload_file").val(''); 29 } 30 }); 31 }); 32 </script> 33 <form id="submit_form" method="post" action="submit_form_process.php" target="exec_target" enctype="multipart/form-data"> 34 <input type="file" name="upload_file" id="upload_file"> <!-- 添加上傳文件 --> 35 </form> 36 <iframe id="exec_target" name="exec_target"></iframe> <!-- 提交表單處理iframe框架 --> 37 <div id="feedback"></div> <!-- 響應返回數據容器 --> 38 </body> 39 </html>
第二、上傳處理PHP文件(submit_form_process.php)。
其主要包含了圖片文件的簡單上傳,及返回圖片標簽<img>,其中存儲剛上傳的圖片。下面是其源碼。
1 <?php 2 //header('content-type:text/html charset:utf-8'); /* 這句要刪除,否則可能會導致IE下回傳HTML變成下載 */ 3 //不存在當前上傳文件則上傳 4 if(!file_exists($_FILES['upload_file']['name'])) move_uploaded_file($_FILES['upload_file']['tmp_name'],iconv('utf-8','gb2312',$_FILES['upload_file']['name'])); 5 //輸出圖片文件<img>標簽 6 echo "<textarea><img src='{$_FILES['upload_file']['name']}'/></textarea>"; 7 //End_php
總結之原理透析:
講到jQuery即時上傳,不知道其原理的人第一想法一般都是使用AJAX(補注:當時不知道有FormData對象),我也嘗試過。但是,由於上傳文件不同於一般數據的POST,它需要表單form的提交來完成。因此,jQuery上傳插件也是將<input type="file">的數據轉至一個新生的form當中將其提交,而表單的target指向新生的iframe,在iframe中做表單提交后的處理,完成后iframe會重新加載並包含處理結果,通過iframe的load事件便可捕捉並獲取處理結果,回傳至原表單所在的頁面(feedback)中,實現jQuery即時上傳的效果。而在表單提交的時候,為了實現選擇文件后即時提交表單,則使用了input標簽的change事件(index.html L19-21),只要選擇了文件,input的值就會發生變化,此時就可以提交表單進行處理了。
軟件包下載:最簡單的jQuery即時上傳示例
/*************************************** 追加 ***************************************/
受@東方翔 評論提示,測試了一下$.ajax 的FormData對象,然后發現成功了(FF、Chrome測試成功),嘿嘿~下面是源碼,控制文件為submit_form_process.php不變。
特別的:contentType: false,
processData: false,
這兩個參數是必須的。
缺少contentType: false,$_FILES值為空。
缺少processData: false,FF控制台報錯:“NS_ERROR_XPC_BAD_OP_ON_WN_PROTO: Illegal operation on WrappedNative prototype object”,直接不能運行。
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 2 <html xmlns="http://www.w3.org/1999/xhtml"> 3 <head> 4 <title>FormData</title> 5 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 6 <meta http-equiv="Content-Language" content="zh-CN" /> 7 <script type="text/javascript" src="http://files.cnblogs.com/Zjmainstay/jquery-1.6.2.min.js"></script> 8 </head> 9 <body> 10 <style> 11 #feedback{width:1200px;margin:0 auto;} 12 #feedback img{float:left;width:300px;height:300px;} 13 </style> 14 <div> 15 <!-- 點擊圖片添加文件方式 --> 16 <img src="http://f7-preview.awardspace.com/zjmainstay.co.cc/jQueryExample/jquery_upload_image/files/addfile.jpg" onclick="getElementById('inputfile').click()" title="點擊添加圖片" alt="點擊添加圖片"> 17 <input type="file" name="image" style="opacity:0;filter:alpha(opacity=0);" id="inputfile"/> 18 </div> 19 <div id="feedback"></div> <!-- 響應返回數據容器 --> 20 <script type="text/javascript"> 21 $(document).ready(function(){ 22 $("#inputfile").change(function(){ 23 //創建FormData對象 24 var data = new FormData(); 25 //為FormData對象添加數據 26 // 27 $.each($('#inputfile')[0].files, function(i, file) { 28 data.append('upload_file', file); 29 }); 30 $.ajax({ 31 url:'submit_form_process.php', 32 type:'POST', 33 data:data, 34 cache: false, 35 contentType: false, //不可缺 36 processData: false, //不可缺 37 success:function(data){ 38 data = $(data).html(); 39 if($("#feedback").children('img').length == 0) $("#feedback").append(data.replace(/</g,'<').replace(/>/g,'>')); 40 else $("#feedback").children('img').eq(0).before(data.replace(/</g,'<').replace(/>/g,'>')); 41 } 42 }); 43 }); 44 }); 45 </script> 46 </body> 47 </html>
/*************************************** 追加2 ***************************************/
多圖上傳實現(獨立於上面兩個版本的文件):
1、index.html文件
功能:點擊圖片添加文件、添加多個文件、即時上傳文件、顯示上傳文件反饋信息。
包含技術:
1)$.ajax
2)$.ajax 發送FormData對象
3)input multiple="multiple"上傳多個文件
4)img onclick="getElementById('inputfile').click()" 點擊圖片實現添加文件操作
5)input type="file" 樣式:height:0;width:0;z-index: -1;隱藏添加文件按鈕(Chrome下使用display:none會導致點擊失效)
源碼:
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 2 <html xmlns="http://www.w3.org/1999/xhtml"> 3 <head> 4 <title>Easy Ajax FormData Upload Multiple Images</title> 5 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 6 <meta http-equiv="Content-Language" content="zh-CN" /> 7 <script type="text/javascript" src="http://files.cnblogs.com/Zjmainstay/jquery-1.6.2.min.js"></script> 8 </head> 9 <body> 10 <style> 11 #feedback{width:1200px;margin:0 auto;} 12 #feedback img{float:left;width:300px;height:300px;} 13 #ZjmainstaySignaturePicture,#addpicContainer{float:left;width: 100%;} 14 #addpicContainer{margin-left:5px;} 15 #ZjmainstaySignaturePicture img{width: 535px;} 16 #addpicContainer img{float: left;} 17 .loading{display:none;background:url("http://f7-preview.awardspace.com/zjmainstay.co.cc/jQueryExample/jquery_upload_image/files/ui-anim_basic_16x16.gif") no-repeat scroll 0 0 transparent;float: left;padding:8px;margin:18px 0 0 18px;} 18 </style> 19 <div id="ZjmainstaySignaturePicture"><a href="http://www.cnblogs.com/Zjmainstay"><img src="http://pic002.cnblogs.com/images/2012/383557/2012071311244097.jpg"/></a></div> 20 <div id="addpicContainer"> 21 <!-- 利用multiple="multiple"屬性實現添加多圖功能 --> 22 <!-- position: absolute;left: 10px;top: 5px;只針對本用例將input隱至圖片底下。--> 23 <!-- height:0;width:0;z-index: -1;是為了隱藏input,因為Chrome下不能使用display:none,否則無法添加文件 --> 24 <!-- onclick="getElementById('inputfile').click()" 點擊圖片時則點擊添加文件按鈕 --> 25 <img onclick="getElementById('inputfile').click()" style="cursor:pointer;border: 1px solid #AABBCC;" title="點擊添加圖片" alt="點擊添加圖片" src="http://f7-preview.awardspace.com/zjmainstay.co.cc/jQueryExample/jquery_upload_image/files/addfile.jpg"> 26 <input type="file" multiple="multiple" id="inputfile" style="height:0;width:0;z-index: -1; position: absolute;left: 10px;top: 5px;"/> 27 <span class="loading"></span> 28 </div> 29 <div id="feedback"></div> <!-- 響應返回數據容器 --> 30 <script type="text/javascript"> 31 $(document).ready(function(){ 32 //響應文件添加成功事件 33 $("#inputfile").change(function(){ 34 //創建FormData對象 35 var data = new FormData(); 36 //為FormData對象添加數據 37 $.each($('#inputfile')[0].files, function(i, file) { 38 data.append('upload_file'+i, file); 39 }); 40 $(".loading").show(); //顯示加載圖片 41 //發送數據 42 $.ajax({ 43 url:'submit_form_process.php', 44 type:'POST', 45 data:data, 46 cache: false, 47 contentType: false, //不可缺參數 48 processData: false, //不可缺參數 49 success:function(data){ 50 data = $(data).html(); 51 //第一個feedback數據直接append,其他的用before第1個( .eq(0).before() )放至最前面。 52 //data.replace(/</g,'<').replace(/>/g,'>') 轉換html標簽,否則圖片無法顯示。 53 if($("#feedback").children('img').length == 0) $("#feedback").append(data.replace(/</g,'<').replace(/>/g,'>')); 54 else $("#feedback").children('img').eq(0).before(data.replace(/</g,'<').replace(/>/g,'>')); 55 $(".loading").hide(); //加載成功移除加載圖片 56 }, 57 error:function(){ 58 alert('上傳出錯'); 59 $(".loading").hide(); //加載失敗移除加載圖片 60 } 61 }); 62 }); 63 }); 64 </script> 65 </body> 66 </html>
2、submit_form_process.php后台處理文件
功能:對FormData中包含的$_FILES數組做處理並上傳圖片文件,回傳反饋信息。
包含技術:
1)FormData提交至$_FILES后的結構形式
2)iconv('utf-8','gb2312',$filename) 對文件名進行轉碼處理
3)preg_match("/^\.(jpg|jpeg|gif|png){1}$/i", strrchr($gb_filename, '.')) 文件類型過濾
4)move_uploaded_file()上傳文件
5)echo '<textarea><img....<img....</textarea>';回傳反饋信息。
源碼:
1 <?php 2 header('content-type:text/html charset:utf-8'); 3 $dir_base = "./files/"; //文件上傳根目錄 4 //沒有成功上傳文件,報錯並退出。 5 if(empty($_FILES)) { 6 echo "<textarea><img src='{$dir_base}error.jpg'/></textarea>"; 7 exit(0); 8 } 9 10 $output = "<textarea>"; 11 $index = 0; //$_FILES 以文件name為數組下標,不適用foreach($_FILES as $index=>$file) 12 foreach($_FILES as $file){ 13 $upload_file_name = 'upload_file' . $index; //對應index.html FomData中的文件命名 14 $filename = $_FILES[$upload_file_name]['name']; 15 $gb_filename = iconv('utf-8','gb2312',$filename); //名字轉換成gb2312處理 16 //文件不存在才上傳 17 if(!file_exists($dir_base.$gb_filename)) { 18 $isMoved = false; //默認上傳失敗 19 $MAXIMUM_FILESIZE = 1 * 1024 * 1024; //文件大小限制 1M = 1 * 1024 * 1024 B; 20 $rEFileTypes = "/^\.(jpg|jpeg|gif|png){1}$/i"; 21 if ($_FILES[$upload_file_name]['size'] <= $MAXIMUM_FILESIZE && 22 preg_match($rEFileTypes, strrchr($gb_filename, '.'))) { 23 $isMoved = @move_uploaded_file ( $_FILES[$upload_file_name]['tmp_name'], $dir_base.$gb_filename); //上傳文件 24 } 25 }else{ 26 $isMoved = true; //已存在文件設置為上傳成功 27 } 28 if($isMoved){ 29 //輸出圖片文件<img>標簽 30 //注:在一些系統src可能需要urlencode處理,發現圖片無法顯示, 31 // 請嘗試 urlencode($gb_filename) 或 urlencode($filename),不行請查看HTML中顯示的src並酌情解決。 32 $output .= "<img src='{$dir_base}{$filename}' title='{$filename}' alt='{$filename}'/>"; 33 }else { 34 $output .= "<img src='{$dir_base}error.jpg' title='{$filename}' alt='{$filename}'/>"; 35 } 36 37 $index++; 38 } 39 40 echo $output."</textarea>"; 41 42 //End_php
軟件包下載:PHP jQuery多圖上傳實現源文件
附:多圖上傳版加強,請參考《續《用最簡單的例子實現jQuery圖片即時上傳》之多圖上傳實現》
