滚动视图应保留对称滚动余量
规则和其他情况说明
- 核心规则:列表项的横向外边距与滚动定位后的上下留白应使用同一间距 Token。候选行使用
mx-1.5时,同时使用scroll-my-1.5,避免首尾选中项贴住视口边缘。 - 程序化滚动必须真正尊重滚动余量。优先使用支持
scroll-margin的scrollIntoView({ block: "nearest" });手动修改scrollTop时,需要把计算样式中的scroll-margin-block-start/end纳入可见区判断。 - 视口存在粘性标题、底部工具栏或安全区时,在滚动容器设置
scroll-padding-block;项目自身的scroll-margin不能替代容器遮挡补偿。 - 渐隐边缘只在内容确实溢出时出现,颜色应衔接容器背景;不要用裁切实现渐隐,以免截断阴影、焦点环或浮层。
- 隐藏滚动条只改变视觉,不应禁用滚轮、触控板、触摸和键盘滚动。内容是否可滚动不明显时,应在悬停或滚动期间显示滚动反馈。
- 键盘高亮、筛选结果、异步加载、容器缩放或分组展开改变列表后,应重新校正活动项位置,并将失效索引限制在有效范围内。
- 嵌套滚动区域要明确由哪个视口消费滚轮和方向键;仅在需要阻止滚动链穿透时使用
overscroll-behavior: contain。 - 虚拟列表应让
scrollToIndex、overscan 和边缘余量共享同一 Token,不能只给未渲染项目添加 CSS margin。 - 焦点环、描边或投影超出项目边界时,滚动余量至少覆盖其外扩距离,保证首尾项的状态反馈完整可见。
- 键盘逐项导航默认即时滚动;非必要不使用平滑滚动,并遵守
prefers-reduced-motion。 - 横向列表和 RTL 布局使用
scroll-margin-inline、scroll-padding-inline等逻辑属性,不把方向写死为 left/right。
CSS Token
.scroll-view {
--scroll-edge-inset: 0.375rem;
scroll-padding-block: var(--scroll-edge-inset);
}
.scroll-view__item {
margin-inline: var(--scroll-edge-inset);
scroll-margin-block: var(--scroll-edge-inset);
}
Tailwind 对应写法:
<div class="mx-1.5 scroll-my-1.5">...</div>
关键截图与效果

- 来源:用户于 2026-08-26 提供的 Evose Desktop 会话编辑器截图。
- 页面或任务场景:在 Slash Mentions 候选列表中通过键盘移动到靠近滚动视图底部的候选项。
- 具体观察(E1):候选行已有横向留白,但底部活动项与视口边缘距离很小,上下留白与左右留白不平衡。
- 支持的结论:列表项进入滚动边界时仍应保留与行横向缩进一致的视觉呼吸空间。
- 证据限制:静态截图不证明键盘滚动、触摸滚动、动态筛选或首项状态;这些情况属于需要通过实现和交互测试验证的边界规则。
- 最终效果:目标是首尾活动项均保留一致边距,当前规则已进入实现,修复后的视觉结果仍待截图复核。
适用场景
- 命令面板、搜索建议、Slash Mentions 和自动补全列表。
- 文件选择器、树形导航、菜单和带键盘高亮的数据列表。
- 含粘性标题、底部操作区、渐隐边缘或隐藏滚动条的紧凑浮层。
不适用于连续阅读正文、自由滚动长页面,或有意让媒体内容贴边沉浸展示的界面;这些场景应由页面栅格和内容安全区决定边缘距离。
补充证据|粘性标题的滚动补偿(2026-10-22)

- 来源:https://x.com/sanyampunia/status/2112919680717660452
- 页面或任务场景:页面上方存在粘性标题时,点击锚点链接跳到章节标题。
- 具体观察:左侧未设置补偿时,章节标题被粘性导航遮住;右侧设置
scroll-padding-block-start: 64px后,标题落在导航下方(E1/P1)。 - 支持的结论:滚动容器的
scroll-padding应与粘性标题高度绑定;锚点链接、直接打开#id、location.hash和scrollIntoView()都应共享这一补偿。 - 证据边界:原帖给出 64px 与头部高度对应的示例,但静态帧不证明所有浏览器、动态头部和响应式高度下的一致行为。