You need to enable JavaScript to run this app. 如何在SwipperJS中同时启用垂直与水平双向滑动切换事件
优惠活动
大模型
产品
解决方案
定价
更多

如何在SwipperJS中同时启用垂直与水平双向滑动切换事件

SwiperJS实现横竖双向滑动切换的配置方案

核心事实:Swiper单实例原生仅支持单一方向的滑动绑定,不存在同时启用vertical和horizontal的原生配置,需根据实际业务场景选择对应实现路径:

场景1:单序列幻灯片,任意方向滑动均触发前后切换

适用场景:全屏引导页、沉浸式单序列内容展示,不区分滑动方向,只要用户滑过阈值就按主滑动方向触发对应切换逻辑。

  • 关键配置逻辑:先取消Swiper原生的单方向滑动拦截,通过监听触摸的起始、结束坐标,判断横纵方向的实际滑动位移,取位移绝对值更大的方向作为主触发方向,对应执行上一张/下一张的切换逻辑。
const swiper = new Swiper('.swiper', {
  // 基础交互参数按需配置
  threshold: 10, // 触发切换的最小滑动距离,可根据交互手感调整
  touchStartPreventDefault: false, // 放开原生方向拦截,保证双方向滑动事件可被捕获
  speed: 400,
  // 自定义滑动方向判断逻辑
  on: {
    touchStart(sw) {
      // 记录触摸起始坐标
      this.startX = sw.touchStartX
      this.startY = sw.touchStartY
    },
    touchEnd(sw) {
      const deltaX = sw.touchEndX - this.startX
      const deltaY = sw.touchEndY - this.startY
      // 取横纵滑动位移绝对值更大的方向作为主触发方向
      if (Math.abs(deltaX) > Math.abs(deltaY)) {
        // 横向交互逻辑:左滑切下一张,右滑切上一张
        deltaX < 0 ? sw.slideNext() : sw.slidePrev()
      } else {
        // 纵向交互逻辑:上滑切下一张,下滑切上一张,对齐通用移动端交互习惯
        deltaY < 0 ? sw.slideNext() : sw.slidePrev()
      }
    }
  }
})
  • 配套CSS配置,避免浏览器原生手势和Swiper事件冲突:
.swiper {
  width: 100%;
  height: 100%;
  touch-action: none;
}

场景2:嵌套层级的双向滑动(外层垂直/内层水平)

适用场景:需要实现“垂直滑动切换顶层大模块、每个大模块内部水平滑动切换子内容”的分层交互,此时不需要单实例双方向绑定,通过嵌套实例的事件透传机制即可实现双方向支持。

  • 关键配置:开启两个层级Swiper的nested参数,Swiper会自动识别滑动主方向,把对应方向的滑动事件下发给匹配的实例处理,从根源避免滑动冲突。
// 外层垂直滑动实例
new Swiper('.swiper-outer', {
  direction: 'vertical',
  nested: true,
  speed: 400
})
// 内层水平滑动实例(每个子模块单独初始化)
document.querySelectorAll('.swiper-inner').forEach(el => {
  new Swiper(el, {
    direction: 'horizontal',
    nested: true,
    speed: 400
  })
})

常见注意事项

  • 不要尝试给单个Swiper实例同时配置vertical和horizontal的direction参数,该参数为单值配置,强改会导致滑动失灵、事件穿透的问题
  • 自定义滑动逻辑时,threshold参数建议设置在8-15px区间,过小容易因为轻微误触触发切换,过大会降低交互灵敏度
  • 如果需要循环切换效果,可直接在实例配置中开启loop: true,自定义的滑动逻辑不会和loop机制产生冲突

内容的提问来源于stack exchange,提问作者Jonathan

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.20 10:54:11