This is an archived page. It's not actively maintained.

nsIHapticFeedback

Draft
This page is not complete.

Implemented to provide support for haptic feedback (that is, vibration support).
1.0
66
Introduced
Gecko 2.0
Inherits from: nsISupports Last changed in Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

Implemented by: @mozilla.org/widget/hapticfeedback;1 as a service:

var hapticFeedback = Components.classes["@mozilla.org/widget/hapticfeedback;1"]
                     .getService(Components.interfaces.nsIHapticFeedback);

Once you have the service, you can initiate haptic feedback (that is, cause the device to vibrate, if it's supported) by calling performSimpleAction():

hapticFeedback.performSimpleAction(Components.interfaces.nsIHapticFeedback.LongPress);

Method overview

void performSimpleAction(in long isLongPress);

Constants

Press length constants

Constant Value Description
ShortPress 0 Specify as the action type to perform a short vibration.
LongPress 1 Specify as the action type to perform a long vibration.

Methods

performSimpleAction()

Perform haptic feedback.

void performSimpleAction(
  in long isLongPress
);
Parameters
isLongPress
The press length; this will determine how long the vibration should last. See Press length constants for permitted values.