1.0.9 • Published 4 years ago

on-swipe v1.0.9

Weekly downloads
12
License
MIT
Repository
github
Last release
4 years ago

on-swipe

Adds a swipe event do the DOM that reports direction, velocity, distance, and duration.

tldr;

import onSwipe from 'on-swipe';

// register swipe event emitter
onSwipe();

// listen for swipe event
document.addEventListener('swipe', (event) => {

    // use swipe
    console.log(event.detail);
})

Install

npm install --save on-swipe

Use

Call onSwipe() once after your app loads.

Syntax

onSwipe({options})
  • options is an object with the following optional properties:
    • node: document DOM node you want to broadcast the swipe event from.
    • sensitivity: 5 number of touch moves before emitting a swipe event.
    • bubbles: true if the event should bubble.
    • cancelable: true if the event.preventDefault() should work.

Returns

The swipe events event.detail attribute contains the following properties:

VariableTypeDescription
directionstringThe direction of the swipe in left, right, up, down
velocityfloatvelocity of swipe in pixels/millisecond
distancefloatdistance of swipe in pixels
durationintduration of swipe in milliseconds
dxfloatdistance of swipe x direction
dyfloatdistance of swipe y direction

Examples

Default

import onSwipe from 'on-swipe';

// register swipe event emitter
onSwipe();

// listen for swipe event
document.addEventListener('swipe', (event) => {

    // use swipe
    let { direction, velocity, distance, duration } = event.detail;
})

Options

import onSwipe from 'on-swipe';

// register swipe event emitter
onSwipe({ node: window, sensitivity: 10 });

// listen for swipe event
window.addEventListener('swipe', (event) => {

    // use swipe
    let { direction, velocity, distance, duration } = event.detail;
})
1.0.9

4 years ago

1.0.8

5 years ago

1.0.7

5 years ago

1.0.6

5 years ago

1.0.5

5 years ago

1.0.4

5 years ago

1.0.3

5 years ago

1.0.2

5 years ago

1.0.1

5 years ago