Expo

Get Started
API Reference

Haptics

expo-haptics provides haptic (touch) feedback for
  • iOS 10+ devices using the Taptic Engine
  • Android devices using Vibrator system service.
On iOS, the Taptic engine will do nothing if any of the following conditions are true on a user's device:
  • Low Power Mode is enabled (Feature Request)
  • User disabled the Taptic Engine in settings (Feature Request)
  • Haptic engine generation is too low (less than 2nd gen) - Private API
    • Using private API will get your app rejected: [[UIDevice currentDevice] valueForKey: @"_feedbackSupportLevel"] so this is not added in Expo
  • iOS version is less than 10 (iPhone 7 is the first phone to support this)
    • This could be found through: Constants.platform.ios.systemVersion or Constants.platform.ios.platform

Platform Compatibility

Android DeviceAndroid EmulatoriOS DeviceiOS SimulatorWeb

Installation

expo install expo-haptics

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

On Android, this module requires permission to control vibration on the device. The VIBRATE permission is added automatically.

import * as Haptics from 'expo-haptics';

  • Promise<void>

A Promise which fulfils once native size haptics functionality is triggered.


The kind of notification response used in the feedback.

A Promise which fulfils once native size haptics functionality is triggered.


Used to let a user know when a selection change has been registered.

A Promise which fulfils once native size haptics functionality is triggered.

The mass of the objects in the collision simulated by a UIImpactFeedbackGenerator object UINotificationFeedbackStyle

  • ImpactFeedbackStyle.Heavy : "heavy" - A collision between large, heavy user interface elements.
  • ImpactFeedbackStyle.Light : "light" - A collision between small, light user interface elements.
  • ImpactFeedbackStyle.Medium : "medium" - A collision between moderately sized user interface elements.

The type of notification feedback generated by a UINotificationFeedbackGenerator object. UINotificationFeedbackType

  • NotificationFeedbackType.Error : "error" - A notification feedback type indicating that a task has failed.
  • NotificationFeedbackType.Success : "success" - A notification feedback type indicating that a task has completed successfully.
  • NotificationFeedbackType.Warning : "warning" - A notification feedback type indicating that a task has produced a warning.