Document : propriété pictureInPictureElement
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 pictureInPictureElement de l'interface Document retourne un Element actuellement affiché en mode image dans l'image dans ce document, ou null si le mode image dans l'image n'est pas utilisé.
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 référence à l'objet Element actuellement en mode image dans l'image.
Retourne null si le document n'a aucun élément associé en mode image dans l'image. Par exemple, il n'y a pas d'élément image dans l'image, ou l'élément provient d'un cadre intégré.
Exemples
Cet exemple présente une fonction, exitPictureInPicture(),
qui teste la valeur retournée par pictureInPictureElement. Si le document est en mode image dans l'image (pictureInPictureElement n'est pas null), alors Document.exitPictureInPicture() est exécutée pour quitter le mode image dans l'image.
function exitPictureInPicture() {
if (document.pictureInPictureElement) {
document.exitPictureInPicture();
}
}
Spécifications
| Specification |
|---|
| Picture-in-Picture # dom-documentorshadowroot-pictureinpictureelement |
Compatibilité des navigateurs
Voir aussi
- La méthode
HTMLVideoElement.requestPictureInPicture() - La propriété
HTMLVideoElement.disablePictureInPicture - La propriété
Document.pictureInPictureEnabled - La méthode
Document.exitPictureInPicture() - La pseudo-classe CSS
:picture-in-picture