CaptureController: zoomlevelchange Ereignis

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Das zoomlevelchange Ereignis der CaptureController Schnittstelle wird ausgelöst, wenn sich der Zoom-Level der erfassten Anzeigeoberfläche ändert.

Dies tritt speziell auf, wenn:

  • Die Methoden increaseZoomLevel(), decreaseZoomLevel() oder resetZoomLevel() auf einem Controller aufgerufen werden, der aktiv eine erfasste Anzeigeoberfläche steuert.
  • Der Benutzer den Zoom-Level in der erfassten Oberfläche ändert.
  • Der Benutzer die erfasste Anzeigeoberfläche auf eine andere mit einem anderen Zoom-Level wechselt.

Syntax

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

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

onzoomlevelchange = (event) => { }

Ereignistyp

Ein generisches Event.

Beispiele

Grundlegende Verwendung von zoomlevelchange

Wenn sich der Zoom-Level einer erfassten Anzeigeoberfläche ändert, wird ein zoomlevelchange Ereignis auf dem Controller ausgelöst. Dieses kann verwendet werden, um einen Ereignishandler wie den folgenden auszuführen, der den aktualisierten Zoom-Level an ein beliebiges Ausgabe-Element schreibt.

js
// Create controller and start capture
const controller = new CaptureController();
videoElem.srcObject = await navigator.mediaDevices.getDisplayMedia({
  controller,
});

// ...

controller.addEventListener(
  "zoomlevelchange",
  () => (outputElem.textContent = `${controller.zoomLevel}%`),
);

Siehe Verwendung der Captured Surface Control API für ein vollständiges Arbeitsbeispiel.

Spezifikationen

Specification
Captured Surface Control
# dom-capturecontroller-onzoomlevelchange

Browser-Kompatibilität

Siehe auch