Document: pictureInPictureElement-Eigenschaft

Limited availability

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

Die schreibgeschützte pictureInPictureElement-Eigenschaft der Document-Schnittstelle gibt das Element zurück, das derzeit im Bild-im-Bild-Modus in diesem Dokument dargestellt wird, oder null, wenn der Bild-im-Bild-Modus derzeit nicht verwendet wird.

Obwohl diese Eigenschaft schreibgeschützt ist, wird sie beim Versuch, sie zu ändern (auch im strengen Modus), keinen Fehler auslösen; der Setter ist eine No-Operation und wird ignoriert.

Wert

Ein Verweis auf das Element-Objekt, das sich derzeit im Bild-im-Bild-Modus befindet.

Gibt null zurück, wenn das Dokument kein zugehöriges Element im Bild-im-Bild-Modus hat. Zum Beispiel gibt es kein Bild-im-Bild-Element oder das Element stammt aus einem iframe.

Beispiele

Dieses Beispiel präsentiert eine Funktion, exitPictureInPicture(), die den von pictureInPictureElement zurückgegebenen Wert testet. Wenn sich das Dokument im Bild-im-Bild-Modus befindet (pictureInPictureElement ist nicht null), wird Document.exitPictureInPicture() ausgeführt, um den Bild-im-Bild-Modus zu beenden.

js
function exitPictureInPicture() {
  if (document.pictureInPictureElement) {
    document.exitPictureInPicture();
  }
}

Spezifikationen

Specification
Picture-in-Picture
# ref-for-dom-documentorshadowroot-pictureinpictureelement①⑤

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch