教你如何自定義 Drag 樣式.md
在 web 中,圖片默認(rèn)是可以拖拽的,通常是一個半透明的預(yù)覽圖(下面簡稱“預(yù)覽圖”),如下:
這個預(yù)覽圖是系統(tǒng)自動生成的,一般無法進(jìn)行自定義,但有時候會覺得拖拽的預(yù)覽圖尺寸太大了,不方便放置,例如在這種場景下。
這是一個拖拽圖片保存的功能,需要將圖片拖拽至指定區(qū)域觸發(fā)保存操作。由于拖拽時預(yù)覽圖太大,導(dǎo)致放置區(qū)域都被遮住了,茫茫的一片,體驗(yàn)非常不好。
如果預(yù)覽圖的尺寸可以小一點(diǎn),例如這樣:
是不是體驗(yàn)就會好很多?下面一起來探討一下。
一、預(yù)覽圖的默認(rèn)尺寸
首先,拖拽預(yù)覽圖的尺寸是和頁面上圖片的CSS 尺寸相關(guān)聯(lián)的,也就是說展示的圖片越大,拖拽的預(yù)覽圖越大。
但是,預(yù)覽圖的大小并不是無限制的,據(jù)我測試,預(yù)覽圖的最大尺寸是 400 * 400,比如下方圖片的尺寸是 500 * 500, 但是拖拽出來的預(yù)覽圖只有 400 * 400,但對實(shí)際開發(fā)而言,這個尺寸還是過大。
以上是 MacOS Chrome 下的表現(xiàn)效果,F(xiàn)irefox 表現(xiàn)要好很多,不會出現(xiàn)預(yù)覽圖過大的情況。
另外,測試了一下 Windows Chrome 的表現(xiàn)效果,比較類似,只不過最大尺寸是 200 * 200,表現(xiàn)如下:
二、借助 setDragImage 修改預(yù)覽圖
原生的拖拽只能通過 setDragImage[1] 來修改預(yù)覽圖,看著好像很強(qiáng)大,實(shí)則非常雞肋,簡單使用如下:
function dragstart_handler(ev) {
var img = new Image();
img.src = 'example.jpg';
ev.dataTransfer.setDragImage(img, 0, 0);
}
這里指定了這樣一張圖片作為預(yù)覽圖:
需要綁定在 dragstart事件上,這里采用事件委托的方式。
document.addEventListener('dragstart', ev => {
if (ev.target.tagName === 'IMG') {
dragstart_handler(ev)
}
})
效果是這樣的:
為什么是第二次拖拽才出現(xiàn)自定義預(yù)覽呢?這就是雞肋的地方了,官方規(guī)定 example.jpg為一個已經(jīng)存在的圖片,如果這個還沒有創(chuàng)建或者還未加載完成,那么瀏覽器將會使用默認(rèn)的拖動圖片,在第二次拖拽的時候圖片加載完了,所以才生效??梢哉f,幾乎所有setDragImage不起作用的情況都是因?yàn)檫@個原因。
除此之外,還有一個問題,無法直接指定預(yù)覽圖的大小,例如:
function dragstart_handler(ev) {
var img = new Image();
img.src = 'example.jpg';
img.width = 50;//無效
img.height = 50;
ev.dataTransfer.setDragImage(img, 0, 0);
}
這樣也是無效的,內(nèi)存中的圖片會按原始大小來展示。
三、指定預(yù)覽圖為頁面元素
其實(shí),要想修改預(yù)覽圖的大小還可以通過 canvas 渲染原圖,然后修改尺寸再生成圖片,但是 canvas 在渲染圖片時經(jīng)常會出現(xiàn)跨域的問題,并且 canvas 也有一定的門檻,所以這里先不采用。
再回過來看看官方的語法:
dataTransfer.setDragImage(img | element, xOffset, yOffset);
可以看到,第一個參數(shù)不僅支持動態(tài)創(chuàng)建的圖片,也支持頁面上實(shí)際存在的元素(頁面上存在的元素肯定是加載完成的)。
假設(shè)我們將自定義預(yù)覽圖添加在頁面。
<img ondragstart="dragstart_handler" src="head.jpg">
<img id="img" src="example.jpg"><!--預(yù)覽圖-->
然后將預(yù)覽圖指定為該圖片example.jpg。
ev.dataTransfer.setDragImage(img, 0, 0);
效果如下:
可以看到,拖拽圖片就像拖拽 example.jpg 一樣,而且也可以通過CSS直接修改尺寸!
#img{
width: 100px;
height: 100px;
}
預(yù)覽圖大小也是跟隨 example.jpg 的。
如果把 example.jpg換成和原始圖相同的鏈接,是不是就相當(dāng)于可以自定義預(yù)覽圖的大小了呢?
現(xiàn)在需要將自定義圖片隱藏起來,畢竟只是借用一下,頁面上不需要顯示,這里需要一點(diǎn)小技巧了,不能真正的將這個圖片隱藏起來,比如:
#img{
display: none;
/*或者*/
opacity: 0;
/*或者*/
visibility: none
}
這些方式都不行,由于預(yù)覽圖是跟隨這張自定義圖片的,如果直接隱藏了都會導(dǎo)致預(yù)覽圖直接消失不見。
這時采取的方式可以將這張圖片移到視區(qū)之外,比如這樣:
#img{
position: absolute;
top: -9999px;
}
這樣就沒問題了。
實(shí)際工作中,這張圖應(yīng)該是自動生成的,而且自動獲取當(dāng)前拖拽圖片的鏈接,完整實(shí)現(xiàn)就是。
/*
* 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);
}
})
可以將這段代碼注入其他地方,試試效果,比如原始效果如下:
注入以上代碼之后的效果如下:
在某些場景下是不是體驗(yàn)好很多呢?
四、自定義預(yù)覽圖樣式
上述預(yù)覽圖不僅可以指定圖片元素,也可以其他元素,比如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;
}
這樣就可以給預(yù)覽圖加上一個黃色邊框(強(qiáng)調(diào)作用)了。
亦或是通過偽元素加個角標(biāo)。
.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); /*褐色濾鏡*/
}
這可能跟系統(tǒng)生成預(yù)覽圖的策略有關(guān),無從得知,也無法修改
五、完全的自定義方案 draggable-polyfill
其實(shí)上述都只是針對 setDragImage做的一些自定義,本質(zhì)上還是原生預(yù)覽圖,也僅適用于圖片拖拽(但是性能超好),如果想完全自定義拖拽效果,自定義普通可拖拽元素,就必須通過 JS 模擬實(shí)現(xiàn)了。大致思路如下
- 去除默認(rèn)的預(yù)覽圖
- 復(fù)制一份當(dāng)前目標(biāo)元素,cloneObj
- 監(jiān)聽拖拽事件,通過 transform 改變cloneObj的位置
- 拖拽結(jié)束移除cloneObj
詳細(xì)原理可以參考我之前的一篇文章:實(shí)現(xiàn)一個美化原生拖拽的draggable-polyfill[2],雖然是自定義實(shí)現(xiàn)的,但是完全不影響原有業(yè)務(wù)拖拽邏輯,這正是 polyfill 的魅力,非常適合原生拖拽實(shí)現(xiàn)的場景。
項(xiàng)目地址:https://github.com/XboxYan/draggable-polyfill(或者訪問文章底部「原文鏈接」)[3],非常輕量,100 來行代碼,不影響業(yè)務(wù)邏輯,非常適合學(xué)習(xí)和時使用,歡迎 star~
3 年前的老代碼了,最近優(yōu)化了一波,非常實(shí)用,歡迎 star
六、總結(jié)一下
以上就完成了圖片拖拽預(yù)覽圖的自定義,其實(shí)主要用于修改預(yù)覽尺寸,在某些場景下還是挺有用的,這里總結(jié)一些要點(diǎn):
- 在拖拽時產(chǎn)生的預(yù)覽圖是系統(tǒng)生成的,無法直接修改
- 在macOS Chrome下,預(yù)覽圖的尺寸最大為 400 * 400,在某些場景下體驗(yàn)不太友好
- setDragImage 可以修改預(yù)覽圖
- setDragImage 需要圖片已經(jīng)加載完成才會生效,否則仍然是默認(rèn)樣式
- setDragImage 可以指定頁面上的其他元素,不僅僅是 img
- setDragImage 指定的元素不能真正的隱藏,否則預(yù)覽圖將不可見,可以通過移出到視線之外的方式
- 以上方案適用于圖片拖拽,并且自定義的樣式有限
- 如果需要完全自定義拖拽,可以采用 draggable-polyfill 方案,歡迎star~
總的來說,整體實(shí)現(xiàn)還是非常簡單的,由于是原生方案,性能就不用說了,也不會影響原有功能,起到了美化的作用,如果有類似的需求,就趕緊用起來吧~
參考資料
[1]setDragImage: https://developer.mozilla.org/zh-CN/docs/Web/API/DataTransfer/setDragImage。
[2]實(shí)現(xiàn)一個美化原生拖拽的draggable-polyfill: https://segmentfault.com/a/1190000020842646。
[3]https://github.com/XboxYan/draggable-polyfill: https://github.com/XboxYan/draggable-polyfill。