当在页面中初始化多个 swiper 实例时，若所有实例共用相同的 `.swiper-button-next` 和 `.swiper-button-prev` 类名，swiper 会将点击事件绑定到**首个匹配的 dom 元素**，导致所有滑块被同一组箭头控制。根本解法是为每个 swiper 实例分配独立的导航、分页和滚动条选择器。
在 Webflow 或任何静态/动态站点中使用多个 Swiper 实例（如 .swiper2、.swiper3、.swiper4）时，一个常见却隐蔽的陷阱是：导航按钮、分页器、滚动条等 UI 控件未做实例隔离。虽然你为每个 Swiper 指定了不同的容器类（如 ".swiper2"），但若 navigation.nextEl、pagination.el 等选项仍复用相同 CSS 类名（例如全部设为 '.swiper-button-next'），Swiper 会按文档顺序查找第一个匹配元素并仅对其绑定事件——后续实例的箭头将无法独立工作，甚至全部触发首个 Swiper 实例。
✅ 正确做法：为每个 Swiper 实例配置唯一的选择器：
// Swiper 实例 2
var swiper2 = new Swiper(".swiper2", {
// ...其他配置保持不变
navigation: {
nextEl: '.swiper-button-next-2', // ← 唯一类名
prevEl: '.swiper-button-prev-2',
},
pagination: {
el: '.swiper-pagination-2', // ← 唯一分页器
},
scrollbar: {
el: '.swiper-scrollbar-2', // ← （可选）唯一滚动条
}
});
// Swiper 实例 3
var swiper3 = new Swiper(".swiper3", {
// ...其他配置保持不变
navigation: {
nextEl: '.swiper-button-next-3',
prevEl: '.swiper-button-prev-3',
},
pagination: {
el: '.swiper-pagination-3',
}
});
// Swiper 实例 4
var swiper4 = new Swiper(".swiper4", {
// ...其他配置保持不变
navigation: {
nextEl: '.swiper-button-next-4',
prevEl: '.swiper-button-prev-4',
},
pagination: {
el: '.swiper-pagination-4',
}
});
? 同时，请确保 HTML 中对应元素也使用匹配的唯一类名：
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
<!-- Swiper2 容器 --> <div class="swiper2"> <div class="swiper-wrapper">...</div> <div class="swiper-pagination-2"></div> <div class="swiper-button-prev-2"></div> <div class="swiper-button-next-2"></div> </div> <!-- Swiper3 容器 --> <div class="swiper3"> <div class="swiper-wrapper">...</div> <div class="swiper-pagination-3"></div> <div class="swiper-button-prev-3"></div> <div class="swiper-button-next-3"></div> </div> <!-- Swiper4 容器 --> <div class="swiper4"> <div class="swiper-wrapper">...</div> <div class="swiper-pagination-4"></div> <div class="swiper-button-prev-4"></div> <div class="swiper-button-next-4"></div> </div>
⚠️ 注意事项：
- 不要省略 el 属性值中的点号（.），否则 Swiper 会将其识别为标签名而非类选择器；
- 在 Webflow 中，需通过自定义代码区域或嵌入 HTML 组件手动添加带唯一类名的导航按钮（Webflow 默认生成的 .swiper-button-* 是全局共享的）；
- 若使用 Swiper 的 dynamicBullets: true 或其他依赖分页器结构的功能，请确保每个分页器容器类名唯一且结构一致；
- 推荐配合 watchOverflow: true 防止因响应式切换导致导航按钮失效。
? 总结：Swiper 的导航与分页机制基于 CSS 选择器单次匹配，而非“作用域绑定”。多实例共存的前提是 UI 控件选择器完全隔离——这不是 Bug，而是设计使然。只要为每个实例分配专属类名，并在 HTML 中一一对应，即可实现真正的独立控制。
