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.0 — 1.0, with 0.0 representing a button that is not pressed, and 1.0 representing a button that is fully pressed.

Example

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

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

Value

A double.

Specifications

Specification
Gamepad
# dom-gamepadbutton-value

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
value
35
21-34
12
29
No
22
15-21
10.1
No
Yes
32
22
14-21
10.3
Yes

See also

Using the Gamepad API

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/GamepadButton/value