当在页面中初始化多个 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 中对应元素也使用匹配的唯一类名:
... ... ...
⚠️ 注意事项:
? 总结:Swiper 的导航与分页机制基于 CSS 选择器单次匹配,而非“作用域绑定”。多实例共存的前提是 UI 控件选择器完全隔离——这不是 Bug,而是设计使然。只要为每个实
例分配专属类名,并在 HTML 中一一对应,即可实现真正的独立控制。