此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

gamepadconnected

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

gamepadconnected 事件会在浏览器检测到游戏控制器第一次连接或者第一次按下游戏键/摇杆的时候触发。

基本信息

文档

Gamepad

类型

事件

冒泡

No

可取消

No

Target

DefaultView (<window>)

默认操着

属性

Property Type Description
target 只读 DOMString 事件目标(DOM 树中的顶层,即 document.documentElement)。
type 只读 EventTarget 事件的类型。
bubbles 只读 Boolean 事件是否正常冒泡。
cancelable 只读 Boolean 事件是否可以取消。
gamepad 只读 Gamepad 单个游戏手柄属性,可用于访问关联游戏手柄的数据。

示例

js
// 请注意,在实现该 API 的浏览器中,该 API 仍为供应商前缀
window.addEventListener("gamepadconnected", function (event) {
  // 所有按钮和轴值均可通过以下方式访问
  event.gamepad;
});

规范

Specification
Gamepad
# event-gamepadconnected

相关事件

还可以参考