This page is Ready to Use

Notice: The WebPlatform project, supported by various stewards between 2012 and 2015, has been discontinued. This site is now available on github.

buttons

Summary

Array of values for all buttons of the gamepad.

Property of apis/gamepad/Gamepadapis/gamepad/Gamepad

Syntax

Note: This property is read-only.

var result = object.buttons;

Return Value

Returns an object of type

array of doubles.

Examples

The Gamepad API provides a function, Navigator.getGamepads, that returns a list of all devices currently visible to the web page, as an array of Gamepad objects. When a gamepad is connected, this example reports its index, id, number of buttons, number of axes, and when the gamepad data was updated.

window.addEventListener("gamepadconnected", function(e) {
  var gp = navigator.getGamepads()[e.gamepad.index];
  console.log("Gamepad connected.");
  console.log("Gamepad index:", gp.index);
  console.log("Gamepad id:", gp.id);
  console.log("Gamepad buttons:", gp.buttons.length);
  console.log("Gamepad axes:", gp.axes.length);
  console.log("Gamepad last updated:", gp.timestamp);
});

Related specifications

W3C Gamepad Specification
W3C Working Draft

Attributions

  • Mozilla Developer Network cc-by-sa-small-wpd.svg: Article