Window: gamepadconnected 事件

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

當瀏覽器檢測到遊戲手柄已連線,或者遊戲手柄的第一個按鈕/軸被使用時,會觸發 gamepadconnected 事件。

如果文件的 gamepad 許可權策略 禁止,則此事件不會觸發。

此事件不可取消,也不會冒泡。

語法

在諸如 addEventListener() 之類的方法中使用事件名稱,或設定事件處理程式屬性。

js
addEventListener("gamepadconnected", (event) => { })

ongamepadconnected = (event) => { }

示例

要獲知遊戲手柄何時連線,您可以使用 addEventListener() 在 window 上新增一個處理程式,如下所示:

js
window.addEventListener("gamepadconnected", (event) => {
  // All buttons and axes values can be accessed through
  const gamepad = event.gamepad;
});

或者,您可以使用 window.ongamepadconnected 事件處理程式屬性來為 gamepadconnected 事件建立一個處理程式。

js
window.ongamepadconnected = (event) => {
  // All buttons and axes values can be accessed through
  const gamepad = event.gamepad;
};

規範

規範
Gamepad
# event-gamepadconnected

瀏覽器相容性

另見