Document: pointerlockchange-Ereignis

Limited availability

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

Das pointerlockchange-Ereignis wird ausgelöst, wenn der Zeiger gesperrt oder entsperrt wird.

Der Ereignishandler kann Document.pointerLockElement verwenden, um festzustellen, ob der Zeiger gesperrt ist und falls ja, an welches Element er gesperrt ist.

Dieses Ereignis kann nicht abgebrochen werden und tritt nicht auf (bubbled) auf.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.

js
addEventListener("pointerlockchange", (event) => {});

onpointerlockchange = (event) => {};

Ereignistyp

Ein generisches Event.

Beispiele

Verwendung von addEventListener():

js
addEventListener("pointerlockchange", (event) => {
  if (document.pointerLockElement)
    console.log("The pointer is locked to: ", document.pointerLockElement);
  else {
    console.log("The pointer is not locked");
  }
});

Verwendung der onpointerlockchange-Ereignishandler-Eigenschaft:

js
document.onpointerlockchange = (event) => {
  if (document.pointerLockElement)
    console.log("The pointer is locked to: ", document.pointerLockElement);
  else {
    console.log("The pointer is not locked");
  }
};

Spezifikationen

Specification
Pointer Lock 2.0
# pointerlockchange-and-pointerlockerror-events
Pointer Lock 2.0
# dom-document-onpointerlockchange

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch