最早把 JS 拖放功能引入網頁的是 IE4。當時網頁中只有兩種物件可以拖放:圖像和某些文字。拖動圖像時,把滑鼠放在圖像上,按住滑鼠不放就能拖動它;拖動文字時,則需要先把文字選取起來,然後像拖動圖像一樣拖動被選取的文字。在 IE4 中,唯一有效的放置目標是文字方塊;到了 IE5,拖放功能得到擴充,新增了事件,而且網頁中任何元素都能作為放置目標;IE5.5 更進一步,讓網頁中的任何元素都可以拖放。IE、Firefox 3.5、Safari 3+、Chrome 都實作了原生拖放功能。
一、可拖放屬性 draggable
預設情況下,圖像、連結、文字是可以拖動的:文字只有在被選取的情況下才能拖動,而圖像和連結在任何時候都可以拖動。這是因為圖像和連結的 draggable 屬性會自動被設為 true,而其他元素這個屬性的預設值都是 false。所以,若想讓其他元素變得可拖動,或者讓圖像、連結變得不能拖動,都可以透過設定 draggable 屬性來改變它們的可拖動狀態。
例如: <!--讓這個圖像不可以拖動-->
<img src="test.jpg" draggable="false" >
<!--讓這個元素可以拖動-->
<div draggable="true"></div>
支援 draggable 屬性的瀏覽器有 IE10+、Firefox 4+、Safari 5+、Chrome;另外,為了讓 Firefox 支援可拖放屬性,還必須添加一個 ondragstart 事件處理程序,並在 dataTransfer 物件中保存一些資訊。
二、事件物件 dataTransfer
dataTransfer 是事件物件的一個屬性,用於從被拖動元素向放置目標傳遞字串格式的資料。因為它是事件物件的屬性,所以只能在拖放事件的事件處理程序中存取 dataTransfer 物件。在事件處理程序中,可以使用這個物件的屬性和方法來完善拖放功能。
dataTransfer 物件主要有兩個方法:setData() 和 getData()。getData() 可以取得由 setData() 保存的值;setData() 方法的第一個參數,也是 getData() 方法的唯一一個參數,是一個字串,表示保存的資料類型,取值為 "text" 或 "URL"。
例如:
//設置和接收文字資料
event.dataTransfer.setData("text","some text");
var text=event.dataTransfer.getData("text");
//設置和接收 URL
event.dataTransfer.setData("URL","https://www.blog.com/");
event.dataTransfer.getData("URL");
IE 只定義了 "text" 和 "URL" 兩種有效的資料類型,而 HTML5 則對此加以擴充,允許指定各種 MIME 類型。考慮到向後相容,HTML5 也支援 "text" 和 "URL",但這兩種類型會被對映為 "text/plain" 和 "text/uri-list"。實際上,dataTransfer 物件可以為每種 MIME 類型都保存一個值,而保存在 dataTransfer 物件中的資料只能在 drop 事件處理程序中讀取;如果沒有在 onDrop 處理程序中讀到資料,那就代表 dataTransfer 物件已被銷毀,資料也丟失了。
把資料保存為文字和保存為 URL 是有區別的:如果將資料保存為文字格式,那麼資料不會得到任何特殊處理;而如果將資料保存為 URL,瀏覽器會把它當成網頁中的連結,也就是說,如果你把它放置到另一個瀏覽器視窗中,瀏覽器就會打開該 URL。
由於 Firefox 在其第 5 個版本之前不能正確地將 "url" 和 "text" 對映為 "text/uri-list" 和 "text/plain",卻能把 "Text"(T 大寫)對映為 "text/plain",為了更好地在跨瀏覽器的情況下從 dataTransfer 物件取得資料,最好在取得 URL 資料時檢測兩個值,而在取得文字資料時使用 "Text"。
//讀取URL
var url=event.dataTransfer.getData("url")||event.dataTransfer.getData("text/uri-list");
//讀取文字
vat text=dataTransfer.getData("Text");
注意:一定要把端資料類型放在前面,因為 IE10 及之前的版本仍然不支援擴充的 MIME 類型名,在遇到無法識別的資料類型時會報錯。
三、dropEffect 和 effectAllowed 屬性
dataTransfer 物件的兩個屬性:dropEffect 和 effectAllowed,這兩個屬性用來確定被拖動元素以及作為放置目標的元素能夠接收什麼操作。
透過 dropEffect 屬性可以知道被拖動元素能夠執行哪一種放置行為,這個屬性有 4 個可能的值:
(1)"none":不能把拖動的元素放在這裡,這是除文字方塊之外所有元素的預設值
(2)"move":應該把拖動的元素移動到放置目標
(3)"copy":應該把拖動的元素複製到放置目標
(4)"link":表示放置目標會打開拖動的元素(但拖動的元素必須是一個連結,有 URL)
把元素拖動到放置目標上時,以上每一個值都會導致游標顯示為不同的符號。要使用 dropEffect 屬性,必須在 ondragenter 事件處理程序中針對放置目標來設定它。
dropEffect 屬性只有搭配 effectAllowed 屬性才有用。effectAllowed 屬性表示允許拖動的元素哪一種 dropEffect,effectAllowed 屬性可能的值有:
(1)"uninitialized":沒有給被拖動元素設定任何放置行為
(2)"none":被拖動的元素不能有任何行為
(3)"copy":只允許值為 "copy" 的 dropEffect
(4)"link":只允許值為 "link" 的 dropEffect
(5)"move":只允許值為 "move" 的 dropEffect
(6)"copyLink":只允許值為 "copy" 和 "link" 的 dropEffect
(7)"copyMove":只允許值為 "copy" 和 "move" 的 dropEffect
(8)"linkMove":只允許值為 "link" 和 "move" 的 dropEffect
(9)"all":允許任意 dropEffect
注意:必須在 ondragstart 事件處理程序中設定 effectAllowed 屬性。
四、拖放事件
1. 拖動某元素時,將依次觸發下列事件:
(1)dragstart:按下滑鼠並開始移動時,會在被拖放的元素上觸發 dragstart 事件
(2)drag:觸發 dragstart 事件後,隨即就會觸發 drag 事件,而且在元素被拖動期間會持續觸發該事件
(3)dragend:當拖動停止時(無論是把該元素放到了有效的放置目標上還是放到了無效的放置目標上),會觸發 dragend 事件
上面這三個事件的目標都是被拖動元素,大多數瀏覽器會為正在被拖動的元素建立一個半透明的副本,這個副本始終跟隨著游標移動。
2. 當某個元素被拖動到一個有效的放置目標上時,下列事件會依次觸發:
(1)dragenter:只要有拖動元素被拖動到放置目標上,就會觸發 dragenter 事件
(2)dragover:在被拖動元素於放置目標的範圍內移動時,就會持續觸發該事件
(3)dragleave 或 drop:當被拖動元素拖出了放置目標,將觸發 dragleave 事件;如果元素被放到了放置目標中,則會觸發 drop,而不會觸發 dragleave 事件。
什麼是有效的放置目標呢?在拖動元素經過某些無效放置目標時,可以看到一種特殊的游標(圓環中有一條反斜槓),表示不能放置。雖然所有元素都支援放置目標事件,但這些元素預設是不允許放置的;所以要想把任何元素變成有效的放置目標,方法是重寫 dragenter 和 dragover 事件的預設行為,也就是 event.preventDefault()。這樣,當被拖動元素移動到放置目標上時,游標就變成了允許放置的符號,釋放滑鼠時,也會觸發 drop 事件。但是 drop 事件的預設行為是打開被放到放置目標上的 URL,當把文字拖放到放置目標上時,則會導致無效的 URL 錯誤,因此為了讓 Firefox 也能正常地拖放,還要取消 drop 事件的預設行為。