---
title: gamepadconnected
slug: Web/API/Window/gamepadconnected_event
tags:
  - Gamepad
  - gamepadconnected
translation_of: Web/API/Window/gamepadconnected_event
---
<p><code>gamepadconnected</code> 事件会在浏览器检测到游戏控制器第一次连接或者第一次按下游戏键/摇杆的时候触发。</p>

<h2 id="基本信息">基本信息</h2>

<dl>
 <dt style="float: left; text-align: right; width: 120px;">文档</dt>
 <dd style="margin: 0 0 0 120px;"><a class="external" href="http://www.w3.org/TR/gamepad/#the-gamepadconnected-event">Gamepad</a></dd>
 <dt style="float: left; text-align: right; width: 120px;">类型</dt>
 <dd style="margin: 0 0 0 120px;">事件</dd>
 <dt style="float: left; text-align: right; width: 120px;">冒泡</dt>
 <dd style="margin: 0 0 0 120px;">No</dd>
 <dt style="float: left; text-align: right; width: 120px;">可取消</dt>
 <dd style="margin: 0 0 0 120px;">No</dd>
 <dt style="float: left; text-align: right; width: 120px;">Target</dt>
 <dd style="margin: 0 0 0 120px;">DefaultView (<code>&lt;window&gt;</code>)</dd>
 <dt style="float: left; text-align: right; width: 120px;">默认操着</dt>
 <dd style="margin: 0 0 0 120px;">无</dd>
</dl>

<h2 id="属性">属性</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Property</th>
   <th scope="col">Type</th>
   <th scope="col">Description</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td><code>target</code> 只读</td>
   <td>{{domxref("DOMString")}}</td>
   <td>事件目标（DOM树中的顶层，即document.documentElement）。</td>
  </tr>
  <tr>
   <td><code>type</code> 只读</td>
   <td>
    <p>{{domxref("EventTarget")}}</p>
   </td>
   <td>事件的类型。</td>
  </tr>
  <tr>
   <td><code>bubbles</code> 只读</td>
   <td>{{jsxref("Boolean")}}</td>
   <td>事件是否正常冒泡。</td>
  </tr>
  <tr>
   <td><code>cancelable</code> 只读</td>
   <td>{{jsxref("Boolean")}}</td>
   <td>事件是否可以取消。</td>
  </tr>
  <tr>
   <td><code>gamepad</code> 只读</td>
   <td>{{domxref("Gamepad")}}</td>
   <td>单个游戏手柄属性，可用于访问关联游戏手柄的数据。</td>
  </tr>
 </tbody>
</table>

<h2 id="示例">示例</h2>

<pre class="brush:js;">// 请注意，在实现该API的浏览器中，该API仍为供应商前缀
window.addEventListener("gamepadconnected", function( event ) {

    // 所有按钮和轴值均可通过以下方式访问
    event.gamepad;

});
</pre>

<h2 id="相关事件">相关事件</h2>

<ul>
 <li><a href="https://developer.mozilla.org/en-US/docs/Web/Reference/Events/gamepaddisconnected">gamepaddisconnected</a></li>
</ul>

<h2 id="还可以参考">还可以参考</h2>

<ul>
 <li><a href="/en-US/docs/API/Gamepad/Using_Gamepad_API">Using Gamepad API</a></li>
</ul>