GamepadButton.value

The GamepadButton.value property of the GamepadButton interface returns a double value used to represent the current state of analog buttons on many modern gamepads, such as the triggers.

The values are normalized to the range 0.01.0, with 0.0 representing a button that is not pressed, and 1.0 representing a button that is fully pressed.

Syntax

    readonly    attribute double  value;

Example

var gp = navigator.getGamepads()[0];

if(gp.buttons[0].value > 0) {
  // respond to analog button being pressed in
} 

Value

A double.

Specifications

Specification Status Comment
Gamepad
The definition of 'GamepadButton.value' in that specification.
Working Draft Initial definition

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support

35

21 — 34 webkit

Yes

29

24 — 281

No

22

15 — 21 webkit

No
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
Basic support No Yes Yes32 No No No

1. From version 24 until version 28 (exclusive): this feature is behind the dom.gamepad.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.

See also

Using the Gamepad API

Document Tags and Contributors

 Contributors to this page: fscholz, erikadoyle, Sebastianz, teoli, phil_nist, chrisdavidmills
 Last updated by: fscholz,