Dokument: Eigenschaft pictureInPictureElement
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Die schreibgeschützte Eigenschaft pictureInPictureElement der Document-Schnittstelle gibt das Element zurück, das derzeit im Picture-in-Picture-Modus in diesem Dokument präsentiert wird, oder null, wenn der Picture-in-Picture-Modus derzeit nicht verwendet wird.
Wert
Eine Referenz auf das Element-Objekt, das sich derzeit im Picture-in-Picture-Modus befindet.
Gibt null zurück, wenn das Dokument kein zugehöriges Element im Picture-in-Picture-Modus hat. Zum Beispiel gibt es kein Picture-in-Picture-Element oder das Element stammt aus einem iframe.
Obwohl diese Eigenschaft schreibgeschützt ist, wird sie keinen Fehler erzeugen, wenn sie modifiziert wird (auch nicht im strikten Modus); der Setter ist eine No-Operation und wird ignoriert.
Beispiele
Grundlegende Verwendung
Dieses Beispiel zeigt eine Funktion, exitPictureInPicture(), die den durch pictureInPictureElement zurückgegebenen Wert testet. Wenn das Dokument sich im Picture-in-Picture-Modus befindet (pictureInPictureElement ist nicht null), wird Document.exitPictureInPicture() ausgeführt, um den Picture-in-Picture-Modus zu beenden.
function exitPictureInPicture() {
if (document.pictureInPictureElement) {
document.exitPictureInPicture();
}
}
Spezifikationen
| Spezifikation |
|---|
| Picture-in-Picture # dom-documentorshadowroot-pictureinpictureelement |