CSS容器查询与:has()实战：告别@media重写商品卡片组件

上个月接手了一个二手商城的前端重构，商品卡片在首页出现了三个位置：左侧侧边栏、中间推荐流、底部的“看了又看”。前同事留下一堆@media，最大的那坨长这样：

@media (min-width: 768px) and (max-width: 1023px) {
  .card-in-sidebar { ... }
  .card-in-main { ... }
  .card-in-bottom { ... }
}

@media (min-width: 1024px) and (max-width: 1366px) {
  .card-in-sidebar { ... }
  .card-in-main { ... }
  .card-in-bottom { ... }
}

看着就头疼。更别扭的是，侧边栏实际宽度是280px，但@media只能判断浏览器视口宽度。视口1024px时侧边栏是280px，视口1366px时侧边栏可能还是280px。也就是说，@media根本不知道组件自己有多宽，它只知道窗口有多宽。

后来我把这套组件用CSS容器查询和:has()重写了一遍，样式代码量直接少了一半，而且每个位置的卡片行为完全由它所在的容器宽度决定，不再互相干扰。

页面级响应式和组件级响应式

传统响应式以页面为单位：屏幕窄了，页面里的所有东西都跟着变。但组件级响应式更贴近现实：同一个卡片组件，在窄侧边栏里应该竖着排，在宽内容区里应该横着排，在底下“看了又看”区域里可能又要变成小图模式。

容器查询就是干这件事的。它允许你为一个元素声明容器，然后容器内部可以查询这个容器自身的尺寸。

容器查询的基本用法

先看一个最核心的声明：

.product-list {
  container-type: inline-size;
  container-name: product-list;
}

container-type: inline-size 告诉浏览器：这个区域的内联轴方向（对水平书写模式来说就是宽度）独立出来，内部元素可以基于它做响应式控制。container-name 是给容器起个名字，避免嵌套时搞混。

然后就能在内部写查询了：

@container product-list (min-width: 480px) {
  .product-card {
    display: grid;
    grid-template-columns: 160px 1fr;
  }
}

意思是：当 .product-list 宽度超过480px时，内部的 .product-card 变成两栏布局。注意，这里完全没有看浏览器窗口是多宽，只看容器自身。

实际案例：商品卡片组件

下面是一张完整的商品卡片HTML结构：

<div class="product-list">
  <article class="product-card">
    <img class="product-card__img" src="https://picsum.photos/seed/a1/400/300" alt="头戴式降噪耳机">
    <div class="product-card__content">
      <h3 class="product-card__title">头戴式降噪耳机</h3>
      <p class="product-card__desc">40mm动圈单元，主动降噪，续航60小时</p>
      <p class="product-card__price">¥799 <del>¥1199</del></p>
      <button class="product-card__btn">立即购买</button>
    </div>
  </article>
</div>

默认情况，也就是容器宽度很小时，卡片竖着排：

.product-card {
  display: flex;
  flex-direction: column;
  gap: 12px;
  padding: 16px;
  background: #fff;
  border-radius: 12px;
}

.product-card__img {
  width: 100%;
  aspect-ratio: 4 / 3;
  object-fit: cover;
  border-radius: 8px;
}

当容器宽度足够时，改成横排：

.product-list {
  container-type: inline-size;
}

@container (min-width: 420px) {
  .product-card {
    flex-direction: row;
    align-items: center;
  }

  .product-card__img {
    width: 180px;
    aspect-ratio: 1;
    flex-shrink: 0;
  }
}

这样写的好处是，.product-list 放在侧边栏还是内容区，卡片自己会适配。如果侧边栏横向窄，它就一直竖着；如果哪天产品经理把侧边栏加宽到了700px，卡片会自动变横板，不需要去改media query。

:has() 让我删掉了一堆状态class

容器查询解决了组件尺寸的响应式，:has() 解决的是组件状态的响应式。

以前我们判断一个卡片是不是“活动商品”，可能要给它加一个类：

<article class="product-card product-card--hot">

然后在CSS里写 .product-card--hot .product-card__btn。加上:has()以后，可以直接看卡片内部有没有某个元素：

.product-card:has(.product-card__tag) {
  border: 1px solid #ff5900;
}

.product-card:has(.product-card__tag--flash) .product-card__btn {
  background: #ff5900;
  color: #fff;
}

对应HTML只要写成：

<article class="product-card">
  <img class="product-card__img" src="..." alt="...">
  <span class="product-card__tag product-card__tag--flash">闪购</span>
  <div class="product-card__content">
    ...
  </div>
</article>

有“闪购”标签，按钮自动变成橙色。没有这个标签，就是默认按钮。这样就不用在模板里写一堆“判断有没有标签然后再拼class”的逻辑了。

还有一个日常场景很实用：有的卡片需要点击整卡跳转，我希望在按钮获得键盘焦点时，整张卡片出现一个外边框，方便键盘用户。用:has()可以这样写：

.product-card:has(.product-card__btn:focus-visible) {
  box-shadow: 0 0 0 3px rgba(0, 120, 255, 0.3);
}

放在以前，你得给卡片也绑定一个focus事件，或者在按钮focus时用js去给父级加类。现在选择器就能搞定。

容器查询和:has()一起用

更舒服的是，这俩能组合在一个条件里。比如：容器宽度超过420px，同时卡片里存在“闪购”标签，才显示标签右侧的倒计时区域。

@container (min-width: 420px) {
  .product-card:has(.product-card__tag--flash) .product-card__countdown {
    display: block;
  }

  .product-card__countdown {
    display: none;
  }
}

这样逻辑非常清晰：尺寸变化由容器查询管，状态变化由:has()管，两个都是纯CSS，不需要JS参与。

我用这个组合重构了购物车列表的选中态：

.cart-item:has(.cart-item__check:checked) {
  background: #f7f7f7;
  opacity: 0.7;
}

勾选框选中，整一行自动变灰，而且钩子是天然的可访问性结构，不是自定义的模拟样式。这块逻辑以前要在JS里监听change事件，再去操作classList，现在十几行CSS就结束了。

兼容性和降级

容器查询在Chrome 105、Firefox 110、Safari 16都开始支持。:has()在Chrome 105、Safari 15.4、Firefox 121开始支持。现在用得比较稳了。

不过为了保险，我会在关键布局上写一个降级：

@supports (container-type: inline-size) {
  .product-list {
    container-type: inline-size;
  }

  @container (min-width: 420px) {
    .product-card {
      flex-direction: row;
    }
  }
}

浏览器不支持容器查询时，卡片保持默认的竖排，只是少了一点横版效果，不影响核心功能。

最后说几句实操感受

• 容器查询是给组件做响应式，media query是给页面做响应式。两者不是替代关系，是不同维度的工具。
• 给容器起名字很关键，尤其是页面里嵌了好几层容器的时候，用名字不会串。
• :has() 能省很多JS状态class，但别什么选择器都拿它写。简单场景优先用原生交互选择器，:hover、:focus-within这些。
• 性能方面，只要不是嵌套十层容器查询，一般页面体感不到开销。真遇到复杂情况，可以用container-type: inline-size + normal来限制范围。

重构完之后，我把原计划要写的响应用户点击的JS全删了。产品经理后来还改了一次页面布局，把同一个卡片从侧边栏挪到了底部，我只改了一个容器位置，卡片样式原封不动。这种感觉，比写一堆@media舒服太多了。