transitionend会触发多次,因为每个过渡属性(如transform、opacity)完成时均独立触发事件;需通过e.propertyName精确过滤目标属性,避免状态错乱或漏处理。

transitionend 事件能监听 CSS 过渡结束,但直接绑定会出错——因为一个 transition 同时改多个属性(比如 transform 和 opacity),它会触发多次,你只处理一次就可能漏掉状态更新。
为什么 transitionend 会触发多次?
当一个元素同时设置了 transition: transform 0.3s, opacity 0.3s,浏览器会在 transform 完成时发一次 transitionend,opacity 完成时再发一次。如果你在回调里直接移除类、切换 DOM 或更新状态,大概率只响应了其中一次,导致视觉卡顿、步骤错位或状态不一致。
- 常见错误现象:步骤条切换后位置偏移、淡入动画完成但内容没显示、滑动容器卡在半途
- 根本原因不是代码写错了,而是没过滤
e.propertyName - Chrome/Firefox/Safari 行为一致,都按属性粒度触发
怎么正确监听单次完成?
用 e.propertyName 判断具体是哪个 CSS 属性过渡结束,只对目标属性做处理。例如你靠 transform 控制位移,那就只响应它:
htmlq 是一个命令行工具,使用 CSS 选择器从 HTML 中提取内容,相当于 jq 的 HTML 版本。该工具使用 Rust 编写,允许你通过 CSS 选择器将 HTML 管道化,直接从终端提取文本、属性和结构化内容。
element.addEventListener('transitionend', function(e) {
if (e.propertyName === 'transform') {
// ✅ 这里放 DOM 更新、类名清理、状态切换逻辑
element.classList.remove('is-transitioning');
}
});
- 如果同时依赖
opacity和transform,且两者必须都完成才执行后续动作,建议用setTimeout+ 计数,或改用getComputedStyle主动轮询(更可控) - 不要用
e.target.style.transition判断,它不可靠——样式可能来自 class 或外部 CSS - 移动端需注意:部分 Android WebView 对
transitionend支持不稳定,可加 fallback 超时兜底
transitionend 和 animate() 的关系
像 Zepto 的 animate()、jQuery 的 .animate(),底层其实也是监听 transitionend,只是封装了属性过滤、超时控制和回调队列。如果你自己手写动画逻辑,没必要重复造轮子;但若项目已去框架、或需精细控制(比如中断动画、逐帧调试),就必须亲手处理 transitionend 的多发问题。
立即学习“前端免费学习笔记(深入)”;
-
animate(properties, { duration: 300, complete: fn })内部做了propertyName过滤和 timeout 保底 - 纯 CSS 方案(只写 class + transition)更轻量,但回调必须自己写全,不能省
- 别混用:一边用
transition做位移,一边用animation做旋转,transitionend监听不到后者
最容易被忽略的是:过渡结束后是否要重置 transition 属性本身。比如你动态加了 transform: translateX(100px),动画完如果不手动清除 transition 声明,下一次仅改 opacity 也会被带出位移动画——这种隐式耦合,比监听漏掉还难排查。


















