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.
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
Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | 35 21 — 34 webkit | Yes | 29 24 — 281 | No | 22 15 — 21 webkit | No |
Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
Basic support | No | Yes | Yes | 32 | 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.