這年頭,網頁如果不支援從桌面或檔案總管直接拖拉檔案,想自稱HTML5都心虛,只能稱作HTML4.5(誤),老闆客戶還會不時打你臉: "Gmail、OneDrive(SkyDrive)、DropBox幾百年前就有了! 為什麼你到現在還做不出來?" (網頁攻城獅內心的OS: 你有給我Google或Microsoft等級的薪水嗎?) 搞網頁好辛苦,客戶老闆上網胡亂逛,不小心看到酷炫網站,馬上把規格放進專案,還說什麼瀏覽器打開HTML、CSS、JavaScript都能看,快點抄一抄給我做出來... 想到這我都鼻酸了,Web Developer們應該團結起來,技術衝那麼快是要逼死誰,我數一二三,大家一起放手吧... orz


"大家不要這麼辛苦,好不好?" "好,大家都不要這麼辛苦。" "一、二、三!"

話說回來,既然走了技術這行就得認命,還是乖乖學習怎麼實現檔案拖拉吧!

先看執行效果。目標如下,網頁左上角有個圖檔拖放區,由檔案總管選取多個檔案,拖拉至拖放區放下,網頁接收選取的檔案清單,透過HTML5 File API讀取圖檔轉為Data URI作為<img> src,在頁面呈現圖示清單,點選圖示時可檢視原圖。

【原理解析】

只簡單說明原理,細節請直接看程式碼及註解:

  1. 拖放操作: 在圖檔拖放區元素加掛ondragover、ondragleave、ondrop事件,滑鼠移拉物件進入離開時切換底色,放下物件時透過transferData.files取得檔案資訊。為避免拖拉操作觸發原有瀏覽器行為,記得要呼叫event.stopPropagation()及event.preventDefault()。
  2. 檔案資訊: event.transferData.files裡的檔案資訊有name, type, size等資訊,基於安全不包含檔案路徑等資訊,但可當成File API參數讀出內容。
  3. 讀取檔案: 透過HTML5 File API FileReader(),將圖檔讀入轉成Data URI,可直接做為<img> src顯示圖檔。【延伸閱讀: [HTML5] HTML5 File API
  4. 清單及檢視: 採用Knockout MVVM實作清單、檢視介面。

程式範例如下: Live Demo

排版顯示純文字
<!DOCTYPE html>
 
<html>
<head>
    <meta name="viewport" content="width=device-width" />
    <title>HTML5 拖拉圖檔顯示在網頁上</title>
    <style>
        .drop-zone {
            position: absolute; top: 6px; width: 120px; height: 90px; 
            background-color: green; color: white; text-align: center;
        }
        .drop-zone.hover {
            background-color: blue;
        }
        .img-list {
            position: absolute; height: 90px; background-color: #444;
            top: 6px; left: 135px; right: 6px; overflow-y: hidden;
            overflow-x: auto; white-space: nowrap;
        }
        .thumbnail {
            max-width: 100px; max-width: 75px; vertical-align: top;
            margin: 3px; cursor: pointer;
            border: 1px solid transparent;
        }
        .thumbnail:hover {
            border: 1px solid red;
        }
        .display {
            position: absolute; top: 110px; 
            left: 6px; right: 6px; bottom: 6px;
            padding: 12px;
        }
    </style>
</head>
<body>
    <div class="drop-zone"><span>圖檔拖放區</span></div>
    <div data-bind ="foreach: images" class="img-list">
        <img data-bind="attr: { src: dataUri }, click: $root.currImage" class="thumbnail" />
    </div>
    <fieldset class="display" data-bind="with: currImage">
        <legend>
            <span data-bind="text: name"></span>
            <span data-bind="text: size"></span>
        </legend>
        <div>
            <img data-bind="attr: { src: dataUri }" />
        </div>
    </fieldset>
    <script src="http://ajax.aspnetcdn.com/ajax/jQuery/jquery-1.9.1.js "></script>
    <script src="http://ajax.aspnetcdn.com/ajax/knockout/knockout-3.0.0.js "></script>
    <script src="http://cdn.kendostatic.com/2013.3.1119/js/kendo.core.min.js"></script>
<script>
        $(function () {
            var $drop = $(".drop-zone");
            //抑制瀏覽器原有的拖拉操作效果
            function stopEvent(evt) {
                evt.stopPropagation();
                evt.preventDefault();
            }
            $drop.bind("dragover", function (e) {
                //滑鼠經過上方時加入特效
                stopEvent(e);
                $(e.target).addClass("hover");
            }).bind("dragleave", function (e) {
                //滑鼠移開時移除特效
                stopEvent(e);
                $(e.target).removeClass("hover");
            }).bind("drop", function (e) {
                //拖放操作完成事件
                stopEvent(e);
                $(e.target).removeClass("hover");
                //由dataTransfer.files取得檔案資訊
                var files = e.originalEvent.dataTransfer.files;
                var imageFiles = $.map(files, function (f, i) {
                    //只留下type為image/*者,例如: image/gif, image/jpeg, image/png...
                    return f.type.indexOf("image") == 0 ? f : null;
                });
                //清除ViewModel
                vm.images.removeAll(); vm.currImage(null);
                //逐一讀入各圖檔,取得DataURI,顯示在網頁上
                $.each(imageFiles, function (i, file) {
                    //使用File API讀取圖檔內容轉為DataUri
                    var reader = new FileReader();
                    reader.onload = function (e) {
                        //將檔名、檔案大小、DataURI放入ViewModel
                        vm.images.push({
                            name: file.name,
                            size: kendo.format("{0:n0} bytes", file.size),
                            dataUri: e.target.result
                        })
                    }
                    reader.readAsDataURL(file);
                });
            });
 
            function myViewModel() {
                var self = this;
                self.images = ko.observableArray();
                self.currImage = ko.observable();
            }
            var vm = new myViewModel();
            ko.applyBindings(vm);
        });
    </script>
</body>
</html>

【注意】IE要IE10以上才開始支援File API,IE9哭哭!

【參考資料】

  1. HTML5 File Drag & Drop API
  2. HTML5 drag and drop asynchronous multi file upload with ASP.NET WebAPI
  3. [HTML5] HTML5 File API by 小朱

Comments

# by 佑翔

chrome還支援拖曳資料夾哦!! 也支援把檔案拖出來("DownloadURL")

# by WWE

黑大您好,謝謝您的教學 原理解析中的第三點 3. 讀取檔案 的延伸閱讀:沒有資料@@

# by Jeffrey

to WWE, 謝謝提醒。編輯時出錯,已修正。

# by axer

感謝你無私的分享 老闆客戶還會不時打你臉: Gmail、OneDrive、DropBox幾百年前就有了! 為什麼你到現在還做不出來。 非常有同感耶。 還記得有人和我說,他以前也想做google map,只差沒資金,結果google偷了他的創意

# by 胡忠晞

var imageFiles = $.map(files, function (f, i) { 這裡用 grep 比較直覺吧! 我被拐到了! var imageFiles = $.grep(files, function(file) { return ~file.type.indexOf("image"); });

# by Jeffrey

to Jax, 嘿,用$.grep()的確簡潔多了,多年來我一直忘了它的存在(羞),謝謝提醒,已筆記。

Post a comment