基于jquery的文件上傳控件,支持ajax無刷新上傳,多個文件同時上傳,上傳進行進度顯示,刪除已上傳文件。
要求使用jquery1.4或以上版本,flash player 9.0.24以上。
有兩個版本,一個用flash,一個是html5。html5的需要付費~所以這里只說flash版本的用法。
官網(wǎng):http://www.uploadify.com/
控件截圖:
用法:
首先引用下面的文件
<link rel="stylesheet" type="text/css" href="uploadify.css"><script type="text/javascript" src="http://code.jquery.com/jquery-1.7.2.min.js"></script><script type="text/javascript" src="jquery.uploadify-3.1.min.js"></script>
創(chuàng)建一個file input,或者其它任何帶ID的元素,并對其初始化Uploadify(注意目錄下要有uploadify.swf這個文件,和uploadify.php后臺文件,路徑按項目中的目錄結(jié)構(gòu))
<input type="file" name="file_upload" id="file_upload" /><script> $(function(){ $('#file_upload').uploadify({ 'swf' :'uploadify.swf', 'uploader':'uploadify.php' // Put your options here }); });</script>
這樣子就完成了一個最基礎(chǔ)的上傳組建?;驹硎歉淖兡銊?chuàng)建的file input生成一個DOM結(jié)構(gòu),創(chuàng)建一個DIV按鈕,按鈕樣式修改在uploadify.css文件中的.uploadify-button,將swf文件定位在按鈕上面,這樣當你點擊按鈕時實際上點擊的是swf
Options:
$('#file_upload').uploadify({ auto:false, //接受true or false兩個值,當為true時選擇文件后會自動上傳;為false時只會把選擇的文件增加進隊列但不會上傳,這時只能使用upload的方法觸發(fā)上傳。不設(shè)置auto時默認為true buttonClass: "some-class", //設(shè)置上傳按鈕的class buttonCursor: 'hand', //設(shè)置鼠標移到按鈕上的開狀,接受兩個值'hand'和'arrow'(手形和箭頭) buttonImage: 'img/browse-btn.png', //設(shè)置圖片按鈕的路徑(當你的按鈕是一張圖片時)。如果使用默認的樣式,你還可以創(chuàng)建一個鼠標懸停狀態(tài),但要把兩種狀態(tài)的圖片放在一起,并且默認的放上面,懸停狀態(tài)的放在下面(原文好難表達?。簓ou can create a hover state for the button by stacking the off state above the hover state in the image)。這只是一個比較便利的選項,最好的方法還是把圖片寫在CSS里面。 buttonText: '<div>選擇文件</div>', //設(shè)置按鈕文字。值會被當作html渲染,所以也可以包含html標簽 checkExisting: '/uploadify/check-exists.php', //接受一個文件路徑。此文件檢查正要上傳的文件名是否已經(jīng)存在目標目錄中。存在時返回1,不存在時返回0(應(yīng)該主要是作為后臺的判斷吧),默認為false debug: false, //開啟或關(guān)閉debug模式 fileObjName:'filedata', //設(shè)置在后臺腳本使用的文件名。舉個例子,在php中,如果這個選項設(shè)置為'the_files',你可以使用$_FILES['the_files']存取這個已經(jīng)上傳的文件。 fileSizeLimit:'100MB', //設(shè)置上傳文件的容量最大值。這個值可以是一個數(shù)字或者字符串。如果是字符串,接受一個單位(B,KB,MB,GB)。如果是數(shù)字則默認單位為KB。設(shè)置為0時表示不限制 fileTypeExts: '*.*', //設(shè)置允許上傳的文件擴展名(也就是文件類型)。但手動鍵入文件名可以繞過這種級別的安全檢查,所以你應(yīng)該始終在服務(wù)端中檢查文件類型。輸入多個擴展名時用分號隔開('*.jpg;*.png;*.gif') fileTypeDesc: 'All Files', //可選文件的描述。這個值出現(xiàn)在文件瀏覽窗口中的文件類型下拉選項中。(chrome下不支持,會顯示為'自定義文件',ie and firefox下可顯示描述) formData: { timestamp: '<?php echo $timestamp;?>', token: '<?php echo md5('unique_salt' . $timestamp);?>' }, //通過get或post上傳文件時,此對象提供額外的數(shù)據(jù)。如果想動態(tài)設(shè)置這些值,必須在onUploadStartg事件中使用settings的方法設(shè)置。在后臺腳本中使用 $_GET or $_POST arrays (PHP)存取這些值。看官網(wǎng)參考寫法:http://www.uploadify.com/documentation/uploadify/formdata/ height: 30, //設(shè)置按鈕的高度(單位px),默認為30.(不要在值里寫上單位,并且要求一個整數(shù),width也一樣) width: 120, //設(shè)置按鈕寬度(單位px),默認120 itemTemplate:false, //模板對象。給增加到上傳隊列中的每一項指定特殊的html模板。模板格式請看官網(wǎng)http://www.uploadify.com/documentation/uploadify/itemtemplate/ method:'post', //提交上傳文件的方法,接受post或get兩個值,默認為post multi: false, //設(shè)置是否允許一次選擇多個文件,true為允許,false不允許 overrideEvents: [], //重寫事件,接受事件名稱的數(shù)組作為參數(shù)。所設(shè)置的事件將可以被用戶重寫覆蓋 preventCaching:true, //是否緩存swf文件。默認為true,會給swf的url地址設(shè)置一個隨機數(shù),這樣它就不會被緩存。(有些瀏覽器緩存了swf文件就會觸發(fā)不了里面的事件--by rainweb) progressData: 'percentage', //設(shè)置文件上傳時顯示數(shù)據(jù),有‘percentage’ or ‘speed’兩個參數(shù)(百分比和速度) queueID: false, //設(shè)置上傳隊列DOM元素的ID,上傳的項目會增加進這個ID的DOM中。設(shè)置為false時則會自動生成隊列DOM和ID。默認為false queueSizeLimit: 999, //設(shè)置每一次上傳隊列中的文件數(shù)量。注意并不是限制總的上傳文件數(shù)量(那是uploadLimit).如果增加進隊列中的文件數(shù)量超出這個值,將會觸發(fā)onSelectError事件。默認值為999 removeCompleted: true, //是否移除掉隊列中已經(jīng)完成上傳的文件。false為不移除 removeTimeout: 3, //設(shè)置上傳完成后刪除掉文件的延遲時間,默認為3秒。如果removeCompleted為false的話,就沒意義了 requeueErrors: false, //設(shè)置上傳過程中因為出錯導(dǎo)致上傳失敗的文件是否重新加入隊列中上傳 successTimeout: 30, //設(shè)置文件上傳后等待服務(wù)器響應(yīng)的秒數(shù),超出這個時間,將會被認為上傳成功,默認為30秒 swf: 'uploadify.swf', //swf的相對路徑,必寫項 uploader: 'uploadify.php' //服務(wù)器端腳本文件路徑,必寫項 uploadLimit: 999 //上傳文件的數(shù)量。達到或超出這數(shù)量會觸發(fā)onUploadError方法。默認999 })
Events:
$('#file_upload').uploadify({ onCancel: function(file){ console.log('The file'+ file.name + 'was cancelled.') }, //文件被移除出隊列時觸發(fā),返回file參數(shù) onClearQueue: function(queueItemCount){ console.log(queueItemCount+'file(s) were removed frome the queue') }, //當調(diào)用cancel方法且傳入'*'這個參數(shù)的時候觸發(fā),其實就是移除掉整個隊列里的文件時觸發(fā),上面有說cancel方法帶*時取消整個上傳隊列 onDestroy: function(){ //調(diào)用destroy方法的時候觸發(fā) }, onDialogClose: function(queueData){ console.log(queueData.filesSelected+'\n'+queueData.filesQueued+'\r\n'+queueData.filesReplaced+'\r\n'+queueData.filesCancelled+'\r\n'+ queueData.filesErrored) }, //關(guān)閉掉瀏覽文件對話框時觸發(fā)。返回queueDate參數(shù),有以下屬性: /* filesSelected 瀏覽文件對話框中選取的文件數(shù)量 filesQueued 加入上傳隊列的文件數(shù) filesReplaced 被替換的文件個數(shù) filesCancelled 取消掉即將加入隊列中的文件個數(shù) filesErrored 返回錯誤的文件個數(shù) */ onDialogOpen:function(){ //打開選擇文件對話框時觸發(fā) }, onDisable:function(){ //禁用uploadify時觸發(fā)(通過disable方法) }, onEnalbe: function(){ //啟用uploadify時觸發(fā)(通過disable方法) }, onFallback:function(){ //在初始化時檢測不到瀏覽器有兼容性的flash版本時實觸發(fā) }, onInit: function(instance){ console.log('The queue ID is'+ instance.settings.queueID) }, //每次初始化一個隊列時觸發(fā),返回uploadify對象的實例 onQueueComplete:function(queueData){ console.log(queueData.uploadsSuccessful+'\n'+queueData.uploadsErrored) }, //隊列中的文件都上傳完后觸發(fā),返回queueDate參數(shù),有以下屬性: /* uploadsSuccessful 成功上傳的文件數(shù)量 uploadsErrored 出現(xiàn)錯誤的文件數(shù)量 */ onSelect: function(file){ console.log(file.name) }, //選擇每個文件增加進隊列時觸發(fā),返回file參數(shù) onSelectError: function(file,errorCode,errorMsg){ console.log(errorCode) console.log(this.queueData.errorMsg) }, //選擇文件出錯時觸發(fā),返回file,erroCode,errorMsg三個參數(shù) /* errorCode是一個包含了錯誤碼的js對象,用來查看事件中發(fā)送的錯誤碼,以確定錯誤的具體類型,可能會有以下的常量: QUEUE_LIMIT_EXCEEDED:-100 選擇的文件數(shù)量超過設(shè)定的最大值; FILE_EXCEEDS_SIZE_LIMIT:-110 文件的大小超出設(shè)定 INVALID_FILETYPE:-130 選擇的文件類型跟設(shè)置的不匹配 errorMsg 完整的錯誤信息,如果你不重寫默認的事件處理器,可以使用‘this.queueData.errorMsg’ 存取完整的錯誤信息 */ onSWFReady: function(){ //swf動畫加載完后觸發(fā),沒有參數(shù) }, onUploadComplete: function(file){ //在每一個文件上傳成功或失敗之后觸發(fā),返回上傳的文件對象或返回一個錯誤,如果你想知道上傳是否成功,最后使用onUploadSuccess或onUploadError事件 }, onUploadError: function(file,errorCode,erorMsg,errorString){ }, //一個文件完成上傳但返回錯誤時觸發(fā),有以下參數(shù) /* file 完成上傳的文件對象 errorCode 返回的錯誤代碼 erorMsg 返回的錯誤信息 errorString 包含所有錯誤細節(jié)的可讀信息 */ onUploadProgress: function(file,bytesUploaded,bytesTotal,totalBytesUploaded,totalBytesTotal){ $('#pregress').html('總共需要上傳'+bytesTotal+'字節(jié),'+'已上傳'+totalBytesTotal+'字節(jié)') }, //每更新一個文件上傳進度的時候觸發(fā),返回以下參數(shù) /* file 正上傳文件對象 bytesUploaded 文件已經(jīng)上傳的字節(jié)數(shù) bytesTotal 文件的總字節(jié)數(shù) totalBytesUploaded 在當前上傳的操作中(所有文件)已上傳的總字節(jié)數(shù) totalBytesTotal 所有文件的總上傳字節(jié)數(shù) */ onUploadStart: function(file){ console.log('start update') }, //每個文件即將上傳前觸發(fā) onUploadSuccess: function(file,data,respone){ alert( 'id: ' + file.id
+ ' - 索引: ' + file.index
+ ' - 文件名: ' + file.name
+ ' - 文件大小: ' + file.size
+ ' - 類型: ' + file.type
+ ' - 創(chuàng)建日期: ' + file.creationdate
+ ' - 修改日期: ' + file.modificationdate
+ ' - 文件狀態(tài): ' + file.filestatus
+ ' - 服務(wù)器端消息: ' + data
+ ' - 是否上傳成功: ' + response); } //每個文件上傳成功后觸發(fā) })
Methods:
Uploadify使用jquery推薦的插件模式,這意味著所有方法的調(diào)用都保持在一個命名空間里。 調(diào)用這些不同的方法,只需要把方法當成第一個參數(shù)傳進uploadify里調(diào)用就行。在這些方法后面增加參數(shù)會被傳進這個方法里(這兩句翻譯得不是很順暢,附原文: To use the different method calls, simply call Uploadify on the DOM element with the method call as the first argument.Any additional arguments added after the method name are passed to the method.)
cancel:取消第一個上傳的文件,如果后面帶參數(shù)"*"則是取消掉整個上傳隊列,如$(el).uploadify('cancel', '*')
upload:上傳第一個上傳的文件,如果后面帶參數(shù)"*"則上傳整個隊列,跟cancel一樣
destroy:移除掉上傳組建,按html默認的方法上傳
disable:有true or false 兩個參數(shù),表示是否禁止上傳按鈕,true表示禁止,false表示允許上傳
settings:返回或者更新一個實例的方法值,接受一個方法名的參數(shù)時是返回那個方法的值,當后面再跟一個參數(shù),則是更新那個方法的值。如
$(el).uploadify('settings','buttonText','BROWSE'); //設(shè)置buttonText的值為BROWSE$(el).uploadify('settings','buttonText') //返回buttonText的值
stop:停止正在上傳中的文件或隊列
翻譯到中間的時候才發(fā)原來網(wǎng)上早已有中文API跟其它的例子,這里附帶幾個,也是我參考著翻譯的資料
http://wenku.baidu.com/view/9df6ce0bde80d4d8d15a4faa.html
http://wenku.baidu.com/view/87df2673a417866fb84a8efd.html
http://www.cnblogs.com/oec2003/archive/2010/01/06/1640027.html
http://www.cnblogs.com/luohu/archive/2011/12/16/2290135.html