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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
pictureInPictureElement

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

Siehe auch