如何实现多个独立定时消失的 Toast 通知(JavaScript 教程)

星婷君_6420

星婷君_6420

2026-08-16

287人浏览

原创

如何实现多个独立定时消失的 Toast 通知(JavaScript 教程)

本文详解如何使用原生 javascript 构建支持多实例、各自独立倒计时与自动移除的 toast 通知系统,解决堆叠错位、z-index 冲突及手动关闭逻辑错误等常见问题。

本文详解如何使用原生 javascript 构建支持多实例、各自独立倒计时与自动移除的 toast 通知系统,解决堆叠错位、z-index 冲突及手动关闭逻辑错误等常见问题。

在实际开发中,一个健壮的 Toast 通知系统不应仅满足“弹出即消失”,更需支持多实例并存、每个通知拥有独立生命周期、动态布局不遮挡底层交互元素(如按钮)。原始代码存在几个关键缺陷:z-index 被错误地反复设置为 -1 导致容器失效;所有通知共用同一全局 setTimeout 延时(5s),无法个性化;动画移除后未及时清理 DOM,造成视觉堆叠与点击穿透失效。

以下是一个经过重构、生产就绪的解决方案:

Alibabacloud Sdk Client Initialization For Java
Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

✅ 核心改进点

  • 每个 Toast 实例绑定专属 timeoutId,支持自定义持续时间(毫秒);
  • 容器 .container-alert 保持固定 z-index: 9999,绝不设为 -1 —— 元素级控制显隐,而非容器级禁用;
  • 使用 CSS transform: translateY() + opacity 实现平滑进出动画,避免 display: none 导致的布局重排;
  • 手动关闭与自动消失均触发相同清理流程,确保 DOM 和内存零残留。

?️ 优化后的完整代码

function toastNotification(msg, duration = 5000) {
  const alertContainer = document.querySelector(".container-alert");
  const newAlert = document.createElement("div");
  newAlert.className = "alert showAlert";
  newAlert.innerHTML = `
    <svg xmlns="http://www.w3.org/2000/svg" width="1.5rem" height="1.5rem" viewbox="0 0 48 48"><defs><mask id="ipSCheckOne0"><g fill="none" stroke-linejoin="round" stroke-width="4"><path fill="#fff" stroke="#fff" d="M24 44a19.937 19.937 0 0 0 14.142-5.858A19.937 19.937 0 0 0 44 24a19.938 19.938 0 0 0-5.858-14.142A19.938 19.938 0 0 0 24 4A19.938 19.938 0 0 0 9.858 9.858A19.938 19.938 0 0 0 4 24a19.937 19.937 0 0 0 5.858 14.142A19.938 19.938 0 0 0 24 44Z"></path><path stroke="#000" stroke-linecap="round" d="m16 24l6 6l12-12"></path></g></mask></defs><path fill="#30d300" d="M0 0h48v48H0z" mask="url(#ipSCheckOne0)"></path></svg><span class="msg">${msg}</span>
    <div class="close-btn"><i class="fas fa-times"></i></div>
  `;

  // 插入到容器顶部(保证新通知在最上层)
  alertContainer.insertBefore(newAlert, alertContainer.firstChild);

  // 启动专属倒计时
  const timeoutId = setTimeout(() => {
    newAlert.classList.remove("showAlert");
    newAlert.classList.add("hide");
    setTimeout(() => {
      if (newAlert.parentNode === alertContainer) {
        alertContainer.removeChild(newAlert);
      }
    }, 300); // 匹配 CSS 动画时长
  }, duration);

  // 绑定关闭按钮事件(同样清除专属 timeout)
  const closeBtn = newAlert.querySelector(".close-btn");
  closeBtn.addEventListener("click", () => {
    clearTimeout(timeoutId);
    newAlert.classList.remove("showAlert");
    newAlert.classList.add("hide");
    setTimeout(() => {
      if (newAlert.parentNode === alertContainer) {
        alertContainer.removeChild(newAlert);
      }
    }, 300);
  });
}

// ✅ 正确调用示例:每个通知独立定时
toastNotification("✅ 商品已加入购物车!", 4000);
setTimeout(() => toastNotification("⚠️ 库存紧张,请尽快结算", 6000), 800);
setTimeout(() => toastNotification("? 优惠券已生效", 3000), 1600);

? 关键 CSS 补充(修复原始样式)

.container-alert {
  position: fixed;
  right: 1rem;
  bottom: 1rem;
  z-index: 9999; /* 固定高优先级,不再动态修改 */
  width: 27rem;
  display: flex;
  flex-direction: column;
  gap: 0.75rem; /* 确保通知间有间距 */
  pointer-events: none; /* 容器不拦截点击 */
}

.alert {
  background-color: #fff;
  border-radius: 0.5rem;
  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
  padding: 0.75rem 1rem;
  display: flex;
  align-items: center;
  gap: 0.75rem;
  font-weight: 500;
  opacity: 0;
  transform: translateY(20px);
  transition: opacity 0.3s ease, transform 0.3s ease;
  pointer-events: auto; /* 仅通知本身可交互 */
}

.alert.showAlert {
  opacity: 1;
  transform: translateY(0);
}

.alert.hide {
  opacity: 0;
  transform: translateY(20px);
}

.close-btn {
  margin-left: auto;
  cursor: pointer;
  color: #999;
  font-size: 1.1rem;
}
.close-btn:hover {
  color: #333;
}

⚠️ 注意事项与最佳实践

  • 禁止动态修改容器 z-index:原始代码中 alertContainer.style.zIndex = "-1" 是根本性错误——它使整个容器不可见且无法响应事件。应始终通过 opacity 和 transform 控制单个 Toast 的显隐。
  • 使用 insertBefore 而非 appendChild:确保新通知始终显示在最上方,避免被旧通知遮挡。
  • 清理 timeoutId:手动关闭时务必 clearTimeout(timeoutId),防止已关闭通知仍触发自动移除,引发异常。
  • 动画时长同步:CSS 中 transition: 0.3s 必须与 JS 中 setTimeout(..., 300) 严格一致,否则出现闪烁或残留。
  • 无障碍增强(可选):为 .alert 添加 role="alert" 和 aria-live="polite",提升屏幕阅读器兼容性。

通过以上重构,你的 Toast 系统将真正具备工业级稳定性:多个通知可同时存在、各自按设定时间优雅消失、底层页面元素(如“加入购物车”按钮)全程可点击,且代码清晰、可维护性强。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

javascript java

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

4186

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

1069

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

4064

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

840

4

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

1716

5

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

2023.09.04

3045

4

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

2023.09.12

3973

6

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

2023.09.20

2540

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

828

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 11.9万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.5万人学习