CSS 容器查询：组件级响应式设计

代码如诗，容器如画。让我们用容器查询的强大能力，创建真正自适应的组件。

什么是容器查询？

容器查询（Container Queries）是 CSS 中一项革命性的特性，它允许我们根据元素的容器大小而不是视口大小来应用样式。这意味着我们可以创建真正独立、自包含的组件，它们能够根据所在容器的尺寸自动调整布局和样式。

为什么需要容器查询？

传统的媒体查询（Media Queries）基于视口大小，但在现代 Web 开发中，组件可能被放置在各种不同大小的容器中。容器查询解决了这个问题，让组件能够根据其实际可用空间做出响应。

/* 传统方式 - 基于视口 */
@media (min-width: 768px) {
  .card { /* 样式 */ }
}

/* 容器查询 - 基于容器 */
@container (min-width: 300px) {
  .card { /* 样式 */ }
}

基础语法

1. 定义容器

首先需要在父元素上定义容器类型：

/* 定义容器 - 基于内联尺寸（宽度） */
.card-container {
  container-type: inline-size;
}

/* 定义容器 - 基于尺寸（宽度和高度） */
.card-container {
  container-type: size;
}

/* 命名容器 */
.card-container {
  container-type: inline-size;
  container-name: card;
}

/* 简写形式 */
.card-container {
  container: card / inline-size;
}

2. 容器查询

使用 @container 规则定义容器查询：

/* 基本容器查询 */
@container (min-width: 300px) {
  .card {
    display: flex;
    flex-direction: row;
  }
}

/* 使用命名的容器 */
@container card (min-width: 300px) {
  .card {
    display: flex;
    flex-direction: row;
  }
}

/* 范围查询 */
@container (300px <= width < 600px) {
  .card {
    padding: 1rem;
  }
}

实际应用示例

1. 自适应卡片

<div class="card-wrapper">
  <div class="card">
    <img src="image.jpg" alt="图片">
    <div class="card-content">
      <h3>卡片标题</h3>
      <p>卡片描述内容...</p>
    </div>
  </div>
</div>

.card-wrapper {
  container-type: inline-size;
  container-name: card-wrapper;
}

.card {
  display: flex;
  flex-direction: column;
  gap: 1rem;
  padding: 1rem;
  border: 1px solid #e0e0e0;
  border-radius: 8px;
}

.card img {
  width: 100%;
  height: 200px;
  object-fit: cover;
  border-radius: 4px;
}

/* 容器宽度 >= 300px 时 */
@container card-wrapper (min-width: 300px) {
  .card {
    flex-direction: row;
    align-items: center;
  }
  
  .card img {
    width: 120px;
    height: 120px;
  }
}

/* 容器宽度 >= 500px 时 */
@container card-wrapper (min-width: 500px) {
  .card {
    padding: 1.5rem;
  }
  
  .card img {
    width: 150px;
    height: 150px;
  }
  
  .card-content h3 {
    font-size: 1.5rem;
  }
}

2. 响应式导航

<nav class="nav-container">
  <div class="logo">Logo</div>
  <ul class="nav-menu">
    <li><a href="#">首页</a></li>
    <li><a href="#">产品</a></li>
    <li><a href="#">服务</a></li>
    <li><a href="#">关于</a></li>
  </ul>
</nav>

.nav-container {
  container-type: inline-size;
  container-name: navigation;
  display: flex;
  justify-content: space-between;
  align-items: center;
  padding: 1rem;
  background: #f8f9fa;
}

.nav-menu {
  display: flex;
  gap: 1.5rem;
  list-style: none;
  margin: 0;
  padding: 0;
}

/* 容器宽度 < 400px 时 - 垂直布局 */
@container navigation (max-width: 399px) {
  .nav-container {
    flex-direction: column;
    gap: 1rem;
  }
  
  .nav-menu {
    flex-direction: column;
    align-items: center;
    gap: 0.5rem;
  }
}

/* 容器宽度 >= 400px 时 - 水平布局 */
@container navigation (min-width: 400px) {
  .nav-container {
    flex-direction: row;
  }
  
  .nav-menu {
    flex-direction: row;
  }
}

3. 产品网格

<div class="product-grid">
  <div class="product-card">
    <img src="product1.jpg" alt="产品1">
    <h3>产品 1</h3>
    <p class="price">¥199</p>
    <button>加入购物车</button>
  </div>
  <!-- 更多产品卡片 -->
</div>

.product-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(250px, 1fr));
  gap: 1.5rem;
}

.product-card {
  container-type: inline-size;
  container-name: product;
  border: 1px solid #e0e0e0;
  border-radius: 8px;
  overflow: hidden;
}

.product-card img {
  width: 100%;
  height: 200px;
  object-fit: cover;
}

.product-card h3 {
  padding: 0.75rem;
  margin: 0;
  font-size: 1.1rem;
}

.product-card .price {
  padding: 0 0.75rem;
  margin: 0;
  color: #667eea;
  font-weight: bold;
}

.product-card button {
  width: calc(100% - 1.5rem);
  margin: 0.75rem;
  padding: 0.5rem;
  background: #667eea;
  color: white;
  border: none;
  border-radius: 4px;
}

/* 容器宽度 >= 300px 时 */
@container product (min-width: 300px) {
  .product-card h3 {
    font-size: 1.25rem;
  }
  
  .product-card button {
    padding: 0.75rem;
  }
}

/* 容器宽度 >= 400px 时 */
@container product (min-width: 400px) {
  .product-card {
    display: flex;
    flex-direction: column;
  }
  
  .product-card img {
    height: 250px;
  }
  
  .product-card h3 {
    font-size: 1.5rem;
    padding: 1rem;
  }
  
  .product-card .price {
    padding: 0 1rem;
    font-size: 1.25rem;
  }
  
  .product-card button {
    margin: 1rem;
    padding: 1rem;
    font-size: 1.1rem;
  }
}

高级用法

1. 嵌套容器查询

/* 外层容器 */
.page-container {
  container-type: inline-size;
  container-name: page;
}

/* 内层容器 */
.sidebar {
  container-type: inline-size;
  container-name: sidebar;
}

/* 外层查询 */
@container page (min-width: 800px) {
  .layout {
    display: grid;
    grid-template-columns: 250px 1fr;
  }
}

/* 内层查询 */
@container sidebar (min-width: 200px) {
  .sidebar-content {
    padding: 1.5rem;
  }
}

2. 容器查询单位

/* 使用容器查询单位 */
.responsive-text {
  font-size: clamp(1rem, 5cqi, 2rem); /* cqi = 容器内联尺寸百分比 */
}

.responsive-padding {
  padding: 2cqi; /* 基于容器宽度的内边距 */
}

.responsive-gap {
  gap: 1cqb; /* cqb = 容器块级尺寸百分比 */
}

3. 样式查询

/* 基于容器样式的查询 */
@container style(--theme: dark) {
  .card {
    background: #1a1a1a;
    color: white;
  }
}

@container style(--theme: light) {
  .card {
    background: white;
    color: #1a1a1a;
  }
}

与媒体查询的结合

/* 视口级别的响应式 */
@media (min-width: 768px) {
  .main-layout {
    display: grid;
    grid-template-columns: 200px 1fr;
  }
}

/* 组件级别的响应式 */
.card-container {
  container-type: inline-size;
}

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

浏览器兼容性

浏览器	支持情况
Chrome	✅ 105+
Edge	✅ 105+
Safari	✅ 16+
Firefox	✅ 110+

最佳实践

1. 渐进增强：为不支持容器查询的浏览器提供回退方案
2. 合理命名：为容器提供有意义的名称，提高代码可读性
3. 避免过度嵌套：过多的嵌套容器查询可能影响性能
4. 结合使用：容器查询和媒体查询可以结合使用，各司其职
5. 测试覆盖：在不同容器大小下测试组件的表现

实践案例：创建自适应仪表板

<div class="dashboard">
  <div class="widget stats-widget">
    <h3>统计数据</h3>
    <div class="stats-grid">
      <div class="stat-item">
        <span class="number">1,234</span>
        <span class="label">用户</span>
      </div>
      <div class="stat-item">
        <span class="number">567</span>
        <span class="label">订单</span>
      </div>
      <div class="stat-item">
        <span class="number">89%</span>
        <span class="label">满意度</span>
      </div>
    </div>
  </div>
  
  <div class="widget chart-widget">
    <h3>销售趋势</h3>
    <div class="chart">图表内容</div>
  </div>
</div>

.dashboard {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
  gap: 1.5rem;
  padding: 1.5rem;
}

.widget {
  container-type: inline-size;
  container-name: widget;
  background: white;
  border-radius: 12px;
  padding: 1.5rem;
  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
}

.widget h3 {
  margin: 0 0 1rem 0;
  font-size: 1.25rem;
}

.stats-grid {
  display: grid;
  gap: 1rem;
}

.stat-item {
  display: flex;
  flex-direction: column;
  padding: 1rem;
  background: #f8f9fa;
  border-radius: 8px;
}

.stat-item .number {
  font-size: 1.5rem;
  font-weight: bold;
  color: #667eea;
}

.stat-item .label {
  font-size: 0.875rem;
  color: #6c757d;
}

/* 容器宽度 >= 250px 时 */
@container widget (min-width: 250px) {
  .stats-grid {
    grid-template-columns: repeat(2, 1fr);
  }
  
  .stat-item .number {
    font-size: 1.75rem;
  }
}

/* 容器宽度 >= 400px 时 */
@container widget (min-width: 400px) {
  .stats-grid {
    grid-template-columns: repeat(3, 1fr);
  }
  
  .stat-item {
    padding: 1.25rem;
  }
  
  .stat-item .number {
    font-size: 2rem;
  }
}

/* 容器宽度 >= 500px 时 */
@container widget (min-width: 500px) {
  .widget h3 {
    font-size: 1.5rem;
  }
  
  .stat-item {
    padding: 1.5rem;
  }
  
  .stat-item .number {
    font-size: 2.5rem;
  }
  
  .stat-item .label {
    font-size: 1rem;
  }
}

总结

容器查询是 CSS 响应式设计的重要里程碑，它让我们能够创建真正自适应的组件。通过掌握容器查询，我们可以构建更加灵活、可复用的组件系统。

容器查询不仅仅是一个新特性，更是一种新的设计思维方式。让我们拥抱这种变化，创建更加灵活、自适应的前端界面，为用户提供更加一致和舒适的浏览体验。