学完这篇,你就能把「靠屏幕宽度判断布局」的媒体查询,换成「按组件自身宽度判断」的容器查询,让同一个卡片组件在侧栏、主栏、全宽三种位置自动切换形态,而不用写三套样式。
第一步:先理解它解决什么问题
媒体查询看的是视口宽度,容器查询看的是父容器宽度。区别很实在:同一个 .card 组件放在 980px 宽的主栏里应该横向图文并排,放在 300px 宽的侧栏里应该竖排堆叠。用媒体查询你只能写 .sidebar .card { ... } 这种位置耦合的选择器,组件一旦挪位置就崩。
容器查询的做法是:卡片自己声明「我是一个可被查询的容器」,然后内部样式根据卡片拿到的宽度自己变形。组件在哪儿都对。
第二步:给容器声明 container-type
在你的卡片外层元素上写:
.card {
container-type: inline-size;
container-name: card;
}
container-type: inline-size 表示「按内联轴(横向)尺寸建立查询容器」,日常 99% 的场景用这个。
container-name: card 给容器起个名字,方便后面精确匹配。可以简写成一行:
.card {
container: card / inline-size;
}
注意:container-type 必须写在容器自身上,而 @container 里写的样式只能作用于它的后代元素。元素不能查询自己,想在卡片宽度变化时改 .card 自己的样式,得在外面再套一层 wrapper 当容器。
第三步:写 @container 规则
语法和媒体查询几乎一样,只是把 @media 换成 @container,后面跟容器名和条件:
/* 默认:窄容器下的竖排布局(移动优先,先写基础样式) */
.card__inner {
display: flex;
flex-direction: column;
gap: 12px;
}
/* 容器宽度 ≥ 420px 时,切换成左图右文 */
@container card (min-width: 420px) {
.card__inner {
display: grid;
grid-template-columns: 160px 1fr;
gap: 20px;
}
.card__title {
font-size: 20px;
}
}
如果页面里只有一个容器层级,容器名可以省略,写成 @container (min-width: 420px),它会匹配最近的匿名容器。但项目一复杂就容易命中错的那个,建议始终命名。
第四步:用容器查询单位做流式排版
容器查询还带来一组新单位:cqw(容器宽度的 1%)、cqh、cqi(内联轴)、cqb(块轴)、cqmin、cqmax。它们让字号能跟着卡片缩放,而不是跟着屏幕:
.card__title {
font-size: clamp(16px, 5cqi, 24px);
}
容器宽 300px 时字号约 15px 并受 clamp 下限保护,容器宽 600px 时到 24px 封顶。比一堆断点干净得多。
注意:cqi 这类单位只在该元素存在祖先查询容器时才有值,否则会退回视口单位(小容器单位),表现和你预期不同。用之前确认祖先链上有 container-type。
第五步:处理兼容与降级
容器查询目前 Chrome 105+、Safari 16+、Firefox 110+ 均支持,但老设备仍在。策略很简单:基础样式写成最窄布局,容器查询只做「变宽」的增强。这样不支持的浏览器拿到的是单列堆叠版,能用,只是不炫。
需要更严谨时可以加:
@supports (container-type: inline-size) {
/* 只在支持容器查询时加载的增强样式 */
}
容易踩的三个坑
注意:container-type: inline-size 会触发尺寸包含(containment),元素宽度不再由内容撑开。把这样的卡片直接丢进 flex 行里,如果不给 flex: 1 1 260px 或明确的 width/min-width,它可能被压成一条线。以前靠内容自动撑宽的写法,在这会失效。
注意:container-type: size 表示同时可查询宽高,代价是元素高度也必须由外部决定(内容不再撑高),除非你确实需要 min-height 查询,否则别用。
注意:嵌套容器时,@container card (...) 匹配的是最近的同名祖先容器。如果你在卡片里又嵌了卡片,内层规则可能命中外层的容器,多套一层不同名字可以规避。
小结
- 容器查询 = 按父容器尺寸写样式,让组件摆脱「位置耦合」,真正可复用。
- 三步走:容器上
container: 名字 / inline-size; → 子元素写默认样式 → @container 名字 (min-width: X) 做增强。
- 元素查不了自己,要改容器本身样式就加一层 wrapper。
- 排版单位用
cqi + clamp(),跟着卡片缩放比断点更自然。
- 降级靠「基础样式 = 最窄布局」,媒体查询继续负责页面级骨架,容器查询负责组件级变形,两者分工不冲突。