SuperAPI AI 工具集

dimensions

前端与建站

查看项目

更新于 10-16 06:16

技能介绍

用途:这是前端检查清单中的一条图片规则,用于审查与“为图片设置明确 width 和 height”相关的图片资源、HTML 标记以及 CDN 或构建转换。

主要能力:扫描代码库中的 img 元素,找出缺失 width 或 height 属性的图片,并报告文件路径与行号;同时检查 picture 元素内的图片(尺寸应设在 img 回退上)。修复时按图片固有像素尺寸补充属性,例如 width="800" height="450",并配合 CSS 的 max-width: 100% 与 height: auto 保持响应式。属性值必须与图片固有宽高比一致,不能随意填占位值;动态尺寸图片可用 CSS aspect-ratio 作为回退。

使用方式:先检查再修复,并展示每张已修复图片修改前后的 HTML。该规则也用于代码评审,指出格式选择、尺寸或加载行为违规的具体文件或组件,并说明如何在 DevTools 中确认修复。完整实现细节、代码示例和框架相关指导见 references/rule.md。规则页面:https://frontendchecklist.io/en/rules/images/dimensions

适用场景与限制:图片缺少明确尺寸是图片导致 CLS 的常见原因,CLS 高于 0.1 视为“需要改进”,高于 0.25 视为“差”。应只为有意义的内容图片报告问题;装饰性微 SVG 或纯装饰资源在 CSS 已保留稳定空间时属于低优先级例外,例如 <img src="/divider.svg" alt="" aria-hidden="true"> 若无可见布局偏移证据不应单独标记。32px 以下的 SVG 图标、CSS 尺寸稳定的微小装饰 SVG 以及作为 CSS 背景加载的图片豁免。