布局与 CSS 深入了解 A2 · 正式技术规范

Container Query

容器查询

容器查询让 CSS 根据组件所在容器来调整内容。它看的是容器尺寸或样式,而不只看整个视口。

看看怎样运作
也有人这样说 Container Query组件断点区块查询

看看怎样运作

原创情境示例容器查询

另一个例子

同一张商品卡放在宽主区域时显示完整信息,放在窄侧栏时只显示简短摘要。

主要部分

  1. 01外部限制
  2. 02内容与间距模型
  3. 03计算尺寸或重排结果

什么时候用

同一个可复用组件会出现在不同宽度的布局区域时,可以使用容器查询。

什么时候不要用

如果内容本来就能自然排好,不要再加上大量查询规则。

代码里的名称

@container

上线前要检查

检查内容先后顺序、共用设计变量、组件一致性、对比度、缩放,以及页面能否随屏幕大小调整。验证每个主题、语言与状态;有动态效果时,也要提供同样完整的减少动态效果版本。

可以直接复制的需求

预期结果:定义或使用 容器查询 (Container Query),做出清楚、一致又好用的视觉体验。 用户场景:同一张商品卡放在宽主区域时显示完整信息,放在窄侧栏时只显示简短摘要。 要运用的设计概念:容器查询 (Container Query)。 适用理由:同一个可复用组件会出现在不同宽度的布局区域时,可以使用容器查询。 不应使用的情况:如果内容本来就能自然排好,不要再加上大量查询规则。 设计要求:定义内容先后顺序、可复用的设计变量(Token)与组件。说明页面如何随屏幕大小和状态改变。分清必要的设计方向与纯装饰。 包容性与韧性:检查对比度、缩放、多语言、主题切换与减少动态效果。不能只靠颜色或特效表达含义。 验收标准:在手机、桌面、缩放、各种主题与所有支持语言中仍清晰可读。每个交互状态都一致且容易理解。 证据与限制(证据边界):正式文档仍可能是草案、候选版或最终版。请查看文档状态,也要确认浏览器或平台是否支持。 待确认:品牌限制、内容多少、支持的主题与语言、目标设备,以及现有设计系统规则。

检查这份需求

请 AI 编程助手检查当前如何使用 容器查询 (Container Query)。 定义:容器查询让 CSS 根据组件所在容器来调整内容。它看的是容器尺寸或样式,而不只看整个视口。 生产环境检查:检查内容先后顺序、共用设计变量、组件一致性、对比度、缩放,以及页面能否随屏幕大小调整。验证每个主题、语言与状态;有动态效果时,也要提供同样完整的减少动态效果版本。 修改程序前,先列出看到的证据、缺口、严重程度,以及最小且安全的修正。

A2
这个术语有多正式?

正式技术规范

一份已发布、有版本的正式技术规范,在列出的范围内定义这个术语。

正式文档仍可能是草案、候选版或最终版。请查看文档状态,也要确认浏览器或平台是否支持。

适用范围
只包含来源有说明的内容:正式名称、定义、语义、实现
文档状态
草案
核验日期
2026-07-30

证据来源与适用范围

正式来源 + 术语参考资料 · W3C CSS Working Group · 草案 CSS Conditional Rules Module Level 5 — Container Queries Container Queries 适用范围: 正式名称、定义、语义、实现 本页用途: 直接术语参考 来源涵盖内容: 正式名称, 定义, 语义, 实现 正式来源 · W3C CSS Working Group · 草案 CSS Conditional Rules Module Level 5 适用范围: 正式名称、定义、语义、实现 本页用途: 只支持写明的范围 来源涵盖内容: 正式名称, 定义, 语义, 实现

自行复制

浏览器无法自动复制。请选择下方文字,再自行复制。