# 單文件上傳 1\.您需要使用requireJs模塊化加載Form,Upload,Fast模塊，語法如下： ``` define(['jquery', 'bootstrap', 'backend', 'table', 'fast','form','upload'], function ($, undefined, Backend, Table, Fast,Form,Upload) {}); ``` 單文件上傳的接口格式如下： ``` Fast.api.uploadFileBox(Function callback,Object options); ``` callback:必須，文件上傳完成后的回調函數，接受1個參數，為返回的文件信息對象 options：可選，為傳遞給接口的配置選項。 2\.在需要調用的頁面的DOM對象的click事件調用文件上傳彈窗插件 HTML部分代碼如下： ``` <a href="javascript:void()" id="btnUploader" data-filetype="file" class="btn btn-info"><i class="fa fa-upload"></i> 上傳</a> ``` 如上，在觸發上傳的代碼塊中增加綁定了data數據`data-filetype="file"`，data-filetype的值可以是``和`file`分別用于指定上傳圖像或文件。 3\.接下來在按鈕的點擊事件中將綁定的數據data-filetype的值構造成JSON對象傳遞給接口 ``` $('#btnUploader').on('click',function(){ var options={}; var button =$(this); if(button.data('filetype'))options.fileType =button.data('filetype'); Fast.api.uploadFileBox(function(data){ console.log(data); },options); }); ``` 單文件上傳返回的文件信息對象結構為： ``` { fileId :10000, //文件上傳后再系統表中的編號 title :'關于生物園區改造資金撥付申請的請示', //文件描述,默認為文件上傳前的名名稱 url :'文件上傳后與站點根的相對路徑', //相對路徑 path :'文件上傳后與站點根的相對路徑', //同URL，為了兼容老接口 userId :1 //上傳此文件的用戶編號 } ``` 圖像格式支持的MIME類型如下： ``` 'image/gif','image/jpeg','image/png','image/bmp' ``` 文件類型支持上傳的擴展名如下： ``` 'zip','rar','tar.gz','doc','docx','xls','xlsx','ppt','pptx','pdf', 'mp3','mp4','flv','avi','mid','wav','gif','jpg','jpeg','png','bmp' ``` 文件上傳后本地的處理： - - - - - - 建議您在存儲文件時將獲取到的文件信息構造成如下標準的JSON結構，并作為字符串存儲到數據庫中，方便后期進行擴展升級 ``` [ {"fileId":10000,"title":"文件描述","url":"文件路徑"}, {"fileId":10000,"title":"文件描述","url":"文件路徑"} ] ```