解决自定义弹窗重复显示问题：JavaScript与CSS动画的同步策略

本教程详细探讨了自定义弹窗组件在开发中常见的重复显示问题，其根源在于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免费学习笔记（深入）”；

1. 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类，才彻底消失，从而造成了“重复执行”的视觉效果。
2. 缺少 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动画的实际结束时间一致。

绘蛙-多图成片

绘蛙新推出的AI图生视频工具

133

查看详情

在我们的例子中，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 = `<div class="toast">
          <div>${d.title}</div>
          <div class="right">${d.content}</div>
        </div>`;
        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结构保持不变，它提供了弹窗的容器和触发按钮。

<div id="myAlertContainer"></div>
<button>makeAlert!</button>
<h1>hello</h1>
<p>lorem ipsum</p>

总结与最佳实践

通过上述调整，我们实现了JavaScript定时器与CSS动画的完美同步。当makeToast被调用时：

1. #myAlertContainer获得.show类。
2. CSS动画fadein和fadeout被触发，弹窗平滑地淡入，保持一段时间，然后淡出。
3. 在动画开始的同时，一个setTimeout被设置，其延迟时间与CSS动画的总时长（3000ms）一致。
4. 当CSS动画在3000ms时完成并使弹窗完全淡出时，animation-fill-mode: forwards确保弹窗保持在完全透明和顶部位置的状态。
5. 几乎在同一时刻，setTimeout回调函数执行，移除.show类，进一步确认了弹窗的隐藏状态，避免了任何视觉上的闪烁或“重复显示”。

关键注意事项：

• 计算总动画时长： 务必准确计算所有动画（包括animation-delay）的总时长，以确保JavaScript的setTimeout与之匹配。
• animation-fill-mode: forwards 的重要性： 它是确保动画结束后元素保持最终状态的关键，尤其是在动画结束后立即移除控制类的情况下。
• 用户体验： 良好的UI动画不仅要平滑，还要逻辑清晰，避免任何可能引起用户困惑的“意外”行为。

遵循这些原则，您可以构建出稳定、高效且用户体验优秀的自定义UI组件。

以上就是解决自定义弹窗重复显示问题：JavaScript与CSS动画的同步策略的详细内容，更多请关注php中文网其它相关文章！