Gesture Handler integration in React Native

Introduction

Gesture handlers let your app respond to touches like taps, swipes, and drags. They make your app feel smooth and natural.

You want to detect a tap on a button or image.

You want to add swipe actions to a list item.

You want to drag and move an object on the screen.

You want to handle complex gestures like pinch or long press.

You want better control over touch events than the default React Native touchables.

Syntax

React Native

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

function MyComponent() {
  const onSingleTap = () => {
    console.log('Tapped!');
  };

  return (
    <GestureHandlerRootView style={{ flex: 1 }}>
      <TapGestureHandler onActivated={onSingleTap}>
        <View style={{ width: 100, height: 100, backgroundColor: 'blue' }} />
      </TapGestureHandler>
    </GestureHandlerRootView>
  );
}

Always wrap your app or screen with GestureHandlerRootView to enable gesture handling.

Use specific gesture handlers like TapGestureHandler, PanGestureHandler, etc., for different gestures.

Examples

A simple tap gesture that shows an alert when tapped.

React Native

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

<TapGestureHandler onActivated={() => alert('Tapped!')}>
  <View style={{ width: 50, height: 50, backgroundColor: 'red' }} />
</TapGestureHandler>

A pan gesture that logs horizontal drag distance as you move your finger.

React Native

import { GestureHandlerRootView, PanGestureHandler } from 'react-native-gesture-handler';
import { View } from 'react-native';

<PanGestureHandler onGestureEvent={event => console.log(event.nativeEvent.translationX)}>
  <View style={{ width: 100, height: 100, backgroundColor: 'green' }} />
</PanGestureHandler>

Sample App

This app shows a blue box in the center. When you tap the box, an alert pops up saying "You tapped the box!". The whole screen is wrapped in GestureHandlerRootView to enable gestures.

React Native

import React from 'react';
import { View, Text, StyleSheet, Alert } from 'react-native';
import { GestureHandlerRootView, TapGestureHandler } from 'react-native-gesture-handler';

export default function App() {
  const onTap = () => {
    Alert.alert('You tapped the box!');
  };

  return (
    <GestureHandlerRootView style={styles.container}>
      <TapGestureHandler onActivated={onTap}>
        <View style={styles.box} />
      </TapGestureHandler>
      <Text style={styles.text}>Tap the blue box</Text>
    </GestureHandlerRootView>
  );
}

const styles = StyleSheet.create({
  container: { flex: 1, justifyContent: 'center', alignItems: 'center' },
  box: { width: 150, height: 150, backgroundColor: 'blue', borderRadius: 10 },
  text: { marginTop: 20, fontSize: 18 }
});

Important Notes

Make sure to install and link react-native-gesture-handler properly before using it.

Wrap your app's root component with GestureHandlerRootView to avoid gesture conflicts.

Gesture handlers provide better performance and flexibility than default touchables.

Summary

Gesture Handler lets you detect and respond to user touches like taps and swipes.

Wrap your app with GestureHandlerRootView to enable gestures.

Use specific handlers like TapGestureHandler for different gestures.

Practice

1. What is the main purpose of wrapping your React Native app with GestureHandlerRootView?

easy

A. To enable gesture detection and handling throughout the app

B. To style the app's background color

C. To improve app performance by caching views

D. To add navigation capabilities between screens

Solution

1. Step 1: Understand the role of GestureHandlerRootView

   This component is required to wrap the app so that gesture detection works properly across all child components.

2. Step 2: Differentiate from other purposes

   Styling, performance caching, or navigation are unrelated to GestureHandlerRootView's function.

3. Final Answer:

   To enable gesture detection and handling throughout the app -> Option A

4. Quick Check:

   GestureHandlerRootView enables gestures [OK]

Hint: GestureHandlerRootView enables gestures app-wide [OK]

Common Mistakes:

• Thinking it styles the app
• Confusing it with navigation setup
• Assuming it improves performance

2. Which of the following is the correct way to import the TapGestureHandler from react-native-gesture-handler?

easy

A. import { TapGestureHandler } from 'react-native';

B. import TapGestureHandler from 'react-native-gesture-handler';

C. import { TapGestureHandler } from 'react-native-gesture-handler';

D. import TapGestureHandler from 'react-native-gesture-handler/TapGestureHandler';

Solution

1. Step 1: Recall correct import syntax

   TapGestureHandler is a named export from 'react-native-gesture-handler', so it must be imported with curly braces.

2. Step 2: Eliminate incorrect imports

   Default import without braces is wrong, importing from 'react-native' is incorrect, and importing from a subpath is not standard.

3. Final Answer:

   import { TapGestureHandler } from 'react-native-gesture-handler'; -> Option C

4. Quick Check:

   Named imports use curly braces [OK]

Hint: Use curly braces for named imports like TapGestureHandler [OK]

Common Mistakes:

• Using default import instead of named import
• Importing from 'react-native' instead of gesture-handler
• Trying to import from a subpath

3. Given this code snippet, what will happen when the user taps the blue box?

import { TapGestureHandler, GestureHandlerRootView } from 'react-native-gesture-handler';
import React from 'react';
import { View, Text, Alert } from 'react-native';

export default function App() {
  const onTap = () => Alert.alert('Box tapped!');

  return (
    
      
        
      
    
  );
}

medium

A. An alert saying 'Box tapped!' will appear when the blue box is tapped

B. Nothing happens because onActivated is not a valid prop

C. The app will crash due to missing gesture handler setup

D. The blue box changes color when tapped

Solution

1. Step 1: Understand TapGestureHandler usage

   The onActivated prop triggers the callback when the tap gesture is recognized.

2. Step 2: Analyze the code behavior

   When the blue box is tapped, the onTap function runs, showing an alert with 'Box tapped!'.

3. Final Answer:

   An alert saying 'Box tapped!' will appear when the blue box is tapped -> Option A

4. Quick Check:

   onActivated triggers alert on tap [OK]

Hint: onActivated fires callback on tap gesture [OK]

Common Mistakes:

• Confusing onActivated with onPress
• Assuming no effect without extra setup
• Expecting color change without code

4. You wrote this code but the tap gesture is not detected. What is the likely cause?

import { TapGestureHandler } from 'react-native-gesture-handler';
import React from 'react';
import { View } from 'react-native';

export default function App() {
  const onTap = () => console.log('Tapped');

  return (
    
      
    
  );
}

medium

A. The style width and height are too small for detection

B. The app is missing the GestureHandlerRootView wrapper

C. The View component must be a Button for gestures

D. The onActivated prop should be onPress instead

Solution

1. Step 1: Check for GestureHandlerRootView presence

   Gesture handlers require the app to be wrapped in GestureHandlerRootView to work properly.

2. Step 2: Evaluate other options

   onActivated is correct, View can detect gestures, and size 100x100 is sufficient.

3. Final Answer:

   The app is missing the GestureHandlerRootView wrapper -> Option B

4. Quick Check:

   Missing GestureHandlerRootView blocks gestures [OK]

Hint: Always wrap app with GestureHandlerRootView [OK]

Common Mistakes:

• Using onPress instead of onActivated
• Thinking View can't detect gestures
• Assuming size is too small

5. You want to detect both tap and long press gestures on the same box using react-native-gesture-handler. Which approach correctly integrates both handlers?

hard

A. Use only TapGestureHandler with a long delay prop

B. Use PanGestureHandler instead for both tap and long press

C. Wrap the box in two sibling gesture handlers without nesting

D. Nest LongPressGestureHandler inside TapGestureHandler and handle callbacks separately

Solution

1. Step 1: Understand gesture handler nesting

   To detect multiple gestures on the same view, nest handlers so gestures can be recognized distinctly.

2. Step 2: Evaluate options

   Using only TapGestureHandler can't detect long press, siblings won't work well on same view, PanGestureHandler is for drag gestures.

3. Final Answer:

   Nest LongPressGestureHandler inside TapGestureHandler and handle callbacks separately -> Option D

4. Quick Check:

   Nesting handlers enables multiple gesture detection [OK]

Hint: Nest handlers to detect multiple gestures on one view [OK]

Common Mistakes:

• Trying to detect long press with TapGestureHandler only
• Using sibling handlers on same view without nesting
• Confusing PanGestureHandler with tap/long press