DIV CSS 佈局教程網

HTML5 拖放 API:把本地圖片直接拖進瀏覽器預覽
編輯:關於JavaScript     

把桌面上一張圖片拖進瀏覽器,它就直接顯示在指定區域裡——這個體驗在現代 Web 應用中幾乎是標配。實作它需要兩個 HTML5 新特性:dataTransfer 負責取得被拖入的檔案物件,FileReader 負責把檔案內容讀成 Data URL。

先攔住瀏覽器的預設行為

如果不做任何處理,拖圖進瀏覽器的結果是「開啟一個新頁面並載入那張圖」,而不是交給你的程式。要阻止這件事,需要 stopPropagation() 與 preventDefault():前者阻擋事件冒泡,後者取消瀏覽器的預設動作。

var ignoreDrag = function(e){
  e.originalEvent.stopPropagation();
  e.originalEvent.preventDefault();
}

接著用 jQuery 把三個拖放相關事件綁到目標容器上:

$('#drop')
 .bind('dragenter',dragenter)
 .bind('dragover',dragover)
 .bind('drop',drop);

這裡之所以用 jQuery 綁定,是因為它幫我們把原生 event 包裝成 e.originalEvent,讓跨瀏覽器存取變得一致。而 dragover 與 dragenter 一定要明確定義,否則預設行為仍然攔不下來:

var dragover = function(e){ ignoreDrag(e); }
var dragenter = function(e){ ignoreDrag(e); }

drop:整個功能的關鍵

var drop = function(e){
  ignoreDrag(e);
  var dt = e.originalEvent.dataTransfer;
  var files = dt.files;
  var fr = new FileReader();
  fr.onload = function(e){
    var image = new Image();
    image.src = e.target.result;
    $('#drop').append(image)
  }
  fr.readAsDataURL(files[0]);
}

dataTransfer.files 是被拖入檔案的陣列,每個元素都有 name、type、size 可讀。至於檔案內容,就交給 FileReader。

FileReader 的四個讀取方法

readAsText:以文字讀取,第二個參數可指定編碼,預設 UTF-8。
readAsBinaryString:讀成二進位字串,常用來 POST 到後端存檔。
readAsDataURL:讀成以 data: 開頭的字串,也就是 Data URI,適合把小圖或 HTML 直接內嵌進文件。
abort:中斷讀取。

要注意的是,這四個方法都不會回傳結果,讀取內容一律存放在 result 屬性中。

FileReader 同時提供完整的事件模型:

拖放事件本身的列表如下:

所以流程就是:readAsDataURL 讀檔 → 觸發 onload → 從 event.target.result 拿到 base64 字串 → 直接塞進 img.src。因為 data 類型的 URL 不需要對外發請求,瀏覽器會直接解析,圖片就瞬間出現了。

完整可執行範例

<html>
<head>
<meta http-equiv="content-type" content="text/html;charset=utf-8">
<style type="text/css">
#drop{
  width:500px; height:300px; border:1px solid grey;
  line-height:300px; text-align:center; overflow:auto;
}
</style>
<script type="text/javascript" src="jquery-1.7.1.min.js"></script>
<script type="text/javascript">
var ignoreDrag = function(e){
  e.originalEvent.stopPropagation();
  e.originalEvent.preventDefault();
}
var dragover  = function(e){ ignoreDrag(e); }
var dragenter = function(e){ ignoreDrag(e); }
var drop = function(e){
  ignoreDrag(e);
  var dt = e.originalEvent.dataTransfer;
  var files = dt.files;
  var fr = new FileReader();
  fr.onload = function(e){
    var image = new Image();
    image.src = e.target.result;
    $('#drop').append(image)
  }
  fr.readAsDataURL(files[0]);
}
$(function(){
  $('#drop').bind('dragenter',dragenter).bind('dragover',dragover).bind('drop',drop);
});
</script>
</head>
<body>
<div id="drop"> 請將圖片放到這裡! </div>
</body>
</html>

延伸可做的事

有了 files 陣列,後續應用非常廣:可以遍歷多張圖一次預覽、用 type 過濾非圖片檔、用 size 提前攔下過大檔案、搭配 URL.createObjectURL() 取代 Data URL 以省記憶體,或用 canvas 順手做裁切與壓縮再上傳到後端。若要支援資料夾拖入,則可使用 DataTransferItem.webkitGetAsEntry()。

以上就是使用 drag-and-drop 實現圖片瀏覽器預覽的完整做法。

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