Document: pictureInPictureEnabled-Eigenschaft

Limited availability

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

Die schreibgeschützte pictureInPictureEnabled-Eigenschaft der Document-Schnittstelle gibt an, ob der Bild-in-Bild-Modus verfügbar ist oder nicht.

Der Bild-in-Bild-Modus ist standardmäßig verfügbar, es sei denn, es ist anders durch eine Permissions-Policy spezifiziert.

Obwohl diese Eigenschaft schreibgeschützt ist, wird kein Fehler ausgelöst, wenn sie modifiziert wird (auch im Strict-Modus); der Setter hat keine Funktion und wird ignoriert.

Wert

Ein boolescher Wert, der true ist, wenn ein Video in den Bild-in-Bild-Modus wechseln und in einem schwebenden Fenster angezeigt werden kann, indem HTMLVideoElement.requestPictureInPicture() aufgerufen wird. Wenn der Bild-in-Bild-Modus nicht verfügbar ist, ist dieser Wert false.

Beispiele

In diesem Beispiel wird vor dem Versuch, den Bild-in-Bild-Modus für ein <video>-Element zu aktivieren, der Wert von pictureInPictureEnabled überprüft, um den Aufruf zu vermeiden, wenn die Funktion nicht verfügbar ist.

js
function requestPictureInPicture() {
  if (document.pictureInPictureEnabled) {
    videoElement.requestPictureInPicture();
  } else {
    console.log("Your browser cannot use picture-in-picture right now");
  }
}

Spezifikationen

Specification
Picture-in-Picture
# ref-for-dom-document-pictureinpictureenabled

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch