弹幕必须用position: absolute脱离文档流,由position: relative的容器包裹;top值需动态计算,滚动用transform: translateX()而非top;顶部/底部弹幕CSS类须分离;JS获取位置应使用getBoundingClientRect()并实时重算。

弹幕元素必须脱离文档流才能自由滚动
直接把弹幕 <div> 塞进普通容器里,它会受父级 <code>padding、margin、flex 或 grid 布局干扰,导致顶部/底部对齐失效。正确做法是让每条弹幕都用 position: absolute 定位,并由一个 position: relative 的弹幕容器包裹。
常见错误:用 top: 0 想贴顶,结果被外层 header 遮住;或设 bottom: 0 却卡在页面最底而非视频区域底部——本质是定位上下文错了。
- 弹幕容器(如
<div class="danmaku-container">)必须设 <code>position: relative,且高度明确(不能是height: auto) - 每条弹幕元素需动态计算
top值:顶部弹幕取0~60px范围,底部弹幕取容器高度减去自身行高再减0~60px - 避免用
vh单位算top,屏幕缩放或地址栏展开时会错位 - 初始
top决定它从哪一行“出生”(例如顶部弹幕统一设top: 12px,底部弹幕设top: calc(100% - 36px)) - 动画只操作
transform: translateX(),从100%到-100%,全程不碰布局属性 - 务必加
will-change: transform提前告知浏览器该元素将被变换 -
.danmaku-top:top: 8px~48px随机,font-size: 14px,动画from { transform: translateX(100%); } to { transform: translateX(-100%); } -
.danmaku-bottom:top: calc(100% - 40px),font-size: 13px,同样动画但起始top固定 - 禁用
z-index乱堆叠,顶部弹幕统一z-index: 10,底部统一z-index: 9
transform: translateY() 比 top 更适合平滑滚动
用 top 配合 transition 滚动会有卡顿,尤其在低端安卓机上。浏览器对 transform 的硬件加速支持更好,且不触发重排。
滚动逻辑其实是「起始位置 → 动画移出视野」,不是靠定时器不断改 top。一条弹幕的真实位置由两个值决定:top(初始垂直偏移) + transform: translateX(-100%)(水平滚动)。
立即学习“前端免费学习笔记(深入)”;
顶部/底部弹幕的 CSS 类要分离,不能共用同一套动画
很多人写一个 @keyframes danmaku-move 然后全弹幕复用,结果顶部弹幕滚着滚着掉到底部去了——因为没区分起始和结束位置的约束。
顶部弹幕应限制在容器上 1/3 区域内,底部弹幕则固定在下 1/3,否则视觉混乱。CSS 层面最稳妥的做法是定义两套类名:
JavaScript 控制弹幕生成时,offsetTop 不可靠,改用 getBoundingClientRect()
想让弹幕精确贴着视频画面上边缘?别读 video.offsetTop,它受 border、transform、scroll 影响极大。实际项目中,90% 的“顶部偏移不准”问题都出在这里。
正确方式是在插入弹幕前,实时获取容器相对于视口的位置,再减去滚动偏移:
const container = document.querySelector('.danmaku-container');
const rect = container.getBoundingClientRect();
const topOffset = rect.top + window.scrollY; // 这才是真实距页面顶部距离
// 然后根据这个值反推弹幕的初始 top(如果需要绝对定位到页面某处)- 不要缓存
getBoundingClientRect()结果,窗口 resize 或滚动后必须重算 - 移动端 Safari 对
getBoundingClientRect()返回值有 1px 浮点误差,建议Math.round()取整 - 如果容器本身有
transform,getBoundingClientRect()已自动包含,无需额外补偿
顶部和底部弹幕看似只是改个 top 值,但真正稳定运行要同时守住 CSS 定位上下文、动画属性选择、类名隔离、以及 JS 获取坐标的时机这四道关。漏掉任何一环,都会在特定机型或缩放比例下突然错位。



















