Document : propriété pictureInPictureEnabled
Limited availability
Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.
La propriété en lecture seule pictureInPictureEnabled de l'interface Document indique si le mode image dans l'image est disponible ou non.
Le mode image dans l'image est disponible par défaut sauf indication contraire par une politique de permission.
Bien que cette propriété soit en lecture seule, elle ne génère pas d'exception si elle est modifiée (même en mode strict) ; le mutateur est une opération nulle et sera ignoré.
Valeur
Une valeur booléenne, qui est true si une vidéo peut passer en mode image dans l'image et être affichée dans une fenêtre flottante en appelant HTMLVideoElement.requestPictureInPicture(). Si le mode image dans l'image n'est pas disponible, cette valeur est false.
Exemples
Dans cet exemple, avant de tenter de passer en mode image dans l'image pour un élément HTML <video>, la valeur de pictureInPictureEnabled est vérifiée pour éviter l'appel si la fonctionnalité n'est pas disponible.
function requestPictureInPicture() {
if (document.pictureInPictureEnabled) {
videoElement.requestPictureInPicture();
} else {
console.log(
"Votre navigateur ne peut pas utiliser le mode image dans l'image actuellement",
);
}
}
Spécifications
| Specification |
|---|
| Picture-in-Picture # dom-document-pictureinpictureenabled |
Compatibilité des navigateurs
Voir aussi
- La méthode
HTMLVideoElement.requestPictureInPicture() - La propriété
HTMLVideoElement.disablePictureInPicture - La méthode
Document.exitPictureInPicture() - La propriété
Document.pictureInPictureElement - La pseudo-classe CSS
:picture-in-picture