给 AI 对话框做贴底滚动:任意上滚即解除、滚到底即恢复、回到底部按钮常在
AI 对话框的滚动有个很具体的别扭:流式输出时你想往上翻翻前面的内容,窗口却一直把你往下拽;等输出完了,窗口又停在半空,你得自己拖到底才能看到最新一句。更糟的一种是:你明明已经滚到底了,输出还在继续,窗口却不动了,"回到底部"按钮也不见了,想回去都没入口。
我没跟着猜是不是滚动容器写错了。我干了另一件事——去翻了一个开源数据智能体工作台(daw,Rust + Tauri 桌面应用)里聊天视图的一次提交:2026 年 8 月 17 日的 db6b887,只改了一个文件 src/components/ChatView.tsx,36 行新增、44 行删除,修的就是这套贴底滚动。
看完我可以负责任地告诉你三件事。
第一,贴底是个状态,不是一次动作——用一个信号 stickToBottom 管"跟不跟",任意向上滚动就解除、滚到底就恢复,流式输出中也一样。
第二,程序化滚动要用时间窗抑制,不用布尔锁——自己发起的滚动会触发 scroll 事件,必须在滚动结束前忽略它们,不然会把自己的动作误读成用户行为。
第三,"回到底部"按钮的状态要主动刷新——内容在视口下方生长时不改变 scrollTop、也不触发 scroll 事件,等事件来刷新按钮就永远等不到。
1. 学习目标:学完这篇你能带走什么
一句话:给你的 AI 对话框做一套贴底滚动:跟随状态机 + 程序化滚动抑制 + 按钮状态主动刷新;同时学会一套"滚动行为不对"的定位方法。
具体一点,读完你能做到三件事:用两个信号(跟随状态、按钮显隐)加一个方向判断,实现"任意上滚即解除、滚到底即恢复"的跟随逻辑;用时间窗抑制区分程序化滚动和用户滚动,让"回到底部"的平滑滚动可以被滚轮随时打断;处理"内容在视口下方生长"这种不触发 scroll 事件的情况,保证解除跟随后永远有个回到底部的入口。
2. 先给大家科普两个概念:三个滚动量、贴底
先给大家科普一个概念「三个滚动量」:一个滚动容器有三个数字——scrollHeight(内容总高度)、scrollTop(已经滚上去的高度)、clientHeight(视口可见高度)。scrollHeight - scrollTop - clientHeight 就是"离底部还差多少"。daw 里判定"到底了"的标准是这个差值 <= 30,留 30 像素容差:
const atBottomOf = (el: HTMLDivElement) =>
el.scrollHeight - el.scrollTop - el.clientHeight <= 30;
再科普一个概念「贴底(stick to bottom)」:流式输出时内容不断变长,窗口自动跟着最新内容走。翻译成人话:贴底就是"新内容出来,窗口自动跟到最底下"。 关键在于"自动"二字是有条件的——用户一旦想回看,自动就得停;用户回到最底下,自动就得恢复。这不是一个开关,而是一个跟用户意图走的状态。
3. 第一步:跟随状态机——任意上滚即解除,滚到底即恢复
核心是两个 SolidJS 信号:
const [stickToBottom, setStickToBottom] = createSignal(true);
const [showScrollDown, setShowScrollDown] = createSignal(false);
stickToBottom 管跟不跟随,showScrollDown 管"回到底部"按钮显不显隐。判定逻辑全在 handleScroll 里:
const handleScroll = (e: Event) => {
if (Date.now() < ignoreScrollUntil) return;
const el = e.currentTarget as HTMLDivElement;
const scrolledUp = lastUserScrollTop >= 0 && el.scrollTop < lastUserScrollTop;
lastUserScrollTop = el.scrollTop;
if (scrolledUp) {
// 任意距离的向上滚动都解除贴底(哪怕 30px 以内),尊重用户回看的意图。
setStickToBottom(false);
} else if (atBottomOf(el)) {
// 滚到底部即恢复贴底,流式输出中同样生效。
setStickToBottom(true);
}
setShowScrollDown(!atBottomOf(el));
};
这里有两个细节值得抄。
细节一:解除贴底看的是"方向",不是"距离"。 旧写法是"离底部超过 30px 才解除",新写法是"只要 scrollTop 变小了就解除,哪怕只滚了 1px"。为什么?因为"用户往上滚"本身就是回看的意图,意图不应该有个 30px 的门槛——用户在底部附近轻轻滚一下轮子想看上一行,旧写法会因为还在 30px 容差内而继续把他往下拽。方向判断靠一个变量 lastUserScrollTop 记录上一条 scroll 事件的位置,scrollTop 变小就是向上滚。
细节二:拖滚动条不触发 wheel 事件,只能靠 scroll 事件判断方向。 滚轮有专门的 wheel 事件,但用户拖滚动条、点滚动条轨道、按键盘翻页,都只产生 scroll 事件。所以方向判断不能只挂在 wheel 上,必须在 scroll 里用"上一次位置 vs 这一次位置"来算。这是这个提交里最容易漏的一点:只处理 wheel,拖滚动条的用户就永远解除不了贴底。
恢复贴底的条件是对称的:atBottomOf(el) 为真就恢复,而且注释里特意写了"流式输出中同样生效"——用户在流式输出中途自己拖到底部,下一条内容出来窗口就继续跟,不用等流式结束。
滚轮处理 handleWheel 只有两行意思:
const handleWheel = (e: WheelEvent) => {
// 滚轮 = 明确的用户意图:立即结束程序化滚动的事件抑制
ignoreScrollUntil = 0;
if (e.deltaY < 0) {
setStickToBottom(false);
}
};
滚轮向上立刻解除贴底;同时把程序化滚动的事件抑制清零——这是下一步要讲的机制。
4. 第二步:程序化滚动的时间窗抑制——别用布尔锁
贴底滚动有个自举难题:窗口自动滚到底用的是 el.scrollTop = el.scrollHeight,这个赋值本身会触发 scroll 事件;而 scroll 事件的处理函数会按"用户滚动"去解读——方向、位置、是否到底,全按用户行为算。自己发起的滚动如果被自己误读,状态机立刻就乱了。
旧方案用的是一个布尔锁 isProgrammaticScroll:程序化滚动前置 true,下一帧 requestAnimationFrame 再置 false,期间的 scroll 事件直接忽略。提交把它换成了时间窗:
// 程序化滚动会触发 scroll 事件,必须在滚动结束前忽略它们,
// 避免把自己的动作误读成用户行为。用户滚轮可随时提前取消抑制。
let ignoreScrollUntil = 0;
function stickScrollToBottom() {
const el = scrollEl;
if (!el) return;
ignoreScrollUntil = Date.now() + 100;
el.scrollTop = el.scrollHeight;
}
function smoothStickToBottom() {
const el = scrollEl;
if (!el) return;
ignoreScrollUntil = Date.now() + 600;
el.scrollTo({ top: el.scrollHeight, behavior: "smooth" });
}
翻译成人话:布尔锁说的是"我正在滚,别理我",时间窗说的是"100 毫秒之内,别理我"。 差别在哪?直接贴底是瞬间完成的,100 毫秒足够覆盖它触发的 scroll 事件;"回到底部"的平滑滚动要 600 毫秒左右,抑制窗口就给 600 毫秒。时间窗的好处是自愈的——即使某条 scroll 事件因为时序问题没赶上窗口,抑制也会自己过期,不会像布尔锁那样一旦忘记复位就永久失灵。
而用户滚轮可以随时提前取消抑制(handleWheel 里 ignoreScrollUntil = 0):用户在"回到底部"的平滑滚动中途滚一下轮子,抑制立刻结束,之后的 scroll 事件按用户行为正常判定。用户意图的优先级,永远高于程序化滚动的完整性。 一个平滑滚动被打断没关系,被打断后状态机还能正常工作才是关键。
还有一段被删掉的旧代码值得当反面教材:之前有个"滚动锁",每帧把 scrollTop 强制拉回用户滚到的位置,想在流式输出时"锁住"用户的阅读位置。结果是拖动滚动条不触发 wheel 事件、锁里记的位置不更新,滚动条"拖不动、只有图表在动"。提交把这套锁整个删了,注释里写明了原因。用每帧强制写 scrollTop 去"锁"滚动,是跟浏览器滚动机制对着干——正确的做法是改状态(解除贴底),让滚动自然发生,而不是每帧把位置写回去。
另外,滚动锚定(overflow-anchor)也被显式禁掉了:.chat-stream { overflow-anchor: none }。浏览器原生的滚动锚定会在内容变化时自动调整滚动位置,跟贴底状态机抢控制权——既然自己管滚动,就要把原生的锚定关掉,控制权只能有一家。
5. 第三步:流式中跟随 + 按钮状态主动刷新
跟随动作挂在一个 effect 上,消息列表或流式状态一变就跑:
createEffect(() => {
props.messages;
isStreaming();
const el = scrollEl;
if (!el) return;
if (untrack(stickToBottom)) {
stickScrollToBottom();
} else {
// 内容在视口下方生长不改变 scrollTop、不触发 scroll 事件,按钮状态必须在
// 此主动刷新——保证解除贴底后永远有"回到底部"这个恢复入口。
setShowScrollDown(el.scrollHeight - el.scrollTop - el.clientHeight > 30);
}
});
这个 else 分支是整个提交里最容易被低估的一行。想一想:用户解除贴底后正在上面回看,流式输出还在继续,新内容在视口下方不断生长——scrollTop 没变、scrollHeight 变大了,没有产生任何 scroll 事件。如果"回到底部"按钮的显隐只靠 scroll 事件刷新,按钮就会停留在旧状态:用户明明已经离底部很远了,按钮却还藏着,想回去都没入口。
所以 effect 里分了两条路:跟随状态是开的,就贴底;跟随状态是关的,就主动算一遍离底部的距离、刷新按钮状态。不触发事件的状态变化,必须有主动刷新的地方兜底。 这条规则不只适用于滚动按钮——任何"状态变了但事件没触发"的场景,都要问一句:谁来主动刷新依赖它的 UI?
按钮本身在视图里就是一行条件渲染:
<Show when={showScrollDown()}>
{/* 回到底部按钮,点击后 smoothStickToBottom() */}
</Show>
点它走的是 smoothStickToBottom——600 毫秒平滑滚动 + 600 毫秒事件抑制,滚轮随时可以打断。
6. 为什么这样设计:三层各管一类失败
这三步其实是三层不同的"正确":
- 跟随状态机买的是"意图优先"——任意上滚即解除(不看距离、只看方向),滚到底即恢复(流式中也生效),用户的回看意图永远有出口。
- 时间窗抑制买的是"自己不误读自己"——程序化滚动触发的 scroll 事件在时间窗内被忽略,窗口过期自愈,用户滚轮随时可以提前取消。
- 按钮状态主动刷新买的是"没有事件也有入口"——内容在视口下方生长不触发 scroll 事件,effect 里主动算距离,保证解除跟随后永远有个回到底部的按钮。
三层之间没有重叠:状态机不管事件抑制,抑制不管按钮刷新,按钮刷新也不管跟随逻辑。排查"滚动行为不对"时也可以按这三层分:先看状态变没变(上滚解除了吗、到底恢复了吗),再看是不是自己误读了自己的滚动(抑制窗口够不够、滚轮能不能打断),最后看没有事件时谁在刷新 UI(按钮是不是卡在旧状态)。
还有一点要说明白:这篇讲的是跟随滚动的状态与事件机制。同一产品另有一篇讲流式渲染的性能(2026-10-13):打字机越打越卡、最大化按钮失灵,四层性能打法。那篇回答"渲染为什么卡",这篇回答"滚动为什么不听话"。一个是渲染成本层,一个是滚动状态层,不重复。
7. 避坑清单
坑一:解除贴底只看距离、不看方向。 “离底部 30px 内不解除"会让用户在底部附近轻轻一滚就被拽回去。解除条件应该是"向上滚了”,哪怕只滚 1px。
坑二:只处理 wheel 事件。 拖滚动条、点轨道、键盘翻页都不产生 wheel 事件,方向判断必须在 scroll 事件里用"上一次位置 vs 这一次位置"来算。
坑三:用布尔锁抑制程序化滚动的事件。 锁一旦忘记复位就永久失灵。换成时间窗:直接贴底 100 毫秒、平滑滚动 600 毫秒,过期自愈,滚轮随时提前取消。
坑四:每帧强制写 scrollTop 去"锁"阅读位置。 跟浏览器滚动机制对着干,滚动条会拖不动。想锁住阅读位置就改状态(解除贴底),别每帧写位置。
坑五:按钮显隐只靠 scroll 事件刷新。 内容在视口下方生长不触发 scroll 事件,解除跟随后按钮会卡在旧状态。必须在消息变化的 effect 里主动算一遍距离、刷新按钮。
坑六:自己管滚动还留着原生滚动锚定。 overflow-anchor 会在内容变化时自动调滚动位置,跟状态机抢控制权——自己管滚动,就把它关掉。
8. 总结
给 AI 对话框做贴底滚动,核心是三个互相独立的机制:跟随状态机(stickToBottom + showScrollDown,任意上滚即解除、滚到底即恢复,方向用 lastUserScrollTop 判断,拖滚动条也覆盖);程序化滚动的时间窗抑制(直接贴底 100 毫秒、平滑滚动 600 毫秒,替代会永久失灵的布尔锁,滚轮随时提前取消);按钮状态主动刷新(消息变化的 effect 里分两路——跟随就贴底、不跟随就重算离底部距离,保证解除跟随后永远有回到底部的入口)。再加上两条纪律:别用每帧写 scrollTop 去锁位置,滚动锚定关掉、控制权只留一家。
给开发者的建议:
- 贴底先定状态机:跟随/解除/恢复三个转移条件写清楚,解除看方向不看距离。
- 程序化滚动的事件抑制用时间窗,不用布尔锁;抑制时长按滚动方式给(直接 100ms、平滑 600ms)。
- 用户滚轮必须能随时打断程序化滚动——用户意图的优先级高于滚动动画的完整性。
- 方向判断写在 scroll 事件里,不只写在 wheel 里——拖滚动条不产生 wheel 事件。
- 任何"状态变了但事件没触发"的 UI,都要有主动刷新的地方兜底,别等事件来。
- 自己管滚动时,把
overflow-anchor关掉;别用每帧写 scrollTop 去锁位置。
滚动条不听话的时候,别先调样式——先看状态机、再看事件抑制、最后看谁在刷新 UI。
项目开源在 GitHub:tsingliuwin/daw,觉得有用欢迎点个 star。
转载自 CSDN-专业IT技术社区
原文链接:https://blog.csdn.net/tsingwin/article/details/171082954



