本文详细介绍了如何在 fancybox 4 模态框关闭后移除指定的 css 类。针对 fancybox 3 中 `afterclose` 回调函数在 fancybox 4 中不再适用的情况，教程将指导读者利用 fancybox 4 全新的事件监听机制，特别是 `on: { destroy: ... }` 事件，来准确实现模态框完全关闭并从 dom 中移除后，对页面元素进行操作，例如移除特定的 css 类，确保页面状态的整洁和正确性。
在前端开发中，当使用模态框（如 Fancybox）展示内容时，我们经常需要在模态框关闭后执行一些清理或状态重置操作，例如移除模态框内容或背景元素上添加的临时 CSS 类。Fancybox 作为一个流行的 JavaScript 模态框库，在不同版本之间其 API 和事件处理机制有所演变。本文将聚焦于 Fancybox 4，详细阐述如何在其模态框完全关闭并销毁后，安全有效地移除指定的 CSS 类。
Fancybox 3 中的 afterClose 回调
在 Fancybox 3 版本中，实现模态框关闭后的操作相对直接，可以通过 afterClose 回调函数来完成。例如，若要在模态框关闭后移除 .modal-content 元素上的 active 类，代码通常如下所示：
$("[data-fancybox]").fancybox({
afterClose: function () {
// 在 Fancybox 3 中，afterClose 在模态框关闭动画完成后触发
$(".modal-content").removeClass("active");
},
});这种方式简洁明了，但在 Fancybox 4 中，afterClose 这一特定的回调已被新的事件系统所取代。
Fancybox 4 的事件监听机制
Fancybox 4 引入了一个更现代化和灵活的事件监听系统。它不再依赖于单一的 afterClose 或 beforeClose 等回调，而是通过 on 选项提供了一系列生命周期事件，允许开发者在模态框的不同阶段执行自定义逻辑。对于模态框完全关闭并从 DOM 中移除后的操作，最合适的事件是 destroy。
立即学习“前端免费学习笔记（深入）”；
destroy 事件在 Fancybox 实例被完全销毁并从 DOM 中移除后触发，这与 Fancybox 3 的 afterClose 行为最为接近，确保了在执行清理操作时，模态框相关的 DOM 元素已经不再存在或处于最终状态。
在 Fancybox 4 中实现类移除
要实现在 Fancybox 4 模态框销毁后移除特定 CSS 类，我们需要使用 Fancybox.bind 方法来绑定事件，并在 on 选项中监听 destroy 事件。
以下是具体的实现代码：
// 使用 Fancybox.bind 绑定 Fancybox 实例并监听事件
Fancybox.bind('[data-fancybox]', {
on: {
// 当 Fancybox 实例被销毁（即模态框完全关闭并从 DOM 中移除）时触发
destroy: function (fancybox, event) {
// 查找所有具有 .modal-content 类的元素
document.querySelectorAll('.modal-content').forEach(function (content) {
// 移除每个找到的元素上的 'active' 类
content.classList.remove('active');
});
},
},
});代码解析：
- Fancybox.bind('[data-fancybox]', { ... }): 这是 Fancybox 4 推荐的初始化方式，它会监听所有带有 data-fancybox 属性的元素，并在点击时创建 Fancybox 实例。第二个参数是一个配置对象。
- on: { ... }: 这是 Fancybox 4 的事件监听器集合。你可以在这里定义对各种生命周期事件的响应。
-
destroy: function (fancybox, event) { ... }: 这是我们关注的核心事件。
- destroy 事件在 Fancybox 实例完成其关闭动画并从 DOM 中完全移除后触发。
- fancybox 参数：代表当前的 Fancybox 实例对象，你可以通过它访问实例的属性和方法。
- event 参数：代表触发该事件的 DOM 事件对象。
-
document.querySelectorAll('.modal-content').forEach(function (content) { ... });:
- document.querySelectorAll('.modal-content')：这是一个标准的 JavaScript DOM API，用于选择文档中所有类名为 modal-content 的元素。它返回一个 NodeList。
- .forEach(function (content) { ... })：遍历 NodeList 中的每一个元素。对于每个元素，回调函数中的 content 参数就是当前遍历到的 DOM 元素。
- content.classList.remove('active')：这是 DOM 元素的 classList API，用于方便地操作元素的 CSS 类。remove('active') 会从当前元素中移除 active 类。
注意事项与最佳实践
- 选择正确的事件： destroy 事件适用于模态框完全关闭并从 DOM 中移除后的清理工作。如果你需要在模态框开始关闭动画前或关闭动画过程中执行操作，可以考虑其他事件，例如 close（在关闭动画开始时触发）或 done（在模态框内容加载完成时触发）。但对于“关闭后移除类”这种场景，destroy 通常是最稳妥的选择。
- 目标元素的精确性： 确保 document.querySelectorAll() 或 document.querySelector() 选择器能够准确地定位到你想要操作的元素。如果你的 .modal-content 元素是动态生成的，或者与 Fancybox 实例有特定的关联，你可能需要更精确的选择器，或者考虑在 Fancybox 实例的 content 或 container 属性中查找相关元素。
- 性能考量： 对于频繁打开和关闭的模态框，确保事件处理函数中的 DOM 操作是高效的。querySelectorAll 通常性能良好，但如果处理大量元素，仍需注意。
- 错误处理： 在实际应用中，你可能需要添加一些错误处理机制，例如检查元素是否存在后再尝试移除类，以避免潜在的运行时错误。
总结
Fancybox 4 通过其强大的事件监听机制，为开发者提供了在模态框生命周期各个阶段执行自定义操作的灵活性。通过监听 destroy 事件，我们可以轻松地实现在模态框完全关闭并从 DOM 中移除后，对页面上的其他元素进行清理，例如移除特定的 CSS 类。这种方法不仅解决了从 Fancybox 3 迁移到 Fancybox 4 的兼容性问题，也展现了 Fancybox 4 更加现代化和事件驱动的设计理念，有助于构建更健壮、更易于维护的交互式前端应用。
