在 web 中，圖片默認是可以拖拽的，通常是一個半透明的預覽圖(下面簡稱“預覽圖”)，如下：

這個預覽圖是系統自動生成的，一般無法進行自定義，但有時候會覺得拖拽的預覽圖尺寸太大了，不方便放置，例如在這種場景下。

這是一個拖拽圖片保存的功能，需要將圖片拖拽至指定區域觸發保存操作。由于拖拽時預覽圖太大，導致放置區域都被遮住了，茫茫的一片，體驗非常不好。

如果預覽圖的尺寸可以小一點，例如這樣：

是不是體驗就會好很多?下面一起來探討一下。

一、預覽圖的默認尺寸

首先，拖拽預覽圖的尺寸是和頁面上圖片的CSS 尺寸相關聯的，也就是說展示的圖片越大，拖拽的預覽圖越大。

但是，預覽圖的大小并不是無限制的，據我測試，預覽圖的最大尺寸是 400 * 400，比如下方圖片的尺寸是 500 * 500， 但是拖拽出來的預覽圖只有 400 * 400，但對實際開發而言，這個尺寸還是過大。

以上是 MacOS Chrome 下的表現效果，Firefox 表現要好很多，不會出現預覽圖過大的情況。

另外，測試了一下 Windows Chrome 的表現效果，比較類似，只不過最大尺寸是 200 * 200，表現如下：

二、借助 setDragImage 修改預覽圖

原生的拖拽只能通過 setDragImage[1] 來修改預覽圖，看著好像很強大，實則非常雞肋，簡單使用如下：

function dragstart_handler(ev) {
 var img = new Image();
 img.src = 'example.jpg';
 ev.dataTransfer.setDragImage(img, 0, 0);
}

這里指定了這樣一張圖片作為預覽圖：

需要綁定在 dragstart事件上，這里采用事件委托的方式。

document.addEventListener('dragstart', ev => {
  if (ev.target.tagName === 'IMG') {
    dragstart_handler(ev)
  }
})

效果是這樣的：

為什么是第二次拖拽才出現自定義預覽呢?這就是雞肋的地方了，官方規定 example.jpg為一個已經存在的圖片，如果這個還沒有創建或者還未加載完成，那么瀏覽器將會使用默認的拖動圖片，在第二次拖拽的時候圖片加載完了，所以才生效。可以說，幾乎所有setDragImage不起作用的情況都是因為這個原因。

除此之外，還有一個問題，無法直接指定預覽圖的大小，例如：

function dragstart_handler(ev) {
 var img = new Image();
 img.src = 'example.jpg';
 img.width = 50;//無效
 img.height = 50;
 ev.dataTransfer.setDragImage(img, 0, 0);
}

這樣也是無效的，內存中的圖片會按原始大小來展示。

三、指定預覽圖為頁面元素

其實，要想修改預覽圖的大小還可以通過 canvas 渲染原圖，然后修改尺寸再生成圖片，但是 canvas 在渲染圖片時經常會出現跨域的問題，并且 canvas 也有一定的門檻，所以這里先不采用。

再回過來看看官方的語法：

dataTransfer.setDragImage(img | element, xOffset, yOffset);

可以看到，第一個參數不僅支持動態創建的圖片，也支持頁面上實際存在的元素(頁面上存在的元素肯定是加載完成的)。

假設我們將自定義預覽圖添加在頁面。

<img ondragstart="dragstart_handler" src="head.jpg">
<img id="img" src="example.jpg"><!--預覽圖-->

然后將預覽圖指定為該圖片example.jpg。

ev.dataTransfer.setDragImage(img, 0, 0);

效果如下：

可以看到，拖拽圖片就像拖拽 example.jpg 一樣，而且也可以通過CSS直接修改尺寸!

#img{
  width: 100px;
  height: 100px;
}

預覽圖大小也是跟隨 example.jpg 的。

如果把 example.jpg換成和原始圖相同的鏈接，是不是就相當于可以自定義預覽圖的大小了呢?

現在需要將自定義圖片隱藏起來，畢竟只是借用一下，頁面上不需要顯示，這里需要一點小技巧了，不能真正的將這個圖片隱藏起來，比如：

#img{
  display: none;
  /*或者*/
  opacity: 0;
  /*或者*/
  visibility: none
}

這些方式都不行，由于預覽圖是跟隨這張自定義圖片的，如果直接隱藏了都會導致預覽圖直接消失不見。

這時采取的方式可以將這張圖片移到視區之外，比如這樣：

#img{
  position: absolute;
  top: -9999px;
}

這樣就沒問題了。

實際工作中，這張圖應該是自動生成的，而且自動獲取當前拖拽圖片的鏈接，完整實現就是。

/* 
* custom_drag_img
* author: xboxyan
*/
const img = document.createElement('img');
img.style = "position: absolute; top: -9999px; max-width: 100px; max-height: 100px;"
document.body.append(img)
document.addEventListener('dragstart', ev => {
  if (ev.target.tagName === 'IMG') {
    img.src = ev.target.src;
    ev.dataTransfer.setDragImage(img, 0, 0);
  }
})

可以將這段代碼注入其他地方，試試效果，比如原始效果如下：

注入以上代碼之后的效果如下：

在某些場景下是不是體驗好很多呢?

四、自定義預覽圖樣式

上述預覽圖不僅可以指定圖片元素，也可以其他元素，比如div，添加一些修飾。

<div class="drag_img">
  <img src="xxx">
</div>

.drag_img{
  position: absolute;
  top: -9999px;
  max-width: 100px;
  max-height: 100px;
  border: 3px solid yellow;
}

這樣就可以給預覽圖加上一個黃色邊框(強調作用)了。

亦或是通過偽元素加個角標。

.drag_img::after{
  content: '';
  position: absolute;
  top: 0;
  right: 0;
  width: 20px;
  height: 20px;
  background: linear-gradient(-135deg, #f44336 50%, transparent 51%);
}

但是添加CSS濾鏡沒有生效，仍然是原始樣式：

.drag_img{
  position: absolute;
  top: -9999px;
  max-width: 100px;
  max-height: 100px;
  filter: sepia(1); /*褐色濾鏡*/
}

這可能跟系統生成預覽圖的策略有關，無從得知，也無法修改

五、完全的自定義方案 draggable-polyfill

其實上述都只是針對 setDragImage做的一些自定義，本質上還是原生預覽圖，也僅適用于圖片拖拽(但是性能超好)，如果想完全自定義拖拽效果，自定義普通可拖拽元素，就必須通過 JS 模擬實現了。大致思路如下

1. 去除默認的預覽圖
2. 復制一份當前目標元素，cloneObj
3. 監聽拖拽事件，通過 transform 改變cloneObj的位置
4. 拖拽結束移除cloneObj

詳細原理可以參考我之前的一篇文章：實現一個美化原生拖拽的draggable-polyfill[2]，雖然是自定義實現的，但是完全不影響原有業務拖拽邏輯，這正是 polyfill 的魅力，非常適合原生拖拽實現的場景。

項目地址：https://github.com/XboxYan/draggable-polyfill(或者訪問文章底部「原文鏈接」)[3]，非常輕量，100 來行代碼，不影響業務邏輯，非常適合學習和時使用，歡迎 star~

3 年前的老代碼了，最近優化了一波，非常實用，歡迎 star

六、總結一下

以上就完成了圖片拖拽預覽圖的自定義，其實主要用于修改預覽尺寸，在某些場景下還是挺有用的，這里總結一些要點：

1. 在拖拽時產生的預覽圖是系統生成的，無法直接修改
2. 在macOS Chrome下，預覽圖的尺寸最大為 400 * 400，在某些場景下體驗不太友好
3. setDragImage 可以修改預覽圖
4. setDragImage 需要圖片已經加載完成才會生效，否則仍然是默認樣式
5. setDragImage 可以指定頁面上的其他元素，不僅僅是 img
6. setDragImage 指定的元素不能真正的隱藏，否則預覽圖將不可見，可以通過移出到視線之外的方式
7. 以上方案適用于圖片拖拽，并且自定義的樣式有限
8. 如果需要完全自定義拖拽，可以采用 draggable-polyfill 方案，歡迎star~

總的來說，整體實現還是非常簡單的，由于是原生方案，性能就不用說了，也不會影響原有功能，起到了美化的作用，如果有類似的需求，就趕緊用起來吧~

參考資料

[1]setDragImage: https://developer.mozilla.org/zh-CN/docs/Web/API/DataTransfer/setDragImage。

[2]實現一個美化原生拖拽的draggable-polyfill: https://segmentfault.com/a/1190000020842646。

[3]https://github.com/XboxYan/draggable-polyfill: https://github.com/XboxYan/draggable-polyfill。