用途:为 React 应用提供 2026 现代响应式设计实践,帮助构建能根据容器尺寸自适应的可复用组件、平滑缩放的流体排版,以及无需大量媒体查询的响应式布局,适用于侧边栏、弹窗、网格等尺寸多变的容器场景。
主要能力:区分媒体查询(响应视口、适合页面布局)与容器查询(响应容器、组件真正可移植,Baseline 2023+);覆盖 CSS Subgrid 嵌套网格对齐、auto-fit/minmax 内在响应式网格、clamp() 流体尺度、可折叠与双屏设备布局、env(safe-area-inset-*)、视口分段查询、容器滚动查询(Chrome 126+);React 侧包含响应式组件、Tailwind 容器查询、useContainerQuery Hook 与响应式图片。规则按需加载,共 6 类 10 个文件,含 CSS、React、PWA、动画、触控移动等。
使用方式:需要时用 Read("rules/<file>.md") 按需读取对应规则文件,如 rules/css-patterns.md、rules/react-patterns.md;参考文件用 Read("references/<file>") 加载。
关键决策:组件用容器查询、页面布局用媒体查询;单位优先 cqi/cqb(逻辑方向、利于国际化)而非 cqw/cqh;流体排版必须含 rem,如 clamp(1rem, 0.5rem + 2vw, 2rem) 以尊重用户字体偏好;坚持移动优先;卡片用 auto-fit、图标用 auto-fill。
限制与禁止:禁止仅用视口单位设置文字、使用 cqw/cqh、容器查询缺少 container-type、桌面优先媒体查询、文字用固定 px 断点、过度嵌套容器查询。浏览器支持不一:容器尺寸查询 Chrome/Edge 105+、Safari 16+、Firefox 110+;容器样式查询仅 Chrome/Edge 111+;滚动状态查询 Chrome/Edge 126+;cqi/cqb 同尺寸查询;clamp() Chrome 79+、Safari 13.1+、Firefox 75+;Subgrid Chrome/Edge 117+、Safari 16+、Firefox 71+。PWA 与动画规则内容资料未展开。相关技能含 design-system-starter、性能、i18n 日期模式,具体细节暂未提供。