jQuery文件上傳插件Uploadify使用指南
對(duì)于HTML5版本會(huì)比較好的支持手機(jī)瀏覽器,避免蘋果手機(jī)Safari瀏覽器不支持
Flash,主要特性:支持多文件上傳、HTML5版本可拖拽上傳、實(shí)時(shí)上傳進(jìn)度條顯示、強(qiáng)大的參數(shù)
定制功能,如文件大小、文件類型、按鈕圖片定義、上傳文件腳本等。
Flash版本使用方法:
1.加載JS和CSS
<script src="jquery/1.7.1/jquery.min.js" type="text/javascript"></script>
<script src="jquery.uploadify.min.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="uploadify.css">
2.編寫HTML內(nèi)容
<form>
<div id="queue"></div>
<input id="file_upload" name="file_upload" type="file" multiple="true">
</form>
3.函數(shù)調(diào)用
<script type="text/javascript">
$(document).ready(function()
{
$("#file_upload").uploadify({
'uploader': 'uploadify.swf',
'script': 'UploadHandler.php',
'folder': 'UploadFile',
'queueID': 'fileQueue',
'auto': true,
'multi': true
});
});
</script>
4.更多參數(shù)配置詳解
uploader : uploadify.swf 文件的相對(duì)路徑,該swf文件是一個(gè)帶有文字BROWSE的按鈕,點(diǎn)擊后淡出
打開文件對(duì)話框,默認(rèn)值:uploadify.swf。
script : 后臺(tái)處理程序的相對(duì)路徑 。默認(rèn)值:uploadify.php
checkScript :用來(lái)判斷上傳選擇的文件在服務(wù)器是否存在的后臺(tái)處理程序的相對(duì)路徑
fileDataName :設(shè)置一個(gè)名字,在服務(wù)器處理程序中根據(jù)該名字來(lái)取上傳文件的數(shù)據(jù)。默認(rèn)為Filedata
method : 提交方式Post 或Get 默認(rèn)為Post
scriptAccess :flash腳本文件的訪問模式,如果在本地測(cè)試設(shè)置為always,默認(rèn)值:sameDomain
folder : 上傳文件存放的目錄 。
queueID : 文件隊(duì)列的ID,該ID與存放文件隊(duì)列的div的ID一致。
queueSizeLimit : 當(dāng)允許多文件生成時(shí),設(shè)置選擇文件的個(gè)數(shù),默認(rèn)值:999 。
multi : 設(shè)置為true時(shí)可以上傳多個(gè)文件。
auto : 設(shè)置為true當(dāng)選擇文件后就直接上傳了,為false需要點(diǎn)擊上傳按鈕才上傳 。
fileDesc : 這個(gè)屬性值必須設(shè)置fileExt屬性后才有效,用來(lái)設(shè)置選擇文件對(duì)話框中的提示文本,如設(shè)
置fileDesc為“請(qǐng)選擇rar doc pdf文件”
fileExt : 設(shè)置可以選擇的文件的類型,格式如:'*.doc;*.pdf;*.rar' 。
sizeLimit : 上傳文件的大小限制 。
simUploadLimit : 允許同時(shí)上傳的個(gè)數(shù) 默認(rèn)值:1 。
buttonText : 瀏覽按鈕的文本,默認(rèn)值:BROWSE 。
buttonImg : 瀏覽按鈕的圖片的路徑 。
hideButton : 設(shè)置為true則隱藏瀏覽按鈕的圖片 。
rollover : 值為true和false,設(shè)置為true時(shí)當(dāng)鼠標(biāo)移到瀏覽按鈕上時(shí)有反轉(zhuǎn)效果。
width : 設(shè)置瀏覽按鈕的寬度 ,默認(rèn)值:110。
height : 設(shè)置瀏覽按鈕的高度 ,默認(rèn)值:30。
wmode : 設(shè)置該項(xiàng)為transparent 可以使瀏覽按鈕的flash背景文件透明,并且flash文件會(huì)被置為頁(yè)
面的最高層。 默認(rèn)值:opaque 。
cancelImg :選擇文件到文件隊(duì)列中后的每一個(gè)文件上的關(guān)閉按鈕圖標(biāo)
上面介紹的key值的value都為字符串或是布爾類型,比較簡(jiǎn)單,接下來(lái)要介紹的key值的value為一個(gè)函數(shù),可以在選擇文件、出錯(cuò)或其他一些操作的時(shí)候返回一些信息給用戶。
onInit : 做一些初始化的工作
onSelect :選擇文件時(shí)觸發(fā),該函數(shù)有三個(gè)參數(shù)
event:事件對(duì)象。
queueID:文件的唯一標(biāo)識(shí),由6為隨機(jī)字符組成。
fileObj:選擇的文件對(duì)象,有name、size、creationDate、modificationDate、type 5個(gè)屬性。
代碼如下:
<script type="text/javascript">
$(document).ready(function()
{
$("#uploadify").uploadify({
'uploader': 'JS/jquery.uploadify-v2.1.0/uploadify.swf',
'script': 'UploadHandler.ashx',
'cancelImg': 'JS/jquery.uploadify-v2.1.0/cancel.png',
'folder': 'UploadFile',
'queueID': 'fileQueue',
'auto': false,
'multi': true,
'onInit':function(){alert("1");},
'onSelect': function(e, queueId, fileObj)
{
alert("唯一標(biāo)識(shí):" + queueId + "\r\n" +
"文件名:" + fileObj.name + "\r\n" +
"文件大小:" + fileObj.size + "\r\n" +
"創(chuàng)建時(shí)間:" + fileObj.creationDate + "\r\n" +
"最后修改時(shí)間:" + fileObj.modificationDate + "\r\n" +
"文件類型:" + fileObj.type
);
}
});
});
</script>
onSelectOnce :在單文件或多文件上傳時(shí),選擇文件時(shí)觸發(fā)。該函數(shù)有兩個(gè)參數(shù)event,data,data對(duì)象
有以下幾個(gè)屬性:
fileCount:選擇文件的總數(shù)。
filesSelected:同時(shí)選擇文件的個(gè)數(shù),如果一次選擇了3個(gè)文件該屬性值為3。
filesReplaced:如果文件隊(duì)列中已經(jīng)存在A和B兩個(gè)文件,再次選擇文件時(shí)又選擇了A和B,該屬性值為2。
allBytesTotal:所有選擇的文件的總大小。
onCancel: 當(dāng)點(diǎn)擊文件隊(duì)列中文件的關(guān)閉按鈕或點(diǎn)擊取消上傳時(shí)觸發(fā)。該函數(shù)有event、queueId、fileObj、
data四個(gè)參數(shù),前三個(gè)參數(shù)同onSelect 中的三個(gè)參數(shù),data對(duì)象有兩個(gè)屬性fileCount和allBytesTotal。
fileCount:取消一個(gè)文件后,文件隊(duì)列中剩余文件的個(gè)數(shù)。
allBytesTotal:取消一個(gè)文件后,文件隊(duì)列中剩余文件的大小。
onClearQueue :當(dāng)調(diào)用函數(shù)fileUploadClearQueue時(shí)觸發(fā)。有event和data兩個(gè)參數(shù),同onCancel 中的兩個(gè)對(duì)應(yīng)參數(shù)。
onQueueFull :當(dāng)設(shè)置了queueSizeLimit并且選擇的文件個(gè)數(shù)超出了queueSizeLimit的值時(shí)觸發(fā)。該函數(shù)有兩個(gè)
參數(shù)event和queueSizeLimit。
onError :當(dāng)上傳過程中發(fā)生錯(cuò)誤時(shí)觸發(fā)。該函數(shù)有event、queueId、fileObj、errorObj四個(gè)參數(shù),其中前三個(gè)參
數(shù)同上,errorObj對(duì)象有type和info兩個(gè)屬性。
type:錯(cuò)誤的類型,有三種‘HTTP', ‘IO', or ‘Security'
info:錯(cuò)誤的描述
onOpen :點(diǎn)擊上傳時(shí)觸發(fā),如果auto設(shè)置為true則是選擇文件時(shí)觸發(fā),如果有多個(gè)文件上傳則遍歷整個(gè)文件隊(duì)列。
該函數(shù)有event、queueId、fileObj三個(gè)參數(shù),參數(shù)的解釋同上。
onProgress :點(diǎn)擊上傳時(shí)觸發(fā),如果auto設(shè)置為true則是選擇文件時(shí)觸發(fā),如果有多個(gè)文件上傳則遍歷整個(gè)文件隊(duì)
列,在onOpen之后觸發(fā)。該函數(shù)有event、queueId、fileObj、data四個(gè)參數(shù),前三個(gè)參數(shù)的解釋同上。
data對(duì)象有四個(gè)屬性percentage、bytesLoaded、allBytesLoaded、speed:
percentage:當(dāng)前完成的百分比
bytesLoaded:當(dāng)前上傳的大小
allBytesLoaded:文件隊(duì)列中已經(jīng)上傳完的大小
speed:上傳速率 kb/s
onComplete:文件上傳完成后觸發(fā)。該函數(shù)有四個(gè)參數(shù)event、queueId、fileObj、response、data五個(gè)參數(shù),前三個(gè)參數(shù)
同上。response為后臺(tái)處理程序返回的值,在上面的例子中為1或0,data有兩個(gè)屬性fileCount和speed
fileCount:剩余沒有上傳完成的文件的個(gè)數(shù)。
speed:文件上傳的平均速率 kb/s
注:fileObj對(duì)象和上面講到的有些不太一樣,onComplete 的fileObj對(duì)象有個(gè)filePath屬性可以取出上傳文件的路徑。
onAllComplete:文件隊(duì)列中所有的文件上傳完成后觸發(fā)。該函數(shù)有event和data兩個(gè)參數(shù),data有四個(gè)屬性,
分別為:
filesUploaded :上傳的所有文件個(gè)數(shù)。
errors :出現(xiàn)錯(cuò)誤的個(gè)數(shù)。
allBytesLoaded :所有上傳文件的總大小。
speed :平均上傳速率 kb/s
相關(guān)文章
jquery自定義類似$.ajax()的方法實(shí)現(xiàn)代碼
$.ajax()的方法想必大家都不會(huì)陌生,下面為大家介紹下使用jquery自定義類實(shí)現(xiàn)類似$.ajax()的方法,感興趣的朋友可以參考下2013-08-08jQuery 位置函數(shù)offset,innerWidth,innerHeight,outerWidth,outerHei
jQuery的位置函數(shù)(offset(),innerWidth(),innerHeight(),outerWidth(),outerHeight(),scrollTop(),scrollLeft())小應(yīng)用2010-03-03jQuery焦點(diǎn)圖切換特效插件封裝實(shí)例
這篇文章介紹了jQuery焦點(diǎn)圖切換特效插件封裝實(shí)例,有需要的朋友可以參考一下2013-08-08jQuery 操作option的實(shí)現(xiàn)代碼
js清空option之前清空option ,我的做法是遍歷現(xiàn)有option,將其每個(gè)子元素都置空即可。2011-03-03div拖拽插件——JQ.MoveBox.js(自制JQ插件)
以前用原生的JS做過類似拖拽div的效果,現(xiàn)在按原思路改做成一個(gè)JQ的小插件,當(dāng)作制作JQ插件的一個(gè)小練習(xí),感興趣的朋友可以了解下哈2013-05-05使用異步controller與jQuery實(shí)現(xiàn)卷簾式分頁(yè)
這篇文章主要介紹了使用異步controller與jQuery實(shí)現(xiàn)卷簾式分頁(yè),使用異步controller與jQuery按需加載內(nèi)容,當(dāng)用戶開始通過網(wǎng)站的內(nèi)容滾動(dòng)時(shí)進(jìn)一步加載內(nèi)容。,需要的朋友可以參考下2019-06-06輕松掌握jQuery中wrap()與unwrap()函數(shù)的用法
wrap()能夠?qū)⒅付℉TML元素包裹DOM結(jié)構(gòu),與之相反unwrap()函數(shù)則是將DOM去掉^^下面讓我們來(lái)以兩個(gè)小例子輕松掌握jQuery中wrap()與unwrap()函數(shù)的用法:)2016-05-05jquery中ajax函數(shù)執(zhí)行順序問題之如何設(shè)置同步
這篇文章主要介紹了jquery中ajax函數(shù)執(zhí)行順序問題之如何設(shè)置同步,需要的朋友可以參考下2014-02-02