拖拽区域必须加 draggable="false" 和 tabindex="0",否则键盘与屏幕阅读器不可用且触发系统文本拖拽;dragover 必须 preventDefault() 否则 drop 不触发;dataTransfer.files 需转真数组;移动端 Safari 不支持拖拽事件,须降级为 input[type=file]。

拖拽区域必须加 draggable="false" 和 tabindex="0"
不加这两个属性,键盘用户无法聚焦,屏幕阅读器识别不了功能意图,鼠标划过文字还会触发系统级文本拖拽,直接干扰 这是最常踩的坑:只绑了 别在移动端依赖拖拽事件。Safari 完全不触发 真正难的不是写对拖拽,而是让同一套逻辑在桌面 Safari、Chrome、Firefox 和移动端所有环境都稳住——尤其是 drop 行为。浏览器默认把普通 draggable="false" 是显式声明“我不参与拖拽源,但我可以接收”;tabindex="0" 让它能被 Tab 键选中,空格/回车可触发文件选择——这是无障碍刚需,不是可选项。
dragover 里不调 preventDefault(),drop 就不会触发drop 监听,却漏掉 dragover 的拦截。浏览器默认行为是打开文件或跳转页面,不阻止它,松手瞬间就走了。而且 dragover 每 30–50ms 触发一次,里面别做重操作(比如读取 FileList 或渲染预览),否则 UI 卡顿。正确写法就是一行:e.preventDefault();,其他逻辑全挪到 drop 里处理。
dataTransfer.files 是只读类数组,得转成真数组才能用 map/filter
event.dataTransfer.files 返回的是 FileList,不是 Array,直接调 .map() 会报 TypeError: files.map is not a function。转换方式只有两种可靠:Array.from(e.dataTransfer.files) 或 [...e.dataTransfer.files]。过滤大文件建议用 file.size(同步获取),别等 FileReader 异步读完再判断;校验类型别只信 file.type,后缀可伪造,前端仅作快速拦截,服务端必须二次校验。移动端 Safari 不支持
dragenter/dragover,必须降级到
dragenter 和 dragover,所以整个拖拽逻辑必须包裹在 if ('draggable' in document.createElement('span')) 判断里,不支持时隐藏拖拽区,改用 ,再用 JS 调 document.getElementById('fallback-input').click() 触发原生选择器。同时记得设好 accept、multiple 和 name,因为后端解析字段名(如 req.files.upload)必须严格匹配。preventDefault() 的时机、FileList 的转换、以及降级路径是否彻底兜底。漏掉任意一环,上传就静默失败。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











