GamepadEvent: gamepad 属性

Baseline 已广泛支持

此特性已得到良好确立,可跨多种设备和浏览器版本使用。自 2017 年 3 月起,所有浏览器均支持此特性。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

GamepadEvent 接口GamepadEvent.gamepad 属性返回一个 Gamepad 对象,它提供对与触发的 gamepadconnectedgamepaddisconnected 事件相关联的游戏手柄数据的访问。

一个 Gamepad 对象。

示例

在触发 gamepadconnected 事件时调用 gamepad 属性。

js
window.addEventListener("gamepadconnected", (e) => {
  console.log(
    "Gamepad connected at index %d: %s. %d buttons, %d axes.",
    e.gamepad.index,
    e.gamepad.id,
    e.gamepad.buttons.length,
    e.gamepad.axes.length,
  );
});

规范

规范
Gamepad
# dom-gamepadevent-gamepad

浏览器兼容性

另见

使用游戏手柄 API