Dokument: 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 Eigenschaft pictureInPictureEnabled 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 festgelegt durch eine Permissions-Policy.

Obwohl diese Eigenschaft schreibgeschützt ist, wird sie beim Ändern keinen Fehler werfen (selbst im strict mode); der Setter ist eine No-Operation und wird ignoriert.

Wert

Ein boolescher Wert, der true ist, wenn ein Video in den Bild-in-Bild-Modus versetzt werden 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, bevor versucht wird, den Bild-in-Bild-Modus für ein <video>-Element aufzurufen, der Wert von pictureInPictureEnabled geprüft, um den Aufruf zu vermeiden, falls 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

Siehe auch