自适应圆角可用 progress() 随剩余空间连续计算

  • 圆角
  • progress()
  • 容器查询
实现
CSS
来源
x.com
收录日期
状态
规约中
自适应圆角可用 progress() 随剩余空间连续计算 规则实证样本

自适应圆角可用 progress() 随剩余空间连续计算

规则和其他情况说明

  • 核心规则:把容器与视口之间的剩余间距(gutter,取 (100vi - 100cqi) / 2)作为进度输入,用 progress() 将其映射到 0–1 并自动 clamp,再乘以最大圆角半径;剩余空间越小圆角越大,剩余空间越大圆角越小,整个过程连续变化而不是按断点跳变。
  • 作者主张(P1):原帖称 progress() “帮你做除法和 clamp”(does the division + clamps for you),即把原先手写的 clamp(0, x / g, 1) 一类归一化计算收进单个函数。
  • 依赖容器查询单位:100cqi 需要卡片是容器(演示中 .card 声明 container-type: inline-size,E1 见代码帧),圆角因此跟随容器相对视口的位置,而不是单纯跟随视口宽度。
  • 同一思路可推广到阴影等其他随空间变化的属性(P1,原帖提到 “adaptive radius, shadow, etc.”)。
  • 例外或边界:progress() 是较新的 CSS 数学函数,标准状态与浏览器支持不确定(详见“来源与证据边界”);不支持的浏览器会得到无效声明,必须提供静态圆角作为兜底值。

CSS Token

原帖正文公开的核心片段如下(出自原帖):

.card__surface {
  --r: 42px; --g: 24px;
  border-radius: calc(
    progress((100vi - 100cqi) / 2, 0px, var(--g)) * var(--r)
  );
}

演示视频代码帧中可见的配套写法(E1,变量名与帖子略有出入,以画面为准):

.card {
  container-type: inline-size;
  inline-size: min(var(--width, 360px), 100%);
}

.card__surface {
  --radius: 42px;
  --gutter: 22px;
  border-radius: calc(
    progress(
      (100vi - 100cqi) / 2,
      0px,
      var(--gutter)
    ) * var(--radius)
  );
}

实现时还需要自行补齐:

  • 不支持 progress() 时的静态 border-radius 兜底(如先写固定值再用 @supports 覆盖;原帖未给出降级写法)。
  • progress() 三个参数均为长度量纲的语义:当前值、起点、终点;起点大于终点时的反向语义原帖未演示。
  • 阴影等配套属性的同款映射(原帖仅口头提及)。

关键截图与效果

大圆角态|剩余空间趋近于零

Jhey-CSS-progress自适应圆角-大圆角态-20260914.png

  • 来源:Jhey 在 X 发布的演示视频(约 20 秒,1080 × 1080),本条截取自约 12% 进度帧;画面是 CodePen「adaptive border-radius」示例,左代码右预览。
  • 页面或任务场景:预览面板被拖窄,卡片几乎占满视口宽度,gutter 接近零。
  • 具体观察(E1):白色卡片呈大圆角(接近 --radius 上限),四角弧线饱满,带柔和投影。
  • 支持的结论:圆角半径随剩余空间收缩而连续放大,接近容器占满视口时达到最大值,符合“边缘贴近视口时更像独立面板”的直觉。
  • 证据限制:单帧只证明一个稳定状态,不证明圆角变化的连续性或拖动过程中的中间帧质量。

gutter 标注态|输入量可视化

Jhey-CSS-progress自适应圆角-gutter标注态-20260914.png

  • 来源:同一演示视频约 50% 进度帧。
  • 页面或任务场景:作者在预览区用橙色虚线与手写体 “the gutter” 标注出容器左缘与视口左缘之间的间距。
  • 具体观察(E1):虚线标记的 gutter 正是 progress() 的输入量 (100vi - 100cqi) / 2 的可视化;卡片圆角处于中间大小。
  • 支持的结论:圆角的驱动量是“容器与视口的单侧间距”这一可观察几何量,设计者可以直接用 gutter 尺寸预算圆角行为。
  • 证据限制:标注为视频后期叠加,不证明实际布局中存在该辅助线。

代码与小圆角预览态|同一视口内的对照

Jhey-CSS-progress自适应圆角-代码与小圆角预览态-20260914.png

  • 来源:同一演示视频约 88% 进度帧。
  • 页面或任务场景:CodePen 编辑器(作者 Jhey 的「adaptive border-radius」Pen)左侧展示 style.css,右侧预览面板较宽(画面右下角标注预览尺寸约 439 × 758)。
  • 具体观察(E1):左侧可见 .card 的 container-type: inline-size 与 .card__surface 中 border-radius: calc(progress((100vi - 100cqi) / 2, 0px, var(--gutter)) * var(--radius)) 的完整写法;右侧 gutter 变宽,卡片圆角相应收窄但仍可见。
  • 支持的结论:代码与效果同帧对照,证明圆角收窄与 gutter 变宽同向发生;实现确由帖子公开的 progress() 片段驱动。
  • 证据限制:帧间对比能证明“gutter 大则圆角小”的对应关系,但不能单独证明映射曲线是线性的或动画连续无跳变。

原始动态证据

  • 文件说明:从 X 官方媒体保存的 1080 × 1080、60 fps、约 20.22 秒视频;未裁剪或转码。
  • 具体观察(E1):视频中拖动预览面板分隔条改变容器宽度,卡片圆角随 gutter 变化连续调整。
  • 作者主张(P1):帖子称这是 “update”,同一技巧此前用手写除法与 clamp 实现,现在由 progress() 代劳;先前版本未在本帖展示。

适用场景

  • 卡片、面板等容器在窄屏或满宽布局下需要更大圆角、宽屏留边时需要更克制圆角的自适应界面。
  • 已使用容器查询布局、希望视觉属性(圆角、阴影强度)与容器相对视口的位置联动而非另设断点的项目。
  • 可以把 progress() 作为增强层、并为不支持的浏览器提供静态圆角兜底的场景。

不适合直接照搬:

  • 要求圆角在所有目标浏览器完全一致、且无法确认 progress() 支持矩阵的关键流程。
  • 容器并非查询容器(缺少 container-type)的布局,100cqi 会退化为视口相关行为,语义改变。
  • 圆角需要按离散档位(如品牌规范只允许多个固定半径)而非连续插值的场景。

来源与证据边界

  • 原始来源:Jhey 的 X 帖子。正文明确给出 progress() 的 border-radius 片段,并称 progress() 负责除法与 clamp。
  • 标准状态:progress() 是较新的 CSS 数学函数,其所属规范进展与各浏览器支持情况在收录时未能从权威来源确认,存在语法或行为调整的可能,因此本条保持 draft;采用前应核对当时的 MDN / 规范状态并准备兜底。
  • 未获得该演示的完整 HTML、--width 等变量的全部定义或生产验证数据;响应式、降级、性能与跨浏览器表现都需要在真实项目中另行验证。
  • 静态帧只证明各稳定状态的存在,不证明圆角插值的连续性与曲线形态;动态行为仅以源视频为证据。