正确做法是隐藏原生<input type="file">(推荐position: absolute; left: -9999px),用自定义按钮绑定onclick并调用其.click()方法触发;必须保留可交互性,禁用pointer-events: none,多文件需添加multiple属性。
<input type="file"> 触发文件选择但不暴露原生按钮直接放一个裸 <input type="file"> 会显示丑陋的系统默认按钮,且样式几乎无法统一控制。正确做法是隐藏原生元素,用自定义按钮触发点击事件。
关键点在于:display: none 或 opacity: 0 都可以隐藏,但必须保留其可交互性(不能加 pointer-events: none),否则 .click() 无效。
position: absolute; left: -9999px 隐藏,避免影响布局又确保可触发onclick 并调用 fileInput.click(),不要用 label[for] —— 它在部分 iOS Safari 下对 multiple 支持不稳定multiple 属性,否则即使 JS 调用也只允许选一个用户选完文件后,得立刻看到数据结构,而不是盲目点击“导入”。这靠 FileReader + 解析库完成,核心是避免全量读取大文件卡死主线程。
对于 CSV:用 PapaParse 的 parse(file, { preview: 10 }) 快速读前 10 行;对于 Excel(.xlsx):用 xlsx 库的 XLSX.read(file, { sheetRows: 10 }) 控制行数。
立即学习“前端免费学习笔记(深入)”;
readAsText() 直接读整个 Excel 文件——二进制格式会报错,必须用 readAsArrayBuffer()
file.type 或后缀名,.xls 和 .xlsx 处理逻辑不同,xlsx 库不支持老式 .xls
<table> 渲染,别套 React/Vue 组件——弹窗场景简单,加框架反而增加首屏延迟用户上传的文件经常字段错位、空行、中文标点逗号、时间格式混用(2024/05/01 vs 2024-05-01)。校验不能只看表头文字是否匹配,得结合类型和样例值。
includes() 不够,要 some(header => header.trim().toLowerCase().includes('phone')),兼容空格和大小写/^1[3-9]d{9}$/,得先 .replace(/[^0-9]/g, '') 清洗括号、短横线、空格Date.parse(str) 判断是否有效,但注意 '2024-05-32' 也会返回 NaN——得额外检查年月日数值合法性row[colIndex] == null || row[colIndex].toString().trim() === ''
fetch 上传文件后接口没收到 FormData 字段常见错误是没设 Content-Type 请求头。当用 FormData 传文件时,**绝对不能手动设置 Content-Type**,否则浏览器无法自动添加 boundary,后端收不到任何字段。
fetch(url, { method: 'POST', body: formData }) —— 让浏览器自己设 headerheaders 里,但避开 Content-Type:{ headers: { 'Authorization': 'Bearer xxx' } }
multer,且路由里要先用 multer().single('file') 或 .fields([...]) 解析,否则 req.body 和 req.file 都是空Content-Type: multipart/form-data; boundary=xxxx
文件编码、跨域、大文件分片这些属于进阶需求,基础导入弹窗先把上面四点跑通,再考虑断点续传或 Web Worker 解析。