本教程详细探讨了自定义弹窗组件在开发中常见的重复显示问题，其根源在于JavaScript的定时器与CSS动画时长不匹配。文章通过分析CSS动画的`animation-duration`、`animation-delay`及`animation-fill-mode`属性，结合JavaScript的`setTimeout`，提供了一套完整的解决方案，旨在实现平滑、准确的UI交互效果。
在前端开发中，自定义弹窗（Toast、Alert）组件是提升用户体验的重要元素。然而，在实现这类组件的显示与隐藏逻辑时，开发者常会遇到一个棘手的问题：弹窗在预期消失后又短暂地再次出现，给人一种“重复执行”的错觉。本文将深入分析这一现象的成因，并提供一套基于JavaScript定时器与CSS动画同步的专业解决方案。
理解问题根源：JS与CSS动画的时序失配
自定义弹窗重复显示的核心原因在于JavaScript控制弹窗状态的逻辑（例如通过setTimeout移除CSS类）与CSS动画本身的生命周期不同步。当一个元素通过添加/移除CSS类来触发动画时，如果JavaScript在CSS动画完成之前或之后过早/过晚地移除了控制类，就可能导致视觉上的不一致。
具体到本例，问题出在以下两点：
立即学习“Java免费学习笔记（深入）”；
-
JavaScript setTimeout 延迟与 CSS 动画总时长不一致：
- CSS动画定义：animation: fadein 0.5s, fadeout 0.5s 2.5s;
- fadein动画持续0.5秒。
- fadeout动画持续0.5秒，但它在2.5秒的延迟后才开始。
- 这意味着，整个动画流程是：0-0.5s（淡入），0.5s-2.5s（保持显示），2.5s-3.0s（淡出）。因此，弹窗从显示到完全消失的总动画时长是3.0秒。
- 原始JavaScript duration 设置为4000毫秒（4秒）。这意味着JavaScript会在弹窗显示4秒后才移除.show类。
- 结果： CSS动画在3秒时完成并使弹窗淡出。然而，由于默认的CSS动画行为，动画结束后元素会回到其初始状态（即visibility: hidden在.show类被移除前仍处于激活状态），或者如果动画没有明确指定animation-fill-mode，它可能会短暂地“闪回”到动画开始前的状态。在3秒到4秒之间，弹窗的状态可能变得不确定或再次短暂可见，直到4秒时JavaScript最终移除.show类，才彻底消失，从而造成了“重复执行”的视觉效果。
- CSS动画定义：animation: fadein 0.5s, fadeout 0.5s 2.5s;
- 缺少 animation-fill-mode: forwards： 当CSS动画结束时，如果没有设置animation-fill-mode: forwards，元素会立即从动画的最终状态跳回到动画开始前的状态。这会导致弹窗在淡出动画完成后，如果.show类仍然存在，它可能会突然“闪现”回完全可见的状态，直到JavaScript最终移除.show类。
解决方案：同步JS定时器与CSS动画
解决此问题的关键在于确保JavaScript移除.show类的时间点与CSS动画完全结束的时间点精确同步，并利用animation-fill-mode来保持动画的最终状态。
1. 调整JavaScript setTimeout 延迟
根据CSS动画的总时长，我们需要将JavaScript中的duration属性调整为与CSS动画的实际结束时间一致。
在我们的例子中，fadein持续0.5s，fadeout在2.5s延迟后开始并持续0.5s。因此，fadeout在2.5s + 0.5s = 3.0s时完成。所以，JavaScript的duration应设置为3000毫秒。
class ToastHawaii {
constructor(config = {}) {
// 默认时长调整为3000ms，以匹配CSS动画
this.duration = typeof(config.duration) == 'undefined' ? 3000 : config.duration;
this.toastContainer = config.toastContainer;
}
makeToast(d) {
const html = `
${d.title}
${d.content}
`;
this.toastContainer.innerHTML = html;
this.toastContainer.classList.add("show");
// setTimeout的延迟时间与CSS动画总时长同步
setTimeout(() => {
this.toastContainer.classList.remove("show");
}, this.duration);
}
}
const mA = new ToastHawaii({
duration: 3000, // 确保这里也设置为3000ms
toastContainer: document.querySelector('#myAlertContainer')
});
const content = `ICON`;
document.querySelector("button").addEventListener('click', () => {
mA.makeToast({
title: "hello",
content: content
});
});2. 添加 animation-fill-mode: forwards
为了确保CSS动画在完成后能保持其最终状态（即完全淡出并消失），我们需要在.show类对应的CSS规则中添加animation-fill-mode: forwards。
#myAlertContainer.show {
visibility: visible;
animation: fadein 0.5s, fadeout 0.5s 2.5s;
/* 关键：确保动画结束后保持最终状态 */
animation-fill-mode: forwards;
}
/* 其他CSS规则保持不变 */
#myAlertContainer {
position: fixed;
left: 0%;
top: 30px;
visibility: hidden; /* 默认隐藏 */
width:100%;
z-index: 1;
height:60px;
}
.toast {
box-sizing: border-box;
display: flex;
justify-content: space-between;
align-items: center;
border-radius: 8px;
background: gray;
color: #000;
height:100%;
padding: 0 16px;
font-size: 0.8rem;
font-weight: bold;
margin: 0 auto;
max-width: 350px;
}
.right {
display: flex;
gap: 5px;
align-items: center;
}
@-webkit-keyframes fadein {
from {top: 0; opacity: 0;}
to {top: 30px; opacity: 1;}
}
@keyframes fadein {
from {top: 0; opacity: 0;}
to {top: 30px; opacity: 1;}
}
@-webkit-keyframes fadeout {
from {top: 30px; opacity: 1;}
to {top: 0; opacity: 0;}
}
@keyframes fadeout {
from {top: 30px; opacity: 1;}
to {top: 0; opacity: 0;}
}3. HTML结构
HTML结构保持不变，它提供了弹窗的容器和触发按钮。
hello
lorem ipsum
总结与最佳实践
通过上述调整，我们实现了JavaScript定时器与CSS动画的完美同步。当makeToast被调用时：
- #myAlertContainer获得.show类。
- CSS动画fadein和fadeout被触发，弹窗平滑地淡入，保持一段时间，然后淡出。
- 在动画开始的同时，一个setTimeout被设置，其延迟时间与CSS动画的总时长（3000ms）一致。
- 当CSS动画在3000ms时完成并使弹窗完全淡出时，animation-fill-mode: forwards确保弹窗保持在完全透明和顶部位置的状态。
- 几乎在同一时刻，setTimeout回调函数执行，移除.show类，进一步确认了弹窗的隐藏状态，避免了任何视觉上的闪烁或“重复显示”。
关键注意事项：
- 计算总动画时长： 务必准确计算所有动画（包括animation-delay）的总时长，以确保JavaScript的setTimeout与之匹配。
- animation-fill-mode: forwards 的重要性： 它是确保动画结束后元素保持最终状态的关键，尤其是在动画结束后立即移除控制类的情况下。
- 用户体验： 良好的UI动画不仅要平滑，还要逻辑清晰，避免任何可能引起用户困惑的“意外”行为。
遵循这些原则，您可以构建出稳定、高效且用户体验优秀的自定义UI组件。
