Window.captureEvents()

Obsolète: Cette fonctionnalité a été supprimée des standards du Web. Bien que quelques navigateurs puissent encore la supporter, elle est en cours d'éradication. Ne l'utilisez ni dans d'anciens projets, ni dans de nouveaux. Les pages et applications Web l'utilisant peuvent cesser de fonctionner à tout moment.

Non standard: Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.

La méthode Window.captureEvents() enregistre la fenêtre pour capturer tous les événements du type spécifié.

Syntaxe

js
window.captureEvents(eventType);

eventType est une combinaison des valeurs suivantes: Event.ABORT, Event.BLUR, Event.CLICK, Event.CHANGE, Event.DBLCLICK, Event.DRAGDDROP, Event.ERROR, Event.FOCUS, Event.KEYDOWN, Event.KEYPRESS, Event.KEYUP, Event.LOAD, Event.MOUSEDOWN, Event.MOUSEMOVE, Event.MOUSEOUT, Event.MOUSEOVER, Event.MOUSEUP, Event.MOVE, Event.RESET, Event.RESIZE, Event.SELECT, Event.SUBMIT, Event.UNLOAD.

Exemple

html
<!doctype html>
<html lang="fr">
  <head>
    <!-- ... -->
    <script>
      function reg() {
        window.captureEvents(Event.CLICK);
        window.onclick = page_click;
      }

      function page_click() {
        alert("événement de clic sur la page détecté!");
      }
    </script>
  </head>

  <body onload="reg();">
    <p>cliquez n'importe où sur cette page.</p>
  </body>
</html>

Notes

Les évènements déclenchés dans le DOM par l'activité de l'utilisatrice ou l'utilisateur (tels que cliquer sur des boutons ou déplacer le focus loin du document actuel) passent généralement par la window de haut niveau et les objets de document avant d'arriver à l'objet qui a déclenché l'évènement.

Lorsque vous appelez la méthode captureEvents() sur window, les évènements du type que vous spécifiez (par exemple, Event.CLICK) ne passent plus par les objets « inférieurs » de la hiérarchie. Pour que les évènements « bouillonnent » comme ils le font normalement, vous devez appeler window.releaseEvents() ( ) sur la fenêtre pour l'empêcher de piéger les évènements.

Notez que vous pouvez transmettre une liste d'événements à cette méthode en utilisant la syntaxe suivante : window.captureEvents(Event.KEYPRESS | Event.KEYDOWN | Event.KEYUP).

Spécification

Cela ne fait partie d'aucune spécification.