边缘淡出应与表面同色

  • 滚动
  • 边缘淡出
  • 滚动条
实现
CSS
来源
Evose Desktop 会话产物列表与滚动组件实现,经用户评审确认
收录日期
状态
已实证
边缘淡出应与表面同色 规则实证样本

边缘淡出应与表面同色

规则和其他情况说明

  • 核心规则:边缘淡出的实色端必须与滚动区所在表面完全一致(--background / --card / --popover 因表面而异)。淡出层是不透明实色向透明的过渡,底色与表面不一致时,边缘会出现一条可见色带。
  • 同一组件复用于不同表面时,淡出底色应作为参数由调用方传入,而不是在组件内写死;本地会话消息流表面是 --background,云端面板表面是 --card。
  • 多段缓出优于单段线性:线性 alpha 渐变在感知上衰减过快、外缘留硬边。用 color-mix 从表面底色派生中间档(0% 实色 → 30% 处 62% → 58% 处 28% → 100% 透明),接近内容自然消隐。
  • 淡出只在对应方向仍可滚动时出现,滚到尽头自动消失,承担「还有更多」的提示职责;不可滚动时完全不渲染,避免误提示。
  • 用兄弟浮层叠加实现淡出,不用 mask 或裁切:裁切会截断卡片 hover 阴影、焦点环等溢出的状态反馈。
  • 淡出宽度按内容密度调整:默认 32px,卡片架等紧凑列表收窄到 24px 即可;过宽会遮挡内容,过窄则提示作用减弱。
  • 滚动条采用 overlay 式:无溢出时隐藏、静息淡显、hover 与拖拽时全显。纯展示架可隐藏滚动条 thumb,但只改视觉,不得禁用滚轮、触控板与键盘滚动。

CSS Token

.scroll-fade {
  /* 表面底色由调用方按所在表面传入,此处以 --background 为例 */
  background: linear-gradient(
    to right,
    hsl(var(--background)) 0%,
    color-mix(in srgb, hsl(var(--background)) 62%, transparent) 30%,
    color-mix(in srgb, hsl(var(--background)) 28%, transparent) 58%,
    transparent 100%
  );
}

关键截图与效果

Evose-滚动列表-20260831.png

  • 来源:用户于 2026-08-31 提供的 Evose Desktop 项目选择列表截图。
  • 页面或任务场景:在可滚动的项目勾选列表中滚动,右侧 overlay 滚动条显现,底部列表项被视口裁断。
  • 具体观察(E1):滚动期间滚动条从隐藏转为可见,提供明确的位置与剩余量反馈;底部项的截断形态提示下方仍有内容。
  • 支持的结论:滚动反馈(滚动条显隐 + 内容溢出形态)是滚动列表的必要状态表达,隐藏滚动条只能隐藏视觉、不能移除反馈。
  • 证据限制:静态截图未展示边缘淡出渐变的显现状态;淡出的同色、缓出曲线与宽度取值经 Evose Desktop 实现与用户评审确认。
  • 最终效果:已在 Evose Desktop 会话产物列表落地(表面同色 + 多段缓出 + 紧凑宽度),typecheck、design lint 与单元测试通过。

适用场景

  • 横向卡片架、标签栏、时间线等可溢出滚动的列表。
  • 浮层内的纵向列表(淡出底色换为 --popover / --card)。

不适用于连续阅读正文(边缘距离由页面栅格和内容安全区决定),或有意让媒体内容贴边沉浸展示的界面。