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.
function exitPictureInPicture() {
if (document.pictureInPictureElement) {
document.exitPictureInPicture();
}
}
Spezifikationen
| Specification |
|---|
| Picture-in-Picture # dom-documentorshadowroot-pictureinpictureelement |
Browser-Kompatibilität
Loading…