HOWTO · JavaScript
如何在 JavaScript 中滚动到 Div 底部
本文介绍如何使用 scrollTop、scrollHeight 和 clientHeight 将 div 滚动到底部,以及如何用 jQuery、jQuery .animate()、element.scroll() 实现即时或平滑滚动,并说明何时适合使用 scrollIntoView()。
本页内容
要让 <div> 显示最新内容,可将它的 scrollTop 设为 scrollHeight - clientHeight。容器需要有固定或受限的高度,并且内容要超出可视区域。例如,聊天消息加入后,在聊天容器上执行这项计算即可。本文还会介绍 jQuery、平滑动画、element.scroll(),以及适合使用 scrollIntoView() 的情况。
在 JavaScript 中使用 scrollTop 和 scrollHeight 滚动到 Div 底部
scrollTop 表示容器在垂直方向上已滚动的像素数。scrollHeight 是内容的完整高度,包括可视区域以外的部分;clientHeight 则是容器内部可视区域的高度。因此,垂直方向上可用的最大滚动位置是 scrollHeight - clientHeight,无需将 scrollTop 设为整个 scrollHeight。
容器必须有受限的高度,而且内容高度要超过这个高度,才能滚动。使用 overflow-y: auto 时,浏览器会在需要时显示滚动条;overflow-y: scroll 也可以使用,并会始终为滚动条预留空间。下面的 JavaScript 示例用与 DOM 属性相同的数值演示这项计算:
const container = { scrollTop: 0, scrollHeight: 640, clientHeight: 240 };
container.scrollTop = container.scrollHeight - container.clientHeight;
console.log(container.scrollTop);
400
在浏览器中,应在内容加入后对实际容器执行赋值,例如:const box = document.querySelector('#chat'); box.scrollTop = box.scrollHeight - box.clientHeight;。如果内容是异步渲染的,应等渲染完成后再赋值,这样测得的高度才会包含新内容。
在 JavaScript 中使用 jQuery 滚动到 Div 底部
如果页面已经使用 jQuery,可以通过它的 scrollTop() 方法设置垂直滚动位置。要读取 scrollHeight,需访问匹配元素对应的 DOM 节点,例如 $('#chat')[0],再减去该节点的 clientHeight。例如:const box = $('#chat')[0]; $('#chat').scrollTop(box.scrollHeight - box.clientHeight);。
这种方式同样要求容器可滚动且内容溢出。jQuery 是外部库依赖;如果页面尚未使用它,原生 scrollTop 方案可以避免额外引入依赖。下面的浏览器代码片段仅作说明,尚未执行。
在 JavaScript 中使用 jQuery .animate() 滚动到 Div 底部
如果希望容器在一段时间内滚动,而不是立即跳到目标位置,可以使用 jQuery .animate()。传入目标 scrollTop 和以毫秒为单位的持续时间。例如:const box = $('#chat')[0]; $('#chat').stop(true).animate({ scrollTop: box.scrollHeight - box.clientHeight }, 500);。
500 表示请求执行半秒的动画。先调用 .stop(true) 会停止当前动画并清空排队的动画,再开始新的动画,因此连续更新时不会累积待执行动画。和即时滚动的 jQuery 方案一样,此方法需要 jQuery,而且容器必须可以滚动。下面的浏览器代码片段尚未执行。
在 JavaScript 中使用 element.scroll() 滚动到 Div 底部
原生 element.scroll() 方法接受目标位置,也可以请求平滑滚动。目标位置仍使用与 scrollTop 相同的最大滚动值:
const box = document.querySelector('#chat'); box.scroll({ top: box.scrollHeight - box.clientHeight, behavior: 'smooth' });
省略 behavior: 'smooth' 或使用 behavior: 'instant',即可立即滚动。下面的浏览器 API 示例尚未执行;它假设 #chat 指向预期的可滚动容器,且容器内容已经渲染完成。
在 JavaScript 中使用 element.scrollIntoView() 滚动到 Div 底部
scrollIntoView() 会将调用它的元素滚动到可视区域内。为此,它可能滚动包含该元素的容器、其他祖先元素,甚至整个页面。它不会直接把某个容器自身的内部滚动位置设为底部。
如果目的是显示最后一条内容或一个标记,可以使用此方法。在内容后添加标记,再调用 document.querySelector('#latest-message').scrollIntoView({ block: 'end', behavior: 'smooth' });。该调用会定位到这个元素;具体布局不同,页面或祖先容器也可能随之滚动。若要可靠地只设置特定容器的底部位置,请改用 scrollTop 或 element.scroll()。下面的浏览器代码片段尚未执行。
总结
对于可滚动的 <div>,直接的原生方案是将 scrollTop 设为 scrollHeight - clientHeight,并在最新内容已经加入后执行。若页面已经依赖 jQuery,可使用它的 scrollTop();需要定时过渡效果时,可使用 .animate()。element.scroll() 提供了支持平滑滚动的原生选项。若要让某个具体子元素进入可视区域,应选择 scrollIntoView();若要设置容器自身的滚动位置,则使用前述容器滚动方案。