HTML5 有哪些 drag 相关的 API ?
参考答案
HTML5 拖放(Drag and Drop)是一套事件 + DataTransfer 对象的 API。
源元素(被拖动)
- 设置
draggable="true"(img、a默认可拖,其他元素要显式开启); - 事件:
dragstart:开始拖动,唯一可以写数据的时机;drag:拖动过程中连续触发(高频,别做重活);dragend:结束(无论成功失败),用于复位 UI。
目标元素(放置区)
dragenter:进入,需preventDefault()才可能接收;dragover:停留时连续触发,**必须e.preventDefault()** 才能允许 drop(最容易漏的一步);dragleave:离开(注意子元素会触发,需计数或判断 relatedTarget);drop:放下,读取数据,同样需在dragover里 preventDefault。
DataTransfer 对象
source.addEventListener('dragstart', e => {
e.dataTransfer.setData('text/plain', 'item-1');
e.dataTransfer.effectAllowed = 'copy'; // copy / move / link / all
e.dataTransfer.setDragImage(img, 10, 10); // 自定义拖影
});
target.addEventListener('dragover', e => { e.preventDefault(); e.dataTransfer.dropEffect = 'copy'; });
target.addEventListener('drop', e => {
e.preventDefault();
const text = e.dataTransfer.getData('text/plain');
const files = e.dataTransfer.files; // 从系统拖入文件
});
相关能力与限制
- 支持拖入外部文件(
dataTransfer.files)、拖出到系统(DownloadURL);items可读多类型(text/uri-list、text/html、Files); - 自定义 MIME 类型可携带结构化数据(同源内有效);
- 移动端浏览器对原生 drag 支持差,一般用
touchstart/move/end或指针事件自己实现; - 拖拽期间无法读
dataTransfer数据(安全限制,只在drop可getData); - 辅助技术(键盘/无障碍)不支持,需要提供替代操作。