The Gamepad.axes
property of the Gamepad
interface returns an array representing the controls with axes present on the device (e.g. analog thumb sticks).
Each entry in the array is a floating point value in the range -1.0 – 1.0, representing the axis position from the lowest value (-1.0) to the highest value (1.0).
Syntax
readonly attribute double[] axes;
Example
function gameLoop() {
if(navigator.webkitGetGamepads) {
var gp = navigator.webkitGetGamepads()[0];
} else {
var gp = navigator.getGamepads()[0];
}
if(gp.axes[0] != 0) {
b -= gp.axes[0];
} else if(gp.axes[1] != 0) {
a += gp.axes[1];
} else if(gp.axes[2] != 0) {
b += gp.axes[2];
} else if(gp.axes[3] != 0) {
a -= gp.axes[3];
}
ball.style.left = a*2 + "px";
ball.style.top = b*2 + "px";
var start = rAF(gameLoop);
};
Value
An array of double
values.
Specifications
Specification | Status | Comment |
GamepadThe definition of 'Gamepad.axes' in that specification. | Working Draft | Initial definition |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
axes
|
Chrome Full support 35 Full support 35 No support 21 — 34 Prefixed' Implemented with the vendor prefix: webkit |
Edge
Full support 12 |
Firefox Full support 29 Full support 29 No support 24 — 28 Disabled' From version 24 until version 28 (exclusive): this feature is behind the |
IE
No support No |
Opera Full support 22 Full support 22 No support 15 — 21 Prefixed' Implemented with the vendor prefix: webkit |
Safari
Full support 10.1 |
WebView Android
No support No |
Chrome Android Full support 35 Full support 35 No support 25 — 34 Prefixed' Implemented with the vendor prefix: webkit |
Firefox Android
Full support 32 |
Opera Android Full support 22 Full support 22 No support 14 — 21 Prefixed' Implemented with the vendor prefix: webkit |
Safari iOS
Full support 10.3 |
Samsung Internet Android Full support 4.0 Full support 4.0 No support 2.0 — 3.0 Prefixed' Implemented with the vendor prefix: webkit |
Legend
- Full support
- Full support
- No support
- No support
- User must explicitly enable this feature.'
- User must explicitly enable this feature.
- Requires a vendor prefix or different name for use.'
- Requires a vendor prefix or different name for use.
See also
Gamepad.axes by Mozilla Contributors is licensed under CC-BY-SA 2.5.