Swiper 11 迁移指南

循环模式

循环模式在 v11 中得到了显著改进，这里只有一个需要注意的破坏性更改

• loopedSlides 参数已被移除。如果它破坏了您的滑块循环行为，请尝试使用新的 loopAdditionalSlides 参数

元素事件前缀

所有 Swiper 元素事件现在默认以 swiper 作为前缀。您需要修改代码以监听新事件，或者通过指定 eventsPrefix: ''（空字符串）参数来恢复之前的行为。

<swiper-container> ... </swiper-container>
<script>
  const swiperEl = document.querySelector('swiper-container');

  // listen for `slideChange` event
  swiperEl.addEventListener('swiperslidechange', onSlideChange);
</script>

溢出隐藏

在 Swiper v11 中，容器的 overflow CSS 属性默认设置为 hidden。如果它破坏了您的布局，只需添加自定义 CSS 样式即可。

.swiper {
  overflow: clip;
}