Document : méthode exitPictureInPicture()
Limited availability
Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.
La méthode exitPictureInPicture() de l'interface Document demande qu'une vidéo contenue dans ce document, actuellement flottante, soit retirée du mode image dans l'image, restaurant l'état précédent de l'écran. Cela annule généralement les effets d'un appel précédent à HTMLVideoElement.requestPictureInPicture().
Syntaxe
exitPictureInPicture()
Paramètres
Aucun.
Valeur de retour
Une promesse (Promise), qui est résolue une fois que l'agent utilisateur a terminé de quitter le mode image dans l'image. Si une erreur se produit lors de la tentative de sortie du mode image dans l'image, le gestionnaire catch() de la promesse est appelé.
Exceptions
InvalidStateErrorDOMException-
Levée si
document.pictureInPictureElementestnull.
Exemples
Cet exemple permet au document actuel de quitter le mode image dans l'image chaque fois que le bouton de la souris est cliqué à l'intérieur.
document.onclick = (event) => {
if (document.pictureInPictureElement) {
document
.exitPictureInPicture()
.then(() => console.log("Document a quitté le mode image dans l'image"))
.catch((err) => console.error(err));
} else {
video.requestPictureInPicture();
}
};
Notez que si vous souhaitez suivre quelle vidéo de votre page est actuellement en cours de lecture en mode image dans l'image, vous devez écouter les événements enterpictureinpicture et exitpictureinpicture sur l'élément HTMLVideoElement concerné. Alternativement, vous pouvez vérifier si Document.pictureInPictureElement fait référence à l'élément HTMLVideoElement actuel.
Spécifications
| Specification |
|---|
| Picture-in-Picture # dom-document-exitpictureinpicture |
Compatibilité des navigateurs
Voir aussi
- La méthode
HTMLVideoElement.requestPictureInPicture() - La méthode
HTMLVideoElement.disablePictureInPicture - La propriété
Document.pictureInPictureEnabled - La propriété
Document.pictureInPictureElement - La pseudo-classe CSS
:picture-in-picture - Les évènements Picture-in-Picture