DIV CSS 佈局教程網

AngularJS + Bootstrap 實現多圖片上傳與管理
編輯:關於JavaScript     

前陣子的項目需要用到多文件上傳與管理。項目本身是基於 Bootstrap 開發的,於是對比了幾款上傳插件,最後還是覺得 bootstrap-fileinput 最耐看,多文件上傳與管理它都能勝任(官方地址:https://plugins.krajee.com/file-input)。

這個插件不限於圖片,普通文件也支持,只是圖片有縮略圖更好辨識,所以下面以圖片為例。

需求拆解

先把項目裡關於圖片管理的需求列清楚:

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 與漢化包都在插件官方壓縮包裡。

二、多文件上傳

先在頁面裡聲明 file 控件,注意 multiple 關鍵字:

<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,哪怕是一個空對象 "{}"。返回的內容會保存在前端的 data.response 中。

三、已有文件的加載與刪除

所謂「已有文件加載」,就是把服務器上已存在的文件回顯到控件裡,讓用戶能繼續管理。這一步主要靠 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 值提交到 config.url,後端只需接一下:

public void deletePicById() {
    String picId = getPara("key");
    service.deletePicById(Integer.valueOf(picId));
    renderJson("{}");
}

四、幾個容易困惑的問題

Q1:model 裡沒有定義屬性,為什麼前端能拿到值?

這裡用的是 JFinal 的 ActiveRecord 模式,不需要寫屬性和 setter/getter,值都映射在 model 的 attrs 這個鍵值對裡,key 就是數據庫字段名。要提醒的是:SQL 語句不區分大小寫,但字段名是區分的。如果字段名是大寫,映射到 model 裡的 key 也是大寫,同時 JFinal 默認以 id 為主鍵的策略會失效,需要在 configPlugin 中顯式聲明,例如 arp.addMapping("pictures", "ID", Picture.class)。建議還是按 Java 命名規範給數據庫字段命名。

Q2:初始化時為什麼要先 clear、destroy?

因為插件在選完文件後,無論是否上傳,都會把文件保留在 file 域裡,再點一次會看到上次選的文件,這不符合多相冊管理的預期。按官方文檔 clear 應該能清空 file 域,但實測並沒有,所以只能先 clear、destroy 再重新初始化控件。這一點我也不太確定,歡迎指正。

Q3:保存時怎麼判斷哪些圖片需要入庫?

$scope 上有個 selectedPics 數組,負責記錄最終會寫入數據庫的文件。選檔後把信息 push 進這個數組,hasUpload 為 false;上傳成功後把對應項的 hasUpload 改為 true;上傳後但未落庫就刪除的,會把元素從數組中移除。

有人會問:選了文件不上傳直接刪除,數組豈不是會錯位?其實不會。fileuploaded 事件中更新的是數組對應位置的元素,而下標是通過圖片所在 DIV 的 data-fileindex 屬性取得的。這個值只遞增、不回填,也不會因刪圖而變動,正好和 selectedPics 的索引對齊。

var idx = $("#" + previewId).attr("data-fileindex");

舉例:選了 3 張圖此時未上傳,data-fileindex 依次是 0、1、2;刪掉中間那張再選新圖,三個值會變成 0、2、3。

五、小結

整套方案的關鍵點就三處:多選靠 input 上的 multiple,回顯靠 initialPreview + initialPreviewConfig,刪除靠 config 裡的 url 與 key 約定。把這三處串起來,多圖上傳與管理就完整了。

示例代碼與數據庫腳本(MySQL,files.sql)可一併下載參考。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved