媒体查询问的是「屏幕多宽」,容器查询问的是「我这个组件被放进了多大的地方」。同一个卡片放进侧栏还是主区,能自己决定怎么排,这才是可复用组件需要的响应方式。

01从视口到容器

先在父级声明 container-type: inline-size(需要双向尺寸时用 size),必要时用 container-name 命名,子组件再用 @container (min-width: 32rem) 写规则。命名查询在 2026 年已支持只按名字匹配,不必反复声明尺寸约束;配合 style() 查询还能根据祖先的自定义属性切换主题,让组件读取设计系统状态,而不必关心整个视口。

团队协作时,「容器查询」最好有一个明确的负责人和一份最短示例。示例要能直接复制运行,包含正确写法与一个典型的错误写法,让新成员在十分钟内建立直觉,比长篇规范文档有效得多。

02常见的组织方式

把断点写在组件内部,而不是全局按设备分类;容器名用语义而非像素值;外层负责布局分配,内层只关心自身可用空间。这样同一个组件在栅格、抽屉、弹窗里复用时不会互相干扰。需要注意 container-type: inline-size 会建立尺寸 containment,对依赖内容撑高的布局要留意,先在小范围验证再推广。

团队协作时,「容器查询」最好有一个明确的负责人和一份最短示例。示例要能直接复制运行,包含正确写法与一个典型的错误写法,让新成员在十分钟内建立直觉,比长篇规范文档有效得多。

03与旧方案的分工

媒体查询仍适合处理整页级变化(导航折叠、全局栅格、字号基准);容器查询负责组件内部。两者不是替代关系。渐进增强时,先给出单列且可用的基础布局,再在 @supports (container-type: inline-size) 内叠加多列规则,保证不支持的环境仍能完整阅读内容。

团队协作时,「容器查询」最好有一个明确的负责人和一份最短示例。示例要能直接复制运行,包含正确写法与一个典型的错误写法,让新成员在十分钟内建立直觉,比长篇规范文档有效得多。

要点速览

  • 父级 container-type + 命名,子级 @container 响应自身空间
  • style() 查询可基于自定义属性切换组件主题
  • 避免 container-type 引入非预期的尺寸 containment
  • 媒体查询管整页,容器查询管组件,二者互补

组件应该知道自己有多大,而不是猜测用户拿了什么设备。