容器查询生成器
按组件自身宽度做响应式,不再依赖视口
.card-list,同时作为 container-name 供 @container 引用。如何使用本工具
- 在左侧填容器类名,例如 card-list;这个类要加在真正限制宽度的父元素上。
- container-type 一般选 inline-size,只按宽度查询;需要同时按高度查才选 size。
- 断点按「宽度=列数」写,例如 480=2, 768=3, 1024=4,最窄档默认 1 列不用写。
- 复制右侧 CSS,把 .card-grid 放到容器内部当网格层;容器自己不能被自己的 @container 命中。
- 需要居中或间距微调时用 cqi 单位,1cqi 等于容器宽度的 1%,比 vw 更贴近组件实际宽度。
常见问题
Q:容器查询和媒体查询到底差在哪?
A:媒体查询看的是视口宽度,容器查询看的是最近一个声明了 container-type 的祖先元素宽度。同一个卡片组件放在侧边栏和主内容区,宽度差一倍,媒体查询给出的断点是一样的,容器查询能各自适配。这是组件级响应式和页面级响应式的根本区别。
Q:为什么我的 @container 完全不生效?
A:三个原因占九成:一是祖先上没有 container-type,二是查询写在了容器自己身上(容器不能被自己命中,必须写在子元素),三是浏览器太老 —— Chrome 105、Safari 16、Firefox 110 才支持。检查时先看祖先有没有 container-type,再看选择器层级。
Q:container-type: size 有什么坑?
A:size 会强制元素在块轴方向形成包含块,如果父级高度是 auto,容器高度会塌成 0,height 相关的查询就全部失效,栅格还会错位。除非确实要按高度查询,否则一律用 inline-size。
Q:cqi 和 cqw 有什么区别?
A:cqw 是容器宽度的 1%,cqh 是高度的 1%,cqi 是 inline 轴(横排就是宽),cqb 是 block 轴(横排就是高)。写响应式字号用 cqi 最稳,因为它在竖排书写模式下会自动跟着书写方向走。还有 cqmin / cqmax 取两者较小和较大值。
Q:容器查询能替代媒体查询吗?
A:不能完全替代。容器查询解决的是组件内部布局,页面级的整体断点、导航折叠、打印样式这些还是媒体查询更合适。实际项目里两者混用:媒体查询管页面骨架,容器查询管组件内部。
Q:为什么推荐 grid-template-columns: minmax(0, 1fr)?
A:默认的 1fr 最小宽度是 auto,遇到超长英文单词或 pre 标签会被撑破,格子宽度溢出容器。写成 minmax(0, 1fr) 把最小宽度锁成 0,配合子元素的 overflow 处理才能正确收缩。这是 grid 和 flex 都常见的坑。