如何在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
相关产品推荐
相关产品推荐

