Dokument: pictureInPictureEnabled-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 Eigenschaft pictureInPictureEnabled der Document-Schnittstelle gibt an, ob der Bild-in-Bild-Modus verfügbar ist oder nicht.
Der Bild-in-Bild-Modus ist standardmäßig verfügbar, es sei denn, es ist anders festgelegt durch eine Permissions-Policy.
Obwohl diese Eigenschaft schreibgeschützt ist, wird sie beim Ändern keinen Fehler werfen (selbst im strict mode); der Setter ist eine No-Operation und wird ignoriert.
Wert
Ein boolescher Wert, der true ist, wenn ein Video in den Bild-in-Bild-Modus versetzt werden 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.
Beispiele
In diesem Beispiel wird, bevor versucht wird, den Bild-in-Bild-Modus für ein <video>-Element aufzurufen, der Wert von pictureInPictureEnabled geprüft, um den Aufruf zu vermeiden, falls 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 |