Touch Pan Directive

类星体提供了功能齐全的 Vue 指令,可以完全取代像Hammerjs这样的库:v-touch-pan, v-touch-swipe, v-touch-hold,甚至v-touch-repeat

这些指令不仅可以处理鼠标事件,还可以处理触摸事件,所以您可以用它们在您的 App 中完成一些很酷的事情。

下面我们将讲述v-touch-pan指令

TouchPan API

Loading TouchPan API...

用法

在下面的示例区域中,点击后往一个方向平移,然后查看页面的变化。在有触摸功能的设备上,上下平移时,页面滚动会被禁用。

TIP

如果您的内容带有图片,您可能需要给它们添加draggable="false"属性,否则浏览器的原生事件可能会起副作用。




平移可以运行于鼠标和触摸事件。也可以指定平移的方向。例如只捕获水平方向的平移。

注意,在有触摸功能的设备上,滚动不会被自动阻止,因为我们只是水平平移。




下面的示例只捕获垂直方向的平移,页面滚动会被禁用,但是您希望的话,也可以选择不禁用。




下面的示例演示如何使用`up`, `down`, `left`, `right`这四个修饰符来捕获自定义方向的平移。

页面滚动会被自动禁用,但是您希望的话,也可以选择不禁用。




处理鼠标事件

当您想处理鼠标事件时,使用mouse修饰符:

<!--
  指令也会被鼠标操作触发
-->
<div v-touch-pan.mouse="userHasPanned">...</div>

禁用页面滚动 (在有触摸功能的设备上)

默认情况请下,这个指令不会阻止页面的滚动,但是您希望阻止页面滚动的话,使用 prevent修饰符。

<div v-touch-pan.prevent="userHasPanned">...</div>

Inhibiting TouchPan

您可以通过阻止内部元素touchstart/mousedown事件的冒泡行为来抑制 TouchPan 事件:

<div v-touch-pan.mouse="userHasHold">
  <!-- ...content -->
  <div @touchstart.stop @mousedown.stop>
    <!--
      TouchPan 事件不会应用到这里, 因为我们
      在 touchstart 和 mousedown 事件上
      调用了 stopPropagation()
    -->
  </div>
  <!-- ...content -->
</div>

然而,若您使用capture 或者 mouseCapture修饰符,则事件会先到达 TouchPan 指令,然后才是内部元素,所以 TouchPan 事件仍然会被触发。

FAB 示例

下面是一个使用 QFab 的优秀示例,您可以拖拽它穿出屏幕。




注意热更新相关

由于性能的原因,不是所有的修饰符都是 reactive 的,有一些需要刷新页面才能更新,请在 API 卡片中检查的哪些修饰符不具备 reactive