拖拉事件

    拖拉的对象有好几种，包括元素节点、图片、链接、选中的文字等等。在网页中，除了元素节点默认不可以拖拉，其他（图片、链接、选中的文字）都是可以直接拖拉的。为了让元素节点可拖拉，可以将该节点的属性设为true。

    draggable属性可用于任何元素节点，但是图片（<img>）和链接（<a>）不加这个属性，就可以拖拉。对于它们，用到这个属性的时候，往往是将其设为false，防止拖拉这两种元素。

    注意，一旦某个元素节点的draggable属性设为true，就无法再用鼠标选中该节点内部的文字或子节点了。

    当元素节点或选中的文本被拖拉时，就会持续触发拖拉事件，包括以下一些事件。

    • drag：拖拉过程中，在被拖拉的节点上持续触发（相隔几百毫秒）。
    • dragstart：用户开始拖拉时，在被拖拉的节点上触发，该事件的target属性是被拖拉的节点。通常应该在这个事件的监听函数中，指定拖拉的数据。
    • dragend：拖拉结束时（释放鼠标键或按下 ESC 键）在被拖拉的节点上触发，该事件的target属性是被拖拉的节点。它与dragstart事件，在同一个节点上触发。不管拖拉是否跨窗口，或者中途被取消，dragend事件总是会触发的。
    • dragenter：拖拉进入当前节点时，在当前节点上触发一次，该事件的target属性是当前节点。通常应该在这个事件的监听函数中，指定是否允许在当前节点放下（drop）拖拉的数据。如果当前节点没有该事件的监听函数，或者监听函数不执行任何操作，就意味着不允许在当前节点放下数据。在视觉上显示拖拉进入当前节点，也是在这个事件的监听函数中设置。
    • dragover：拖拉到当前节点上方时，在当前节点上持续触发（相隔几百毫秒），该事件的target属性是当前节点。该事件与dragenter事件的区别是，dragenter事件在进入该节点时触发，然后只要没有离开这个节点，dragover事件会持续触发。
    • dragleave：拖拉操作离开当前节点范围时，在当前节点上触发，该事件的target属性是当前节点。如果要在视觉上显示拖拉离开操作当前节点，就在这个事件的监听函数中设置。
    • drop：被拖拉的节点或选中的文本，释放到目标节点时，在目标节点上触发。注意，如果当前节点不允许drop，即使在该节点上方松开鼠标键，也不会触发该事件。如果用户按下 ESC 键，取消这个操作，也不会触发该事件。该事件的监听函数负责取出拖拉数据，并进行相关处理。

    下面的例子展示，如何动态改变被拖动节点的背景色。

    1. div.addEventListener('dragstart', function (e) {
    2.   this.style.backgroundColor = 'red';
    3. }, false);
    5. div.addEventListener('dragend', function (e) {
    6.   this.style.backgroundColor = 'green';
    7. }, false);

    上面代码中，div节点被拖动时，背景色会变为红色，拖动结束，又变回绿色。

    下面是一个例子，展示如何实现将一个节点从当前父节点，拖拉到另一个父节点中。

    1. /* HTML 代码如下
    2.  <div class="dropzone">
    3.    <div id="draggable" draggable="true">
    4.      该节点可拖拉
    5.    </div>
    6.  </div>
    7.  <div class="dropzone"></div>
    8.  <div class="dropzone"></div>
    9.  <div class="dropzone"></div>
    10. */
    12. // 被拖拉节点
    13. var dragged;
    15. document.addEventListener('dragstart', function (event) {
    16.   // 保存被拖拉节点
    17.   dragged = event.target;
    18.   // 被拖拉节点的背景色变透明
    19.   event.target.style.opacity = 0.5;
    20. }, false);
    22. document.addEventListener('dragend', function (event) {
    23.   // 被拖拉节点的背景色恢复正常
    24.   event.target.style.opacity = '';
    25. }, false);
    27. document.addEventListener('dragover', function (event) {
    28.   // 防止拖拉效果被重置，允许被拖拉的节点放入目标节点
    29.   event.preventDefault();
    30. }, false);
    32. document.addEventListener('dragenter', function (event) {
    33.   // 目标节点的背景色变紫色
    34.   // 由于该事件会冒泡，所以要过滤节点
    35.   if (event.target.className === 'dropzone') {
    36.     event.target.style.background = 'purple';
    37.   }
    38. }, false);
    40. document.addEventListener('dragleave', function( event ) {
    41.   // 目标节点的背景色恢复原样
    42.   if (event.target.className === 'dropzone') {
    43.     event.target.style.background = '';
    44.   }
    45. }, false);
    47. document.addEventListener('drop', function( event ) {
    48.   // 防止事件默认行为（比如某些元素节点上可以打开链接），
    49.   event.preventDefault();
    50.   if (event.target.className === 'dropzone') {
    51.     // 恢复目标节点背景色
    52.     // 将被拖拉节点插入目标节点
    53.     dragged.parentNode.removeChild(dragged);
    54.     event.target.appendChild( dragged );
    55.   }
    56. }, false);

    关于拖拉事件，有以下几个注意点。

    • 拖拉过程只触发以上这些拖拉事件，尽管鼠标在移动，但是鼠标事件不会触发。
    • 将文件从操作系统拖拉进浏览器，不会触发dragstart和dragend事件。
    • dragenter和dragover事件的监听函数，用来取出拖拉的数据（即允许放下被拖拉的元素）。由于网页的大部分区域不适合作为放下拖拉元素的目标节点，所以这两个事件的默认设置为当前节点不允许接受被拖拉的元素。如果想要在目标节点上放下的数据，首先必须阻止这两个事件的默认行为。
    1. <div ondragover="return false">
    2. <div ondragover="event.preventDefault()">

    上面代码中，如果不取消拖拉事件或者阻止默认行为，就不能在div节点上放下被拖拉的节点。

    拖拉事件都继承了DragEvent接口，这个接口又继承了MouseEvent接口和Event接口。

    浏览器原生提供一个DragEvent()构造函数，用来生成拖拉事件的实例对象。

    1. new DragEvent(type, options)

    DragEvent()构造函数接受两个参数，第一个参数是字符串，表示事件的类型，该参数必须；第二个参数是事件的配置对象，用来设置事件的属性，该参数可选。配置对象除了接受MouseEvent接口和Event接口的配置属性，还可以设置dataTransfer属性要么是，要么是一个DataTransfer接口的实例。

    DataTransfer的实例对象用来读写拖拉事件中传输的数据，详见下文《DataTransfer 接口》的部分。

    所有拖拉事件的实例都有一个DragEvent.dataTransfer属性，用来读写需要传递的数据。这个属性的值是一个DataTransfer接口的实例。

    浏览器原生提供一个DataTransfer()构造函数，用来生成DataTransfer实例对象。

    1. var dataTrans = new DataTransfer();

    DataTransfer()构造函数不接受参数。

    拖拉的数据分成两方面：数据的种类（又称格式）和数据的值。数据的种类是一个 MIME 字符串（比如text/plain、image/jpeg），数据的值是一个字符串。一般来说，如果拖拉一段文本，则数据默认就是那段文本；如果拖拉一个链接，则数据默认就是链接的 URL。

    拖拉事件开始时，开发者可以提供数据类型和数据值。拖拉过程中，开发者通过dragenter和dragover事件的监听函数，检查数据类型，以确定是否允许放下（drop）被拖拉的对象。比如，在只允许放下链接的区域，检查拖拉的数据类型是否为text/uri-list。

    发生drop事件时，监听函数取出拖拉的数据，对其进行处理。

    DataTransfer.dropEffect属性用来设置放下（drop）被拖拉节点时的效果，会影响到拖拉经过相关区域时鼠标的形状。它可能取下面的值。

    • copy：复制被拖拉的节点
    • move：移动被拖拉的节点
    • link：创建指向被拖拉的节点的链接
    • none：无法放下被拖拉的节点
    1. target.addEventListener('dragover', function (e) {
    2.   e.preventDefault();
    3.   e.stopPropagation();
    4.   e.dataTransfer.dropEffect = 'copy';
    5. });

    上面代码中，被拖拉元素一旦drop，接受的区域会复制该节点。

    dropEffect属性一般在dragenter和dragover事件的监听函数中设置，对于dragstart、drag、dragleave这三个事件，该属性不起作用。因为该属性只对接受被拖拉的节点的区域有效，对被拖拉的节点本身是无效的。进入目标区域后，拖拉行为会初始化成设定的效果。

    DataTransfer.effectAllowed

    DataTransfer.effectAllowed属性设置本次拖拉中允许的效果。它可能取下面的值。

    • copy：复制被拖拉的节点
    • move：移动被拖拉的节点
    • link：创建指向被拖拉节点的链接
    • copyLink：允许copy或link
    • copyMove：允许copy或move
    • linkMove：允许link或move
    • all：允许所有效果
    • none：无法放下被拖拉的节点
    • uninitialized：默认值，等同于all

    如果某种效果是不允许的，用户就无法在目标节点中达成这种效果。

    这个属性与dropEffect属性是同一件事的两个方面。前者设置被拖拉的节点允许的效果，后者设置接受拖拉的区域的效果，它们往往配合使用。

    dragstart事件的监听函数，可以用来设置这个属性。其他事件的监听函数里面设置这个属性是无效的。

    只要dropEffect属性和effectAllowed属性之中，有一个为none，就无法在目标节点上完成drop操作。

    DataTransfer.files

    DataTransfer.files属性是一个 FileList 对象，包含一组本地文件，可以用来在拖拉操作中传送。如果本次拖拉不涉及文件，则该属性为空的 FileList 对象。

    下面就是一个接收拖拉文件的例子。

    1. // HTML 代码如下
    2. // <div id="output" style="min-height: 200px;border: 1px solid black;">
    3. //   文件拖拉到这里
    4. // </div>
    6. var div = document.getElementById('output');
    8. div.addEventListener("dragenter", function( event ) {
    9.   div.textContent = '';
    10.   event.stopPropagation();
    11.   event.preventDefault();
    12. }, false);
    14. div.addEventListener("dragover", function( event ) {
    15.   event.stopPropagation();
    16.   event.preventDefault();
    17. }, false);
    19. div.addEventListener("drop", function( event ) {
    20.   event.stopPropagation();
    21.   event.preventDefault();
    22.   var files = event.dataTransfer.files;
    23.   for (var i = 0; i < files.length; i++) {
    24.     div.textContent += files[i].name + ' ' + files[i].size + '字节\n';
    25.   }
    26. }, false);

    上面代码中，通过dataTransfer.files属性读取被拖拉的文件的信息。如果想要读取文件内容，就要使用FileReader对象。

    1. div.addEventListener('drop', function(e) {
    2.   e.preventDefault();
    3.   e.stopPropagation();
    5.   var fileList = e.dataTransfer.files;
    6.   if (fileList.length > 0) {
    7.     var file = fileList[0];
    8.     var reader = new FileReader();
    9.     reader.onloadend = function(e) {
    10.       if (e.target.readyState === FileReader.DONE) {
    11.         var content = reader.result;
    12.         div.innerHTML = 'File: ' + file.name + '\n\n' + content;
    13.       }
    14.     }
    15.     reader.readAsBinaryString(file);
    16.   }
    17. });

    DataTransfer.types属性是一个只读的数组，每个成员是一个字符串，里面是拖拉的数据格式（通常是 MIME 值）。比如，如果拖拉的是文字，对应的成员就是text/plain。

    下面是一个例子，通过检查dataTransfer属性的类型，决定是否允许在当前节点执行drop操作。

    1. function contains(list, value){
    2.   for (var i = 0; i < list.length; ++i) {
    3.     if(list[i] === value) return true;
    4.   }
    5.   return false;
    6. }
    7. function doDragOver(event) {
    8.   var isLink = contains(event.dataTransfer.types, 'text/uri-list');
    9.   if (isLink) event.preventDefault();
    10. }

    上面代码中，只有当被拖拉的节点是一个链接时，才允许在当前节点放下。

    DataTransfer.items

    DataTransfer.items属性返回一个类似数组的只读对象（DataTransferItemList 实例），每个成员就是本次拖拉的一个对象（DataTransferItem 实例）。如果本次拖拉不包含对象，则返回一个空对象。

    DataTransferItemList 实例具有以下的属性和方法。

    • length：返回成员的数量
    • add(data, type)：增加一个指定内容和类型（比如text/html和）的字符串作为成员
    • add(file)：add方法的另一种用法，增加一个文件作为成员
    • remove(index)：移除指定位置的成员
    • clear()：移除所有的成员

    DataTransferItem 实例具有以下的属性和方法。

    • kind：返回成员的种类（string还是file）。
    • type：返回成员的类型（通常是 MIME 值）。
    • getAsFile()：如果被拖拉是文件，返回该文件，否则返回null。
    • getAsString(callback)：如果被拖拉的是字符串，将该字符传入指定的回调函数处理。该方法是异步的，所以需要传入回调函数。

    下面是一个例子。

    1. div.addEventListener('drop', function (e) {
    2.   e.preventDefault();
    3.   if (e.dataTransfer.items != null) {
    4.     for (var i = 0; i < e.dataTransfer.items.length; i++) {
    5.       console.log(e.dataTransfer.items[i].kind + ': ' + e.dataTransfer.items[i].type);
    6.     }
    7.   }
    8. });

    DataTransfer.setData()

    DataTransfer.setData()方法用来设置拖拉事件所带有的数据。该方法没有返回值。

    1. event.dataTransfer.setData('text/plain', 'Text to drag');

    上面代码为当前的拖拉事件加入纯文本数据。

    该方法接受两个参数，都是字符串。第一个参数表示数据类型（比如text/plain），第二个参数是具体数据。如果指定类型的数据在dataTransfer属性不存在，那么这些数据将被加入，否则原有的数据将被新数据替换。

    1. <div draggable="true">
    2.   aaa
    3. </div>

    上面代码中，拖拉这个<div>元素会自动带上文本数据aaa。

    使用setData方法，可以替换到原有数据。

    上面代码中，拖拉数据实际上是bbb，而不是aaa。

    下面是添加其他类型的数据。由于text/plain是最普遍支持的格式，为了保证兼容性，建议最后总是保存一份纯文本格式的数据。

    1. var dt = event.dataTransfer;
    3. // 添加链接
    4. dt.setData('text/uri-list', 'http://www.example.com');
    5. dt.setData('text/plain', 'http://www.example.com');
    7. // 添加 HTML 代码
    8. dt.setData('text/html', 'Hello there, <strong>stranger</strong>');
    9. dt.setData('text/plain', 'Hello there, <strong>stranger</strong>');
    11. // 添加图像的 URL
    12. dt.setData('text/uri-list', imageurl);
    13. dt.setData('text/plain', imageurl);

    可以一次提供多种格式的数据。

    1. var dt = event.dataTransfer;
    2. dt.setData('application/x-bookmark', bookmarkString);
    3. dt.setData('text/uri-list', 'http://www.example.com');
    4. dt.setData('text/plain', 'http://www.example.com');

    上面代码中，通过在同一个事件上面，存放三种类型的数据，使得拖拉事件可以在不同的对象上面，drop不同的值。注意，第一种格式是一个自定义格式，浏览器默认无法读取，这意味着，只有某个部署了特定代码的节点，才可能drop（读取到）这个数据。

    DataTransfer.getData()方法接受一个字符串（表示数据类型）作为参数，返回事件所带的指定类型的数据（通常是用setData方法添加的数据）。如果指定类型的数据不存在，则返回空字符串。通常只有drop事件触发后，才能取出数据。

    下面是一个drop事件的监听函数，用来取出指定类型的数据。

    1. function onDrop(event) {
    2.   var data = event.dataTransfer.getData('text/plain');
    3.   event.target.textContent = data;
    4.   event.preventDefault();
    5. }

    上面代码取出拖拉事件的文本数据，将其替换成当前节点的文本内容。注意，这时还必须取消浏览器的默认行为，因为假如用户拖拉的是一个链接，浏览器默认会在当前窗口打开这个链接。

    getData方法返回的是一个字符串，如果其中包含多项数据，就必须手动解析。

    1. function doDrop(event) {
    2.   var lines = event.dataTransfer.getData('text/uri-list').split('\n');
    3.   for (let line of lines) {
    4.     let link = document.createElement('a');
    5.     link.href = line;
    6.     link.textContent = line;
    7.     event.target.appendChild(link);
    8.   }
    9.   event.preventDefault();
    10. }

    上面代码中，getData方法返回的是一组链接，就必须自行解析。

    类型值指定为URL，可以取出第一个有效链接。

    1. var link = event.dataTransfer.getData('URL');

    下面的例子是从多种类型的数据里面取出数据。

    1. function doDrop(event) {
    2.   var types = event.dataTransfer.types;
    3.   var supportedTypes = ['text/uri-list', 'text/plain'];
    4.   types = supportedTypes.filter(function (value) { types.includes(value) });
    5.   if (types.length) {
    6.     var data = event.dataTransfer.getData(types[0]);
    7.   }
    8.   event.preventDefault();
    9. }

    DataTransfer.clearData()

    DataTransfer.clearData()方法接受一个字符串（表示数据类型）作为参数，删除事件所带的指定类型的数据。如果没有指定类型，则删除所有数据。如果指定类型不存在，则调用该方法不会产生任何效果。

    上面代码清除事件所带的text/uri-list类型的数据。

    该方法不会移除拖拉的文件，因此调用该方法后，DataTransfer.types属性可能依然会返回Files类型（前提是存在文件拖拉）。

    注意，该方法只能在dragstart事件的监听函数之中使用，因为这是拖拉操作的数据唯一可写的时机。

    DataTransfer.setDragImage()

    拖动过程中（dragstart事件触发后），浏览器会显示一张图片跟随鼠标一起移动，表示被拖动的节点。这张图片是自动创造的，通常显示为被拖动节点的外观，不需要自己动手设置。

    DataTransfer.setDragImage()方法可以自定义这张图片。它接受三个参数。第一个是<img>节点或者<canvas>节点，如果省略或为null，则使用被拖动的节点的外观；第二个和第三个参数为鼠标相对于该图片左上角的横坐标和右坐标。

    下面是一个例子。

    1. /* HTML 代码如下
    2.  <div id="drag-with-image" class="dragdemo" draggable="true">
    3.    drag me
    4.  </div>
    5. */
    7. var div = document.getElementById('drag-with-image');
    8. div.addEventListener('dragstart', function (e) {
    9.   var img = document.createElement('img');
    10.   img.src = 'http://path/to/img';
    11.   e.dataTransfer.setDragImage(img, 0, 0);
    12. }, false);