placeholder-wave动画一闪而过主因是CSS坐标系被破坏:父容器缺position: relative、有overflow: hidden或transform干扰,导致background-position失效;同时background-size与animation位移值不匹配、栅格布局引发尺寸不同步、display: none硬切造成视觉抽搐。

placeholder-wave 动画一闪而过,根本不是 JS 问题
动画“闪一下就停”或“只动一帧”,90% 情况下和 JavaScript 无关,是 CSS 坐标系被破坏导致的 background-position 位移失效。placeholder-wave 的本质是 background-position 在 x 轴上循环移动,它极度依赖父容器提供稳定、可预测的定位上下文。
- 父容器没设
position: relative:位移参考系变成html或视口,滚动时波纹直接“飞出屏幕” - 父容器有
overflow: hidden(比如.card默认带这个):动画所需的背景渐变延伸区域被硬裁掉,只剩半截条纹 - 父容器用了
transform: scale()、translateZ(0)或will-change: transform:这些会触发新层叠上下文,重置背景坐标系,background-position 失效
用栅格类(.col-6)套 placeholder 容器,动画必然错乱
Bootstrap 的栅格系统靠 flex + width 计算尺寸,而 placeholder-wave 动画帧和浏览器 layout 触发时机不同步——尤其是首次渲染或动态插入时,width 可能还没稳定,background-size 就已按错误尺寸渲染,造成条纹拉伸、断裂、跳帧。
- 别写:
- 改用显式尺寸:
- 如果必须响应式,用
aspect-ratio+max-width替代栅格,例如:style="max-width: 100%; aspect-ratio: 16/9;"
加载完成时用 display: none 切换,视觉上就是“抽搐”
直接执行 element.style.display = 'none' 或清空 innerHTML,会导致骨架动画最后一帧和真实内容的字体排版、行高计算完全脱节。用户看到的是:波纹刚停 → 瞬间空白 → 文字突然“弹”出来。
- 正确做法是用 opacity 渐变过渡:
transition: opacity .2s ease-out - 数据就绪后,先设
element.style.opacity = '0' - 监听
transitionend事件,再调用element.remove()或替换内容 - 绝对不要用
visibility: hidden—— 它保留布局空间,可能撑开卡片、影响后续 flex 排列
background-size 和 animation 里的位移值不匹配,条纹就拉伸断裂
.placeholder-wave 的动画效果强依赖 background-size 和 @keyframes 中 background-position 的数值协同。常见错误是把默认的 2rem 留着不动,但实际占位高度是 1.5rem 或 24px,结果条纹被压缩或拉长,看起来像“卡顿”或“闪烁”。
- 若占位高度为
1.5rem,应同步改两处:background-size: 1.5rem 100%和@keyframes placeholder-wave { background-position: -1.5rem 0 } - 检查是否漏了
animation: placeholder-wave 2s infinite,缺了这句就根本不会动 - 避免在父级或自身加
background-repeat: no-repeat—— 它会切断条纹连续性
动画真正稳下来的关键,往往藏在父容器那几行不起眼的 CSS 里:没有 position: relative,一切动画都是空中楼阁;没处理好 overflow 和 transform 的干扰,再准的 background-position 也会偏航。











