天天看點

uploadify上傳檔案(2)--基礎文法

  隔了好久,因為最近搬家,離開從小生活的城市,來到杭州。找工作、找房子等諸多事宜耽誤了這篇文章許久。今天難得閑暇在旅館中完成uploadify上傳檔案系列的第二篇--uploadify使用的基礎文法。

下面我們看一看如何在你的項目上部署uploadify:

本文目錄:

1.使用步驟

2.屬性

3.事件

4.方法

使用步驟

1.我們假定上傳控件部署在網站根目錄下的upload.

php中,uploadify檔案夾位于網站根目錄中,上傳的檔案儲存在根目錄下的upload檔案夾中,uploadify檔案夾中包含check-exists.php、jquery.min.js 、jquery.uploadify.min.js、uploadify.css、uploadify.swf、uploadify-cancel.png。

2.引用jquery庫

<script type="text/javascript" src="/uploadify/jquery.min.js"></script>

3.引用uploadify腳本

<script type="text/javascript" src="/uploadify /jquery.uploadify.min.js"></script>

4.引用uploadify樣式表

<link rel="stylesheet" type="text/css" href="uploadify.css" />

5. 聲明一個普通的html檔案上傳控件,并指定id

<input id="file_upload" name="file_upload" type="file" multiple="true">

6. 将聲明的普通上傳控件與Uploadify插件綁定,并初始化

<script type="text/javascript">    $(function() {        $(‘#file_upload‘).uploadify({            ‘swf‘      : ‘/uploadify uploadify.swf‘,    //指定上傳控件的主體檔案            ‘uploader‘ : ‘/uploadify uploadify.php‘    //指定伺服器端上傳處理檔案            //其他配置項        });    });</script>

屬性

auto布爾型

設定auto為true,當檔案被添加至上傳隊列時,将會自動上傳。

buttonClass字元串

為上傳按鈕添加類名。

buttonCursor字元串

滑鼠經過上傳按鈕時,滑鼠的形狀。可選值為‘hand’(手形) 和 ‘arrow’(箭頭)。

buttonImage字元串

定義“浏覽”按鈕背景圖像的路徑。給按鈕設定背景圖像的代碼最好寫在CSS檔案中。

buttonText字元串

定義顯示在預設按鈕上的文本。

checkExisting字元串

定義檢查目标檔案夾中是否存在同名檔案的腳本檔案路徑。

debug布爾型

當其值為true時,開啟SWFUpload調試模式。

fileObjName字元串

定義上傳資料處理檔案中接收資料使用的檔案對象名。

fileSizeLimit整型

上傳檔案大小限制。

fileTypeDesc字元串

可選擇的檔案類型的描述。此字元串出現在浏覽檔案對話框的檔案類型下拉菜單中。

fileTypeExts字元串

定義允許上傳的檔案字尾。

formDataJSON對象

定義在檔案上傳時需要一同送出的其他資料對象。

height整型

上傳按鈕的高度(機關:像素)。

itemTemplate布爾型

itemTemplate選項允許你為每一個添加到隊列中選項設定一個不同HTML模闆。

method字元串

上傳檔案的送出方法,取值‘post‘或‘get‘。

multi布爾型

設定值為false時,一次隻能選中一個檔案。

overrideEventsJSON

該項定義了一組預設腳本中你不想執行的事件名稱。

preventCaching布爾型

如果設定為真,一個随機的值添加到SWF檔案的URL,是以它不會緩存。

progressData字元串

設定顯示在上傳進度條中的資料類型,可選項時百分比(percentage)或速度(speed)。

queueID字元串

queueID選項允許你設定一個擁有唯一ID的DOM元素來作為顯示上傳隊列的容器。

queueSizeLimit整型

上傳隊列中一次可容納的最大條數。

removeCompleted布爾型

不設定該選項或者将其設定為false,将使上傳隊列中的項目始終顯示于隊列中,直到點選了關閉按鈕或者隊列被清空。

removeTimeout整型

設定上傳完成後從上傳隊列中移除的時間(機關:秒)。

requeueErrors布爾型

設定為真時,上傳隊列重置或上傳多次重試時,傳回錯誤資訊。

successTimeout整型

表示uploadify的成功等待時間(機關:秒,預設30秒)。

swf字元串

定義uploadify.swf的路徑。

uploader字元串

定義伺服器端上傳資料處理腳本檔案uploadify.swf的路徑。

uploadLimit整型

定義允許的最大上傳數量。

width整型

定義浏覽按鈕的寬度。

事件

onCancel函數

設定onCancel選項,在檔案上傳被取消時,将允許運作一個自定義函數。

onClearQueue函數

設定onClearQueue選項,上傳隊列清空(激活ancel方法)時,将允許運作一個自定義函數。

onDestroy函數

銷毀Uploadify執行個體(調用destroy方法)時觸發該事件。

onDialogClose函數

當浏覽檔案對話框關閉時觸發該事件。如果該事件被添加到overrideEvents屬性中,在添加檔案到隊列中發生錯誤時,将不會彈出預設錯誤資訊。

onDialogOpen函數

在浏覽檔案對話框被打開前一瞬觸發該事件。

onDisable函數

調用disable方法禁用Uploadify執行個體時觸發該事件。

onEnable函數

調用disable方法啟用Uploadify執行個體時觸發該事件。

onFallback函數

浏覽器檢測不到相容版本的Flash時觸發該事件。

onInit函數

調用Uploadify初始化結束時觸發該事件。

onQueueComplete函數

隊列中的所有檔案被處理完成時觸發該事件。

onSelect函數

每添加一個檔案至上傳隊列時觸發該事件。

onSelectError函數

選擇檔案傳回錯誤時觸發該事件。每一個檔案傳回錯誤都會觸發該事件。

onSWFReady函數

當flash按鈕載入完畢時觸發該事件。

onUploadComplete函數

每一個檔案上傳完成都會觸發該事件,不管是上傳成功還是上傳失敗。

onUploadError函數

上傳失敗時觸發該事件。

onUploadProgress函數

上傳進度更新時觸發該事件。

onUploadStart函數

在開始上傳之前的瞬間會觸發該事件。

onUploadSuccess函數

每一個檔案上傳成功時觸發該事件。

方法

cancel

取消上傳對象。

destroy

銷毀Uploadify執行個體,并傳回原檔案域。

disable

控制浏覽按鈕是否可用。

settings

傳回或更新一個Uploadify執行個體的值。

stop

停止目前上傳。

upload

上傳指定檔案或隊列中的所有檔案。

本文參考自碼迷,進行了部分修改。

如果覺得不錯,可以推薦收藏一下,讓我也更有動力。