必须同时支持srcset+sizes和,否则Safari 15.6、旧Android WebView或弱网设备易白屏;src需指向≤800px的JPG/PNG兜底图,srcset用真实宽度w描述符,sizes须匹配CSS布局,仅用于格式降级或艺术方向,AVIF放首位,type写全MIME,不可省略且路径必须有效。

博客主题必须同时支持 srcset+sizes 响应式选图 和 格式降级,否则在 Safari 15.6、旧版 Android WebView 或弱网设备上大概率出现白屏或模糊图——这不是体验问题,是渲染失败。
主题模板里怎么写 ![]()
才真正生效
不能只靠 CSS 的 max-width: 100% 或 JS 动态插入;浏览器预加载器在 DOM 解析阶段就要拿到足够信息。主题中所有正文图片(尤其是首屏)必须用原生 HTML 属性驱动选择逻辑:
-
src必须存在,且指向一个已压缩、尺寸适中(建议 ≤800px 宽)、格式为.jpg或.png的兜底图——它不是“备选”,而是 IE11、旧 WebView、CSP 严格模式下的唯一加载入口 -
srcset按w描述符写,例如"photo-480w.jpg 480w, photo-800w.jpg 800w, photo-1200w.jpg 1200w";每个值必须和原图真实宽度完全一致,不能估算 -
sizes必须匹配实际 CSS 布局,比如文章容器是max-width: 720px,那 sizes 就不能写成"100vw",而应是"(max-width: 720px) 100vw, 720px" - 别在
srcset里混用x和w,老版 Safari 会直接忽略整条属性
在主题中该不该用、怎么用
要用,但仅限两类场景:现代格式(WebP/AVIF)主动降级、艺术方向裁剪(如移动端竖构图+桌面端横构图)。普通博客图不用它做分辨率适配——那是 srcset 的事。
- AVIF 必须放在第一个
,WebP 次之,必须是最后一个子元素且不可省略
-
type值必须写全 MIME 类型:"image/avif",不能简写为"avif"或"avif/webp" - 所有
srcset路径必须真实可访问,哪怕只是占位图;若某返回 404,浏览器不会跳到下一个,只会静默失败,最终依赖 - IE 完全不识别
,但它会渲染内部的——所以只要可用,IE 就不会白屏
主题构建时容易被忽略的兼容性硬伤
很多主题在本地开发时一切正常,上线后在 iOS 15.6、Android 8 WebView 或某些 CDN 缓存策略下崩掉,原因往往藏在细节里:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
-
sizes字符串里不能有空格以外的空白符(比如换行、制表符),某些旧解析器会截断;写成一行更稳妥:sizes="(max-width: 480px) 100vw, (max-width: 768px) 50vw, 33vw" - WordPress 主题常通过
wp_get_attachment_image_srcset()自动生成srcset,但若上传图本身宽度过小(如只有 600px),函数仍可能输出1200w项——这会导致浏览器选错源,需配合max_srcset_image_width过滤 - CDN 开启 WebP 自动转码时,不要让
实际返回 AVIF;MIME 类型不匹配会触发解码失败,且不会 fallback 到
- 懒加载(
loading="lazy")和srcset不冲突,但不要给首屏关键图加,否则预加载器无法提前决策
如何验证主题是否真正可靠
别只看 Chrome DevTools 的 Network 面板——它默认启用 DPR 模拟,会掩盖真实 fallback 行为:
- 用真机测试:iOS 15.6 Safari、Android 8 Chrome,禁用缓存后刷新,观察是否加载了
src图 - 在 Chrome 中打开
chrome://flags/#enable-experimental-web-platform-features关闭 AVIF 支持,再刷新,确认是否退到 WebP 或 JPG - 用 curl 检查响应头:
curl -I https://yoursite.com/photo.avif看Content-Type: image/avif是否准确 - 把
的src临时改成 404 地址,看是否显示 alt 文本——如果显示,说明结构或位置错了
最常出问题的不是语法,而是路径管理:主题里生成的 srcset 路径经常漏掉 CDN 域名前缀,或没处理 WordPress 的子目录安装路径,导致资源 404 后整个降级链失效。这点必须在构建时做字符串校验,不能依赖运行时 JS 补救。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










