multiple 属性必须显式写出且不带值,仅写 multiple 即可;若误写为 multiple="true" 或遗漏,多选功能将失效;FileList 对象需转数组操作,不可直接修改;accept 与 multiple 共存时仅过滤类型,不限制数量。

file input 的 multiple 属性必须显式写出来
HTML 中 <input type="file"> 默认只能选一个文件,要支持多选,multiple 是必需的布尔属性——它不接受值,也不能写成 multiple="true" 或 multiple="1",只写 multiple 就够了。漏掉这个单词,哪怕加了 accept 或样式优化,也完全不起作用。
常见错误是复制粘贴时删掉了它,或者用 JS 动态添加时误写成 el.setAttribute('multiple', 'true'),这会导致浏览器忽略多选行为。
-
<input type="file" multiple>✅ 正确 -
<input type="file" multiple="multiple">⚠️ 兼容但冗余(HTML5 允许,但没必要) -
<input type="file" multiple="true">❌ 多数浏览器当普通字符串处理,不触发多选 -
<input type="file">❌ 单选,无论用户 Ctrl/Cmd 点击多少个都没用
获取 multiple 选中的文件列表要用 files 属性
<input type="file" multiple> 提交后,input.files 返回的是 FileList 对象,不是数组。它类数组、只读、没有 map/filter 方法,直接遍历或转数组是常见需求。
别试图用 input.value 拿路径——现代浏览器出于安全限制,这里只返回空字符串或伪路径(如 C:\fakepath\xxx.jpg),真实路径不可读。
立即学习“前端免费学习笔记(深入)”;
- 正确读取:
const fileList = input.files; // FileList - 转数组方便操作:
Array.from(input.files)或[...input.files] - 单个文件访问:
input.files[0]、input.files.item(0)都可以 - 注意:删除某项不行——
FileList不可变,需自己过滤后重新赋值给其他变量
multiple 在不同浏览器中对 Ctrl/Cmd+Click 的支持一致,但拖拽行为有差异
所有主流浏览器(Chrome/Firefox/Safari/Edge)都支持按住 Ctrl(Windows)或 Cmd(macOS)点击多个文件,也能拖拽多个文件进 input 区域——但 Safari 对拖拽多文件的支持直到 macOS Monterey(12.0)+ Safari 15 才稳定,旧版本可能只取第一个。
移动端(iOS/Android)的 file input 行为更受限:iOS Safari 支持多选照片/视频,但不支持从文件 App 多选;Android 各厂商浏览器差异大,部分只允许单选,即使写了 multiple 也无效。
- 桌面端基本可靠,重点测试 Safari 14 及以下版本的拖拽兼容性
- 移动端建议降级提示:“请选择单个文件” 或改用第三方 SDK(如 Fine Uploader)兜底
- 不要依赖
change事件里e.target.files.length判断是否真多选——用户可能取消选择再重选,长度会变,应以实际files内容为准
搭配 accept 属性时,multiple 不影响类型过滤逻辑
accept 限制的是每个单独文件的 MIME 类型或扩展名,multiple 只控制数量上限。两者共存时,浏览器会先按 accept 过滤可选文件列表,再允许从中多选。
比如 <input type="file" multiple accept=".pdf,.docx">,用户看到的文件对话框里只会显示 PDF 和 DOCX 文件,且能勾选多个;但如果写成 accept="image/*",就无法选中 PDF——哪怕你本意是“图片或 PDF”,必须显式写成 accept="image/*,.pdf"。
-
accept是提示性限制,服务端仍需校验,不能信任前端过滤 - 多个类型用逗号分隔,空格会被忽略,但不要加多余符号如
accept="image/png, image/jpeg"(中间空格可能导致某些 Android 浏览器失效) - 若同时需要多选和拍照,用
accept="image/*" capture="environment",此时multiple依然生效,但部分安卓机型可能禁用多选
multiple 这个词本身,或者以为加了 accept 就自动支持多选。拖拽和移动端表现也容易在上线后才发现不一致。



















