Composables e utilitários

gestures

Composable / módulo

Utilitários puros de gesto (sem DOM): resistência elástica fora do intervalo e decisão de concluir um swipe a partir do deslocamento e da velocidade.

Importação
import { rubberBand, snapFromVelocity } from 'vueui-nova-kit'

Uso

Use com usePointerDrag ou com o seu próprio ponteiro. rubberBand amortece valores além de min/max; snapFromVelocity devolve se o gesto deve completar (threshold ou flick). GESTURE_DEFAULTS expõe os números padrão da lib.

Exemplo
import { rubberBand, snapFromVelocity, GESTURE_DEFAULTS } from 'vueui-nova-kit'

const offset = rubberBand(delta, -120, 0)
if (snapFromVelocity(-offset, velocity, GESTURE_DEFAULTS.swipeThreshold)) {
  // conclui o swipe
}

Retorno

NomeTipoDescrição
rubberBand(value, min, max, factor?) => numberDevolve o valor com resistência elástica fora de [min, max].
snapFromVelocity(offset, velocity, threshold?, flick?) => booleanIndica se o gesto deve completar, por distância ou por flick.
GESTURE_DEFAULTS{ swipeThreshold, flickVelocity, rubberBandFactor }Limiares padrão usados pelos componentes de swipe.

Demo

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

API

GESTURE_DEFAULTS

Constantes: swipeThreshold 80, flickVelocity 0.5, rubberBandFactor 0.35.

ts
GESTURE_DEFAULTS = { swipeThreshold: 80, flickVelocity: 0.5, rubberBandFactor: 0.35, } as const
rubberBand

Aplica um fator de resistência quando o valor sai do intervalo permitido.

ts
rubberBand(value: number, min: number, max: number, factor = GESTURE_DEFAULTS.rubberBandFactor): number
snapFromVelocity

Retorna true se o deslocamento passa do limiar ou se a velocidade caracteriza um flick.

ts
snapFromVelocity(offset: number, velocity: number, threshold = GESTURE_DEFAULTS.swipeThreshold, flick = GESTURE_DEFAULTS.flickVelocity): boolean

Fonte: src/motion/gestures.ts