Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Document : évènement pointerlockchange

Limited availability

Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.

L'évènement pointerlockchange de l'interface Document est déclenché lorsque le pointeur est verrouillé ou déverrouillé.

Le gestionnaire d'évènements peut utiliser Document.pointerLockElement pour déterminer si le pointeur est verrouillé, et si oui, sur quel élément il l'est.

Cet évènement n'est pas annulable et ne se propage pas.

Syntaxe

Utiliser le nom de l'évènement dans des méthodes comme addEventListener(), ou définir une propriété de gestionnaire d'évènement.

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

onpointerlockchange = (event) => { }

Type d'évènement

Un objet Event générique.

Exemples

Utilisation de addEventListener() :

js
addEventListener("pointerlockchange", (event) => {
  if (document.pointerLockElement)
    console.log(
      "Le pointeur est verrouillé sur :",
      document.pointerLockElement,
    );
  else {
    console.log("Le pointeur n'est pas verrouillé");
  }
});

Utilisation de la propriété de gestionnaire d'évènement onpointerlockchange :

js
document.onpointerlockchange = (event) => {
  if (document.pointerLockElement)
    console.log(
      "Le pointeur est verrouillé sur :",
      document.pointerLockElement,
    );
  else {
    console.log("Le pointeur n'est pas verrouillé");
  }
};

Spécifications

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

Compatibilité des navigateurs

Voir aussi