最近在寫自己的個人網站,前端使用 Bootstrap 框架,做到上傳圖片功能時,網上找到一個基於 Bootstrap 的圖片上傳插件 file-input。這個插件的樣式非常符合我的審美,所以簡單記錄一下它的使用方法。
首先根據自己的項目路徑引入插件的 CSS 和 JS 文件,注意 locale 語言文件要在 fileinput.min.js 之後引入:
<!-- file input --> <link href="../../css/fileinput.min.css" rel="stylesheet"> <script src="../../js/fileinput.min.js"></script> <script src="../../js/locales/zh.js" type="text/javascript"></script>
接著是 HTML 代碼,這裡把 file 輸入框放進一個模態框(Modal)中:
<!-- 模態框(Modal) --> <span style="white-space:pre"> </span><div class="modal fade" id="myModal" tabindex="-1" role="dialog" aria-labelledby="myModalLabel" aria-hidden="true"> <span style="white-space:pre"> </span><div class="modal-dialog"> <span style="white-space:pre"> </span><div class="modal-content"> <span style="white-space:pre"> </span><div class="modal-header"> <span style="white-space:pre"> </span><button type="button" class="close" data-dismiss="modal" aria-hidden="true"> <span style="white-space:pre"> </span>× <span style="white-space:pre"> </span></button> <span style="white-space:pre"> </span><h3 class="modal-title" id="myModalLabel" align="center"> <span style="white-space:pre"> </span><b>新增曲譜信息</b> <span style="white-space:pre"> </span></h3> <span style="white-space:pre"> </span></div> <span style="white-space:pre"> </span><div class="modal-body"> <span style="white-space:pre"> </span><form id="addForm" class="bs-example bs-example-form" role="form" enctype="multipart/form-data"> <span style="white-space:pre"> </span> <div class="input-group" style="width: 566px;"> <span style="white-space:pre"> </span> <span class="input-group-addon">曲譜名稱</span> <span style="white-space:pre"> </span> <input type="text" id="scoreName" name="scoreName" class="form-control" placeholder=""> <span style="white-space:pre"> </span> </div> <span style="white-space:pre"> </span> <div class="input-group col-lg-5" style="display: inline-table; margin-top: 10px;"> <span style="white-space:pre"> </span> <span class="input-group-addon">曲譜類型</span> <span style="white-space:pre"> </span> <input type="text" id="type" name="type" class="form-control"> <span style="white-space:pre"> </span> </div> <span style="white-space:pre"> </span> <div class="input-group col-lg-5" style="margin-top: 10px;margin-left: 90px;"> <span style="white-space:pre"> </span> <span class="input-group-addon">曲譜難度</span> <span style="white-space:pre"> </span> <input type="text" id="difficulty" name="difficulty" class="form-control"> <span style="white-space:pre"> </span> </div> <span style="white-space:pre"> </span> <div class="input-group col-lg-5" style="margin-top: 10px;"> <span style="white-space:pre"> </span> <span class="input-group-addon">曲調</span> <span style="white-space:pre"> </span> <input type="text" id="tune" name="tune" class="form-control"> <span style="white-space:pre"> </span> </div> <span style="white-space:pre"> </span> <div class="input-group" style="width: 566px; margin-top: 10px;"> <span style="white-space:pre"> </span><input id="fileup" type="file" class="file"/> <span style="white-space:pre"> </span> </div> <span style="white-space:pre"> </span></form> <span style="white-space:pre"> </span></div> <span style="white-space:pre"> </span><div class="modal-footer"> <span style="white-space:pre"> </span><button type="button" class="btn btn-default" data-dismiss="modal">關閉 <span style="white-space:pre"> </span></button> <span style="white-space:pre"> </span></div> <span style="white-space:pre"> </span></div><!-- /.modal-content --> <span style="white-space:pre"> </span></div><!-- /.modal --> <span style="white-space:pre"> </span></div>
然後是 JS 代碼,初始化 file-input:
//初始化 fileinput 控件(第一次初始化) function initFileInput(ctrlName, uploadUrl) { var control = $('#' + ctrlName); control.fileinput({ language: 'zh', //設置語言 uploadUrl: uploadUrl, //上傳的地址 allowedFileExtensions : ['jpg', 'png','gif'],//接收的文件後綴 showUpload: true, //是否顯示上傳按鈕 showCaption: false,//是否顯示標題 browseClass: "btn btn-primary", //按鈕樣式 previewFileIcon: "<i class='glyphicon glyphicon-king'></i>", uploadAsync: false, uploadExtraData:function (previewId, index) { var obj = {}; $('#addForm').find('input').each(function() { var id = $(this).attr('id'), val = $(this).val(); obj[id] = val; }); return obj; } }); } //初始化 fileinput initFileInput("fileup", "https://localhost:8080/web/guita/addGuitaInfo.action");
這段代碼是插件的核心,其中 uploadUrl 是後台給的訪問路徑。這裡要特別注意下面這一段:
uploadExtraData:function (previewId, index) { var obj = {}; $('#addForm').find('input').each(function() { var id = $(this).attr('id'), val = $(this).val(); obj[id] = val; }); return obj; }
這段代碼中的 uploadExtraData 用於傳遞額外參數,可以用來提交 form 表單的其他 input 框數據:
uploadExtraData:{ type:"type", tune:"tune" }
一般的靜態數據如上圖提交,後台就可以直接接到,但這樣寫會得不到動態數據,因為數據只會在初始化的時候生成一次,之後不會改變。這個問題糾結了我不少時間,最後是在 git 上參考國外朋友的討論與 API 才解決掉。

這些寫好之後就可以看到效果圖了。

樣式還是很不錯的,點擊上傳之後,整個 form 的數據都會提交到後台。
網上找的很多該插件的應用整合的都是 PHP,我這裡是用 Java 寫的,也上一下後台接收的代碼,Spring MVC 框架接收數據還是很方便的。


這樣就完成了數據參數和圖片參數的傳遞,然後後台調用文件上傳的代碼存入圖片即可。該插件還有很多值得研究的用法,這裡只是簡單說一下使用方式並完成動態數據的傳輸,剛接觸這個插件的朋友可以稍微做一下參考。
關於 Bootstrap 使用 file-input 插件上傳圖片的方法就介紹這麼多,希望對大家有所幫助。若有任何疑問歡迎留言,我會及時回覆。