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`.
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.
<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
| Nome | Tipo | Descrição |
|---|---|---|
offset | Ref<number> | Deslocamento atual no eixo escolhido. |
dragging | Ref<boolean> | True enquanto o ponteiro estiver capturado. |
onPointerDown / Move / Up | (event: PointerEvent) => void | Handlers para ligar no elemento. |
snapFromVelocity | typeof snapFromVelocity | O mesmo helper de `gestures`, para decidir se o gesto completa. |
reset | () => void | Zera offset, velocidade e o estado de arraste. |
Demo
Exemplo ao vivo usando o próprio composable ou módulo, com componentes da lib.
API
PointerDragOptionsexport interface PointerDragOptions {
axis?: 'x' | 'y' | 'both'
min?: number
max?: number
rubberBand?: boolean
onCommit?: (offset: number, velocity: number) => void
onUpdate?: (offset: number, velocity: number) => void
}usePointerDragLiga listeners de ponteiro a um elemento e expõe offset, velocidade e helpers de commit.
usePointerDrag(elementRef: Ref<HTMLElement | null>, options: PointerDragOptions = {}) Fonte: src/composables/usePointerDrag.ts