--- title: GamepadEvent slug: Web/API/GamepadEvent translation_of: Web/API/GamepadEvent --- <p>{{APIRef("Gamepad API")}}</p> <p>Gamepad API 的 GamepadEvent 接口包含对连接到系统的控制器的引用,这也是 gamepad 事件events {{domxref("Window.gamepadconnected")}} 与 {{domxref("Window.gamepaddisconnected")}} 被触发时响应的内容。</p> <h2 id="构造函数">构造函数</h2> <dl> <dt>{{domxref("GamepadEvent.GamepadEvent","GamepadEvent()")}}</dt> <dd>返回一个新的 <code>GamepadEvent</code> 对象。</dd> </dl> <h2 id="属性">属性</h2> <dl> <dt>{{ domxref("GamepadEvent.gamepad") }} {{readonlyInline}}</dt> <dd>返回一个 {{ domxref("Gamepad") }} 对象,提供触发事件的控制器数据的访问。</dd> </dl> <h2 id="示例">示例</h2> <p>在触发的 {{domxref("Window.gamepadconnected")}} 事件上调用控制器属性。</p> <pre class="brush: js">window.addEventListener("gamepadconnected", function(e) { console.log("控制器已连接于 %d 位:%s。 %d 个按键,%d 个坐标方向。", e.gamepad.index, e.gamepad.id, e.gamepad.buttons.length, e.gamepad.axes.length); });</pre> <p>与 {{domxref("Window.gamepaddisconnected")}} 事件上的。</p> <pre class="brush: js">window.addEventListener("gamepaddisconnected", function(e) { console.log("控制器已从 %d 位断开:%s", e.gamepad.index, e.gamepad.id); });</pre> <h2 id="规范">规范</h2> <table class="standard-table"> <tbody> <tr> <th scope="col">规范</th> <th scope="col">状态</th> <th scope="col">备注</th> </tr> <tr> <td>{{SpecName("Gamepad", "#gamepadevent-interface", "GamepadEvent")}}</td> <td>{{Spec2("Gamepad")}}</td> <td>Initial definition</td> </tr> </tbody> </table> <h2 id="Browser_compatibility" name="Browser_compatibility">浏览器兼容性</h2> <p>{{Compat("api.GamepadEvent")}}</p> <h2 id="另请参阅">另请参阅</h2> <p><a href="/en-US/docs/Web/Guide/API/Gamepad">使用 Gamepad API</a></p>