Dokumentation: pictureInPictureEnabled-Eigenschaft
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 pictureInPictureEnabled-Eigenschaft der Document-Schnittstelle gibt an, ob der Bild-in-Bild-Modus verfügbar ist.
Der Bild-in-Bild-Modus ist standardmäßig verfügbar, es sei denn, er wird durch die Permissions-Policy der Seite verweigert.
Wert
Ein boolescher Wert, der true ist, wenn ein Video in den Bild-in-Bild-Modus wechseln und in einem schwebenden Fenster angezeigt werden kann, indem HTMLVideoElement.requestPictureInPicture() aufgerufen wird. Wenn der Bild-in-Bild-Modus nicht verfügbar ist, ist dieser Wert false.
Obwohl diese Eigenschaft schreibgeschützt ist, wird kein Fehler ausgelöst, wenn sie modifiziert wird (auch nicht im Strict Mode); der Setter hat keine Wirkung und wird ignoriert.
Beispiele
Grundlegende Verwendung
In diesem Beispiel wird, bevor der Versuch unternommen wird, den Bild-in-Bild-Modus für ein <video>-Element zu aktivieren, der Wert von pictureInPictureEnabled überprüft, um den Aufruf zu vermeiden, wenn die Funktion nicht verfügbar ist.
function requestPictureInPicture() {
if (document.pictureInPictureEnabled) {
videoElement.requestPictureInPicture();
} else {
console.log("Your browser cannot use picture-in-picture right now");
}
}
Spezifikationen
| Spezifikation |
|---|
| Picture-in-Picture # dom-document-pictureinpictureenabled |