Skip to main content
Version: v5

@capacitor/haptics

The Haptics API provides physical feedback to the user through touch or vibration.

On devices that don't have Taptic Engine or Vibrator, the API calls will resolve without performing any action.

Installโ€‹

npm install @capacitor/haptics@latest-5
npx cap sync

Exampleโ€‹

import { Haptics, ImpactStyle } from '@capacitor/haptics';

const hapticsImpactMedium = async () => {
await Haptics.impact({ style: ImpactStyle.Medium });
};

const hapticsImpactLight = async () => {
await Haptics.impact({ style: ImpactStyle.Light });
};

const hapticsVibrate = async () => {
await Haptics.vibrate();
};

const hapticsSelectionStart = async () => {
await Haptics.selectionStart();
};

const hapticsSelectionChanged = async () => {
await Haptics.selectionChanged();
};

const hapticsSelectionEnd = async () => {
await Haptics.selectionEnd();
};

APIโ€‹

impact(...)โ€‹

impact(options?: ImpactOptions | undefined) => Promise<void>

Trigger a haptics "impact" feedback

ParamType
options
ImpactOptions

Since: 1.0.0


notification(...)โ€‹

notification(options?: NotificationOptions | undefined) => Promise<void>

Trigger a haptics "notification" feedback

ParamType
options
NotificationOptions

Since: 1.0.0


vibrate(...)โ€‹

vibrate(options?: VibrateOptions | undefined) => Promise<void>

Vibrate the device

ParamType
options
VibrateOptions

Since: 1.0.0


selectionStart()โ€‹

selectionStart() => Promise<void>

Trigger a selection started haptic hint

Since: 1.0.0


selectionChanged()โ€‹

selectionChanged() => Promise<void>

Trigger a selection changed haptic hint. If a selection was started already, this will cause the device to provide haptic feedback

Since: 1.0.0


selectionEnd()โ€‹

selectionEnd() => Promise<void>

If selectionStart() was called, selectionEnd() ends the selection. For example, call this when a user has lifted their finger from a control

Since: 1.0.0


Interfacesโ€‹

ImpactOptionsโ€‹

PropTypeDescriptionDefaultSince
style
ImpactStyle
Impact Feedback Style The mass of the objects in the collision simulated by a UIImpactFeedbackGenerator object.ImpactStyle.Heavy1.0.0

NotificationOptionsโ€‹

PropTypeDescriptionDefaultSince
type
NotificationType
Notification Feedback Type The type of notification feedback generated by a UINotificationFeedbackGenerator object.NotificationType.SUCCESS1.0.0

VibrateOptionsโ€‹

PropTypeDescriptionDefaultSince
durationnumberDuration of the vibration in milliseconds.3001.0.0

Enumsโ€‹

ImpactStyleโ€‹

MembersValueDescriptionSince
Heavy'HEAVY'A collision between large, heavy user interface elements1.0.0
Medium'MEDIUM'A collision between moderately sized user interface elements1.0.0
Light'LIGHT'A collision between small, light user interface elements1.0.0

NotificationTypeโ€‹

MembersValueDescriptionSince
Success'SUCCESS'A notification feedback type indicating that a task has completed successfully1.0.0
Warning'WARNING'A notification feedback type indicating that a task has produced a warning1.0.0
Error'ERROR'A notification feedback type indicating that a task has failed1.0.0