HomeGuidesReferenceLearn

Reference version

ArchiveExpo SnackDiscord and ForumsNewsletter

GestureHandler

GitHub

npm

A library that provides an API for handling complex gestures.


An API for handling complex gestures. From the project's README:

This library provides an API that exposes mobile platform-specific native capabilities of touch and gesture handling and recognition. It allows for defining complex gesture handling and recognition logic that runs 100% in the native thread and is therefore deterministic.

Platform Compatibility

Android DeviceAndroid EmulatoriOS DeviceiOS SimulatorWeb

Installation

Terminal
npx expo install react-native-gesture-handler

If you're installing this in a bare React Native app, you should also follow these additional installation instructions.

API

Add this import to the top of your app entry file, such as App.js:

import 'react-native-gesture-handler';

This will ensure that appropriate event handlers are registered with React Native. Now, you can import gesture handlers wherever you need them:

import { TapGestureHandler, RotationGestureHandler } from 'react-native-gesture-handler';

class ComponentName extends Component {
  render() {
    return (
      <TapGestureHandler>
        <RotationGestureHandler>...</RotationGestureHandler>
      </TapGestureHandler>
    );
  }
}

Usage

Read the react-native-gesture-handler docs for more information on the API and usage.