Back to Content

GamepadButton: value property

files/en-us/web/api/gamepadbutton/value/index.md

latest756 B
Original Source

{{APIRef("Gamepad API")}}{{SecureContext_Header}}

The GamepadButton.value property of the {{domxref("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.

Examples

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

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

Value

A double.

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

Using the Gamepad API