React-use-gesture NPM | npm.io

9.1.3 • Published 3 years ago

Install

Weekly downloads

92,893

License

MIT

Repository

Last release

3 years ago

React UseGesture

npm bundle size NPM Travis (.org) branch

React UseGesture is a hook that lets you bind richer mouse and touch events to any component or view. With the data you receive, it becomes trivial to set up gestures, and often takes no more than a few lines of code.

You can use it stand-alone, but to make the most of it you should combine it with an animation library like react-spring, though you can most certainly use any other.

Installation

#Yarn
yarn add react-use-gesture

#NPM
npm install react-use-gesture

Full documentation website

Simple example

import { useSpring, animated } from 'react-spring'
import { useDrag } from 'react-use-gesture'

function PullRelease() {
  const [{ x, y }, set] = useSpring(() => ({ x: 0, y: 0 }))

  // Set the drag hook and define component movement based on gesture data
  const bind = useDrag(({ down, movement: [mx, my] }) => {
    set({ x: down ? mx : 0, y: down ? my : 0 })
  })

  // Bind it to a component
  return <animated.div {...bind()} style={{ x, y, touchAction: 'none' }} />

The example above makes a div draggable so that it follows your mouse on drag, and returns to its initial position on release.

Make sure you always set touchAction on a draggable element to prevent glitches with the browser native scrolling on touch devices.

Available hooks

React-use-gesture exports several hooks that can handle different gestures:

Hook	Description
`useDrag`	Handles the drag gesture
`useMove`	Handles mouse move events
`useHover`	Handles mouse enter and mouse leave events
`useScroll`	Handles scroll events
`useWheel`	Handles wheel events
`usePinch`	Handles the pinch gesture
`useGesture`	Handles multiple gestures in one hook

More on the full documentation website...

react hook gesture mouse trackpad touch drag pinch rotate scale zoom scroll wheel

@nattlivet/react-pully atlasgroup-react-atlantic r3f-sdk-test @vdjurdjevic/react-toolkit zds-react-desktop zds-react-desktop3 zds-react-desktop4 zds-react-desktop5 cf-storybook gatsby-theme-evelan gatsby-theme-sanity-evelan @zebra-fed/zds-react-mini use-amazon @nicklabs/uikit @enlighthq/modals audio-tour-hamada @nicklabs/uikit-react react-drawing-board-custom react-drawing-custom react-drawing-customize @alpin11/cookie-monster n1k1tk-react-spring-bottom-sheet @maker-ui/components xiaowei-ui11 drawing-canvas-custom puil3.0 maccha.manager prova-react-three-fiber treatment-viwer sid-npm-test3 sid-npmtest-1 sid-npmtest-2 sid-test-create-npm @lxjx/blink-ui @lxjx/flicker @gelatonetwork/stop-limit-orders-react react-bim @puneet_epigraph/epigraph_configurator_ui anm.pa.search.widget @kkit/react-dataloader @academysports/ui-component-library @everything-registry/sub-chunk-2621 universal-components-library-v3 universal-components-library @alpin11/cookie-devil jas-react-spring-bottom-sheet itauros-ui guiw5-bottom-sheet handwrite-custom-1 handwrite-custom-ver1.1 handwrite-custom-ver2 kosmos-ui react-sortful-nested oscod-slider mui-bottom-sheet next-landing ombra m78 mhyd my-crazy-react-test-thing mollectorgame-sdk qubic-lib qubic qubic-vis synalgic-components stonelight ui-react-csv-uploader ubeswap-header ubeswap-swap-dev unitx-ui react-liquidswipe react-animated-bottomsheet react-chromeless-gallery react-overflowed react-player-controls react-planet react-planet-r18 solidoc-base-component-lib soulswap-limit-orders-react soulswap-stop-limit-orders-react shed-builder server-os-uikit roundy stf-screenshare recycling-react-carousel retool-react-spring-bottom-sheet react-horizontal react-home-harmony react-c4 react-atlantic react-bottom-sheet-web react-csv-importer-v2 react-drawing-board react-drawing-board-ver1 react-card-memory react-the1-lightbox react-simple-picker react-slider-measure react-spring-lightbox react-spring-pan-zoom

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago