Document: pictureInPictureElement-Eigenschaft
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more support for this feature? Tell us why.
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.
function exitPictureInPicture() {
if (document.pictureInPictureElement) {
document.exitPictureInPicture();
}
}
Spezifikationen
| Spezifikation |
|---|
| Picture-in-Picture # dom-documentorshadowroot-pictureinpictureelement |