Composables e utilitários

usePointerDrag

Composable / módulo

Arraste por ponteiro em um elemento, com eixo (`x`, `y` ou ambos), limites, rubber band e velocidade no `pointerup`.

Importação
import { usePointerDrag } from 'vueui-nova-kit'

Uso

Passe um ref do elemento e ligue onPointerDown, onPointerMove e onPointerUp. Com rubberBand e min/max, o offset resiste além dos limites. onCommit recebe o deslocamento e a velocidade no fim do gesto.

Exemplo
<script setup lang="ts">
import { ref } from 'vue'
import { usePointerDrag } from 'vueui-nova-kit'

const el = ref<HTMLElement | null>(null)
const { offset, dragging, onPointerDown, onPointerMove, onPointerUp } = usePointerDrag(el, {
  axis: 'x',
  min: -80,
  max: 80,
  rubberBand: true,
})
</script>

<template>
  <div
    ref="el"
    @pointerdown="onPointerDown"
    @pointermove="onPointerMove"
    @pointerup="onPointerUp"
    :style="{ transform: `translateX(${offset}px)` }"
  >
    Arraste
  </div>
</template>

Retorno

NomeTipoDescrição
offsetRef<number>Deslocamento atual no eixo escolhido.
draggingRef<boolean>True enquanto o ponteiro estiver capturado.
onPointerDown / Move / Up(event: PointerEvent) => voidHandlers para ligar no elemento.
snapFromVelocitytypeof snapFromVelocityO mesmo helper de `gestures`, para decidir se o gesto completa.
reset() => voidZera offset, velocidade e o estado de arraste.

Demo

Exemplo ao vivo usando o próprio composable ou módulo, com componentes da lib.

API

PointerDragOptions
ts
export interface PointerDragOptions {
  axis?: 'x' | 'y' | 'both'
  min?: number
  max?: number
  rubberBand?: boolean
  onCommit?: (offset: number, velocity: number) => void
  onUpdate?: (offset: number, velocity: number) => void
}
usePointerDrag

Liga listeners de ponteiro a um elemento e expõe offset, velocidade e helpers de commit.

ts
usePointerDrag(elementRef: Ref<HTMLElement | null>, options: PointerDragOptions = {})

Fonte: src/composables/usePointerDrag.ts