最近一個項目中需要實現多文件上傳與管理,而項目是基於bootstrap開發的,所以查了一些bootstrap文件上傳插件,最後發現還是bootstrap-fileinput最美觀,該插件可以實現多文件的上傳與管理(插件官方地址:http://plugins.krajee.com/file-input),具體的效果如下:
(bootstrap-fileinput不局限於圖片上傳,也可以實現文件上傳,但圖片的縮略圖容易辨識,這裡就以圖片上傳為例)
該插件基本的操作可以參考:JS文件上傳神器bootstrap fileinput詳解,本文主要針對多文件管理。
在講該插件如何使用前,先跟大家講一下項目中關於圖片管理的需求:
1、可以上傳多個圖片
2、只有當點擊保存按鈕時,圖片信息才保存至數據庫
3、可以加載已經保存到數據庫的圖片信息,並提供刪除功能
因此,我們可以規定幾個文件狀態:
已選擇:已經放入到插件中,但還沒有上傳到服務器。如上圖中第3個圖片,該圖片下方有上傳按鈕。
已上傳:已經上傳到服務器,但圖片信息沒有保存到數據庫。如上圖中第2個圖片,該圖片下方有100%的進度條。
已保存:圖片信息已經保存至數據庫的圖片,如上圖中第1張圖,這些圖片下方有刪除按鈕,點擊刪除時會將圖片信息從數據庫中刪除。
一、引入必要文件
<link href="<%=path%>/static/css/bootstrap-3.3.5/bootstrap.min.css" rel="stylesheet"> <link href="<%=path%>/static/css/bootstrap-3.3.5/fileinput.css" rel="stylesheet"> <script src="<%=path%>/static/js/jquery-1.11.3.js"></script> <script src="<%=path%>/static/js/angularjs-1.3.9/angular.min.js"></script> <script src="<%=path%>/static/js/bootstrap-3.3.5/bootstrap.min.js"></script> <script src="<%=path%>/static/js/bootstrap-3.3.5/fileinput.js"></script> <script src="<%=path%>/static/js/bootstrap-3.3.5/fileinput_locale_zh.js"></script>
其中fileinput.js和fileinput_locale_zh.js都在插件待官方包中,angular.min.js和bootstrap.min.js就不多介紹了
二、多文件上傳
首先在頁面中定義file控件:
<input id="input-images" type="file" multiple class="file-loading" accept="image/*">
然後對該控件進行初始化,就可以實現該組件的多文件上傳了:
$("#input-images").fileinput({ uploadUrl: "<%=path%>" + "/album/pictureFileUpload", allowedFileExtensions: ["jpg", "png", "gif"], resizePreference: 'height', maxFileCount: 10, language: 'zh', overwriteInitial: false, resizeImage: true, });
當然,初始化時的屬性有很多,這裡不一一介紹了,後台代碼(使用JFinal)如下:
public void pictureFileUpload() { UploadFile uploadFile = getFile(); renderJson("{\"link\":" + "\"/fileinput/upload/" + uploadFile.getFileName() + "\"" + ",\"fileName\":\"" + uploadFile.getOriginalFileName() + "\"}"); }
注意最後一定要返回Json,哪怕返回一個空json串(“{}”),返回的值保存在前台的data.response中。
三、已有文件的加載與刪除
已有文件的加載是指將服務器上已經存在的文件展示在該控件中,以實現文件管理,提供刪除功能,這主要依賴於initialPreview實現的。
將服務器上的文件名稱和文件地址獲取之後,使用initialPreview和initialPreviewConfig完成加載和定義刪除操作:
var initPreview = new Array();//展示元素 var initPreviewConfig = new Array();//展示設置 $.post( "<%=path%>" + "/album/getPicsByAlbum", {albumId : albumId}, function(result) { for(var i=0;i<result.length;i++){ var pictureFile = result[i]; //用於展示已經上傳的圖片 initPreview.push("<img src='" + pictureFile.PICADDRESS + "' class='file-preview-image' alt='"+pictureFile.PICNAME+"' title='"+pictureFile.PICNAME+"'>"); var config = new Object(); config.caption = pictureFile.PICNAME; config.url="<%=path%>" + "/album/deletePicById"; config.key=pictureFile.ID; initPreviewConfig.push(config); } initFileInput($scope); $("#input-images").fileinput('refresh', { initialPreview: initPreview, initialPreviewConfig: initPreviewConfig }); } );
點擊刪除圖標,會默認把config中待key值傳至後台,後台中定義deletePicById方法即可:
public void deletePicById() { String picId = getPara("key"); service.deletePicById(Integer.valueOf(picId)); renderJson("{}"); }
四、幾點疑問的解答
1、為什麼model裡沒有屬性,卻可以在前端展示相關屬性?
這裡主要使用了JFinal的ActiveRecord功能,無需定義屬性和setter,getter方法,屬性值被映射在model裡的attrs裡,這個屬性是<key, value>的鍵值對,而key值就是數據庫的字段名。 特別提醒:雖然SQL語句不分區大小寫,但字段名還是存在大小寫的,如果字段名是大寫的,那麼映射到model裡的key就是大寫的,同時JFinal的默認id為主鍵的策略也不能生效,需要在 configPlugin中設置,如下:arp.addMapping("pictures", "ID", Picture.class),建議大家按照Java命名規范命名數據庫字段。
2、(參考代碼)中初始化FileInput為什麼要執行clear,destory操作?
因為FileInput插件在選擇文件後,不管有沒有上傳,都會保留文件在file域中,因此再點擊時會顯示上一次選擇的文件,不符合多相冊管理的需求,原本以為clear操作就可以清空file域(官方文檔這麼說的),但實際操作發現並沒有清空,因此才調用clear,destory後再重新初始化文件上傳控件。(這一點不太確定,希望有大神可以指點)
3、保存時怎麼知道那些圖片需要存數據庫,這是基於什麼實現的?
$scope上有個selectedPics數組,該屬性負責保存最終那些文件會保存到數據庫。在文件選擇後會將選擇待文件信息保存到這個數組中,但hasUpload屬性為false;在文件上傳後,會修改對應的hasUpload為true;在上傳成功後執行刪除(還沒有保存到數據庫)會從數組中移除對應的元素。有人會問,那選擇文件後不上傳直接刪除,那文件信息豈不是會占用數據位置從而導致元素錯亂嗎?其實並不會,在fileuploaded事件中,哪些圖片已經hasUpload,是直接改數組對應位置元素的值的,而數組坐標是通過圖片所在DIV的data-fileindex屬性值獲得的, 該值會一直增加,不會替補空缺值,不會因為刪除圖片而變動,正好與selectedPics數組相對應。
var idx = $("#"+previewId).attr("data-fileindex");
例如我選擇了3張圖片,此時沒有上傳,他們依次的data-fileindex為0,1,2,當我刪除中間那個圖片並重新選擇新圖片時,那麼他們的data-fileindex就會變為0,2,3。
五、代碼參考
最後本人才學AngularJS,代碼寫的不夠純熟,如有不妥之處,歡迎大家留言,示例代碼在文章末尾,數據庫腳本為files.sql(MySQL),大家多看看代碼吧。
源碼下載:http://xiazai.jb51.net/201611/yuanma/BSfileinput(jb51.net).rar
如果大家還想深入學習,可以點擊這裡進行學習,再為大家附兩個精彩的專題:Bootstrap學習教程 Bootstrap實戰教程
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持。