accept 和 exts 仅筛选文件类型,不参与图标渲染;图标需在 templet 或 choose 回调中通过后缀或 type 手动匹配,推荐优先用 file.name 提取后缀并结合正则判断。

accept 和 exts 不负责图标渲染,只是筛选入口
很多人以为配了 accept: 'file' 或 exts: 'pdf|zip' 就能自动显示对应图标——其实它们只影响文件选择框里能选什么,跟后续预览、图标展示完全无关。Layui upload 模块本身不内置“按类型换图标”逻辑,所有图标匹配必须手动写。
真正起作用的是你在 choose 或 templet 里怎么解析 file.name 或 file.type:
-
file.name.split('.').pop().toLowerCase()最稳定,适合提取后缀(如"report.pdf"→"pdf") -
file.type看似更“标准”,但浏览器兼容差:Chrome 对.xlsx常返回空字符串,Safari 对某些自定义后缀也失效 - 推荐组合判断:先查
file.type是否以image/、video/、audio/开头;为空时再 fallback 到后缀匹配
templet 是最直接的图标控制点
如果你用 layui.table 或 layui.upload 的列表模式展示已选文件,templet 回调就是改图标的唯一可控出口。别指望 preview 回调——它只对图片生效,且 Layui 2.8+ 才支持,PDF、ZIP、MP4 全都不走这条路。
示例(放在列配置中):
templet: function(d) {
const ext = d.file.name.split('.').pop().toLowerCase();
let icon = 'layui-icon-file';
if (/^jpe?g|png|gif|bmp|svg$/i.test(ext)) {
icon = 'layui-icon-picture';
} else if (/^pdf$/i.test(ext)) {
icon = 'layui-icon-file-bord'; // 注意不是 file-board
} else if (/^zip|rar|7z|tar\.gz$/i.test(ext)) {
icon = 'layui-icon-template';
} else if (/^mp4|avi|mov$/i.test(ext)) {
icon = 'layui-icon-video';
}
return '<i class="layui-icon ' + icon + '"></i> ' + d.file.name;
}
关键细节:
-
layui-icon-file-bord是 PDF 专用图标类名,拼错就变空白方块 -
layui-icon-template虽非官方语义,但社区通用作压缩包图标,别硬套layui-icon-file-zip(不存在) - 正则里
tar\.gz的点要转义,否则匹配失败
choose 回调里也能提前处理图标,但得自己拼 DOM
如果不用表格,而是用 layui-upload-list 这种原生列表,choose 是你唯一能干预预览内容的地方。这里不能靠 templet,得手动创建 <i> 标签并插入到列表容器中。
常见操作顺序:
- 在
choose中遍历obj.files(注意它不是数组,要用Array.from(obj.files)或for (let i = 0; i ) - 对每个
file提取后缀或 type,决定图标 class - 生成 HTML 字符串:
<i class="layui-icon layui-icon-picture"></i> avatar.jpg - 追加到
layui-upload-list容器内(比如$('#uploadList').append(html))
注意:别在 choose 里调 obj.upload(),否则文件立刻上传,你刚拼好的 DOM 可能被后续逻辑覆盖或清空。
图标颜色和状态样式得靠额外 CSS 控制
光换图标 class 不够,不同文件类型往往需要不同颜色或尺寸。Layui 的 templet 不允许写内联 style,但可以加自定义 class,再用 CSS 处理。
比如在 templet 里返回:
<i class="layui-icon layui-icon-file-bord file-pdf"></i>
然后在页面 <head> 或全局样式里补上:
.file-pdf { color: #d32f2f; font-size: 22px; }
.file-zip { color: #1976d2; }
容易被忽略的一点:这些 CSS 必须在 Layui 初始化前就加载好,否则第一次渲染时图标还是默认灰黑色——因为 class 已经加上了,但样式还没生效。


















