UI 视觉设计 / 系统课时

用容器查询处理组件宽度变化

用容器查询处理组件宽度变化

同一张任务卡在桌面页面中可能放进 320px 侧栏,也可能放进 560px 内容区。只按浏览器视口切换布局,会让宽屏里的窄卡片被强行横排。本课用 CSS 容器查询,让组件按所在区域的实际宽度重排,并制定可验证的卡片、工具栏和复合组件规则。

学习目标

  • 区分 @media 的视口条件与 @container 的祖先容器条件。
  • 用 container-type、container-name 和宽度断点实现可复用卡片。
  • 给嵌套组件确定断点,并在浏览器中验证临界宽度和降级行为。

视口断点为什么会失效

假设浏览器视口宽 1440px,主内容区宽 560px,侧栏宽 320px。如果使用 @media (min-width: 1024px) 控制任务卡横排,两处卡片都会命中规则;侧栏里 320px 的空间却放不下缩略区、标题和按钮。

容器查询将判断依据改为组件某个祖先元素的内容盒宽度。下面示例约定:小于 420px 时纵向排列;达到 420px 时,缩略区与文案横排。浏览器视口不变,左右卡片也可以呈现不同结构。

相同桌面视口中不同宽度容器的任务卡布局对比

把任务卡改成按容器重排

将下面内容保存为 container-demo.html,用支持 CSS 容器尺寸查询的现代浏览器打开。.slot 是查询容器,.card 是被改变布局的后代;两处卡片复用同一组 CSS,无须感知自己在侧栏还是主区域。

html
<!doctype html>
<html lang='zh-CN'>
<head>
  <meta charset='utf-8'>
  <meta name='viewport' content='width=device-width, initial-scale=1'>
  <title>容器查询演示</title>
  <style>
    * { box-sizing: border-box; }
    body { margin: 24px; font: 16px/1.5 system-ui, sans-serif; }
    .demo { display: flex; flex-wrap: wrap; gap: 24px; }

    /* 查询容器放在卡片外层,宽度由父级布局决定 */
    .slot { container: task-card / inline-size; width: min(100%, 320px); }
    .slot--wide { width: min(100%, 560px); }

    /* 窄容器默认保持单列,旧浏览器也能阅读 */
    .card {
      display: grid;
      grid-template-columns: minmax(0, 1fr);
      gap: 12px;
      padding: 16px;
      border: 1px solid #b8c7d8;
      border-radius: 12px;
    }
    .cover {
      min-height: 96px;
      display: grid;
      place-items: center;
      border-radius: 8px;
      background: #e7eef7;
    }
    .details { min-width: 0; }
    .details h2 { margin: 0 0 8px; font-size: 18px; }
    .details p { margin: 0; }
    .actions { display: flex; flex-wrap: wrap; gap: 8px; }

    /* 仅修改命名容器的后代,420px为本案例的内容阈值 */
    @container task-card (min-width: 420px) {
      .card { grid-template-columns: 112px minmax(0, 1fr); }
      .cover { grid-column: 1; grid-row: 1 / span 2; }
      .details, .actions { grid-column: 2; }
    }
  </style>
</head>
<body>
  <main class='demo'>
    <section class='slot' aria-label='窄区域'>
      <article class='card'>
        <div class='cover' aria-hidden='true'>封面</div>
        <div class='details'>
          <h2>处理客户工单</h2>
          <p>待处理 7 项,负责人:A 组</p>
        </div>
        <div class='actions'>
          <button type='button'>查看</button>
          <button type='button'>分派</button>
        </div>
      </article>
    </section>
    <section class='slot slot--wide' aria-label='宽区域'>
      <article class='card'>
        <div class='cover' aria-hidden='true'>封面</div>
        <div class='details'>
          <h2>处理客户工单</h2>
          <p>待处理 7 项,负责人:A 组</p>
        </div>
        <div class='actions'>
          <button type='button'>查看</button>
          <button type='button'>分派</button>
        </div>
      </article>
    </section>
  </main>
</body>
</html>

预期结果:在足够宽的浏览器窗口中,320px 容器内的封面、文案、按钮上下排列;560px 容器内封面位于左列,文案与按钮位于右列。缩小窗口后,第二个容器的实际宽度若低于 420px,也会自动退回单列。

这里的 inline-size 在通常的横排书写模式下对应宽度;container: task-card / inline-size 是 container-name 与 container-type 的简写。@container 查询的是容器内容盒宽度,规则作用于其后代,不能用同一条查询规则直接改变作为查询对象的 .slot 自身。

为工具栏和复合组件确定断点

不要把全站的 768px、1024px 视口断点原样搬进组件。先列出组件最窄时必须保留的内容,再用浏览器逐步缩小宿主区域,记录文字开始拥挤或操作控件换行的宽度。以下是一个工单后台的初始设计值,属于示例约定,不是 CSS 标准断点。

组件及查询容器 低于阈值 达到阈值
任务卡 task-card,420px 封面在上,操作区在下 112px 封面列 + 自适应内容列
筛选工具栏 task-tools,520px 搜索框占整行,筛选按钮换行 搜索框和筛选按钮同一行
任务编辑区 task-form,640px 标签、输入框单列排列 表单分成两列,长备注仍占整行

工具栏、表单应分别由自己的外层元素声明 container: task-tools / inline-size 和 container: task-form / inline-size,并用对应名称的 @container 规则控制内部元素。一个复合页面可以嵌套多个命名容器,避免工具栏误用外层卡片的宽度条件。页面总体的侧栏显示与隐藏、顶部导航模式等仍适合使用 @media。

验收临界宽度与排查失效

  1. 打开浏览器开发者工具,选中 .slot,检查计算样式是否包含 container-type: inline-size 与 container-name: task-card。
  2. 临时把 .slot 的宽度改为 419px、420px、421px:419px 应为单列,420px 起改为双列。观察的是内容盒尺寸;若元素带 padding 或 border,不要把外框宽度直接当作查询宽度。
  3. 在 1440px 的大视口中继续把侧栏压窄,确认卡片回到单列;再将相同组件放入宽内容区,确认恢复横排。
  4. 验证标题变长、按钮文案加长、浏览器缩放至 200% 时不出现横向溢出,键盘 Tab 顺序仍按“查看、分派”移动。

若查询完全不生效,先检查 container-type 是否设置在目标元素的祖先上,再核对 @container 名称是否一致。若组件在双列时挤出边界,保留 minmax(0, 1fr) 与 .details { min-width: 0; },必要时给长单词加换行规则。对不支持容器查询的旧浏览器,本例默认单列仍可用,只是不会增强为横排;正式项目应按目标浏览器清单确认兼容性。

把断点记录为“查询容器名称、阈值、阈值两侧的变化、验收样例”四项,交付给开发时便能复现组件在不同嵌入位置的行为。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用容器查询处理组件宽度变化

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通